version 1.28, 2017/06/28 00:59:57 |
version 1.37, 2021/09/18 12:34:27 |
|
|
.\" $Id$ |
.\" $Id$ |
.\" |
.\" |
.\" Copyright (c) 2010, 2011 Kristaps Dzonsons <kristaps@bsd.lv> |
.\" Copyright (c) 2010, 2011 Kristaps Dzonsons <kristaps@bsd.lv> |
.\" Copyright (c) 2014, 2015, 2017 Ingo Schwarze <schwarze@openbsd.org> |
.\" Copyright (c) 2014,2015,2017,2018,2019 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 |
Line 94 Allow page breaks within the table. |
|
Line 94 Allow page breaks within the table. |
|
This is a GNU extension and currently ignored. |
This is a GNU extension and currently ignored. |
.It Cm nospaces |
.It Cm nospaces |
Ignore leading and trailing spaces in data cells. |
Ignore leading and trailing spaces in data cells. |
This is a GNU extension and currently ignored. |
This is a GNU extension. |
.It Cm nowarn |
.It Cm nowarn |
Suppress warnings about tables exceeding the current line length. |
Suppress warnings about tables exceeding the current line length. |
This is a GNU extension and currently ignored. |
This is a GNU extension and currently ignored. |
Line 147 The combined cell as a whole consumes only one cell |
|
Line 147 The combined cell as a whole consumes only one cell |
|
of the corresponding data line. |
of the corresponding data line. |
.It Cm a |
.It Cm a |
Left-justify a string and pad with one space. |
Left-justify a string and pad with one space. |
.It Cm ^ |
.It Cm \(ha |
Vertically span rows from the last |
Vertically span rows from the last |
.Pf non- Cm ^ |
.Pf non- Cm \(ha |
layout cell. |
layout cell. |
It is an error to invoke a vertical span on the first layout line. |
It is an error to invoke a vertical span on the first layout line. |
Unlike a horizontal span, a vertical span consumes a data cell |
Unlike a horizontal span, a vertical span consumes a data cell |
Line 178 of any other column also having the |
|
Line 178 of any other column also having the |
|
.Cm e |
.Cm e |
modifier. |
modifier. |
.It Cm f |
.It Cm f |
The next character selects the font to use for this cell. |
The next one or two characters select the font to use for this cell. |
|
One-character font names must be followed by a blank or period. |
See the |
See the |
.Xr roff 7 |
.Xr roff 7 |
manual for supported one-character font names. |
manual for supported font names. |
.It Cm i |
.It Cm i |
Use an italic font for the contents of this cell. |
Use an italic font for the contents of this cell. |
.It Cm m |
.It Cm m |
Line 231 Each data line consists of one or more data cells, del |
|
Line 232 Each data line consists of one or more data cells, del |
|
.Cm tab |
.Cm tab |
characters. |
characters. |
.Pp |
.Pp |
If a data cells contains only the single character |
If a data cell contains only the two bytes |
|
.Ql \e\(ha , |
|
the cell above spans to this row, as if the layout specification |
|
of this cell were |
|
.Cm \(ha . |
|
.Pp |
|
If a data cell contains only the single character |
.Ql _ |
.Ql _ |
or |
or |
.Ql = , |
.Ql = , |
a single or double horizontal line is drawn across the cell, |
a single or double horizontal line is drawn across the cell, |
joining its neighbours. |
joining its neighbours. |
If a data cells contains only the two character sequence |
If a data cell contains only the two character sequence |
.Ql \e_ |
.Ql \e_ |
or |
or |
.Ql \e= , |
.Ql \e= , |
|
|
AFL:2.39b |
AFL:2.39b |
Mutt:1.8.0 |
Mutt:1.8.0 |
Ruby:1.8.7.374 |
Ruby:1.8.7.374 |
TeX Live:2015 |
TeX Live:2015 |
.TE |
.TE |
.Ed |
.Ed |
.sp 2v |
.sp 2v |
Line 332 Spans and skipping width calculations: |
|
Line 339 Spans and skipping width calculations: |
|
\&.TS |
\&.TS |
box tab(:); |
box tab(:); |
lz s | rt |
lz s | rt |
lt| cb| ^ |
lt| cb| \(ha |
^ | rz s. |
\(ha | rz s. |
left:r |
left:r |
l:center: |
l:center: |
:right |
:right |
|
|
These examples were constructed to demonstrate many |
These examples were constructed to demonstrate many |
.Nm |
.Nm |
features in a compact way. |
features in a compact way. |
In real manual pages, keep tables as simple as possible: |
In real manual pages, keep tables as simple as possible. |
Like that, they usually look better, are less fragile, and more portable. |
They usually look better, are less fragile, and are more portable. |
.Sh COMPATIBILITY |
.Sh COMPATIBILITY |
The |
The |
.Xr mandoc 1 |
.Xr mandoc 1 |
Line 410 equations inside tables. |
|
Line 417 equations inside tables. |
|
.Xr roff 7 |
.Xr roff 7 |
.Rs |
.Rs |
.%A M. E. Lesk |
.%A M. E. Lesk |
.%T Tbl\(emA Program to Format Tables |
.%T Tbl \(em A Program to Format Tables |
.%D June 11, 1976 |
.%D June 11, 1976 |
.Re |
.Re |
.Sh HISTORY |
.Sh HISTORY |
Line 420 The GNU reimplementation of tbl, part of the groff pac |
|
Line 427 The GNU reimplementation of tbl, part of the groff pac |
|
in 1990 by James Clark. |
in 1990 by James Clark. |
A standalone tbl implementation was written by Kristaps Dzonsons in |
A standalone tbl implementation was written by Kristaps Dzonsons in |
2010. |
2010. |
This formed the basis of the implementation that is part of the |
This formed the basis of the implementation that first appeared in |
|
.Ox 4.9 |
|
as a part of the |
.Xr mandoc 1 |
.Xr mandoc 1 |
utility. |
utility. |
.Sh AUTHORS |
.Sh AUTHORS |
Line 430 reference was written by |
|
Line 439 reference was written by |
|
.An Kristaps Dzonsons Aq Mt kristaps@bsd.lv |
.An Kristaps Dzonsons Aq Mt kristaps@bsd.lv |
and |
and |
.An Ingo Schwarze Aq Mt schwarze@openbsd.org . |
.An Ingo Schwarze Aq Mt schwarze@openbsd.org . |
|
.Sh BUGS |
|
In |
|
.Fl T |
|
.Cm utf8 |
|
output mode, heavy lines are drawn instead of double lines. |
|
This cannot be improved because the Unicode standard only provides |
|
an incomplete set of box drawing characters with double lines, |
|
whereas it provides a full set of box drawing characters |
|
with heavy lines. |
|
It is unlikely this can be improved in the future because the box |
|
drawing characters are already marked in Unicode as characters |
|
intended only for backward compatibility with legacy systems, |
|
and their use is not encouraged. |
|
So it seems unlikely that the missing ones might get added in the future. |