version 1.112, 2014/09/12 00:10:26 |
version 1.123, 2014/11/25 20:18:15 |
|
|
.Sm off |
.Sm off |
.Op Fl I Cm os Li = Ar name |
.Op Fl I Cm os Li = Ar name |
.Sm on |
.Sm on |
|
.Op Fl K Ns Ar encoding |
.Op Fl m Ns Ar format |
.Op Fl m Ns Ar format |
.Op Fl O Ns Ar option |
.Op Fl O Ns Ar option |
.Op Fl T Ns Ar output |
.Op Fl T Ns Ar output |
|
|
.It Fl h |
.It Fl h |
Display only the SYNOPSIS lines. |
Display only the SYNOPSIS lines. |
Implies |
Implies |
.Fl a . |
.Fl c . |
|
.It Fl K Ns Ar encoding |
|
Specify the input encoding. |
|
The supported |
|
.Ar encoding |
|
arguments are |
|
.Cm us-ascii , |
|
.Cm iso-8859-1 , |
|
and |
|
.Cm utf-8 . |
|
If not specified, autodetection uses the first match: |
|
.Bl -tag -width iso-8859-1 |
|
.It Cm utf-8 |
|
if the first three bytes of the input file |
|
are the UTF-8 byte order mark (BOM, 0xefbbbf) |
|
.It Ar encoding |
|
if the first or second line of the input file matches the |
|
.Sy emacs |
|
mode line format |
|
.Pp |
|
.D1 .\e" -*- Oo ...; Oc coding: Ar encoding ; No -*- |
|
.It Cm utf-8 |
|
if the first non-ASCII byte in the file introduces a valid UTF-8 sequence |
|
.It Cm iso-8859-1 |
|
otherwise |
|
.El |
.It Fl k |
.It Fl k |
A synonym for |
A synonym for |
.Xr apropos 1 . |
.Xr apropos 1 . |
Line 233 This is the default. |
|
Line 259 This is the default. |
|
See |
See |
.Sx ASCII Output . |
.Sx ASCII Output . |
.It Fl T Ns Cm html |
.It Fl T Ns Cm html |
Produce strict CSS1/HTML-4.01 output. |
Produce HTML5, CSS1, and MathML output. |
See |
See |
.Sx HTML Output . |
.Sx HTML Output . |
.It Fl T Ns Cm lint |
.It Fl T Ns Cm lint |
Line 265 Encode output in the UTF\-8 multi-byte format. |
|
Line 291 Encode output in the UTF\-8 multi-byte format. |
|
See |
See |
.Sx UTF\-8 Output . |
.Sx UTF\-8 Output . |
.It Fl T Ns Cm xhtml |
.It Fl T Ns Cm xhtml |
Produce strict CSS1/XHTML-1.0 output. |
This is a synonym for |
See |
.Fl T Ns Cm html . |
.Sx XHTML Output . |
|
.El |
.El |
.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 |
Line 320 which will normalise to \(>=60. |
|
Line 345 which will normalise to \(>=60. |
|
.Ss HTML Output |
.Ss HTML Output |
Output produced by |
Output produced by |
.Fl T Ns Cm html |
.Fl T Ns Cm html |
conforms to HTML-4.01 strict. |
conforms to HTML5 using optional self-closing tags. |
|
Default styles use only CSS1. |
|
Equations rendered from |
|
.Xr eqn 7 |
|
blocks use MathML. |
.Pp |
.Pp |
The |
The |
.Pa example.style.css |
.Pa example.style.css |
Line 328 file documents style-sheet classes available for custo |
|
Line 357 file documents style-sheet classes available for custo |
|
If a style-sheet is not specified with |
If a style-sheet is not specified with |
.Fl O Ns Ar style , |
.Fl O Ns Ar style , |
.Fl T Ns Cm html |
.Fl T Ns Cm html |
defaults to simple output readable in any graphical or text-based web |
defaults to simple output (via an embedded style-sheet) |
|
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. |
|
|
arguments are accepted: |
arguments are accepted: |
.Bl -tag -width Ds |
.Bl -tag -width Ds |
.It Cm fragment |
.It Cm fragment |
Omit the |
Omit the <!DOCTYPE> declaration and the <html>, <head>, and <body> |
.Aq !DOCTYPE |
elements and only emit the subtree below the <body> element. |
declaration and the |
|
.Aq html , |
|
.Aq head , |
|
and |
|
.Aq body |
|
elements and only emit the subtree below the |
|
.Aq body |
|
element. |
|
The |
The |
.Cm style |
.Cm style |
argument will be ignored. |
argument will be ignored. |
Line 471 to force a UTF\-8 locale. |
|
Line 493 to force a UTF\-8 locale. |
|
See |
See |
.Sx Locale Output |
.Sx Locale Output |
for details and options. |
for details and options. |
.Ss XHTML Output |
|
Output produced by |
|
.Fl T Ns Cm xhtml |
|
conforms to XHTML-1.0 strict. |
|
.Pp |
|
See |
|
.Sx HTML Output |
|
for details; beyond generating XHTML tags instead of HTML tags, these |
|
output modes are identical. |
|
.Sh ENVIRONMENT |
.Sh ENVIRONMENT |
.Bl -tag -width MANPAGER |
.Bl -tag -width MANPAGER |
.It Ev MANPAGER |
.It Ev MANPAGER |
Line 916 The previous, interrupted macro is deleted from the pa |
|
Line 929 The previous, interrupted macro is deleted from the pa |
|
.Ss "Warnings related to missing arguments" |
.Ss "Warnings related to missing arguments" |
.Bl -ohang |
.Bl -ohang |
.It Sy "skipping empty request" |
.It Sy "skipping empty request" |
.Pq roff |
.Pq roff , eqn |
The macro name is missing from a macro definition request. |
The macro name is missing from a macro definition request, |
|
or an |
|
.Xr eqn 7 |
|
control statement or operation keyword lacks its required argument. |
.It Sy "conditional request controls empty scope" |
.It Sy "conditional request controls empty scope" |
.Pq roff |
.Pq roff |
A conditional request is only useful if any of the following |
A conditional request is only useful if any of the following |
|
|
utility assumes |
utility assumes |
.Fl std |
.Fl std |
even when it is not specified, but other implementations may not. |
even when it is not specified, but other implementations may not. |
|
.It Sy "missing eqn box, using \(dq\(dq" |
|
.Pq eqn |
|
A diacritic mark or a binary operator is found, |
|
but there is nothing to the left of it. |
|
An empty box is inserted. |
.El |
.El |
.Ss "Warnings related to bad macro arguments" |
.Ss "Warnings related to bad macro arguments" |
.Bl -ohang |
.Bl -ohang |
Line 1118 macro has an invalid argument. |
|
Line 1139 macro has an invalid argument. |
|
It is used verbatim, with |
It is used verbatim, with |
.Qq "AT&T UNIX " |
.Qq "AT&T UNIX " |
prefixed to it. |
prefixed to it. |
|
.It Sy "comma in function argument" |
|
.Pq mdoc |
|
An argument of an |
|
.Ic \&Fa |
|
or |
|
.Ic \&Fn |
|
macro contains a comma; it should probably be split into two arguments. |
|
.It Sy "parenthesis in function name" |
|
.Pq mdoc |
|
The first argument of an |
|
.Ic \&Fc |
|
or |
|
.Ic \&Fn |
|
macro contains an opening or closing parenthesis; that's probably wrong, |
|
parentheses are added automatically. |
.It Sy "invalid content in Rs block" |
.It Sy "invalid content in Rs block" |
.Pq mdoc |
.Pq mdoc |
An |
An |
|
|
The invalid argument is moved out of the macro, which leaves the macro |
The invalid argument is moved out of the macro, which leaves the macro |
empty, causing it to toggle the spacing mode. |
empty, causing it to toggle the spacing mode. |
.It Sy "unknown font, skipping request" |
.It Sy "unknown font, skipping request" |
.Pq man |
.Pq man , tbl |
A |
A |
.Xr roff 7 |
.Xr roff 7 |
.Ic \&ft |
.Ic \&ft |
request has an invalid argument. |
request or a |
|
.Xr tbl 7 |
|
.Ic \&f |
|
layout modifier has an unknown |
|
.Ar font |
|
argument. |
.El |
.El |
.Ss "Warnings related to plain text" |
.Ss "Warnings related to plain text" |
.Bl -ohang |
.Bl -ohang |
Line 1203 keeps the code more readable. |
|
Line 1244 keeps the code more readable. |
|
.It "equation scope open on exit" |
.It "equation scope open on exit" |
.It "overlapping equation scopes" |
.It "overlapping equation scopes" |
.It "unexpected end of equation" |
.It "unexpected end of equation" |
.It "equation syntax error" |
|
.El |
.El |
.Ss "Errors related to tables" |
.Ss "Errors related to tables" |
.Bl -inset -compact |
.Bl -inset -compact |
|
|
It may be mistyped or unsupported. |
It may be mistyped or unsupported. |
The request or macro is discarded including its arguments. |
The request or macro is discarded including its arguments. |
.It Sy "skipping item outside list" |
.It Sy "skipping item outside list" |
.Pq mdoc |
.Pq mdoc , eqn |
An |
An |
.Ic \&It |
.Ic \&It |
macro occurs outside any |
macro occurs outside any |
.Ic \&Bl |
.Ic \&Bl |
list. |
list, or an |
|
.Xr eqn 7 |
|
.Ic above |
|
delimiter occurs outside any pile. |
It is discarded including its arguments. |
It is discarded including its arguments. |
.It Sy "skipping column outside column list" |
.It Sy "skipping column outside column list" |
.Pq mdoc |
.Pq mdoc |
Line 1283 block closing macro, a |
|
Line 1326 block closing macro, a |
|
.Ic \&RE |
.Ic \&RE |
or |
or |
.Ic \&UE |
.Ic \&UE |
macro, or the end of an equation, table, or |
macro, an |
|
.Xr eqn 7 |
|
right delimiter or closing brace, or the end of an equation, table, or |
.Xr roff 7 |
.Xr roff 7 |
conditional request is encountered but no matching block is open. |
conditional request is encountered but no matching block is open. |
The offending request or macro is discarded. |
The offending request or macro is discarded. |
|
|
.Ic \&St |
.Ic \&St |
macro has an unknown argument and is discarded. |
macro has an unknown argument and is discarded. |
.It Sy "skipping request without numeric argument" |
.It Sy "skipping request without numeric argument" |
.Pq roff |
.Pq roff , eqn |
An |
An |
.Ic \&it |
.Ic \&it |
request has a non-numeric or negative argument or no argument at all. |
request or an |
The invalid request is ignored. |
.Xr eqn 7 |
|
.Ic \&size |
|
or |
|
.Ic \&gsize |
|
statement has a non-numeric or negative argument or no argument at all. |
|
The invalid request or statement is ignored. |
.It Sy "skipping all arguments" |
.It Sy "skipping all arguments" |
.Pq mdoc , man , eqn , roff |
.Pq mdoc , man , eqn , roff |
An |
An |
|
|
.Ic \&PP |
.Ic \&PP |
macro, an |
macro, an |
.Xr eqn 7 |
.Xr eqn 7 |
|
.Ic \&EQ |
|
or |
.Ic \&EN |
.Ic \&EN |
macro, or a |
macro, or a |
.Xr roff 7 |
.Xr roff 7 |
|
|
.It |
.It |
Words aren't hyphenated. |
Words aren't hyphenated. |
.El |
.El |
.Ss HTML/XHTML Compatibility |
.Ss HTML Compatibility |
.Bl -bullet -compact |
.Bl -bullet -compact |
.It |
.It |
The |
The |