[groff] 02/02: tbl(1): Fix style nits.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit 4dde143683d239a323d67ced01999307ba6c0554
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Thu Apr 20 01:59:54 2023 -0500

    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.
---
 src/preproc/tbl/tbl.1.man | 54 ++++++++++++++++++++++++++++-------------------
 1 file 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,