=================================================================== RCS file: /cvs/mandoc/mandoc.1,v retrieving revision 1.27 retrieving revision 1.29 diff -u -p -r1.27 -r1.29 --- mandoc/mandoc.1 2009/07/21 15:52:41 1.27 +++ mandoc/mandoc.1 2009/07/26 19:30:50 1.29 @@ -1,4 +1,4 @@ -.\" $Id: mandoc.1,v 1.27 2009/07/21 15:52:41 kristaps Exp $ +.\" $Id: mandoc.1,v 1.29 2009/07/26 19:30: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: July 26 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,7 +263,13 @@ 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 @@ -262,6 +278,7 @@ macro does not underline when under a .Sq \&It . 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