soelim(1): Relocate material.

...in preparation for further edits.

* Move compatibility save and mode switch to follow the legal notice.
* Coalsesce nonstandard "Usage" section into "Description" section.

Except for replacing ".SH Usage" with a .PP macro call, this commit
changes no text.

1 files changed, 61 insertions, 64 deletions

diff --git a/src/preproc/soelim/soelim.1.man b/src/preproc/soelim/soelim.1.man
index 9554709d3..958c371cd 100644
--- a/src/preproc/soelim/soelim.1.man
+++ b/src/preproc/soelim/soelim.1.man
@@ -4,12 +4,6 @@
 @g@soelim \- interpret .so requests in groff input
 .
 .
-.\" Save and disable compatibility mode (for, e.g., Solaris 10/11).
-.do nr *groff_soelim_1_man_C \n[.cp]
-.cp 0
-.mso pic.tmac
-.
-.
 .\" ====================================================================
 .\" Legal Terms
 .\" ====================================================================
@@ -32,6 +26,12 @@
 .\" instead of in the original English.
 .
 .
+.\" Save and disable compatibility mode (for, e.g., Solaris 10/11).
+.do nr *groff_soelim_1_man_C \n[.cp]
+.cp 0
+.mso pic.tmac
+.
+.
 .\" ====================================================================
 .SH Synopsis
 .\" ====================================================================
@@ -109,64 +109,7 @@ request (and
 ignores it).
 .
 .
-.\" ====================================================================
-.SH Options
-.\" ====================================================================
-.
-.B \-\-help
-displays a usage message,
-while
-.B \-v
-and
-.B \-\-version
-show version information;
-all exit afterward.
-.
-.
-.TP
-.B \-C
-Recognize
-.B .so
-even when followed by a character other than space or newline.
-.
-.TP
-.BI \-I dir
-This option may be used to add a directory to the search path for
-files (both those on the command line and those named in
-.B .so
-requests).
-.
-The search path is initialized with the current directory.
-.
-This option may be specified more than once; the directories are then
-searched in the order specified (but before the current directory).
-.
-If you want to make the current directory be read before other
-directories, add
-.B \-I.\&
-at the appropriate place.
-.
-.IP
-No directory search is performed for files with an absolute file name.
-.
-.TP
-.B \-r
-Do not add
-.B .lf
-requests (for general use, with non-groff files).
-.
-.TP
-.B \-t
-Don't emit
-.B .lf
-requests but TeX comment lines (starting with \[oq]%\[cq]) giving the
-current file and line number.
-.
-.
-.\" ====================================================================
-.SH Usage
-.\" ====================================================================
-.
+.PP
 The normal processing sequence of groff is this:
 .
 .
@@ -285,6 +228,60 @@ box invisible width 0.5 height 0.4 "output" "file"
 .
 .
 .\" ====================================================================
+.SH Options
+.\" ====================================================================
+.
+.B \-\-help
+displays a usage message,
+while
+.B \-v
+and
+.B \-\-version
+show version information;
+all exit afterward.
+.
+.
+.TP
+.B \-C
+Recognize
+.B .so
+even when followed by a character other than space or newline.
+.
+.TP
+.BI \-I dir
+This option may be used to add a directory to the search path for
+files (both those on the command line and those named in
+.B .so
+requests).
+.
+The search path is initialized with the current directory.
+.
+This option may be specified more than once; the directories are then
+searched in the order specified (but before the current directory).
+.
+If you want to make the current directory be read before other
+directories, add
+.B \-I.\&
+at the appropriate place.
+.
+.IP
+No directory search is performed for files with an absolute file name.
+.
+.TP
+.B \-r
+Do not add
+.B .lf
+requests (for general use, with non-groff files).
+.
+.TP
+.B \-t
+Don't emit
+.B .lf
+requests but TeX comment lines (starting with \[oq]%\[cq]) giving the
+current file and line number.
+.
+.
+.\" ====================================================================
 .SH "See Also"
 .\" ====================================================================
 .