version 1.2, 2011/01/05 09:31:10 |
version 1.5, 2011/01/08 17:00:27 |
|
|
.Em pre-processed , |
.Em pre-processed , |
that is, data rows are parsed then inserted into the underlying stream |
that is, data rows are parsed then inserted into the underlying stream |
of input data. |
of input data. |
This allows data rows to be interspersed by arbitrary |
This allows data rows to be interspersed by arbitrary |
.Xr roff 7 , |
.Xr roff 7 , |
.Xr mdoc 7 , |
.Xr mdoc 7 , |
and |
and |
Line 138 If the first line does not have a terminating semicolo |
|
Line 138 If the first line does not have a terminating semicolo |
|
that no options are specified and instead a |
that no options are specified and instead a |
.Sx Layout |
.Sx Layout |
is processed. |
is processed. |
Some options accept arguments enclosed by paranthesis. |
Some options accept arguments enclosed by parenthesis. |
The following case-insensitive options are available: |
The following case-insensitive options are available: |
.Bl -tag -width Ds |
.Bl -tag -width Ds |
.It Cm center |
.It Cm center |
Line 166 This option is not supported by |
|
Line 166 This option is not supported by |
|
.Xr mandoc 1 . |
.Xr mandoc 1 . |
.It Cm tab |
.It Cm tab |
Accepts a single-character argument. |
Accepts a single-character argument. |
This character is used a delimiter between data cells, which otherwise |
This character is used as a delimiter between data cells, which otherwise |
defaults to the tab character. |
defaults to the tab character. |
.It Cm linesize |
.It Cm linesize |
Accepts a natural number (all digits). |
Accepts a natural number (all digits). |
Line 231 Emit a vertical bar instead of data. |
|
Line 231 Emit a vertical bar instead of data. |
|
Emit a double-vertical bar instead of data. |
Emit a double-vertical bar instead of data. |
.El |
.El |
.Pp |
.Pp |
For example, following layout specifies a centre-justified column of |
|
minimum width 10, followed by vertical bar, followed by a left-justified |
|
column of minimum width 10, another vertical bar, then a column |
|
justified about the decimal point in numbers: |
|
.Pp |
|
.Dl c10 | l10 | n |
|
.Pp |
|
Keys may be followed by a set of modifiers. |
Keys may be followed by a set of modifiers. |
A modifier is either a modifier key or a natural number for specifying |
A modifier is either a modifier key or a natural number for specifying |
spacing. |
the minimum width of a column. |
The following case-insensitive modifier keys are available: |
The following case-insensitive modifier keys are available: |
.Cm z , |
.Cm z , |
.Cm u , |
.Cm u , |
|
|
.Cm i . |
.Cm i . |
All of these are ignored by |
All of these are ignored by |
.Xr mandoc 1 . |
.Xr mandoc 1 . |
|
.Pp |
|
For example, the following layout specifies a centre-justified column of |
|
minimum width 10, followed by vertical bar, followed by a left-justified |
|
column of minimum width 10, another vertical bar, then a column |
|
justified about the decimal point in numbers: |
|
.Pp |
|
.Dl c10 | l10 | n |
.Ss Data |
.Ss Data |
The data section follows the last layout row. |
The data section follows the last layout row. |
By default, cells in a data section are delimited by a tab. |
By default, cells in a data section are delimited by a tab. |
|
|
.Cm \e- |
.Cm \e- |
or |
or |
.Cm \e= |
.Cm \e= |
is specified, a line is drawn within the data field (i.e., terminating |
is specified, a line is drawn within the data field (i.e. terminating |
within the cell and not draw to the border). |
within the cell and not draw to the border). |
If the last cell of a line is |
If the last cell of a line is |
.Cm T{ , |
.Cm T{ , |
all subsequent lines are included as part of the cell until |
all subsequent lines are included as part of the cell until |
.Cm T} |
.Cm T} |
is specified on its own line. |
is specified as its own data cell. |
|
It may then be followed by a tab |
|
.Pq or as designated by Cm tab |
|
or an end-of-line to terminate the row. |
.Sh COMPATIBILITY |
.Sh COMPATIBILITY |
This section documents compatibility between mandoc and other |
This section documents compatibility between mandoc and other |
.Nm |
.Nm |
Line 293 implementation allows them. |
|
Line 296 implementation allows them. |
|
.El |
.El |
.Sh SEE ALSO |
.Sh SEE ALSO |
.Xr mandoc 1 , |
.Xr mandoc 1 , |
.Xr mandoc_char 7 , |
|
.Xr roff 7 , |
|
.Xr man 7 , |
.Xr man 7 , |
.Xr mdoc 7 |
.Xr mandoc_char 7 , |
|
.Xr mdoc 7 , |
|
.Xr roff 7 |
.Rs |
.Rs |
.%A M. E. Lesk |
.%A M. E. Lesk |
.%T Tbl\(emA Program to Format Tables |
.%T Tbl\(emA Program to Format Tables |