=================================================================== RCS file: /cvs/mandoc/mandoc.1,v retrieving revision 1.51 retrieving revision 1.56 diff -u -p -r1.51 -r1.56 --- mandoc/mandoc.1 2010/03/22 14:03:03 1.51 +++ mandoc/mandoc.1 2010/03/29 10:10:35 1.56 @@ -1,4 +1,4 @@ -.\" $Id: mandoc.1,v 1.51 2010/03/22 14:03:03 kristaps Exp $ +.\" $Id: mandoc.1,v 1.56 2010/03/29 10:10:35 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: March 22 2010 $ +.Dd $Mdocdate: March 29 2010 $ .Dt MANDOC 1 .Os . @@ -176,6 +176,10 @@ Produce an indented parse tree. . .It Fl T Ns Ar lint Parse only: produce no output. +Implies +.Fl W Ns Ar all +and +.Fl f Ns Ar strict . .El . .Pp @@ -216,7 +220,8 @@ and .Fl f Ns Ar no-ign-chars . . .It Fl f Ns Ar ign-errors -Don't halt when encountering parse errors. Useful with +When parsing multiple files, don't halt when one errors out. Useful +with .Fl T Ns Ar lint over a large set of manuals passed on the command line. .El @@ -225,6 +230,8 @@ over a large set of manuals passed on the command line .Ss Output Options For the time being, only .Fl T Ns Ar html +and +.Fl T Ns Ar xhtml accepts output options: .Bl -tag -width Ds .It Fl O Ns Ar style=style.css @@ -504,6 +511,7 @@ CSS2 styling used for .Fl m Ns Ar doc input lists does not render properly in older browsers, such as Internet Explorer 6 and earlier. +. .Pp In .Fl T Ns Ar html @@ -514,6 +522,7 @@ the maximum size of an element attribute is determined which is usually 1024 bytes. Be aware of this when setting long link formats, e.g., .Fl O Ns Ar style=really/long/link . +. .Pp The .Fl T Ns Ar html @@ -525,9 +534,10 @@ font size escape documented in .Xr mdoc 7 and .Xr man 7 . +. .Pp Nesting elements within next-line element scopes of -.Fl m Ar Ns an , +.Fl m Ns Ar an , such as .Sq br within an empty @@ -536,4 +546,17 @@ will confuse .Fl T Ns Ar html and .Fl T Ns Ar xhtml -and cause it to forget the formatting. +and cause them to forget the formatting of the prior next-line scope. +. +.Pp +The +.Sq i +macro in +.Fl m Ns Ar an +should italicise all subsequent text if a line argument is not provided. +This behaviour is not implemented. +. +The +.Sq \(aq +control character is an alias for the standard macro control character +and does not emit a line-break as stipulated in GNU troff.