version 1.11, 2009/03/26 16:44:22 |
version 1.12, 2009/04/02 16:42:35 |
|
|
Input format. See |
Input format. See |
.Sx Input Formats |
.Sx Input Formats |
for available formats. Defaults to |
for available formats. Defaults to |
.Fl m Ns Ar doc . |
.Fl m Ns Ar andoc . |
.\" ITEM |
.\" ITEM |
.It Fl T |
.It Fl T |
Output format. See |
Output format. See |
|
|
.Nm |
.Nm |
reads |
reads |
.Xr mdoc 7 |
.Xr mdoc 7 |
|
or |
|
.Xr man 7 |
text from stdin, implying |
text from stdin, implying |
.Fl m Ns Ar mdoc , |
.Fl m Ns Ar andoc , |
and prints 78-column backspace-encoded output to stdout as if |
and prints 78-column backspace-encoded output to stdout as if |
.Fl T Ns Ar ascii |
.Fl T Ns Ar ascii |
were provided. |
were provided. |
|
|
.Xr man 7 |
.Xr man 7 |
should only be used for legacy manuals. |
should only be used for legacy manuals. |
.Pp |
.Pp |
|
A third option, |
|
.Fl m Ns Ar andoc , |
|
which is also the default, determines encoding on-the-fly. If multiple |
|
files are passed in, each has its file-type determined this way. If |
|
multiple files are passed and |
|
.Fl m Ns Ar doc |
|
or |
|
.Fl m Ns Ar an |
|
is specified, then this format is used exclusively. |
|
.Pp |
The following escape sequences are recognised, although the per-format |
The following escape sequences are recognised, although the per-format |
compiler may not allow certain sequences. |
compiler may not allow certain sequences. |
.Bl -tag -width Ds -offset XXXX |
.Bl -tag -width Ds -offset XXXX |
Line 192 Parse only: produce no output. |
|
Line 204 Parse only: produce no output. |
|
Default compiler behaviour may be overriden with the |
Default compiler behaviour may be overriden with the |
.Fl f |
.Fl f |
flag. |
flag. |
.Bl -tag -width XXXXXXXXXXXX -offset XXXX |
.Bl -tag -width XXXXXXXXXXXXXX -offset XXXX |
.It Fl f Ns Ar ign-scope |
.It Fl f Ns Ar ign-scope |
When rewinding the scope of a block macro, forces the compiler to ignore |
When rewinding the scope of a block macro, forces the compiler to ignore |
scope violations. This can seriously mangle the resulting tree. |
scope violations. This can seriously mangle the resulting tree. |
Line 200 scope violations. This can seriously mangle the resul |
|
Line 212 scope violations. This can seriously mangle the resul |
|
.It Fl f Ns Ar ign-escape |
.It Fl f Ns Ar ign-escape |
Ignore invalid escape sequences. |
Ignore invalid escape sequences. |
.It Fl f Ns Ar ign-macro |
.It Fl f Ns Ar ign-macro |
Ignore unknown macros at the start of input lines. |
Ignore unknown macros at the start of input lines (default for |
|
.Xr man 7 |
|
parsing). |
|
.It Fl f Ns Ar no-ign-macro |
|
Do not ignore unknown macros at the start of input lines (default for |
|
.Xr mdoc 7 |
|
parsing). |
.El |
.El |
.\" PARAGRAPH |
.\" PARAGRAPH |
.Pp |
.Pp |