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

Diff for /mandoc/mandoc.1 between version 1.157 and 1.161

version 1.157, 2015/03/27 21:40:04 version 1.161, 2015/09/26 12:56:04
Line 284  See
Line 284  See
 .Sx PostScript Output .  .Sx PostScript Output .
 .It Fl T Cm tree  .It Fl T Cm tree
 Produce an indented parse tree.  Produce an indented parse tree.
   See
   .Sx Syntax tree output .
 .It Fl T Cm utf8  .It Fl T Cm utf8
 Encode output in the UTF\-8 multi-byte format.  Encode output in the UTF\-8 multi-byte format.
 See  See
Line 490  to force a UTF\-8 locale.
Line 492  to force a UTF\-8 locale.
 See  See
 .Sx Locale Output  .Sx Locale Output
 for details and options.  for details and options.
   .Ss Syntax tree output
   Use
   .Fl T Cm tree
   to show a human readable representation of the syntax tree.
   It is useful for debugging the source code of manual pages.
   The exact format is subject to change, don't write parsers for it.
   Each output line shows one syntax tree node.
   Child nodes are indented with respect to their parent node.
   The columns are:
   .Pp
   .Bl -enum -compact
   .It
   For macro nodes, the macro name; for text and
   .Xr tbl 7
   nodes, the content.  There is a special format for
   .Xr eqn 7
   nodes.
   .It
   Node type (text, elem, block, head, body, body-end, tail, tbl, eqn).
   .It
   Flags:
   .Bl -dash -compact
   .It
   An opening parenthesis if the node is an opening delimiter.
   .It
   An asterisk if the node starts a new input line.
   .It
   The input line number (starting at one).
   .It
   A colon.
   .It
   The input column number (starting at one).
   .It
   A closing parenthesis if the node is a closing delimiter.
   .It
   A full stop if the node ends a sentence.
   .El
   .El
 .Sh ENVIRONMENT  .Sh ENVIRONMENT
 .Bl -tag -width MANPAGER  .Bl -tag -width MANPAGER
 .It Ev MANPAGER  .It Ev MANPAGER
Line 502  Specifies the pagination program to use when
Line 542  Specifies the pagination program to use when
 .Ev MANPAGER  .Ev MANPAGER
 is not defined.  is not defined.
 If neither PAGER nor MANPAGER is defined,  If neither PAGER nor MANPAGER is defined,
 .Pa /usr/bin/more Fl s  .Xr more 1
   .Fl s
 will be used.  will be used.
 .El  .El
 .Sh EXIT STATUS  .Sh EXIT STATUS
Line 566  as the style-sheet:
Line 607  as the style-sheet:
 .Pp  .Pp
 To check over a large set of manuals:  To check over a large set of manuals:
 .Pp  .Pp
 .Dl $ mandoc \-T lint `find /usr/src -name \e*\e.[1-9]`  .Dl $ mandoc \-T lint \(gafind /usr/src -name \e*\e.[1-9]\(ga
 .Pp  .Pp
 To produce a series of PostScript manuals for A4 paper:  To produce a series of PostScript manuals for A4 paper:
 .Pp  .Pp
Line 933  list block contains text or macros before the first
Line 974  list block contains text or macros before the first
 .Ic \&It  .Ic \&It
 macro.  macro.
 The offending children are moved before the beginning of the list.  The offending children are moved before the beginning of the list.
 .It Sy ".Vt block has child macro"  
 .Pq mdoc  
 The  
 .Ic \&Vt  
 macro supports plain text arguments only.  
 Formatting may be ugly and semantic searching  
 for the affected content might not work.  
 .It Sy "fill mode already enabled, skipping"  .It Sy "fill mode already enabled, skipping"
 .Pq man  .Pq man
 A  A
Legend:
Removed from v.1.157  
changed lines
  Added in v.1.161
CVSweb