Revert part of the previous diff to fix a regression (another endless loop)

[mandoc.git] / tbl.7

diff --git a/tbl.7 b/tbl.7
index e6575527825fdb1dca938aa4b642771a2a88078d..4ecc354c4ea357a467bd0fe883d256b09e847fb3 100644 (file)
--- a/tbl.7
+++ b/tbl.7
@@ -1,7 +1,7 @@
-.\"    $Id: tbl.7,v 1.32 2019/02/08 22:51:53 schwarze Exp $
+.\"    $Id: tbl.7,v 1.37 2021/09/18 12:34:27 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, 2018 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: February 8 2019 $
+.Dd $Mdocdate: September 18 2021 $

 .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.


@@ -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


@@ -394,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


@@ -416,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


@@ -438,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.