[groff] 03/07: [grohtml]: Update usage() to be accurate.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit 7db16f1abd070837fc1776341218d0fe7f1762e4
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Sat May 22 18:17:36 2021 +1000

    [grohtml]: Update usage() to be accurate.
    
    * src/devices/grohtml/post-html.cpp (usage):
    * src/preproc/html/pre-html.cpp (usage): Fix inaccuracies in supported
      option summary.
    
    Also update editor aid comments.
---
 ChangeLog                         |  6 ++++++
 src/devices/grohtml/post-html.cpp | 12 ++++++++++--
 src/preproc/html/pre-html.cpp     | 33 ++++++++++++++++++++++-----------
 3 files changed, 38 insertions(+), 13 deletions(-)

diff --git a/ChangeLog b/ChangeLog
index 0f39b78..c7262d4 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,5 +1,11 @@
 2021-05-22  G. Branden Robinson <g.branden.robinson@gmail.com>
 
+       * src/preproc/html/pre-html.cpp (usage):
+       * src/devices/grohtml/post-html.cpp (usage): Fix inaccuracies in
+       supported option summary.
+
+2021-05-22  G. Branden Robinson <g.branden.robinson@gmail.com>
+
        * src/preproc/html/pre-html.cpp (scanArguments):
        * src/devices/grohtml/post-html.cpp (main): Use libgroff's
        warning() instead of printf() to emit diagnostic about
diff --git a/src/devices/grohtml/post-html.cpp 
b/src/devices/grohtml/post-html.cpp
index 76e088c..057cbe5 100644
--- a/src/devices/grohtml/post-html.cpp
+++ b/src/devices/grohtml/post-html.cpp
@@ -1,4 +1,3 @@
-// -*- C++ -*-
 /* Copyright (C) 2000-2020 Free Software Foundation, Inc.
  *
  *  Gaius Mulley (gaius@glam.ac.uk) wrote post-html.cpp
@@ -5555,6 +5554,15 @@ int main(int argc, char **argv)
 
 static void usage(FILE *stream)
 {
-  fprintf(stream, "usage: %s [-vbelnhVy] [-D dir] [-I image_stem] [-F dir] [-x 
x] [files ...]\n",
+  fprintf(stream, "usage: %s [-bhlnrVy] [-F FONT-DIRECTORY]"
+         " [-j OUTPUT-STEM] [-s BASE-POINT-SIZE] [-S HEADING-LEVEL]"
+         " [-x HTML-DIALECT] [FILE ...]\n",
          program_name);
+  fprintf(stream, "usage: %s -v\n", program_name);
 }
+
+// Local Variables:
+// fill-column: 72
+// mode: C++
+// End:
+// vim: set cindent noexpandtab shiftwidth=2 textwidth=72:
diff --git a/src/preproc/html/pre-html.cpp b/src/preproc/html/pre-html.cpp
index 72d8202..041e385 100644
--- a/src/preproc/html/pre-html.cpp
+++ b/src/preproc/html/pre-html.cpp
@@ -1,4 +1,3 @@
-// -*- C++ -*-
 /* Copyright (C) 2000-2020 Free Software Foundation, Inc.
  * Written by Gaius Mulley (gaius@glam.ac.uk).
  *
@@ -1551,15 +1550,21 @@ static char_buffer inputFile;
 
 static void usage(FILE *stream)
 {
-  fprintf(stream,
-    "\n"
-    "This program is not intended to be called stand-alone;\n"
-    "it is part of the groff pipeline to produce HTML output.\n"
-    "\n"
-    "If there is ever the need to call it manually (e.g., for\n"
-    "debugging purposes), add command-line option '-V' while calling\n"
-    "the 'groff' program to see which arguments are passed to it.\n"
-    "\n");
+  fprintf(stream, "usage: %s [-epV] [-a ANTI-ALIASING-TEXT-BITS]"
+         " [-D IMAGE-DIRECTORY] [-F FONT-DIRECTORY]"
+         " [-g ANTI-ALIASING-GRAPHICS-BITS] [-i RESOLUTION]"
+         " [-I IMAGE-STEM] [-o IMAGE-VERTICAL-OFFSET]"
+         " [-x HTML-DIALECT] [FILE ...]\n"
+         "usage: %s -v\n"
+         "\n"
+         "This program is not intended to be called stand-alone;\n"
+         "it is part of the groff pipeline to produce HTML output.\n"
+         "\n"
+         "If there is ever the need to call it manually (e.g., for\n"
+         "debugging purposes), add command-line option '-V' while\n"
+         "calling the 'groff' program to see which arguments are\n"
+         "passed to it.\n"
+         "\n", program_name, program_name);
 }
 
 /*
@@ -1620,7 +1625,7 @@ static int scanArguments(int argc, char **argv)
       }
       break;
     case 'h':
-      // handled by post-grohtml
+      // handled by post-grohtml (write headings with font size changes)
       break;
     case 'i':
       image_res = atoi(optarg);
@@ -1832,3 +1837,9 @@ static int do_file(const char *filename)
   current_filename = NULL;
   return 1;
 }
+
+// Local Variables:
+// fill-column: 72
+// mode: C++
+// End:
+// vim: set cindent noexpandtab shiftwidth=2 textwidth=72: