=================================================================== RCS file: /cvs/mandoc/Attic/mdocml.1,v retrieving revision 1.18 retrieving revision 1.23 diff -u -p -r1.18 -r1.23 --- mandoc/Attic/mdocml.1 2008/12/05 11:28:17 1.18 +++ mandoc/Attic/mdocml.1 2008/12/08 16:29:57 1.23 @@ -1,5 +1,5 @@ .\" -.Dd $Mdocdate: December 5 2008 $ +.Dd $Mdocdate: December 8 2008 $ .Dt mdocml 1 alpha .Os .\" @@ -30,21 +30,25 @@ 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 v +Make warning and error messages verbose. .It Ar infile Read input from .Ar infile , which may be -.Qq \- +.Dq \- for stdin. .El .Pp By default, .Nm reads from stdin and writes to stdout using the xml filter. +.Pp +.Ex -std mdocml .\" .Ss XML Filter The XML filter, specified by @@ -54,24 +58,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 @@ -116,7 +120,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 @@ -128,8 +132,6 @@ structured ones: .Bl -enum -compact -offset indent .It The engine doesn't understand the -.Sq \&Xo , -.Sq \&Xc , .Sq \&No , .Sq \&Db , .Sq \&Xc ,