=================================================================== RCS file: /cvs/mandoc/Attic/mdocml.1,v retrieving revision 1.20 retrieving revision 1.24 diff -u -p -r1.20 -r1.24 --- mandoc/Attic/mdocml.1 2008/12/06 13:18:44 1.20 +++ mandoc/Attic/mdocml.1 2008/12/09 17:09:12 1.24 @@ -1,5 +1,5 @@ .\" -.Dd $Mdocdate: December 6 2008 $ +.Dd $Mdocdate: December 9 2008 $ .Dt mdocml 1 alpha .Os .\" @@ -9,7 +9,8 @@ .\" .Sh SYNOPSIS .Nm mdocml -.Op Fl vW +.Op Fl v +.Op Fl W Ns Ar err... .Op Fl f Ar filter .Op Fl o Ar outfile .Op Ar infile @@ -30,15 +31,24 @@ The output filter name. Write output to .Ar outfile , which may be -.Qq \- +.Dq \- for stdout. -.It Fl W -Print warnings to stderr. +.It Fl W Ns Ar err... +Print warning messages. If set to +.Fl W Ns Ar all , +all warnings are printed; if +.Fl W Ns Ar error , +warnings are considered errors and cause utility termination. Multiple +.Fl W +arguments may be comma-separated, such as +.Fl W Ns Ar error,all . +.It Fl v +Make warning and error messages verbose. .It Ar infile Read input from .Ar infile , which may be -.Qq \- +.Dq \- for stdin. .El .Pp @@ -56,24 +66,24 @@ is the default filter. This filter has no additional The XML filter creates an XML document where element names are their respective roff macro names. Each element name has an associated namespace, which is one of -.Qq block , -.Qq head , -.Qq body , +.Dq block , +.Dq head , +.Dq body , or -.Qq inline , +.Dq inline , corresponding to the display mode of a node. The document root is always the -.Qq mdoc +.Dq mdoc element, in the default namespace; the -.Qq head +.Dq head namespace is for block headers (such as .Sq .Ss and .Sq .Sh ) ; the -.Qq body +.Dq body namespace is for block bodies; and the -.Qq inline +.Dq inline namespace is for in-line elements (such as .Sq .Em ) . .Ss HTML Filter @@ -118,7 +128,7 @@ and The .Nm utility was written by -.An Em Kristaps Dzonsons Aq kristaps@kth.se . +.An Kristaps Dzonsons Aq kristaps@kth.se . .\" .Sh CAVEATS Most caveats of