version 1.15, 2011/09/02 19:37:35 |
version 1.21, 2014/11/26 17:51:55 |
|
|
.\" $Id$ |
.\" $Id$ |
.\" |
.\" |
.\" Copyright (c) 2010, 2011 Kristaps Dzonsons <kristaps@bsd.lv> |
.\" Copyright (c) 2010, 2011 Kristaps Dzonsons <kristaps@bsd.lv> |
|
.\" Copyright (c) 2014 Ingo Schwarze <schwarze@openbsd.org> |
.\" |
.\" |
.\" Permission to use, copy, modify, and distribute this software for any |
.\" Permission to use, copy, modify, and distribute this software for any |
.\" purpose with or without fee is hereby granted, provided that the above |
.\" purpose with or without fee is hereby granted, provided that the above |
|
|
4:5:6 |
4:5:6 |
.TE |
.TE |
.Ed |
.Ed |
.Pp |
|
The |
|
.Nm |
|
implementation in |
|
.Xr mandoc 1 |
|
is |
|
.Ud |
|
.Sh TABLE STRUCTURE |
.Sh TABLE STRUCTURE |
Tables are enclosed by the |
Tables are enclosed by the |
.Sq TS |
.Sq TS |
|
|
.Ss Options |
.Ss Options |
The first line of a table consists of space-separated option keys and |
The first line of a table consists of space-separated option keys and |
modifiers terminated by a semicolon. |
modifiers terminated by a semicolon. |
|
For GNU compatibility, option keys can also be separated by commas. |
If the first line does not have a terminating semicolon, it is assumed |
If the first line does not have a terminating semicolon, it is assumed |
that no options are specified and instead a |
that no options are specified and instead a |
.Sx Layout |
.Sx Layout |
Line 202 Each layout line corresponds to a line of data; the la |
|
Line 197 Each layout line corresponds to a line of data; the la |
|
applies to all remaining data lines. |
applies to all remaining data lines. |
Layout lines may also be separated by a comma. |
Layout lines may also be separated by a comma. |
Each layout cell consists of one of the following case-insensitive keys: |
Each layout cell consists of one of the following case-insensitive keys: |
.Bl -tag -width Ds |
.Bl -tag -width 2n |
.It Cm c |
.It Cm c |
Centre a literal string within its column. |
Centre a literal string within its column. |
.It Cm r |
.It Cm r |
Line 251 Keys may be followed by a set of modifiers. |
|
Line 246 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 |
the minimum width of a column. |
the minimum width of a column. |
The following case-insensitive modifier keys are available: |
The following case-insensitive modifier keys are available: |
.Cm z , |
.Bl -tag -width 2n |
.Cm u , |
.It Cm b |
.Cm e , |
Use a bold font for the contents of this column. |
.Cm t , |
.It Cm e |
|
Make this column wider to match the maximum width |
|
of any other column also having the |
|
.Cm e |
|
modifier. |
|
.It Cm f |
|
The next character selects the font to use for this column. |
|
See the |
|
.Xr roff 7 |
|
manual for supported one-character font names. |
|
.It Cm i |
|
Use an italic font for the contents of this column. |
|
.It Cm x |
|
After determining the width of all other columns, distribute the |
|
rest of the line length among all columns having the |
|
.Cm x |
|
modifier. |
|
.It Cm z |
|
Do not use this cell for determining the width of this column. |
|
.El |
|
.Pp |
|
The modifiers |
.Cm d , |
.Cm d , |
.Cm f , |
.Cm t , |
.Cm b , |
.Cm u , |
.Cm i , |
|
.Cm b , |
|
and |
and |
.Cm i . |
.Cm w |
All of these are ignored by |
are ignored by |
.Xr mandoc 1 . |
.Xr mandoc 1 . |
.Pp |
.Pp |
For example, the following layout specifies a centre-justified column of |
For example, the following layout specifies a centre-justified column of |
minimum width 10, followed by vertical bar, followed by a left-justified |
minimum width 10, followed by vertical bar, followed by a left-justified |
column of minimum width 10, another vertical bar, then a column |
column of minimum width 10, another vertical bar, then a column using |
justified about the decimal point in numbers: |
bold font justified about the decimal point in numbers: |
.Pp |
.Pp |
.Dl c10 | l10 | n |
.Dl c10 | l10 | nfB |
.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. |
|
|
This |
This |
.Nm |
.Nm |
reference was written by |
reference was written by |
.An Kristaps Dzonsons , |
.An Kristaps Dzonsons Aq Mt kristaps@bsd.lv . |
.Mt kristaps@bsd.lv . |
|