=================================================================== RCS file: /cvs/mandoc/mandoc.1,v retrieving revision 1.27 retrieving revision 1.30 diff -u -p -r1.27 -r1.30 --- mandoc/mandoc.1 2009/07/21 15:52:41 1.27 +++ mandoc/mandoc.1 2009/08/19 09:14:50 1.30 @@ -1,4 +1,4 @@ -.\" $Id: mandoc.1,v 1.27 2009/07/21 15:52:41 kristaps Exp $ +.\" $Id: mandoc.1,v 1.30 2009/08/19 09:14:50 kristaps Exp $ .\" .\" Copyright (c) 2009 Kristaps Dzonsons .\" @@ -14,7 +14,7 @@ .\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF .\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. .\" -.Dd $Mdocdate: July 21 2009 $ +.Dd $Mdocdate: August 19 2009 $ .Dt MANDOC 1 .Os .\" SECTION @@ -227,6 +227,10 @@ Implies .Fl f Ns Ar no-ign-macro and .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 .\" PARAGRAPH .Pp @@ -245,6 +249,12 @@ To page manuals to the terminal: .Pp .D1 % mandoc \-Wall,error \-fstrict mandoc.1 2>&1 | 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 .Sh COMPATIBILITY This section summarises @@ -253,15 +263,22 @@ compatibility with .Xr groff 1 . .Pp .Bl -bullet -compact +.\" LIST-ITEM .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 . -This behaves correctly in +.Sq \&It +in the FILES section. This behaves correctly in .Nm . +.\" LIST-ITEM .It A list or display following .Sq \&Ss @@ -271,12 +288,13 @@ does not assert a prior vertical break, just as it doe The \-literal and \-unfilled .Sq \&Bd displays types are synonyms, as are \-filled and \-ragged. +.\" LIST-ITEM .It Words aren't hyphenated. +.\" LIST-ITEM .It 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 -.Pq Dq French spacing . +so double spaces following sentence closure are reduced to a single space. .El .\" SECTION .Sh SEE ALSO