version 1.137, 2015/01/26 13:03:48 |
version 1.139, 2015/01/28 17:32:07 |
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 1302 The option is ignored. |
|
Line 1320 The option is ignored. |
|
.Pq tbl |
.Pq tbl |
A table option argument contains an invalid number of characters. |
A table option argument contains an invalid number of characters. |
Both the option and the argument are ignored. |
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. |
|
.It Sy "tbl without any data cells" |
|
.Pq tbl |
|
A table does not contain any data cells. |
|
It will probably produce no output. |
|
.It Sy "ignoring data in spanned tbl cell" |
|
.Pq tbl |
|
A table cell is marked as a horizontal span |
|
.Pq Sq Cm s |
|
or vertical span |
|
.Pq Sq Cm ^ |
|
in the table layout, but it contains data. |
|
The data is ignored. |
|
.It Sy "ignoring extra tbl data cells" |
|
.Pq tbl |
|
A data line contains more cells than the corresponding layout line. |
|
The data in the extra cells is ignored. |
|
.It Sy "data block open at end of tbl" |
|
.Pq tbl |
|
A data block is opened with |
|
.Cm T{ , |
|
but never closed with a matching |
|
.Cm T} . |
|
The remaining data lines of the table are all put into one cell, |
|
and any remaining cells stay empty. |
.El |
.El |
.Pp |
|
.Bl -inset -compact |
|
.It Sy "no table layout cells specified" |
|
.It Sy "no table data cells specified" |
|
.It Sy "ignore data in cell" |
|
.It Sy "data block still open" |
|
.It Sy "ignoring extra data cells" |
|
.El |
|
.Ss "Errors related to roff, mdoc, and man code" |
.Ss "Errors related to roff, mdoc, and man code" |
.Bl -ohang |
.Bl -ohang |
.It Sy "input stack limit exceeded, infinite loop?" |
.It Sy "input stack limit exceeded, infinite loop?" |
Line 1607 request supported by GNU troff or Heirloom troff but n |
|
Line 1657 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 "unsupported table layout" |
.It Sy "eqn delim option in tbl" |
.It Sy "ignoring macro in table" |
|
.It Sy "eqn in tbl" |
|
.Pq eqn , tbl |
.Pq eqn , tbl |
The options line of a table defines equation delimiters. |
The options line of a table defines equation delimiters. |
Any equation source code contained in the table will be printed unformatted. |
Any equation source code contained in the table will be printed unformatted. |
|
.It Sy "unsupported table layout modifier" |
|
.Pq tbl |
|
A table layout specification contains an |
|
.Sq Cm m |
|
modifier. |
|
The modifier is discarded. |
|
.It Sy "ignoring macro in table" |
|
.Pq tbl , mdoc , man |
|
A table contains an invocation of an |
|
.Xr mdoc 7 |
|
or |
|
.Xr man 7 |
|
macro or of an undefined macro. |
|
The macro is ignored, and its arguments are handled |
|
as if they were a text line. |
.El |
.El |
.Sh COMPATIBILITY |
.Sh COMPATIBILITY |
This section summarises |
This section summarises |