[groff] 51/72: [troff]: Update usage message.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit 600e81d1c7fd37d1855fdc047ab5da9b71f73fdd
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Sun Oct 23 12:54:56 2022 -0500

    [troff]: Update usage message.
    
    * src/roff/troff/input.cpp (usage): Update usage message.  Present
      different modes of operation on separate output lines.  Revise
      metasyntactic variable names for clarity.
      - name -> string
      The former is not wrong but is too general.  In practice there is no
      way to populate a macro or diversion from a command-line argument.
      - reg -> register
      - expr -> numeric-expression
      Use complete words and the exact terminology from our documentation.
---
 ChangeLog                |  1 +
 src/roff/troff/input.cpp | 14 +++++++++-----
 2 files changed, 10 insertions(+), 5 deletions(-)

diff --git a/ChangeLog b/ChangeLog
index deff16302..b4661171a 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -15,6 +15,7 @@
        * src/preproc/refer/refer.cpp (usage):
        * src/preproc/soelim/soelim.cpp (usage):
        * src/roff/groff/groff.cpp (synopsis, help):
+       * src/roff/troff/input.cpp (usage):
        * src/utils/addftinfo/addftinfo.cpp (usage):
        * src/utils/hpftodit/hpftodit.cpp (usage):
        * src/utils/indxbib/indxbib.cpp (usage):
diff --git a/src/roff/troff/input.cpp b/src/roff/troff/input.cpp
index 4ebf7aa3b..2b4f877ff 100644
--- a/src/roff/troff/input.cpp
+++ b/src/roff/troff/input.cpp
@@ -8031,11 +8031,15 @@ static void add_string(const char *s, string_list **p)
 void usage(FILE *stream, const char *prog)
 {
   fprintf(stream,
-"usage: %s [-abcCEiRUz] [-dCS] [-dNAME=STRING] [-fFAM] [-Fdir]"
-" [-Idir] [-mNAME] [-Mdir] [-nNUM] [-oLIST] [-rCN] [-rREG=EXPR]"
-" [-Tdev] [-wNAME] [-Wname] [file ...]\n"
-"usage: %s {-h | --help | -v | --version}\n",
-         prog, prog);
+"usage: %s [-abcCEiRUz] [-d ct] [-d string=text] [-f font-family]"
+" [-F font-directory] [-I inclusion-directory] [-m macro-package]"
+" [-M macro-directory] [-n page-number] [-o page-list]"
+" [-r cnumeric-expression] [-r register=numeric-expression]"
+" [-T output-device] [-w warning-category] [-W warning-category]"
+" [file ...]\n"
+"usage: %s {-v | --version}\n"
+"usage: %s {-h | --help}\n",
+         prog, prog, prog);
 }
 
 int main(int argc, char **argv)