X-Git-Url: https://git.cameronkatri.com/mandoc.git/blobdiff_plain/6e833a20a85c3db8d206be179927b1591339d982..ad49fd6fca6bf93db3c355e5d5c4c18d84405a08:/mandoc.1 diff --git a/mandoc.1 b/mandoc.1 index 5ab24126..ffbc18c2 100644 --- a/mandoc.1 +++ b/mandoc.1 @@ -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 by 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.