[groff] 01/02: addftinfo, tfmtodit: Tweak usage messages.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit bcfc8b17a4e0abd67527bd6d03186eda01f9bd72
Author: G. Branden Robinson <address@hidden>
AuthorDate: Thu Apr 30 20:35:02 2020 +1000

    addftinfo, tfmtodit: Tweak usage messages.
    
    * src/utils/addftinfo/addftinfo.cpp (usage):
    * src/utils/tfmtodit/tfmtodit.cpp (usage): Add "usage:" prefix to
      messages documenting auxiliary modes of invoking the program.  The
      output doesn't look right without one, and it feels dishonest to not
      document the relevant options (-v, --version) disjunctively.  I'm
      trying to strike a balance between the ultra-terse BSD approach and
      the ultra-garrulous GNU one (see, e.g., ls(1)).  Likely both camps
      will be unhappy.  :-/
---
 ChangeLog                         | 11 +++++++++++
 src/utils/addftinfo/addftinfo.cpp |  4 ++--
 src/utils/tfmtodit/tfmtodit.cpp   |  4 ++--
 3 files changed, 15 insertions(+), 4 deletions(-)

diff --git a/ChangeLog b/ChangeLog
index c13a3fc..cebf9e6 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,5 +1,16 @@
 2020-04-30  G. Branden Robinson <address@hidden>
 
+       * src/utils/addftinfo/addftinfo.cpp (usage):
+       * src/utils/tfmtodit/tfmtodit.cpp (usage): Add "usage:" prefix
+       to messages documenting auxiliary modes of invoking the program.
+       The output doesn't look right without one, and it feels
+       dishonest to not document the relevant options (-v, --version)
+       disjunctively.  I'm trying to strike a balance between the
+       ultra-terse BSD approach and the ultra-garrulous GNU one (see,
+       e.g., ls(1)).  Likely both camps will be unhappy.  :-/
+
+2020-04-30  G. Branden Robinson <address@hidden>
+
        * src/utils/tfmtodit/tfmtodit.cpp (read_map): Report invalid
        character code from map file in diagnostic.
        (main): Report invalid skew character position in diagnostic.
diff --git a/src/utils/addftinfo/addftinfo.cpp 
b/src/utils/addftinfo/addftinfo.cpp
index 7e63b9d..5ee8874 100644
--- a/src/utils/addftinfo/addftinfo.cpp
+++ b/src/utils/addftinfo/addftinfo.cpp
@@ -139,8 +139,8 @@ static void usage(FILE *stream)
   for (int i = 0; i < len; i++)
     fprintf(stream, " [-%s N]", param_table[i].name);
   fprintf(stream, " RESOLUTION UNIT-WIDTH FONT\n");
-  fprintf(stream, "%s -v\n", program_name);
-  fprintf(stream, "%s --version\n", program_name);
+  fprintf(stream, "usage: %s -v\n", program_name);
+  fprintf(stream, "usage: %s --version\n", program_name);
 }
 
 static void usage()
diff --git a/src/utils/tfmtodit/tfmtodit.cpp b/src/utils/tfmtodit/tfmtodit.cpp
index 6a49fe9..04c0646 100644
--- a/src/utils/tfmtodit/tfmtodit.cpp
+++ b/src/utils/tfmtodit/tfmtodit.cpp
@@ -877,6 +877,6 @@ static void usage(FILE *stream)
 {
   fprintf(stream, "usage: %s [-s] [-g GF-FILE] [-k SKEW-CHAR] TFM-FILE"
          " MAP-FILE FONT\n", program_name);
-  fprintf(stream, "%s -v\n", program_name);
-  fprintf(stream, "%s --version\n", program_name);
+  fprintf(stream, "usage: %s -v\n", program_name);
+  fprintf(stream, "usage: %s --version\n", program_name);
 }