[groff] 02/02: preconv(1): Reorganize.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit 0baee65d35e2394cc21c96ead9b10d187feaa00d
Author: G. Branden Robinson <address@hidden>
AuthorDate: Sun May 17 13:45:43 2020 +1000

    preconv(1): Reorganize.
    
    Move compatibility mode save below legal terms notice, since we don't
    need compatibility mode in that comment block or the apropos/mkwhatis
    line before it.
    
    Coalesce "Usage" section into "Description"; we don't need both, and
    "Usage" is nonstandard per Kerrisk's man-pages(7) (which is not
    normative for us, but useful and suggestive).
    
    Except for replacement of the "Usage" section heading with a paragraph
    macro call, this is a relocation-only commit.
---
 src/preproc/preconv/preconv.1.man | 111 +++++++++++++++++++-------------------
 1 file changed, 54 insertions(+), 57 deletions(-)

diff --git a/src/preproc/preconv/preconv.1.man 
b/src/preproc/preconv/preconv.1.man
index d4ec56b..c3b2c86 100644
--- a/src/preproc/preconv/preconv.1.man
+++ b/src/preproc/preconv/preconv.1.man
@@ -3,11 +3,6 @@
 preconv \- prepare files for typesetting with GNU roff
 .
 .
-.\" Save and disable compatibility mode (for, e.g., Solaris 10/11).
-.do nr *groff_preconv_1_man_C \n[.cp]
-.cp 0
-.
-.
 .\" ====================================================================
 .\" Legal Terms
 .\" ====================================================================
@@ -30,6 +25,11 @@ preconv \- prepare files for typesetting with GNU roff
 .\" instead of in the original English.
 .
 .
+.\" Save and disable compatibility mode (for, e.g., Solaris 10/11).
+.do nr *groff_preconv_1_man_C \n[.cp]
+.cp 0
+.
+.
 .\" ====================================================================
 .SH Synopsis
 .\" ====================================================================
@@ -109,58 +109,7 @@ options of
 .IR groff .
 .
 .
-.\" ====================================================================
-.SH Options
-.\" ====================================================================
-.
-.B \-h
-and
-.B \-\-help
-display a usage message,
-while
-.B \-v
-and
-.B \-\-version
-show version information;
-all exit afterward.
-.
-.
-.TP
-.B \-d
-Emit debugging messages to the standard error stream.
-.
-.
-.TP
-.BI \-D\~ default-encoding
-Report
-.I default-encoding
-if all detection methods fail.
-.
-.
-.TP
-.BI \-e\~ encoding
-Override detection procedure and assume
-.IR encoding .
-.
-This corresponds to
-.IR groff 's
-.RB \[lq] \-K
-.IR encoding \[rq]
-option.
-.
-.
-.TP
-.B \-r
-Write files \[lq]raw\[rq];
-do not add
-.B .lf
-requests.
-.
-.
-.\" ====================================================================
-.SH Usage
-.\" ====================================================================
-.
+.PP
 .I preconv
 tries to find the input encoding with the following algorithm,
 stopping at the first success.
@@ -474,6 +423,54 @@ it is correctly detected and mapped.
 .
 .
 .\" ====================================================================
+.SH Options
+.\" ====================================================================
+.
+.B \-h
+and
+.B \-\-help
+display a usage message,
+while
+.B \-v
+and
+.B \-\-version
+show version information;
+all exit afterward.
+.
+.
+.TP
+.B \-d
+Emit debugging messages to the standard error stream.
+.
+.
+.TP
+.BI \-D\~ default-encoding
+Report
+.I default-encoding
+if all detection methods fail.
+.
+.
+.TP
+.BI \-e\~ encoding
+Override detection procedure and assume
+.IR encoding .
+.
+This corresponds to
+.IR groff 's
+.RB \[lq] \-K
+.IR encoding \[rq]
+option.
+.
+.
+.TP
+.B \-r
+Write files \[lq]raw\[rq];
+do not add
+.B .lf
+requests.
+.
+.
+.\" ====================================================================
 .SH "See Also"
 .\" ====================================================================
 .