[groff] 09/12: [soelim]: Revise description.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit 1d550cc4d33db105c37c867b836512afa7373341
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Tue Nov 19 17:06:59 2024 -0600

    [soelim]: Revise description.
    
    * src/preproc/soelim/soelim.1.man (Description):
    * src/preproc/soelim/soelim.cpp (usage): Do it.
---
 ChangeLog                       |  5 +++++
 src/preproc/soelim/soelim.1.man |  7 ++++---
 src/preproc/soelim/soelim.cpp   | 16 ++++++++--------
 3 files changed, 17 insertions(+), 11 deletions(-)

diff --git a/ChangeLog b/ChangeLog
index 4d22ec3c0..61e766840 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,8 @@
+2024-11-19  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+       * src/preproc/soelim/soelim.1.man (Description):
+       * src/preproc/soelim/soelim.cpp (usage): Revise description.
+
 2024-11-19  G. Branden Robinson <g.branden.robinson@gmail.com>
 
        * src/roff/troff/div.cpp (DIVERSION_LENGTH_MAX): Declare as
diff --git a/src/preproc/soelim/soelim.1.man b/src/preproc/soelim/soelim.1.man
index 33a7323ea..36c50f2be 100644
--- a/src/preproc/soelim/soelim.1.man
+++ b/src/preproc/soelim/soelim.1.man
@@ -97,9 +97,9 @@ is a preprocessor for the
 document formatting system.
 .
 .I @g@soelim
-works as a filter to eliminate source requests in
+eliminates source requests in
 .MR roff @MAN7EXT@
-input;
+and other text files;
 that is,
 it replaces lines of the form
 .RB \[lq] .so
@@ -112,6 +112,7 @@ recursively.
 .
 By default,
 it writes
+.I roff
 .B lf
 requests as well to record the name and line number of each
 .I input-file
@@ -231,7 +232,7 @@ option,
 therefore,
 .I @g@soelim
 can be used to process text files in general,
-to flatten a tree of input documents.
+to flatten a tree of documents.
 .
 .
 .PP
diff --git a/src/preproc/soelim/soelim.cpp b/src/preproc/soelim/soelim.cpp
index 8637e2bf2..1653b1d4d 100644
--- a/src/preproc/soelim/soelim.cpp
+++ b/src/preproc/soelim/soelim.cpp
@@ -55,14 +55,14 @@ void usage(FILE *stream)
   if (stdout == stream)
     fputs(
 "\n"
-"GNU soelim eliminates source requests in roff(7) input; it replaces\n"
-"lines of the form \".so included‐file\" within each text input-file\n"
-"with the contents of included-file, recursively.  By default, it\n"
-"writes \"lf\" requests as well to record the name and line number of\n"
-"each input-file and included-file.  Use the -t option to produce TeX\n"
-"comments instead of roff requests.  Use the -r option to process\n"
-"general text files, to flatten a tree of input documents.  See the\n"
-"soelim(1) manual page.\n",
+"GNU soelim eliminates source requests in roff(7) and other text\n"
+"files; it replaces lines of the form \".so included‐file\" within\n"
+"each text input-file with the contents of included-file,\n"
+"recursively.  By default, it writes roff \"lf\" requests as well to\n"
+"record the name and line number of each input-file and\n"
+"included-file.  Use the -t option to produce TeX comments instead of\n"
+"roff requests.  Use the -r option to write neither, flattening a\n"
+"tree of documents.  See the soelim(1) manual page.\n",
          stream);
 }