version 1.151, 2015/02/06 16:06:25 |
version 1.154, 2015/02/16 19:02:48 |
|
|
.Nd format and display UNIX manuals |
.Nd format and display UNIX manuals |
.Sh SYNOPSIS |
.Sh SYNOPSIS |
.Nm mandoc |
.Nm mandoc |
.Op Fl acfhklV |
.Op Fl acfhkl |
.Sm off |
.Sm off |
.Op Fl I Cm os Li = Ar name |
.Op Fl I Cm os Li = Ar name |
.Sm on |
.Sm on |
|
|
for available formats. |
for available formats. |
Defaults to |
Defaults to |
.Fl T Ns Cm locale . |
.Fl T Ns Cm locale . |
.It Fl V |
|
Print version and exit. |
|
.It Fl W Ns Ar level |
.It Fl W Ns Ar level |
Specify the minimum message |
Specify the minimum message |
.Ar level |
.Ar level |
Line 729 macro occurs after some non-prologue macro, but still |
|
Line 727 macro occurs after some non-prologue macro, but still |
|
.Pq mdoc |
.Pq mdoc |
The |
The |
.Ic \&Dt |
.Ic \&Dt |
macro can only occur before the first non-prologue macro |
macro appears after the first non-prologue macro. |
because traditional formatters write the page header |
Traditional formatters cannot handle this because |
before parsing the document body. |
they write the page header before parsing the document body. |
Even though this technical restriction does not apply to |
Even though this technical restriction does not apply to |
.Nm , |
.Nm , |
traditional semantics is preserved. |
traditional semantics is preserved. |
Line 836 manual for replacements. |
|
Line 834 manual for replacements. |
|
.Pq mdoc |
.Pq mdoc |
The name of a macro that is not callable appears on a macro line. |
The name of a macro that is not callable appears on a macro line. |
It is printed verbatim. |
It is printed verbatim. |
If the intention is to call it, move it to its own line; |
If the intention is to call it, move it to its own input line; |
otherwise, escape it by prepending |
otherwise, escape it by prepending |
.Sq \e& . |
.Sq \e& . |
.It Sy "skipping paragraph macro" |
.It Sy "skipping paragraph macro" |
|
|
.Ic \&It |
.Ic \&It |
block is empty. |
block is empty. |
An empty list item is shown. |
An empty list item is shown. |
.It Sy "missing font type" |
.It Sy "missing font type, using \efR" |
.Pq mdoc |
.Pq mdoc |
A |
A |
.Ic \&Bf |
.Ic \&Bf |
macro has no argument. |
macro has no argument. |
It switches to the default font, |
It switches to the default font. |
.Cm \efR . |
.It Sy "unknown font type, using \efR" |
.It Sy "unknown font type" |
|
.Pq mdoc |
.Pq mdoc |
The |
The |
.Ic \&Bf |
.Ic \&Bf |
argument is invalid. |
argument is invalid. |
The default font |
The default font is used instead. |
.Cm \efR |
|
is used instead. |
|
.It Sy "nothing follows prefix" |
.It Sy "nothing follows prefix" |
.Pq mdoc |
.Pq mdoc |
A |
A |
Line 1503 macros as well as tables require explicit closing by d |
|
Line 1498 macros as well as tables require explicit closing by d |
|
A block that doesn't support bad nesting |
A block that doesn't support bad nesting |
ends before all of its children are properly closed. |
ends before all of its children are properly closed. |
The open child nodes are closed implicitly. |
The open child nodes are closed implicitly. |
.It Sy "scope open on exit" |
.It Sy "appending missing end of block" |
.Pq mdoc , man , eqn , tbl , roff |
.Pq mdoc , man , eqn , tbl , roff |
At the end of the document, an explicit |
At the end of the document, an explicit |
.Xr mdoc 7 |
.Xr mdoc 7 |
Line 1691 with more than one argument or with a non-integer argu |
|
Line 1686 with more than one argument or with a non-integer argu |
|
or a request of the |
or a request of the |
.Ic \&de |
.Ic \&de |
family with more than two arguments |
family with more than two arguments |
|
.It |
|
.Ic \&Dt |
|
with more than three arguments |
.It |
.It |
.Ic \&TH |
.Ic \&TH |
with more than five arguments |
with more than five arguments |