version 1.26, 2009/07/20 13:45:11 |
version 1.30, 2009/08/19 09:14:50 |
Line 130 replaced on output by a single space. Thus, if you wi |
|
Line 130 replaced on output by a single space. Thus, if you wi |
|
multiple spaces, they must be space-escaped |
multiple spaces, they must be space-escaped |
.Sq \e\ |
.Sq \e\ |
or used in a literal display mode, e.g., |
or used in a literal display mode, e.g., |
.Sq \&.Bd \-literal |
.Sq \&Bd \-literal |
in |
in |
.Xr mdoc 7 . |
.Xr mdoc 7 . |
.\" SUB-SECTION |
.\" SUB-SECTION |
|
|
.Fl m Ns Ar andoc , |
.Fl m Ns Ar andoc , |
which is also the default, determines encoding on-the-fly: if the first |
which is also the default, determines encoding on-the-fly: if the first |
non-comment macro is |
non-comment macro is |
.Sq \&.Dd |
.Sq \&Dd |
or |
or |
.Sq \&.Dt , |
.Sq \&Dt , |
the |
the |
.Xr mdoc 7 |
.Xr mdoc 7 |
parser is used; otherwise, the |
parser is used; otherwise, the |
|
|
.Fl f Ns Ar no-ign-macro |
.Fl f Ns Ar no-ign-macro |
and |
and |
.Fl f Ns Ar no-ign-chars . |
.Fl f Ns Ar no-ign-chars . |
|
.It Fl f Ns Ar ign-errors |
|
Don't halt when encountering parse errors. Useful with |
|
.Fl T Ns Ar lint |
|
over a large set of manuals passed on the command line. |
.El |
.El |
.\" PARAGRAPH |
.\" PARAGRAPH |
.Pp |
.Pp |
Line 245 To page manuals to the terminal: |
|
Line 249 To page manuals to the terminal: |
|
.Pp |
.Pp |
.D1 % mandoc \-Wall,error \-fstrict mandoc.1 2>&1 | less |
.D1 % mandoc \-Wall,error \-fstrict mandoc.1 2>&1 | less |
.D1 % mandoc mandoc.1 mdoc.3 mdoc.7 | less |
.D1 % mandoc mandoc.1 mdoc.3 mdoc.7 | less |
|
.\" PARAGRAPH |
|
.Pp |
|
To check over a large set of manuals: |
|
.\" PARAGRAPH |
|
.Pp |
|
.Dl % mandoc \-Tlint \-fign-errors `find /usr/src -name \e*\e.[1-9]` |
.\" SECTION |
.\" SECTION |
.Sh COMPATIBILITY |
.Sh COMPATIBILITY |
This section summarises |
This section summarises |
Line 253 compatibility with |
|
Line 263 compatibility with |
|
.Xr groff 1 . |
.Xr groff 1 . |
.Pp |
.Pp |
.Bl -bullet -compact |
.Bl -bullet -compact |
|
.\" LIST-ITEM |
.It |
.It |
|
The |
|
.Sq \e~ |
|
special character doesn't produce expected behaviour. |
|
.\" LIST-ITEM |
|
.It |
|
In |
|
.Xr groff 1 , |
|
the |
|
.Sq \&Pa |
|
macro does not underline when under a |
|
.Sq \&It |
|
in the FILES section. This behaves correctly in |
|
.Nm . |
|
.\" LIST-ITEM |
|
.It |
A list or display following |
A list or display following |
.Sq \&.Ss |
.Sq \&Ss |
does not assert a prior vertical break, just as it doesn't with |
does not assert a prior vertical break, just as it doesn't with |
.Sq \&.Sh . |
.Sq \&Sh . |
.It |
.It |
The \-literal and \-unfilled |
The \-literal and \-unfilled |
.Sq \&.Bd |
.Sq \&Bd |
displays types are synonyms, as are \-filled and \-ragged. |
displays types are synonyms, as are \-filled and \-ragged. |
|
.\" LIST-ITEM |
.It |
.It |
Words aren't hyphenated. |
Words aren't hyphenated. |
|
.\" LIST-ITEM |
.It |
.It |
In normal mode (not a literal block), blocks of spaces aren't preserved, |
In normal mode (not a literal block), blocks of spaces aren't preserved, |
so double spaces following sentence closure are reduced to a single space |
so double spaces following sentence closure are reduced to a single space. |
.Pq Dq French spacing . |
|
.El |
.El |
.\" SECTION |
.\" SECTION |
.Sh SEE ALSO |
.Sh SEE ALSO |