From b9d96a737fcb953cd1360cf7056e2c39ae954c1a Mon Sep 17 00:00:00 2001
From: wl <wl>
Date: Fri, 5 Jan 2007 14:42:22 +0000
Subject: * src/preproc/tbl/tbl.man: Document .T#.

Revert last NEWS change.
---
 ChangeLog               |  2 +-
 NEWS                    |  6 ------
 src/preproc/tbl/tbl.man | 31 ++++++++++++++++++++++++++-----
 3 files changed, 27 insertions(+), 12 deletions(-)

diff --git a/ChangeLog b/ChangeLog
index eb7f5a6d..2bceddb1 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,6 +1,6 @@
 2006-01-05  Werner LEMBERG  <wl@gnu.org>
 
-	* src/preproc/tbl/tbl.man, NEWS: Document \n[TW].
+	* src/preproc/tbl/tbl.man: Document .T# and \n[TW].
 
 2006-01-04  Gaius Mulley  <gaius@glam.ac.uk>
 
diff --git a/NEWS b/NEWS
index 48db4b88..6f320aa5 100644
--- a/NEWS
+++ b/NEWS
@@ -82,12 +82,6 @@ o int(x) now really behaves as documented: It truncates the non-integer part
 o Pic now supports up to 32 macro arguments (and up to 16 on EBCDIC
   platforms).
 
-Tbl
----
-
-o The number register `TW' holds the width of the last table.  This GNU
-  extension isn't new but hasn't been documented before.
-
 Chem
 ----
 
diff --git a/src/preproc/tbl/tbl.man b/src/preproc/tbl/tbl.man
index f2f60e73..00ce84b7 100644
--- a/src/preproc/tbl/tbl.man
+++ b/src/preproc/tbl/tbl.man
@@ -411,6 +411,32 @@ the
 .B .TS
 request.
 .
+.LP
+The number register
+.B \[rs]n[TW]
+holds the table width; it can't be used within the table itself but is defined
+right before calling
+.B .TE
+so that this macro can make use of it.
+.
+.LP
+.B tbl
+also defines a macro
+.B .T#
+which produces the bottom and side lines of a boxed table.
+While
+.B tbl
+does call this macro itself at the end of the table, it can be used by
+macro packages to create boxes for multi-page tables by calling it within the
+page footer.
+An example of this is shown by the
+.B \-ms
+macros which provide this functionality if a table starts with
+.B .TS\ H
+instead of the standard call to the
+.B .TS
+macro.
+.
 .
 .SH "INTERACTION WITH @G@EQN"
 .BR @g@tbl (@MAN1EXT@)
@@ -444,11 +470,6 @@ When using
 you should avoid using any names beginning with a\~\c
 .BR 3 .
 .
-.LP
-The number register
-.B \[rs]n[TW]
-holds the table width of the previous table.
-.
 .
 .SH "GNU TBL WITHIN MACROS"
 Since
-- 
cgit v1.2.1