[groff] 15/24: src/preproc/*/*.man: Fix style and markup nits.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit f601012c6091aadae8ce17df82ac503fae87725a
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Thu Aug 17 03:01:21 2023 -0500

    src/preproc/*/*.man: Fix style and markup nits.
    
    This is mainly recovery of good pagination after addition of the `BP`
    and `TS` registers, with their new defaults, altered page layouts.
    
    * Use active voice more.
    * Tighten wording.
    * Add or adjust poor man's keeps.
    * Don't set examples in bold when they illustrate only input.
    * Annotate manually computed tagged paragraph indentations.
---
 src/preproc/preconv/preconv.1.man |  4 +++-
 src/preproc/refer/refer.1.man     | 27 ++++++++++++---------------
 src/preproc/tbl/tbl.1.man         |  9 +++++----
 3 files changed, 20 insertions(+), 20 deletions(-)

diff --git a/src/preproc/preconv/preconv.1.man 
b/src/preproc/preconv/preconv.1.man
index 35b73323f..55ea8f58a 100644
--- a/src/preproc/preconv/preconv.1.man
+++ b/src/preproc/preconv/preconv.1.man
@@ -256,7 +256,9 @@ This notation appears in specially marked regions of an 
input file
 designated for \[lq]file-local variables\[rq].
 .
 .
-.PP
+.br
+.ne 4v
+.P
 .I preconv
 interprets the following syntax if it occurs in a
 .I roff
diff --git a/src/preproc/refer/refer.1.man b/src/preproc/refer/refer.1.man
index 8f294baff..49b12c1dc 100644
--- a/src/preproc/refer/refer.1.man
+++ b/src/preproc/refer/refer.1.man
@@ -629,13 +629,12 @@ line and a warning will be given.
 There is no special notation for making a citation to multiple
 references.
 .
-Just use a sequence of citations,
-one for each reference.
+Use a sequence of citations,
+one for each reference,
+with nothing between them.
 .
-Don't put anything between the citations.
-.
-The labels for all the citations will be attached to the line preceding
-the first citation.
+.I @g@refer
+will attach all of their labels to the line preceding the first.
 .
 The labels may also be sorted or merged.
 .
@@ -669,7 +668,7 @@ or the second citation's
 .I closing-text
 is non-empty.
 .
-(If you wish to prevent this,
+(To prevent this,
 use the dummy character escape sequence
 .B \[rs]&
 as the first citation's
@@ -978,7 +977,7 @@ For example,
 .RS \" RS twice to get inboard of the tagged paragraph indentation.
 .RS
 .EX
-.B date\-as\-label D.+yD.y%a*D.\-y
+date\-as\-label D.+yD.y%a*D.\-y
 .EE
 .RE
 .
@@ -1051,7 +1050,7 @@ The default behavior is as follows.
 .RS \" RS twice to get inboard of the tagged paragraph indentation.
 .RS
 .EX
-.B et\-al \[dq] et al\[dq] 2 3
+et\-al " et al" 2 3
 .EE
 .RE
 .
@@ -1169,11 +1168,9 @@ Reverse the fields whose names
 are in
 .IR string .
 .
-Each field name can be followed by a number which says how many such
-fields should be reversed.
-.
-If no number is given for a field,
-all such fields will be reversed.
+An optional integer after a field name limits the number of such fields
+to the given count;
+no integer means no limit.
 .
 .
 .TP
@@ -1673,7 +1670,7 @@ macro.
 .
 .
 .br
-.ne 4v
+.ne 5v
 .\" ====================================================================
 .SH Options
 .\" ====================================================================
diff --git a/src/preproc/tbl/tbl.1.man b/src/preproc/tbl/tbl.1.man
index b030fc020..691211fef 100644
--- a/src/preproc/tbl/tbl.1.man
+++ b/src/preproc/tbl/tbl.1.man
@@ -504,12 +504,13 @@ the second and any further rows' first and second columns 
are left- and
 right-aligned,
 respectively.
 .
-.\" slack text for window/orphan control
-.\"If more rows of entries are added to the table data,
-.\"they reuse the row definition
-.\".RB \[lq] LR \[rq].
+If more rows of entries are added to the table data,
+they reuse the row definition
+.RB \[lq] LR \[rq].
 .
 .
+.br
+.ne 3v
 .P
 The row definition with the most column descriptors determines the
 number of columns in the table;