groff
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

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


From: Brian Inglis
Subject: Re: groff 1.22.4 mandb 2.11.2 man -H tbl not rendered
Date: Wed, 22 Feb 2023 11:42:00 -0700
User-agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:102.0) Gecko/20100101 Thunderbird/102.8.0

Thanks Branden,

That and what you've changed already is much better than current, as it previously read as if global/region options could be specified after .T&.

Any chance you could eventually get the info docs to the same level?
I normally expect more and easier access to the info than the man pages for GNU packages, so start there first! ;^>

[And prefer "open" ePub, vs *proprietary* Adobe PS and PDF, as it's zipped html readable in browser addons, or vim or less(/open) if desperate. Get on it FSF!]

--
Take care. Thanks, Brian Inglis              Calgary, Alberta, Canada


On 2023-02-22 01:00, G. Branden Robinson wrote:
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



reply via email to

[Prev in Thread] Current Thread [Next in Thread]