mandoc/tbl.7 - diff

Return to tbl.7 CVS log

Up to [cvsweb.bsd.lv] / mandoc

Diff for /mandoc/tbl.7 between version 1.20 and 1.23

version 1.20, 2014/10/14 02:16:06

version 1.23, 2015/01/26 13:03:48

Line 1

.\" $Id$

.\"

.\" Permission to use, copy, modify, and distribute this software for any

.\" purpose with or without fee is hereby granted, provided that the above

Line 50 macro tags, whose precise syntax is documented in

Tables consist of a series of options on a single line, followed by the

table layout, followed by data.

.Pp

For example, the following creates a boxed table with digits centred in

For example, the following creates a boxed table with digits centered in

the cells.

.Bd -literal -offset indent

\&.TS

Line 133 c c c.

in the case of

.Xr man 7 .

.Ss Options

The first line of a table consists of space-separated option keys and

The first line of a table may contain options separated by spaces, tabs,

modifiers terminated by a semicolon.

or commas and terminated by a semicolon.

If the first line does not have a terminating semicolon, it is assumed

that no options are specified and instead a

.Sx Layout

is processed.

Some options accept arguments enclosed by parenthesis.

Some options require arguments enclosed by parentheses.

The following case-insensitive options are available:

.Bl -tag -width Ds

.It Cm center

.It Cm allbox

This option is not supported by

Draw a single-line box around each table cell.

.Xr mandoc 1 .

Currently treated as a synonym for

This may also be invoked with

.Cm box .

.Cm centre .

.It Cm delim

Accepts a two-character argument.

This option is not supported by

.Xr mandoc 1 .

.It Cm expand

This option is not supported by

.Xr mandoc 1 .

.It Cm box

Draw a single-line box around the table.

This may also be invoked with

For GNU compatibility, this may also be invoked with

.Cm frame .

.It Cm center

Center the table instead of left-adjusting it.

Currently ignored.

For GNU compatibility, this may also be invoked with

.Cm centre .

.It Cm decimalpoint

Use the single-character argument as the decimal point with the

.Cm n

layout key.

This is a GNU extension.

.It Cm delim

Use the two characters of the argument as

.Xr eqn 7

delimiters.

Currently unsupported.

.It Cm doublebox

Draw a double-line box around the table.

This may also be invoked with

For GNU compatibility, this may also be invoked with

.Cm doubleframe .

.It Cm allbox

.It Cm expand

This option is not supported by

Increase the width of the table to the current line length.

.Xr mandoc 1 .

Currently ignored.

.It Cm tab

Accepts a single-character argument.

This character is used as a delimiter between data cells, which otherwise

defaults to the tab character.

.It Cm linesize

Accepts a natural number (all digits).

Draw lines with the point size given by the unsigned integer argument.

This option is not supported by

Currently ignored.

.Xr mandoc 1 .

.It Cm nokeep

This option is not supported by

Allow page breaks within the table.

.Xr mandoc 1 .

This is a GNU extension and currently ignored.

.It Cm decimalpoint

Accepts a single-character argument.

This character will be used as the decimal point with the

.Cm n

layout key.

.It Cm nospaces

This option is not supported by

Ignore leading and trailing spaces in data cells.

.Xr mandoc 1 .

This is a GNU extension and currently ignored.

.It Cm nowarn

Suppress warnings about tables exceeding the current line length.

This is a GNU extension and currently ignored.

.It Cm tab

Use the single-character argument as a delimiter between data cells.

By default, the tab character is used.

.El

.Ss Layout

The table layout follows

Line 198 Layout lines may also be separated by a comma.

Line 201 Layout lines may also be separated by a comma.

Each layout cell consists of one of the following case-insensitive keys:

.Bl -tag -width 2n

.It Cm c

Centre a literal string within its column.

Center a literal string within its column.

.It Cm r

Right-justify a literal string within its column.

.It Cm l

Line 278 and

Line 281 and

are ignored by

.Xr mandoc 1 .

.Pp

For example, the following layout specifies a centre-justified column of

For example, the following layout specifies a center-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 using

bold font justified about the decimal point in numbers:

CVSweb