[groff] 13/23: tbl(1): Clarify behavior of `.T&`.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit e0674a9e54f4eef8eabde5a4871ad6433299881a
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Wed Feb 22 02:01:27 2023 -0600

    tbl(1): Clarify behavior of `.T&`.
    
    Thanks to Brian Inglis for raising an ambiguity in the previous
    language.
---
 src/preproc/tbl/tbl.1.man | 10 +++++++++-
 1 file changed, 9 insertions(+), 1 deletion(-)

diff --git a/src/preproc/tbl/tbl.1.man b/src/preproc/tbl/tbl.1.man
index 6fd06d634..15a3c7638 100644
--- a/src/preproc/tbl/tbl.1.man
+++ b/src/preproc/tbl/tbl.1.man
@@ -146,13 +146,21 @@ and
 .
 Each such
 .I table region
-encloses one or more tables.
+encloses one or more table descriptions.
 .
 Within a table region,
 table descriptions beyond the first must each be preceded
 by an input line beginning with
 .BR .T& .
 .
+This mechanism does not start a new table region;
+all table descriptions are treated as part of their
+.BR .TS / .TE
+enclosure,
+even if they are boxed or have column headings that repeat on subsequent
+pages
+(see below).
+.
 .
 .P
 (Experienced