Re: groff 1.22.4 mandb 2.11.2 man -H tbl not rendered

[G. Branden Robinson]

Hello again Brian,

At 2023-02-22T01:12:31-0600, G. Branden Robinson wrote:
> Ah, I understand you now.  Yes.  A "table continuation" (`.T&`) isn't
> treated in most (any?) respects like a separate table by tbl(1).
[...]
> I'll have a look at the caveats regarding multi-page boxed or
> column-heading-requiring tables and see if they need to say "table
> region" instead of "table" in some places.

I think you've identified an ambiguity in my writing and/or thinking.  I
have the following change in my working copy.  Does this read more
clearly?

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

Regards,
Branden

signature.asc
Description: PGP signature