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) 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
@@ -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.
 .\"
-.Dd $Mdocdate: June 28 2017 $
+.Dd $Mdocdate: January 12 2022 $
 .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.
+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.
@@ -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.
-.It Cm ^
+.It Cm \(ha
 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
@@ -178,10 +178,11 @@ of any other column also having the
 .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
-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
@@ -231,13 +232,19 @@ Each data line consists of one or more data cells, delimited by
 .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.
-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= ,
@@ -323,7 +330,7 @@ _
 AFL:2.39b
 Mutt:1.8.0
 Ruby:1.8.7.374
-TeX Live:2015 
+TeX Live:2015
 .TE
 .Ed
 .sp 2v
@@ -332,8 +339,8 @@ Spans and skipping width calculations:
 \&.TS
 box tab(:);
 lz  s | rt
-lt| cb| ^
-^ | rz  s.
+lt| cb| \(ha
+\(ha | rz  s.
 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
-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
@@ -388,8 +395,8 @@ T}::line 5
 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
@@ -410,7 +417,7 @@ equations inside tables.
 .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
@@ -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.
-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
@@ -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 .
+.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.