version 1.159, 2015/04/03 08:46:17 |
version 1.161, 2015/09/26 12:56:04 |
|
|
.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 934 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 |