[groff] 22/31: [grohtml,groff,nroff,troff]: Tweak usage message.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit d7b3ec32943da7a34a9a057a47fde170af6b191c
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Mon Jan 31 05:06:57 2022 +1100

    [grohtml,groff,nroff,troff]: Tweak usage message.
    
    * src/devices/grohtml/post-html.cpp (usage):
    * src/roff/groff/groff.cpp (synopsis):
    * src/roff/nroff/nroff.sh:
    * src/roff/troff/input.cpp (usage): Partly revert commit 06ae7b0b8, 16
      January.  Move an ellipsis back inside a bracketed operand (that is,
      an optional one).  On reflection, I think this notation makes it
      clearer that the command can be meaningfully run without operands.
---
 ChangeLog                         | 13 +++++++++++++
 src/devices/grohtml/post-html.cpp |  2 +-
 src/roff/groff/groff.cpp          |  2 +-
 src/roff/nroff/nroff.sh           |  2 +-
 src/roff/troff/input.cpp          |  2 +-
 5 files changed, 17 insertions(+), 4 deletions(-)

diff --git a/ChangeLog b/ChangeLog
index 7db3edd7..b2ede9ff 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,16 @@
+2022-01-31  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+       [grohtml,groff,nroff,troff]: Tweak usage message.
+
+       * src/devices/grohtml/post-html.cpp (usage):
+       * src/roff/groff/groff.cpp (synopsis):
+       * src/roff/nroff/nroff.sh:
+       * src/roff/troff/input.cpp (usage): Partly revert commit
+       06ae7b0b8, 16 January.  Move an ellipsis back inside a bracketed
+       operand (that is, an optional one).  On reflection, I think this
+       notation makes it clearer that the command can be meaningfully
+       run without operands.
+
 2022-01-31  G. Branden Robinson <g.branden.robinson@gmail.com>
 
        * tmac/papersize.tmac: Slightly refactor.  Use new `stringdown`
diff --git a/src/devices/grohtml/post-html.cpp 
b/src/devices/grohtml/post-html.cpp
index ca667392..69fb0595 100644
--- a/src/devices/grohtml/post-html.cpp
+++ b/src/devices/grohtml/post-html.cpp
@@ -5671,7 +5671,7 @@ static void usage(FILE *stream)
 {
   fprintf(stream, "usage: %s [-bCGhlnrVy] [-F font-directory]"
          " [-j output-stem] [-s base-point-size] [-S heading-level]"
-         " [-x html-dialect] [file] ...\n",
+         " [-x html-dialect] [file ...]\n",
          program_name);
   fprintf(stream, "usage: %s {--help | -v | --version}\n",
          program_name);
diff --git a/src/roff/groff/groff.cpp b/src/roff/groff/groff.cpp
index 315cc0eb..565b0755 100644
--- a/src/roff/groff/groff.cpp
+++ b/src/roff/groff/groff.cpp
@@ -789,7 +789,7 @@ void synopsis(FILE *stream)
 "usage: %s [-abcCeEgGijklNpRsStUVXzZ] [-dCS] [-dNAME=STRING] [-Denc]"
 " [-fFAM] [-Fdir] [-Idir] [-Kenc] [-Larg] [-mNAME] [-Mdir] [-nNUM]"
 " [-oLIST] [-Parg] [-rCN] [-rREG=EXPR] [-Tdev] [-wNAME] [-Wname]"
-" [file] ...\n"
+" [file ...]\n"
 "usage: %s {-h | --help | -v | --version}\n",
          program_name, program_name);
 }
diff --git a/src/roff/nroff/nroff.sh b/src/roff/nroff/nroff.sh
index 0b21cbad..96270373 100644
--- a/src/roff/nroff/nroff.sh
+++ b/src/roff/nroff/nroff.sh
@@ -30,7 +30,7 @@ is_option_argument_pending=
 
 usage="usage: $prog [-bcCEhikpRStUVz] [-dCS] [-dNAME=STRING] [-Karg]\
  [-mNAME] [-Mdir] [-nNUM] [-oLIST] [-Parg] [-rCN] [-rREG=EXPR] [-Tdev]\
- [-wNAME] [-Wname] [file] ...
+ [-wNAME] [-Wname] [file ...]
 usage: $prog {--help | -v | --version}"
 
 for arg
diff --git a/src/roff/troff/input.cpp b/src/roff/troff/input.cpp
index bf676051..03d8dea3 100644
--- a/src/roff/troff/input.cpp
+++ b/src/roff/troff/input.cpp
@@ -7987,7 +7987,7 @@ 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"
+" [-Tdev] [-wNAME] [-Wname] [file ...]\n"
 "usage: %s {-h | --help | -v | --version}\n",
          prog, prog);
 }