Add doc on gawkbug program.

1 files changed, 50 insertions, 54 deletions

diff --git a/doc/gawk.info b/doc/gawk.info
index 037df3d0..67b10ce3 100644
--- a/doc/gawk.info
+++ b/doc/gawk.info
@@ -31885,39 +31885,34 @@ make both your life and the lives of the maintainers much easier.
 
   5. Before reporting a bug or trying to fix it yourself, try to isolate
      it to the smallest possible 'awk' program and input data file that
-     reproduce the problem.  Then send us:
+     reproduce the problem.
 
-        * The program and data file.
-
-        * Some idea of what kind of Unix system you're using.
+  6. Use the 'gawkbug' program to submit the bug report.  This program
+     sets up a bug report template and opens it in your editor.  You
+     then need to edit it appropriately to include:
 
-        * The compiler you used to compile 'gawk'.
+        * The program and data file.
 
         * The exact results 'gawk' gave you.  Also say what you expected
           to occur; this helps us decide whether the problem is really
           in the documentation.
 
-        * The version number of 'gawk' you are using.  You can get this
-          information with the command 'gawk --version'.
+        * A fix if you have one.
 
-  6. Do _not_ send screenshots.  Instead, use copy/paste to send text,
+  7. Do _not_ send screenshots.  Instead, use copy/paste to send text,
      or send files.
 
-  7. Do send files as attachments, instead of inline.  This avoids
-     corruption by mailer programs out in the wilds of the Internet.
-
   8. Please be sure to send all mail in _plain text_, not (or not
      exclusively) in HTML.
 
   9. _All email must be in English.  This is the only language
      understood in common by all the maintainers._
 
-   Once you have a precise problem description, send email to
-<bug-gawk@gnu.org>.
+   The 'gawkbug' program sends email to <bug-gawk@gnu.org>.
 
    The 'gawk' maintainers subscribe to this address, and thus they will
-receive your bug report.  Although you can send mail to the maintainers
-directly, the bug reporting address is preferred because the email list
+receive your bug report.  Do _not_ send mail to the maintainers
+directly; the bug reporting address is preferred because the email list
 is archived at the GNU Project.
 
      NOTE: Many distributions of GNU/Linux and the various BSD-based
@@ -36027,8 +36022,8 @@ Index
 * buffers, flushing:                     I/O Functions.       (line  32)
 * buffers, flushing <1>:                 I/O Functions.       (line 168)
 * bug reports, email address, <bug-gawk@gnu.org>: Bug address.
-                                                              (line  56)
-* <bug-gawk@gnu.org> bug reporting address: Bug address.      (line  56)
+                                                              (line  52)
+* <bug-gawk@gnu.org> bug reporting address: Bug address.      (line  52)
 * built-in functions:                    Functions.           (line   6)
 * built-in functions, evaluation order:  Calling Built-in.    (line  30)
 * BusyBox Awk:                           Other Versions.      (line  92)
@@ -36628,7 +36623,7 @@ Index
                                                               (line  48)
 * elements in arrays, deleting:          Delete.              (line   6)
 * email address for bug reports, <bug-gawk@gnu.org>: Bug address.
-                                                              (line  56)
+                                                              (line  52)
 * empty array elements:                  Reference to Elements.
                                                               (line  18)
 * empty pattern:                         Empty.               (line   6)
@@ -37125,6 +37120,7 @@ Index
 * gawk, implementation issues, debugging: Compatibility Mode. (line   6)
 * gawk, features, adding:                Adding Code.         (line   6)
 * gawk, coding style in:                 Adding Code.         (line  37)
+* gawkbug utility:                       Bug address.         (line  31)
 * gawkextlib project:                    gawkextlib.          (line   6)
 * gawklibpath_append shell function:     Shell Startup Files. (line  29)
 * gawklibpath_default shell function:    Shell Startup Files. (line  22)
@@ -39351,42 +39347,42 @@ Node: VMS GNV1278546
 Node: Bugs1279260
 Node: Bug definition1280172
 Node: Bug address1283108
-Node: Usenet1286496
-Node: Performance bugs1287685
-Node: Asking for help1290606
-Node: Maintainers1292573
-Node: Other Versions1293767
-Node: Installation summary1301931
-Node: Notes1303295
-Node: Compatibility Mode1304089
-Node: Additions1304871
-Node: Accessing The Source1305796
-Node: Adding Code1307233
-Node: New Ports1313425
-Node: Derived Files1317800
-Ref: Derived Files-Footnote-11323460
-Ref: Derived Files-Footnote-21323495
-Ref: Derived Files-Footnote-31324093
-Node: Future Extensions1324207
-Node: Implementation Limitations1324865
-Node: Extension Design1326075
-Node: Old Extension Problems1327219
-Ref: Old Extension Problems-Footnote-11328737
-Node: Extension New Mechanism Goals1328794
-Ref: Extension New Mechanism Goals-Footnote-11332158
-Node: Extension Other Design Decisions1332347
-Node: Extension Future Growth1334460
-Node: Notes summary1335066
-Node: Basic Concepts1336224
-Node: Basic High Level1336905
-Ref: figure-general-flow1337187
-Ref: figure-process-flow1337873
-Ref: Basic High Level-Footnote-11341175
-Node: Basic Data Typing1341360
-Node: Glossary1344688
-Node: Copying1376575
-Node: GNU Free Documentation License1414118
-Node: Index1439238
+Node: Usenet1286296
+Node: Performance bugs1287485
+Node: Asking for help1290406
+Node: Maintainers1292373
+Node: Other Versions1293567
+Node: Installation summary1301731
+Node: Notes1303095
+Node: Compatibility Mode1303889
+Node: Additions1304671
+Node: Accessing The Source1305596
+Node: Adding Code1307033
+Node: New Ports1313225
+Node: Derived Files1317600
+Ref: Derived Files-Footnote-11323260
+Ref: Derived Files-Footnote-21323295
+Ref: Derived Files-Footnote-31323893
+Node: Future Extensions1324007
+Node: Implementation Limitations1324665
+Node: Extension Design1325875
+Node: Old Extension Problems1327019
+Ref: Old Extension Problems-Footnote-11328537
+Node: Extension New Mechanism Goals1328594
+Ref: Extension New Mechanism Goals-Footnote-11331958
+Node: Extension Other Design Decisions1332147
+Node: Extension Future Growth1334260
+Node: Notes summary1334866
+Node: Basic Concepts1336024
+Node: Basic High Level1336705
+Ref: figure-general-flow1336987
+Ref: figure-process-flow1337673
+Ref: Basic High Level-Footnote-11340975
+Node: Basic Data Typing1341160
+Node: Glossary1344488
+Node: Copying1376375
+Node: GNU Free Documentation License1413918
+Node: Index1439038
 
 End Tag Table