summaryrefslogtreecommitdiff
path: root/src
diff options
context:
space:
mode:
authorG. Branden Robinson <g.branden.robinson@gmail.com>2023-04-20 01:59:54 -0500
committerG. Branden Robinson <g.branden.robinson@gmail.com>2023-04-20 03:39:55 -0500
commit4dde143683d239a323d67ced01999307ba6c0554 (patch)
tree0ec626c366846b703c831b477a8420f005d74313 /src
parent6ee42a18c31c2b61a6b63411ef7e621f418e6530 (diff)
downloadgroff-git-4dde143683d239a323d67ced01999307ba6c0554.tar.gz
tbl(1): Fix style nits.
* Kick mention of region option case-invariance down to "GNU tbl enhancements" subsection. * Discuss the content of column descriptors _before_ discussing how they're separated. * Arrange mentions of column modifier correspondence to *roff requests consistently, _after_ covering the syntax of those modifiers. * Clarify that tbl doesn't perform measurements itself; it constructs formatter instructions to do so. * Tighten wording. Also adjust dead-tree pagination.
Diffstat (limited to 'src')
-rw-r--r--src/preproc/tbl/tbl.1.man54
1 files changed, 32 insertions, 22 deletions
diff --git a/src/preproc/tbl/tbl.1.man b/src/preproc/tbl/tbl.1.man
index e13aef97b..65af50b1f 100644
--- a/src/preproc/tbl/tbl.1.man
+++ b/src/preproc/tbl/tbl.1.man
@@ -217,11 +217,7 @@ token may specify region options,
keywords that influence the interpretation or rendering of the region as
a whole or all table entries within it indiscriminately.
.
-They can be specified in any lettercase
-(unlike AT&T
-.IR tbl , \" AT&T
-which accepted only options with all characters in the same case)
-and must be separated by commas,
+They must be separated by commas,
spaces,
or tabs.
.
@@ -413,10 +409,20 @@ entries within it are to be typeset.
The format specification is a series of column
.I descriptors.
.
+Each descriptor encodes a
+.I classifier
+followed by zero or more
+.I modifiers.
+.
+Classifiers are letters
+(recognized case-insensitively)
+or punctuation symbols;
+modifiers consist of or begin with letters or numerals.
+.
Spaces,
tabs,
newlines,
-and commas are valid descriptor separators.
+and commas separate descriptors.
.
Newlines and commas are special;
they apply the descriptors following them to a subsequent row of the
@@ -437,11 +443,6 @@ only some modifiers,
described below,
make separation necessary.
.
-Column classifiers are letters or punctuation symbols,
-whereas modifiers consist of or begin with letters or numerals.
-.
-Letters are recognized case-insensitively.
-.
.
.P
Each column descriptor begins with a mandatory
@@ -847,11 +848,6 @@ This modifier must be followed by an
.RI integer\~ n
with an optional leading sign.
.
-(The parameter corresponds to that accepted by the
-.I troff \" generic
-.B ps
-request.)
-.
If unsigned,
the type size is set to
.IR n \~scaled
@@ -864,6 +860,11 @@ points.
.
The use of a signed multi-digit number is a GNU extension.
.
+(The parameter corresponds to that accepted by the
+.I troff \" generic
+.B ps
+request.)
+.
If a type size modifier is followed by a column separation modifier
(see below),
they must be separated by at least one space or tab.
@@ -890,11 +891,6 @@ This is a GNU extension.
.BR v ,\~ V
Set the vertical spacing to be used in a text block.
.
-(This parameter corresponds to that accepted by the
-.I troff \" generic
-.B vs
-request.)
-.
This modifier must be followed by an
.RI integer\~ n
with an optional leading sign.
@@ -909,6 +905,11 @@ the vertical spacing is incremented or decremented per the sign by
.
The use of a signed multi-digit number is a GNU extension.
.
+(This parameter corresponds to that accepted by the
+.I troff \" generic
+.B vs
+request.)
+.
If a vertical spacing modifier is followed by a column separation
modifier
(see below),
@@ -1037,7 +1038,8 @@ adjusted,
or populated with additional inter-sentence space.
.
.I @g@tbl
-measures each table entry as it occurs in the input,
+instructs the formatter to measure each table entry as it occurs in the
+input,
updating the width required by its corresponding column.
.
If the
@@ -1396,6 +1398,10 @@ removes constraints endured by users of AT&T
.
.
.IP \[bu] 2n
+Region options can be specified in any lettercase.
+.
+.
+.IP \[bu]
There is no limit on the number of columns in a table,
regardless of their classification,
nor any limit on the number of text blocks.
@@ -1498,6 +1504,8 @@ and restoring its value at a convenient location after applicable
arithmetic.
.
.
+.br
+.ne 5v
.\" ====================================================================
.SH Options
.\" ====================================================================
@@ -1820,6 +1828,8 @@ Total;\[ti]24.4
.RE
.
.
+.br
+.ne 12v
.P
Next,
we'll lightly adapt a compact presentation of spanning,