diff options
author | G. Branden Robinson <g.branden.robinson@gmail.com> | 2023-04-20 01:59:54 -0500 |
---|---|---|
committer | G. Branden Robinson <g.branden.robinson@gmail.com> | 2023-04-20 03:39:55 -0500 |
commit | 4dde143683d239a323d67ced01999307ba6c0554 (patch) | |
tree | 0ec626c366846b703c831b477a8420f005d74313 /src | |
parent | 6ee42a18c31c2b61a6b63411ef7e621f418e6530 (diff) | |
download | groff-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.man | 54 |
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, |