version 1.17, 2008/12/04 11:25:29 |
version 1.23, 2008/12/08 16:29:57 |
Line 30 The output filter name. |
|
Line 30 The output filter name. |
|
Write output to |
Write output to |
.Ar outfile , |
.Ar outfile , |
which may be |
which may be |
.Qq \- |
.Dq \- |
for stdout. |
for stdout. |
.It Fl W |
.It Fl W |
Print warnings to stderr. |
Print warnings to stderr. |
|
.It Fl v |
|
Make warning and error messages verbose. |
.It Ar infile |
.It Ar infile |
Read input from |
Read input from |
.Ar infile , |
.Ar infile , |
which may be |
which may be |
.Qq \- |
.Dq \- |
for stdin. |
for stdin. |
.El |
.El |
.Pp |
.Pp |
By default, |
By default, |
.Nm |
.Nm |
reads from stdin and writes to stdout using the xml filter. |
reads from stdin and writes to stdout using the xml filter. |
|
.Pp |
|
.Ex -std mdocml |
.\" |
.\" |
.Ss XML Filter |
.Ss XML Filter |
The XML filter, specified by |
The XML filter, specified by |
Line 54 is the default filter. This filter has no additional |
|
Line 58 is the default filter. This filter has no additional |
|
The XML filter creates an XML document where element names are their respective |
The XML filter creates an XML document where element names are their respective |
roff macro names. Each element name has an associated |
roff macro names. Each element name has an associated |
namespace, which is one of |
namespace, which is one of |
.Qq block , |
.Dq block , |
.Qq head , |
.Dq head , |
.Qq body , |
.Dq body , |
or |
or |
.Qq inline , |
.Dq inline , |
corresponding to the display mode of a node. The document root is |
corresponding to the display mode of a node. The document root is |
always the |
always the |
.Qq mdoc |
.Dq mdoc |
element, in the default namespace; the |
element, in the default namespace; the |
.Qq head |
.Dq head |
namespace is for block headers (such as |
namespace is for block headers (such as |
.Sq .Ss |
.Sq .Ss |
and |
and |
.Sq .Sh ) ; |
.Sq .Sh ) ; |
the |
the |
.Qq body |
.Dq body |
namespace is for block bodies; and the |
namespace is for block bodies; and the |
.Qq inline |
.Dq inline |
namespace is for in-line elements (such as |
namespace is for in-line elements (such as |
.Sq .Em ) . |
.Sq .Em ) . |
.Ss HTML Filter |
.Ss HTML Filter |
Line 85 The CSS file location, which defaults to |
|
Line 89 The CSS file location, which defaults to |
|
.It Fl e |
.It Fl e |
Whether to embed the CSS file into the HTML prologue. |
Whether to embed the CSS file into the HTML prologue. |
.El |
.El |
.\" This next request is for sections 1, 6, 7 & 8 only. |
.\" |
.\" .Sh ENVIRONMENT |
|
.Sh EXAMPLES |
.Sh EXAMPLES |
To produce an HTML4-strict document |
To produce an HTML4-strict document |
.Pa mdocml.html |
.Pa mdocml.html |
|
|
.Pa mdocml.1 |
.Pa mdocml.1 |
with the default, embedded style-sheet: |
with the default, embedded style-sheet: |
.Pp |
.Pp |
.D1 % mdocml -fhtml -e mdocml.1 -o mdocml.html |
.D1 % mdocml -fhtml -e -o mdocml.html mdocml.1 |
.Pp |
.Pp |
To create an XML document on standard output from |
To create an XML document on standard output from |
.Pa mdocml.1 |
.Pa mdocml.1 |
|
|
The |
The |
.Nm |
.Nm |
utility was written by |
utility was written by |
.An Em Kristaps Dzonsons Aq kristaps@kth.se . |
.An Kristaps Dzonsons Aq kristaps@kth.se . |
.\" |
.\" |
.Sh CAVEATS |
.Sh CAVEATS |
Most caveats of |
Most caveats of |
Line 129 structured ones: |
|
Line 132 structured ones: |
|
.Bl -enum -compact -offset indent |
.Bl -enum -compact -offset indent |
.It |
.It |
The engine doesn't understand the |
The engine doesn't understand the |
.Sq \&Xo , |
|
.Sq \&Xc , |
|
.Sq \&No , |
.Sq \&No , |
.Sq \&Db , |
.Sq \&Db , |
.Sq \&Xc , |
.Sq \&Xc , |