[groff] 32/72: [preconv]: Update usage message.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit 906fcc9c1473893f53343424aa9898ab8fa37600
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Fri Oct 21 22:09:52 2022 -0500

    [preconv]: Update usage message.
    
    * src/preproc/preconv/preconv.cpp (usage): Update usage message.
      Present different modes of operation on separate output lines.  Sort
      options in English lexicographic order.
---
 ChangeLog                       |  3 ++-
 src/preproc/preconv/preconv.cpp | 32 +++++++++++++++++++++-----------
 2 files changed, 23 insertions(+), 12 deletions(-)

diff --git a/ChangeLog b/ChangeLog
index e1e01fb6b..0a3cfd8db 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -5,7 +5,8 @@
        * src/devices/grolj4/lj4.cpp (usage):
        * src/preproc/eqn/main.cpp (usage):
        * src/preproc/grn/main.cpp (usage):
-       * src/preproc/pic/main.cpp (usage): Update usage message.
+       * src/preproc/pic/main.cpp (usage):
+       * src/preproc/preconv/preconv.cpp (usage): Update usage message.
        Present different modes of operation on separate output lines.
        Sort options in English lexicographic order.
 
diff --git a/src/preproc/preconv/preconv.cpp b/src/preproc/preconv/preconv.cpp
index c77a756b5..c85363f06 100644
--- a/src/preproc/preconv/preconv.cpp
+++ b/src/preproc/preconv/preconv.cpp
@@ -1204,17 +1204,27 @@ do_file(const char *filename)
 void
 usage(FILE *stream)
 {
-  fprintf(stream, "usage: %s [ option ] [ files ]\n"
-                 "\n"
-                 "-d           show debugging messages\n"
-                 "-D encoding  specify default encoding\n"
-                 "-e encoding  specify input encoding\n"
-                 "-h           print this message\n"
-                 "-r           don't add .lf requests\n"
-                 "-v           print version number\n"
-                 "\n"
-                 "The default encoding is '%s'.\n",
-                 program_name, default_encoding);
+  fprintf(stream,
+"usage: %s [-dr] [-D enc] [-e enc] [file ...]\n"
+"usage: %s {-v | --version}\n"
+"usage: %s {-h | --help}\n"
+"\n"
+"Read each file, convert its encoded characters to a form GNU troff\n"
+"can interpret, and send the result to the standard output stream.\n"
+"\n"
+"Options:\n"
+"  -d      show debugging messages\n"
+"  -D ENC  fall back to encoding ENC\n"
+"  -e ENC  assume input encoding of ENC\n"
+"  --help\n"
+"  -h      show this message and exit\n"
+"  -r      don't add 'lf' requests to output\n"
+"  --version\n"
+"  -v      show version information and exit\n"
+"\n"
+"The default fallback encoding is '%s'.  See the preconv(1) manual"
+" page.\n",
+         program_name, program_name, program_name, default_encoding);
 }
 
 // ---------------------------------------------------------