[groff] 10/38: [man pages]: Relocate material.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit dbf0665014e05e13c69bd6600d12ea47227210c2
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Sun Aug 28 17:07:32 2022 -0500

    [man pages]: Relocate material.
    
    Collate presentation of options in English lexicographic order.
    
    Exception: present refer's '-R' option before the others, since it is
    behaves differently.
    
    Slightly recast discussion of refer(1) options.
---
 src/devices/grohtml/grohtml.1.man | 10 ++---
 src/preproc/grn/grn.1.man         | 66 +++++++++++++++---------------
 src/preproc/refer/refer.1.man     | 84 ++++++++++++++++++++-------------------
 3 files changed, 81 insertions(+), 79 deletions(-)

diff --git a/src/devices/grohtml/grohtml.1.man 
b/src/devices/grohtml/grohtml.1.man
index 1152b415b..4b8828124 100644
--- a/src/devices/grohtml/grohtml.1.man
+++ b/src/devices/grohtml/grohtml.1.man
@@ -386,11 +386,6 @@ usually
 .
 .
 .TP
-.B \-G
-Suppress output of \[lq]Creator:\[rq] HTML comment.
-.
-.
-.TP
 .BI \-g \~anti-aliasing-graphic-bits
 Number of bits of antialiasing information to be used by graphics when
 generating PNG images.
@@ -420,6 +415,11 @@ from issuing antialiasing commands to
 .
 .
 .TP
+.B \-G
+Suppress output of \[lq]Creator:\[rq] HTML comment.
+.
+.
+.TP
 .B \-h
 Generate section headings by using HTML
 .B B
diff --git a/src/preproc/grn/grn.1.man b/src/preproc/grn/grn.1.man
index a1ab41c49..fe1465bfd 100644
--- a/src/preproc/grn/grn.1.man
+++ b/src/preproc/grn/grn.1.man
@@ -844,33 +844,14 @@ all exit afterward.
 .
 .
 .TP
-.BI \-T\~ dev
-Prepare device output using output driver
-.IR dev .
-.
-The default is
-.BR @DEVICE@ .
-.
-See
-.MR groff @MAN1EXT@
-for a list of valid devices.
-.
-.
-.TP
-.BI \-M\~ dir
-Prepend
-.I dir
-to the search path for
-.I gremlin
-files.
-.
-The default search path is the current directory,
-the home directory,
-.IR @SYSTEMMACRODIR@ ,
-.IR @LOCALMACRODIR@ ,
+.B \-C
+Recognize
+.B .GS
 and
-.IR @MACRODIR@ ,
-in that order.
+.B .GE
+(and
+.BR .GF )
+even when followed by a character other than space or newline.
 .
 .
 .TP
@@ -891,14 +872,20 @@ and
 .
 .
 .TP
-.B \-C
-Recognize
-.B .GS
+.BI \-M\~ dir
+Prepend
+.I dir
+to the search path for
+.I gremlin
+files.
+.
+The default search path is the current directory,
+the home directory,
+.IR @SYSTEMMACRODIR@ ,
+.IR @LOCALMACRODIR@ ,
 and
-.B .GE
-(and
-.BR .GF )
-even when followed by a character other than space or newline.
+.IR @MACRODIR@ ,
+in that order.
 .\".
 .\".
 .\".TP
@@ -918,6 +905,19 @@ even when followed by a character other than space or 
newline.
 .\"can still have text and graphics on a shaded background.
 .
 .
+.TP
+.BI \-T\~ dev
+Prepare device output using output driver
+.IR dev .
+.
+The default is
+.BR @DEVICE@ .
+.
+See
+.MR groff @MAN1EXT@
+for a list of valid devices.
+.
+.
 .\" ====================================================================
 .SH Files
 .\" ====================================================================
diff --git a/src/preproc/refer/refer.1.man b/src/preproc/refer/refer.1.man
index e89d36f69..452cb2e47 100644
--- a/src/preproc/refer/refer.1.man
+++ b/src/preproc/refer/refer.1.man
@@ -244,53 +244,47 @@ show version information;
 all exit afterward.
 .
 .
-.LP
-Most options are equivalent to commands
-(for a description of these commands,
-see subsection \[lq]Commands\[rq] below).
-.
-.
-.TP 16n
-.B \-b
-.B "\%no\-label\-in\-text; \%no\-label\-in\-reference"
+.TP
+.B \-R
+Don't recognize lines beginning with
+.BR .R1 / .R2 .
 .
 .
-.TP
-.B \-e
-.B accumulate
+.P
+Other options are equivalent to commands;
+see subsection \[lq]Commands\[rq] below.
 .
 .
-.TP
-.B \-n
-.B \%no\-default\-database
+.TP 16n
+.BI \-a\~ n
+.B reverse
+.BI A n
 .
 .
 .TP
-.B \-C
-.B compatible
+.B \-b
+.B "\%no\-label\-in\-text; \%no\-label\-in\-reference"
 .
 .
 .TP
-.B \-P
-.B move\-punctuation
+.B \-B
+See below.
 .
 .
 .TP
-.B \-S
-.B \%label \[dq](A.n|Q) \[aq], \[aq] (D.y|D)\[dq]; \
-\%bracket-\%label \[dq]\~(\[dq]\~)\~\[dq];\~\[dq]
+.BI \-c\~ fields
+.B capitalize
+.I fields
 .
 .
 .TP
-.BI \-a\~ n
-.B reverse
-.BI A n
+.B \-C
+.B compatible
 .
 .
 .TP
-.BI \-c\~ fields
-.B capitalize
-.I fields
+.B \-e
+.B accumulate
 .
 .
 .TP
@@ -342,27 +336,45 @@ see subsection \[lq]Commands\[rq] below).
 .
 .
 .TP
+.B \-n
+.B \%no\-default\-database
+.
+.
+.TP
 .BI \-p\~ db-file
 .B database
 .I db-file
 .
 .
 .TP
+.B \-P
+.B move\-punctuation
+.
+.
+.TP
 .BI \-s\~ spec
 .B sort
 .I spec
 .
 .
 .TP
+.B \-S
+.B \%label \[dq](A.n|Q) \[aq], \[aq] (D.y|D)\[dq]; \
+\%bracket-\%label \[dq]\~(\[dq]\~)\~\[dq];\~\[dq]
+.
+.
+.TP
 .BI \-t\~ n
 .B search\-truncate
 .I n
 .
 .
 .P
-The next options are equivalent to commands with the addition that the
-file names specified on the command line are processed as if they were
-arguments to the
+The
+.B B
+option has command equivalents with the addition that the file names
+specified on the command line are processed as if they were arguments to
+the
 .B \%bibliography
 command instead of in the normal way.
 .
@@ -380,16 +392,6 @@ command instead of in the normal way.
 .B \%no\-label\-in\-reference
 .
 .
-.P
-The following option has no synonymous command.
-.
-.
-.TP
-.B \-R
-Don't recognize lines beginning with
-.BR .R1 / .R2 .
-.
-.
 .\" ====================================================================
 .SH Usage
 .\" ====================================================================