summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--ChangeLog4
-rw-r--r--src/preproc/tbl/tbl.man45
2 files changed, 49 insertions, 0 deletions
diff --git a/ChangeLog b/ChangeLog
index 0bf6e5da..bd203257 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,7 @@
+2008-08-20 Werner LEMBERG <wl@gnu.org>
+
+ * src/preproc/tbl/tbl.man: Document computation of element widths.
+
2008-08-20 Alexey Gladkov <legion@altlinux.ru>
Werner LEMBERG <wl@gnu.org>
diff --git a/src/preproc/tbl/tbl.man b/src/preproc/tbl/tbl.man
index 71610bf1..bd904a66 100644
--- a/src/preproc/tbl/tbl.man
+++ b/src/preproc/tbl/tbl.man
@@ -362,6 +362,51 @@ Long input lines can be broken across multiple lines if the last character
on the line is `\[rs]' (which vanishes after concatenation).
.
.LP
+Note that
+.B @g@tbl
+computes the column widths line by line, applying \[rs]w on each entry.
+As a consequence, constructions like
+.IP
+.B .TS
+.br
+.B c,l.
+.br
+.B \[rs]s[20]MM
+.br
+.B MMMM
+.br
+.B .TE
+.br
+.
+.LP
+fail; you must either say
+.IP
+.B .TS
+.br
+.B cp20,lp20.
+.br
+.B MM
+.br
+.B MMMM
+.br
+.B .TE
+.br
+.
+.LP
+or
+.IP
+.B .TS
+.br
+.B c,l.
+.br
+.B \[rs]s[20]MM
+.br
+.B \[rs]s[20]MMMM
+.br
+.B .TE
+.br
+.
+.LP
A dot starting a line, followed by anything but a digit is handled as a
troff command, passed through without changes.
The table position is unchanged in this case.