[BACK]Return to mandoc.1 CVS log [TXT][DIR] Up to [cvsweb.bsd.lv] / mandoc

Diff for /mandoc/mandoc.1 between version 1.168 and 1.174

version 1.168, 2017/01/08 00:11:23 version 1.174, 2017/02/10 15:45:28
Line 498  Use
Line 498  Use
 to show a human readable representation of the syntax tree.  to show a human readable representation of the syntax tree.
 It is useful for debugging the source code of manual pages.  It is useful for debugging the source code of manual pages.
 The exact format is subject to change, so don't write parsers for it.  The exact format is subject to change, so don't write parsers for it.
 Each output line shows one syntax tree node.  .Pp
   The first paragraph shows meta data found in the
   .Xr mdoc 7
   prologue, on the
   .Xr man 7
   .Ic \&TH
   line, or the fallbacks used.
   .Pp
   In the tree dump, each output line shows one syntax tree node.
 Child nodes are indented with respect to their parent node.  Child nodes are indented with respect to their parent node.
 The columns are:  The columns are:
 .Pp  .Pp
Line 529  The input column number (starting at one).
Line 537  The input column number (starting at one).
 A closing parenthesis if the node is a closing delimiter.  A closing parenthesis if the node is a closing delimiter.
 .It  .It
 A full stop if the node ends a sentence.  A full stop if the node ends a sentence.
   .It
   BROKEN if the node is a block broken by another block.
   .It
   NOSRC if the node is not in the input file,
   but automatically generated from macros.
   .It
   NOPRT if the node is not supposed to generate output
   for any output format.
 .El  .El
 .El  .El
   .Pp
   The following
   .Fl O
   argument is accepted:
   .Bl -tag -width Ds
   .It Cm noval
   Skip validation and show the unvalidated syntax tree.
   This can help to find out whether a given behaviour is caused by
   the parser or by the validator.
   Meta data is not available in this case.
   .El
 .Sh ENVIRONMENT  .Sh ENVIRONMENT
 .Bl -tag -width MANPAGER  .Bl -tag -width MANPAGER
 .It Ev MANPAGER  .It Ev MANPAGER
Line 1343  it is hard to predict which tab stop position the tab 
Line 1370  it is hard to predict which tab stop position the tab 
 Whitespace at the end of input lines is almost never semantically  Whitespace at the end of input lines is almost never semantically
 significant \(em but in the odd case where it might be, it is  significant \(em but in the odd case where it might be, it is
 extremely confusing when reviewing and maintaining documents.  extremely confusing when reviewing and maintaining documents.
   .It Sy "new sentence, new line"
   .Pq mdoc
   A new sentence starts in the middle of a text line.
   Start it on a new input line to help formatters produce correct spacing.
 .It Sy "bad comment style"  .It Sy "bad comment style"
 .Pq roff  .Pq roff
 Comment lines start with a dot, a backslash, and a double-quote character.  Comment lines start with a dot, a backslash, and a double-quote character.
Line 1818  as if they were a text line.
Line 1849  as if they were a text line.
 .Xr mdoc 7 ,  .Xr mdoc 7 ,
 .Xr roff 7 ,  .Xr roff 7 ,
 .Xr tbl 7  .Xr tbl 7
   .Sh HISTORY
   The
   .Nm
   utility first appeared in
   .Ox 4.8 .
   The option
   .Fl I
   appeared in
   .Ox 5.2 ,
   and
   .Fl aCcfhKklMSsw
   in
   .Ox 5.7 .
 .Sh AUTHORS  .Sh AUTHORS
 .An -nosplit  .An -nosplit
 The  The
Line 1826  utility was written by
Line 1870  utility was written by
 .An Kristaps Dzonsons Aq Mt kristaps@bsd.lv  .An Kristaps Dzonsons Aq Mt kristaps@bsd.lv
 and is maintained by  and is maintained by
 .An Ingo Schwarze Aq Mt schwarze@openbsd.org .  .An Ingo Schwarze Aq Mt schwarze@openbsd.org .
 .Sh BUGS  
 In  
 .Fl T Cm html ,  
 the maximum size of an element attribute is determined by  
 .Dv BUFSIZ ,  
 which is usually 1024 bytes.  
 Be aware of this when setting long link  
 formats such as  
 .Fl O Cm style Ns = Ns Ar really/long/link .  
Legend:
Removed from v.1.168  
changed lines
  Added in v.1.174
CVSweb