version 1.88, 2011/05/20 15:51:18 |
version 1.91, 2011/09/17 15:00:51 |
|
|
.Op Fl O Ns Ar option |
.Op Fl O Ns Ar option |
.Op Fl T Ns Ar output |
.Op Fl T Ns Ar output |
.Op Fl W Ns Ar level |
.Op Fl W Ns Ar level |
.Op Ar file... |
.Op Ar |
.Sh DESCRIPTION |
.Sh DESCRIPTION |
The |
The |
.Nm |
.Nm |
Line 159 utility accepts the following |
|
Line 159 utility accepts the following |
|
arguments, which correspond to output modes: |
arguments, which correspond to output modes: |
.Bl -tag -width Ds |
.Bl -tag -width Ds |
.It Fl T Ns Cm utf8 |
.It Fl T Ns Cm utf8 |
Encode output in the UTF-8 multi-byte format. |
Encode output in the UTF\-8 multi-byte format. |
See |
See |
.Xr UTF-8 Output . |
.Sx UTF\-8 Output . |
.It Fl T Ns Cm locale |
.It Fl T Ns Cm locale |
Encode output using the current |
Encode output using the current locale. |
.Xr locale 1 . |
|
See |
See |
.Sx Locale Output . |
.Sx Locale Output . |
.It Fl T Ns Cm ascii |
.It Fl T Ns Cm ascii |
|
|
Parse only: produce no output. |
Parse only: produce no output. |
Implies |
Implies |
.Fl W Ns Cm warning . |
.Fl W Ns Cm warning . |
|
.It Fl T Ns Cm man |
|
Produce output in |
|
.Xr man 7 |
|
format; only useful when applied to |
|
.Fl m Ns Cm doc |
|
input. |
.It Fl T Ns Cm pdf |
.It Fl T Ns Cm pdf |
Produce PDF output. |
Produce PDF output. |
See |
See |
|
|
.Pp |
.Pp |
If multiple input files are specified, these will be processed by the |
If multiple input files are specified, these will be processed by the |
corresponding filter in-order. |
corresponding filter in-order. |
.Ss UTF-8 Output |
.Ss UTF\-8 Output |
Use |
Use |
.Fl T Ns Cm utf8 |
.Fl T Ns Cm utf8 |
to force a UTF-8 locale. |
to force a UTF\-8 locale. |
See |
See |
.Sx Locale Output |
.Sx Locale Output |
for details and options. |
for details and options. |
Line 265 If a style-sheet is not specified with |
|
Line 270 If a style-sheet is not specified with |
|
defaults to simple output readable in any graphical or text-based web |
defaults to simple output readable in any graphical or text-based web |
browser. |
browser. |
.Pp |
.Pp |
Special characters are rendered in decimal-encoded UTF-8. |
Special characters are rendered in decimal-encoded UTF\-8. |
.Pp |
.Pp |
The following |
The following |
.Fl O |
.Fl O |
Line 418 To check over a large set of manuals: |
|
Line 423 To check over a large set of manuals: |
|
To produce a series of PostScript manuals for A4 paper: |
To produce a series of PostScript manuals for A4 paper: |
.Pp |
.Pp |
.Dl $ mandoc \-Tps \-Opaper=a4 mdoc.7 man.7 \*(Gt manuals.ps |
.Dl $ mandoc \-Tps \-Opaper=a4 mdoc.7 man.7 \*(Gt manuals.ps |
|
.Pp |
|
Convert a modern |
|
.Xr mdoc 7 |
|
manual to the older |
|
.Xr man 7 |
|
format, for use on systems lacking an |
|
.Xr mdoc 7 |
|
parser: |
|
.Pp |
|
.Dl $ mandoc \-Tman foo.mdoc \*(Gt foo.man |
.Sh DIAGNOSTICS |
.Sh DIAGNOSTICS |
Standard error messages reporting parsing errors are prefixed by |
Standard error messages reporting parsing errors are prefixed by |
.Pp |
.Pp |
Line 573 lists render similarly. |
|
Line 588 lists render similarly. |
|
The |
The |
.Nm |
.Nm |
utility was written by |
utility was written by |
.An Kristaps Dzonsons Aq kristaps@bsd.lv . |
.An Kristaps Dzonsons , |
|
.Mt kristaps@bsd.lv . |
.Sh CAVEATS |
.Sh CAVEATS |
In |
In |
.Fl T Ns Cm html |
.Fl T Ns Cm html |