[groff] 07/14: [groff]: Comment out vestiges of gideal support.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit e7efc68e424ec648296d84bde6cedb09862203b7
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Mon Jul 19 06:31:53 2021 +1000

    [groff]: Comment out vestiges of gideal support.
    
    It would be lovely to have, but no free (and GPL-compatible)
    implementation has showed up after decades of waiting.  Production of
    the original was a Ph.D. thesis.  Excited by de Moivre's theorem?  Take
    a stab at it.
    
    * src/roff/groff/groff.cpp (main): Comment out effect of `-J` option.
      It remains recognized, but silently ignored (instead of attempting to
      execute a nonexistent preprocessor).
    
      (synopsis): Add comment reminding us to document the option if we ever
      get the support.
    
      (help): Comment out documentation of option.
---
 ChangeLog                | 15 +++++++++++++++
 src/roff/groff/groff.cpp |  5 +++--
 2 files changed, 18 insertions(+), 2 deletions(-)

diff --git a/ChangeLog b/ChangeLog
index 5a798c1..8a1690c 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,18 @@
+2021-07-19  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+       [groff]: Comment out vestiges of gideal support.  It would be
+       lovely to have, but no free (and GPL-compatible) implementation
+       has showed up after decades of waiting.  Production of the
+       original was a Ph.D. thesis.  Excited by de Moivre's theorem?
+       Take a stab at it.
+
+       * src/roff/groff/groff.cpp (main): Comment out effect of `-J`
+       option.  It remains recognized, but silently ignored (instead of
+       attempting to execute a nonexistent preprocessor).
+       (synopsis): Add comment reminding us to document the option if
+       we ever get the support.
+       (help): Comment out documentation of option.
+
 2021-07-18  G. Branden Robinson <g.branden.robinson@gmail.com>
 
        [[gnt]roff]: Make usage messages more accurate.
diff --git a/src/roff/groff/groff.cpp b/src/roff/groff/groff.cpp
index 698f0ac..ef7772d 100644
--- a/src/roff/groff/groff.cpp
+++ b/src/roff/groff/groff.cpp
@@ -176,7 +176,7 @@ int main(int argc, char **argv)
       commands[TBL_INDEX].set_name(command_prefix, "tbl");
       break;
     case 'J':
-      commands[IDEAL_INDEX].set_name(command_prefix, "gideal");
+      // commands[IDEAL_INDEX].set_name(command_prefix, "gideal");
       // need_pic = 1;
       break;
     case 'j':
@@ -780,6 +780,7 @@ char **possible_command::get_argv()
 
 void synopsis(FILE *stream)
 {
+  // Add `J` to the cluster if we ever get ideal(1) support.
   fprintf(stream,
 "usage: %1$s [-abcCeEgGijklNpRsStUVXzZ] [-dCS] [-dNAME=STRING] [-Denc]"
 " [-fFAM] [-Fdir] [-Idir] [-Kenc] [-Larg] [-mNAME] [-Mdir] [-nNUM]"
@@ -810,7 +811,7 @@ void help()
 "-i\tread standard input after all FILEs\n"
 "-I DIR\tsearch DIR for input files; implies -s\n"
 "-j\tpreprocess with chem\n"
-"-J\tpreprocess with gideal\n"
+// "-J\tpreprocess with gideal\n"
 "-k\tpreprocess with preconv\n"
 "-K ENC\tuse ENC as input encoding; implies -k\n"
 "-l\tspool the output\n"