Tedu support for the -xsh4.2 argument to the mdoc(7) .St macro

[mandoc.git] / tbl.7

diff --git a/tbl.7 b/tbl.7
index e2f84538370b042d436d1a08b9db7df0eaf16003..44b6fbafaaa6c9d51de9ad877e7f81285d4bd99c 100644 (file)
--- a/tbl.7
+++ b/tbl.7
@@ -1,7 +1,7 @@
-.\"    $Id: tbl.7,v 1.28 2017/06/28 00:59:57 schwarze Exp $
+.\" $Id: tbl.7,v 1.38 2022/01/12 04:14:25 schwarze Exp $

 .\"
 .\" 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
 .\" purpose with or without fee is hereby granted, provided that the above
 .\"
 .\" Permission to use, copy, modify, and distribute this software for any
 .\" purpose with or without fee is hereby granted, provided that the above


@@ -15,7 +15,7 @@
 .\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
 .\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
 .\"
 .\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
 .\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
 .\"

-.Dd $Mdocdate: June 28 2017 $
+.Dd $Mdocdate: January 12 2022 $

 .Dt TBL 7
 .Os
 .Sh NAME
 .Dt TBL 7
 .Os
 .Sh NAME


@@ -94,7 +94,7 @@ Allow page breaks within the table.
 This is a GNU extension and currently ignored.
 .It Cm nospaces
 Ignore leading and trailing spaces in data cells.
 This is a GNU extension and currently ignored.
 .It Cm nospaces
 Ignore leading and trailing spaces in data cells.

-This is a GNU extension and currently ignored.
+This is a GNU extension.

 .It Cm nowarn
 Suppress warnings about tables exceeding the current line length.
 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.


@@ -147,9 +147,9 @@ The combined cell as a whole consumes only one cell
 of the corresponding data line.
 .It Cm a
 Left-justify a string and pad with one space.
 of the corresponding data line.
 .It Cm a
 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.
 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
 layout cell.
 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


@@ -178,10 +178,11 @@ of any other column also having the
 .Cm e
 modifier.
 .It Cm f
 .Cm e
 modifier.
 .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
 .Xr roff 7
 See the
 .Xr roff 7

-manual for supported one-character font names.
+manual for supported font names.

 .It Cm i
 Use an italic font for the contents of this cell.
 .It Cm m
 .It Cm i
 Use an italic font for the contents of this cell.
 .It Cm m


@@ -231,13 +232,19 @@ Each data line consists of one or more data cells, delimited by
 .Cm tab
 characters.
 .Pp
 .Cm tab
 characters.
 .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 _
 or
 .Ql = ,
 a single or double horizontal line is drawn across the cell,
 joining its neighbours.
 .Ql _
 or
 .Ql = ,
 a single or double horizontal line is drawn across the cell,
 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_
 or
 .Ql \e= ,
 .Ql \e_
 or
 .Ql \e= ,


@@ -323,7 +330,7 @@ _
 AFL:2.39b
 Mutt:1.8.0
 Ruby:1.8.7.374
 AFL:2.39b
 Mutt:1.8.0
 Ruby:1.8.7.374

-TeX Live:2015 
+TeX Live:2015

 .TE
 .Ed
 .sp 2v
 .TE
 .Ed
 .sp 2v


@@ -332,8 +339,8 @@ Spans and skipping width calculations:
 \&.TS
 box tab(:);
 lz  s | rt
 \&.TS
 box tab(:);
 lz  s | rt

-lt| cb| ^
-^ | rz  s.
+lt| cb| \(ha
+\(ha | rz  s.

 left:r
 l:center:
 :right
 left:r
 l:center:
 :right


@@ -360,7 +367,7 @@ allbox tab(:);
 le le||7 lw10.
 The fourth line:_:line 1
 of this column:=:line 2
 le le||7 lw10.
 The fourth line:_:line 1
 of this column:=:line 2

-determines:\_:line 3
+determines:\e_:line 3

 the column width.:T{
 This text is too wide to fit into a column of width 17.
 T}:line 4
 the column width.:T{
 This text is too wide to fit into a column of width 17.
 T}:line 4


@@ -388,8 +395,8 @@ T}::line 5
 These examples were constructed to demonstrate many
 .Nm
 features in a compact way.
 These examples were constructed to demonstrate many
 .Nm
 features in a compact way.

-In real manual pages, keep tables as simple as possible:
-Like that, they usually look better, are less fragile, and more portable.
+In real manual pages, keep tables as simple as possible.
+They usually look better, are less fragile, and are more portable.

 .Sh COMPATIBILITY
 The
 .Xr mandoc 1
 .Sh COMPATIBILITY
 The
 .Xr mandoc 1


@@ -410,7 +417,7 @@ equations inside tables.
 .Xr roff 7
 .Rs
 .%A M. E. Lesk
 .Xr roff 7
 .Rs
 .%A M. E. Lesk

-.%T Tbl\(emA Program to Format Tables
+.%T Tbl \(em A Program to Format Tables

 .%D June 11, 1976
 .Re
 .Sh HISTORY
 .%D June 11, 1976
 .Re
 .Sh HISTORY


@@ -420,7 +427,9 @@ The GNU reimplementation of tbl, part of the groff package, was released
 in 1990 by James Clark.
 A standalone tbl implementation was written by Kristaps Dzonsons in
 2010.
 in 1990 by James Clark.
 A standalone tbl implementation was written by Kristaps Dzonsons in
 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
 utility.
 .Sh AUTHORS
 .Xr mandoc 1
 utility.
 .Sh AUTHORS


@@ -430,3 +439,17 @@ reference was written by
 .An Kristaps Dzonsons Aq Mt kristaps@bsd.lv
 and
 .An Ingo Schwarze Aq Mt schwarze@openbsd.org .
 .An Kristaps Dzonsons Aq Mt kristaps@bsd.lv
 and
 .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.