[groff] 07/18: [tbl]: Fix incorrect claim regarding `#T`.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit ab440acc307fa5cf5e0df7c6abc517933ac45a05
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Tue Jan 2 17:48:48 2024 -0600

    [tbl]: Fix incorrect claim regarding `#T`.
    
    Observe:
    
      $ printf 'Top of page.\n.sp 1i\n.TS\nL.\nHello, world. \
      #T=\\n(#T\n.TE\n.sp\n#T=\\n(#T\n' | DWBHOME=. ./bin/tbl \
      | DWBHOME=. ./bin/troff -a
      Top of page.
    
      Hello, world. #T=-1
    
      #T=-1
---
 ChangeLog                 |  5 +++++
 src/preproc/tbl/tbl.1.man | 10 ++++++++--
 2 files changed, 13 insertions(+), 2 deletions(-)

diff --git a/ChangeLog b/ChangeLog
index 5c73b70f1..a11dab7d1 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,8 @@
+2024-01-02  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+       * src/preproc/tbl/tbl.1.man (roff interface): Fix incorrect
+       claim regarding `#T` register.
+
 2024-01-02  G. Branden Robinson <g.branden.robinson@gmail.com>
 
        [man,mdoc]: Increase default line length to 80n on terminals.
diff --git a/src/preproc/tbl/tbl.1.man b/src/preproc/tbl/tbl.1.man
index 6502fbf16..2e9c9a4cd 100644
--- a/src/preproc/tbl/tbl.1.man
+++ b/src/preproc/tbl/tbl.1.man
@@ -1337,9 +1337,15 @@ can make use of it.
 is a Boolean-valued register indicating whether the bottom of the table
 is being processed.
 .
-The
+A
 .B #T
-register marks the top of the table.
+register
+is used internally.
+.\" marks the top of the table.
+.\" XXX: That claim, from Lesk 1979, is not true of DWB tbl/nroff nor
+.\" Heirloom Doctools tbl/nroff.  GNU tbl appears to use it to mark the
+.\" top of a diverted table row when it's too tall to fit before the
+.\" next vertical trap.
 .
 Avoid using these names for any other purpose.
 .