version 1.133, 2015/01/20 21:16:51 |
version 1.138, 2015/01/26 18:42:30 |
|
|
.Fl W Ns Cm warning |
.Fl W Ns Cm warning |
was specified. |
was specified. |
.It 4 |
.It 4 |
At least on unsupported feature was encountered, and |
At least one unsupported feature was encountered, and |
.Fl W Ns Cm unsupp , |
.Fl W Ns Cm unsupp , |
.Fl W Ns Cm error |
.Fl W Ns Cm error |
or |
or |
Line 1273 its value is implicitly set to the empty string. |
|
Line 1273 its value is implicitly set to the empty string. |
|
However, defining strings explicitly before use |
However, defining strings explicitly before use |
keeps the code more readable. |
keeps the code more readable. |
.El |
.El |
|
.Ss "Warnings related to tables" |
|
.Bl -ohang |
|
.It Sy "tbl line starts with span" |
|
.Pq tbl |
|
The first cell in a table layout line is a horizontal span |
|
.Pq Sq Cm s . |
|
Data provided for this cell is ignored, and nothing is printed in the cell. |
|
.It Sy "tbl column starts with span" |
|
.Pq tbl |
|
The first line of a table layout specification |
|
requests a vertical span |
|
.Pq Sq Cm ^ . |
|
Data provided for this cell is ignored, and nothing is printed in the cell. |
|
.It Sy "skipping vertical bar in tbl layout" |
|
.Pq tbl |
|
A table layout specification contains more than two consecutive vertical bars. |
|
A double bar is printed, all additional bars are discarded. |
|
.El |
.Ss "Errors related to equations" |
.Ss "Errors related to equations" |
.Bl -inset -compact |
.Bl -inset -compact |
.It "unexpected equation scope closure" |
.It "unexpected equation scope closure" |
Line 1281 keeps the code more readable. |
|
Line 1299 keeps the code more readable. |
|
.It "unexpected end of equation" |
.It "unexpected end of equation" |
.El |
.El |
.Ss "Errors related to tables" |
.Ss "Errors related to tables" |
|
.Bl -ohang |
|
.It Sy "non-alphabetic character in tbl options" |
|
.Pq tbl |
|
The table options line contains a character other than a letter, |
|
blank, or comma where the beginning of an option name is expected. |
|
The character is ignored. |
|
.It Sy "skipping unknown tbl option" |
|
.Pq tbl |
|
The table options line contains a string of letters that does not |
|
match any known option name. |
|
The word is ignored. |
|
.It Sy "missing tbl option argument" |
|
.Pq tbl |
|
A table option that requires an argument is not followed by an |
|
opening parenthesis, or the opening parenthesis is immediately |
|
followed by a closing parenthesis. |
|
The option is ignored. |
|
.It Sy "wrong tbl option argument size" |
|
.Pq tbl |
|
A table option argument contains an invalid number of characters. |
|
Both the option and the argument are ignored. |
|
.It Sy "empty tbl layout" |
|
.Pq tbl |
|
A table layout specification is completely empty, |
|
specifying zero lines and zero columns. |
|
As a fallback, a single left-justified column is used. |
|
.It Sy "invalid character in tbl layout" |
|
.Pq tbl |
|
A table layout specification contains a character that can neither |
|
be interpreted as a layout key character nor as a layout modifier, |
|
or a modifier precedes the first key. |
|
The invalid character is discarded. |
|
.It Sy "unmatched parenthesis in tbl layout" |
|
.Pq tbl |
|
A table layout specification contains an opening parenthesis, |
|
but no matching closing parenthesis. |
|
The rest of the input line, starting from the parenthesis, has no effect. |
|
.El |
|
.Pp |
.Bl -inset -compact |
.Bl -inset -compact |
.It "no table layout cells specified" |
.It Sy "no table data cells specified" |
.It "no table data cells specified" |
.It Sy "ignore data in cell" |
.It "ignore data in cell" |
.It Sy "data block still open" |
.It "data block still open" |
.It Sy "ignoring extra data cells" |
.It "ignoring extra data cells" |
|
.El |
.El |
.Ss "Errors related to roff, mdoc, and man code" |
.Ss "Errors related to roff, mdoc, and man code" |
.Bl -ohang |
.Bl -ohang |
Line 1369 right delimiter or closing brace, or the end of an equ |
|
Line 1425 right delimiter or closing brace, or the end of an equ |
|
.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. |
|
.It Sy "fewer RS blocks open, skipping" |
|
.Pq man |
|
The |
|
.Ic \&RE |
|
macro is invoked with an argument, but less than the specified number of |
|
.Ic \&RS |
|
blocks is open. |
|
The |
|
.Ic \&RE |
|
macro is discarded. |
.It Sy "inserting missing end of block" |
.It Sy "inserting missing end of block" |
.Pq mdoc , tbl |
.Pq mdoc , tbl |
Various |
Various |
|
|
block closing request is invoked with at least one argument. |
block closing request is invoked with at least one argument. |
All arguments are ignored. |
All arguments are ignored. |
.It Sy "skipping excess arguments" |
.It Sy "skipping excess arguments" |
.Pq mdoc , roff |
.Pq mdoc , man , roff |
The |
The |
.Ic \&Bf |
.Ic \&Bf |
macro is invoked with more than one argument, or a request of the |
macro is invoked with more than one argument, the |
|
.Ic \&RE |
|
macro is invoked with more than one argument |
|
or with a non-integer argument, or a request of the |
.Ic \&de |
.Ic \&de |
family is invoked with more than two arguments. |
family is invoked with more than two arguments. |
The excess arguments are ignored. |
The excess arguments are ignored. |
Line 1555 cannot handle input files larger than its arbitrary si |
|
Line 1624 cannot handle input files larger than its arbitrary si |
|
of 2^31 bytes (2 Gigabytes). |
of 2^31 bytes (2 Gigabytes). |
Since useful manuals are always small, this is not a problem in practice. |
Since useful manuals are always small, this is not a problem in practice. |
Parsing is aborted as soon as the condition is detected. |
Parsing is aborted as soon as the condition is detected. |
|
.It Sy "unsupported control character" |
|
.Pq roff |
|
An ASCII control character supported by other |
|
.Xr roff 7 |
|
implementations but not by |
|
.Nm |
|
was found in an input file. |
|
It is replaced by a question mark. |
.It Sy "unsupported roff request" |
.It Sy "unsupported roff request" |
.Pq roff |
.Pq roff |
An input file contains a |
An input file contains a |
Line 1563 request supported by GNU troff or Heirloom troff but n |
|
Line 1640 request supported by GNU troff or Heirloom troff but n |
|
.Nm , |
.Nm , |
and it is likely that this will cause information loss |
and it is likely that this will cause information loss |
or considerable misformatting. |
or considerable misformatting. |
.It Sy "bad table syntax" |
.It Sy "unsupported table layout modfier" |
.It Sy "bad table option" |
.Pq tbl |
.It Sy "bad table layout" |
A table layout specification contains an |
|
.Sq Cm m |
|
modifier. |
|
The modifier is discarded. |
.It Sy "ignoring macro in table" |
.It Sy "ignoring macro in table" |
|
.It Sy "eqn in tbl" |
|
.Pq eqn , tbl |
|
The options line of a table defines equation delimiters. |
|
Any equation source code contained in the table will be printed unformatted. |
.El |
.El |
.Sh COMPATIBILITY |
.Sh COMPATIBILITY |
This section summarises |
This section summarises |