src/usr.bin/mandoc/mandoc.1 - diff

Return to mandoc.1 CVS log

Up to [local] / src / usr.bin / mandoc

Diff for /src/usr.bin/mandoc/mandoc.1 between version 1.58 and 1.59

-version 1.58, 2014/06/23 22:03:03
+version 1.59, 2014/08/08 16:25:15
 Line 496
 Line 496
 Line 496
  .Pp
  .Dl $ mandoc \-Tman foo.mdoc \*(Gt foo.man
  .Sh DIAGNOSTICS
- Standard error messages reporting parsing errors are prefixed by
+ Messages displayed by
+ .Nm
+ follow this format:
  .Pp
- .D1 Nm Ns : Ar file : Ns Ar line : Ns Ar column : level :
+ .D1 Nm Ns : Ar file : Ns Ar line : Ns Ar column : level : message : macro args
  .Pp
- where the fields have the following meanings:
+ Line and column numbers start at 1.
- .Bl -tag -width "column"
+ Both are omitted for messages referring to an input file as a whole.
- .It Ar file
+ Macro names and arguments are omitted where meaningless.
- The name of the input file causing the message.
+ Fatal messages about invalid command line arguments
- .It Ar line
+ or operating system errors, for example when memory is exhausted,
- The line number in that input file.
+ may also omit the
- Line numbering starts at 1.
+ .Ar file
- .It Ar column
- The column number in that input file.
- Column numbering starts at 1.
- If the issue is caused by a word, the column number usually
- points to the first character of the word.
- .It Ar level
- The message level, printed in capital letters.
- .El
- .Pp
- The
- .Ar line
  and
- .Ar column
+ .Ar level
- fields are omitted when meaningless.
+ fields.
  .Pp
  Message levels have the following meanings:
  .Bl -tag -width "warning"
-Line 558
+Line 549
 Line 558
 Line 549
  option or
  .Fl T Ns Cm lint
  output mode.
- .Pp
- The
- .Nm
- utility may also print messages related to invalid command line arguments
- or operating system errors, for example when memory is exhausted.
- Such messages may not carry the prefix described above.
  .Sh COMPATIBILITY
  This section summarises
  .Nm