Rework Bugs section in the manual.

4 files changed, 729 insertions, 656 deletions

diff --git a/doc/ChangeLog b/doc/ChangeLog
index 67e92fa6..76497789 100644
--- a/doc/ChangeLog
+++ b/doc/ChangeLog
@@ -1,3 +1,9 @@
+2016-10-02         Arnold D. Robbins     <arnold@skeeve.com>
+
+	* gawktexi.in (Bugs): Rework this section and break into
+	subsections, mainly to emphasize that I no longer
+	read comp.lang.awk.
+
 2016-09-20         Arnold D. Robbins     <arnold@skeeve.com>
 
 	* gawktexi.in (Group Functions): Typo fix. Reported
diff --git a/doc/gawk.info b/doc/gawk.info
index d348ef61..dd82d71d 100644
--- a/doc/gawk.info
+++ b/doc/gawk.info
@@ -643,6 +643,9 @@ in (a) below.  A copy of the license is included in the section entitled
 * VMS Old Gawk::                        An old version comes with some VMS
                                         systems.
 * Bugs::                                Reporting Problems and Bugs.
+* Bug address::                         Where to send reports to.
+* Usenet::                              Where not to send reports to.
+* Maintainers::                         Maintainers of non-*nix ports.
 * Other Versions::                      Other freely available 'awk'
                                         implementations.
 * Installation summary::                Summary of installation.
@@ -28378,11 +28381,22 @@ B.4 Reporting Problems and Bugs
 report it to the developers; we cannot promise to do anything, but we
 might well want to fix it.
 
-   Before reporting a bug, make sure you have really found a genuine
-bug.  Carefully reread the documentation and see if it says you can do
-what you're trying to do.  If it's not clear whether you should be able
-to do something or not, report that too; it's a bug in the
-documentation!
+* Menu:
+
+* Bug address::                 Where to send reports to.
+* Usenet::                      Where not to send reports to.
+* Maintainers::                 Maintainers of non-*nix ports.
+
+
+File: gawk.info,  Node: Bug address,  Next: Usenet,  Up: Bugs
+
+B.4.1 Submitting Bug Reports
+----------------------------
+
+Before reporting a bug, make sure you have really found a genuine bug.
+Carefully reread the documentation and see if it says you can do what
+you're trying to do.  If it's not clear whether you should be able to do
+something or not, report that too; it's a bug in the documentation!
 
    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
@@ -28406,12 +28420,6 @@ the only language understood in common by all the maintainers._  In
 addition, please be sure to send all mail in _plain text_, not (or not
 exclusively) in HTML.
 
-     CAUTION: Do _not_ try to report bugs in 'gawk' by posting to the
-     Usenet/Internet newsgroup 'comp.lang.awk'.  The 'gawk' developers
-     do occasionally read this newsgroup, but there is no guarantee that
-     we will see your posting.  The steps described here are the only
-     officially recognized way for reporting bugs.  Really.
-
      NOTE: Many distributions of GNU/Linux and the various BSD-based
      operating systems have their own bug reporting systems.  If you
      report a bug using your distribution's bug reporting system, you
@@ -28429,12 +28437,35 @@ questions about things that are unclear in the documentation or are just
 obscure features, ask on the bug list; we will try to help you out if we
 can.
 
-   If you find bugs in one of the non-Unix ports of 'gawk', send an
-email to the bug list, with a copy to the person who maintains that
-port.  The maintainers are named in the following list, as well as in
-the 'README' file in the 'gawk' distribution.  Information in the
-'README' file should be considered authoritative if it conflicts with
-this Info file.
+
+File: gawk.info,  Node: Usenet,  Next: Maintainers,  Prev: Bug address,  Up: Bugs
+
+B.4.2 Please Don't Post Bug Reports to USENET
+---------------------------------------------
+
+     I gave up on Usenet a couple of years ago and haven't really looked
+     back.  It's like sports talk radio--you feel smarter for not having
+     read it.
+                            -- _Chet Ramey_
+
+   Please do _not_ try to report bugs in 'gawk' by posting to the
+Usenet/Internet newsgroup 'comp.lang.awk'.  Although some of the 'gawk'
+developers occasionally read this newgroup, the primary 'gawk'
+maintainer no longer does.  Thus it's virtually guaranteed that he will
+_not_ see your posting.  The steps described here are the only
+officially recognized way for reporting bugs.  Really.
+
+
+File: gawk.info,  Node: Maintainers,  Prev: Usenet,  Up: Bugs
+
+B.4.3 Reporting Problems with Non-Unix Ports
+--------------------------------------------
+
+If you find bugs in one of the non-Unix ports of 'gawk', send an email
+to the bug list, with a copy to the person who maintains that port.  The
+maintainers are named in the following list, as well as in the 'README'
+file in the 'gawk' distribution.  Information in the 'README' file
+should be considered authoritative if it conflicts with this Info file.
 
    The people maintaining the various 'gawk' ports are:
 
@@ -32274,7 +32305,7 @@ Index
 * bt debugger command (alias for backtrace): Execution Stack. (line  13)
 * Buening, Andreas:                      Acknowledgments.     (line  60)
 * Buening, Andreas <1>:                  Contributors.        (line  93)
-* Buening, Andreas <2>:                  Bugs.                (line  73)
+* Buening, Andreas <2>:                  Maintainers.         (line  14)
 * buffering, input/output:               I/O Functions.       (line 166)
 * buffering, input/output <1>:           Two-way I/O.         (line  53)
 * buffering, interactive vs. noninteractive: I/O Functions.   (line  76)
@@ -32282,8 +32313,8 @@ Index
 * buffers, flushing <1>:                 I/O Functions.       (line 166)
 * buffers, operators for:                GNU Regexp Operators.
                                                               (line  51)
-* bug reports, email address, bug-gawk@gnu.org: Bugs.         (line  30)
-* bug-gawk@gnu.org bug reporting address: Bugs.               (line  30)
+* bug reports, email address, bug-gawk@gnu.org: Bug address.  (line  22)
+* bug-gawk@gnu.org bug reporting address: Bug address.        (line  22)
 * built-in functions:                    Functions.           (line   6)
 * built-in functions, evaluation order:  Calling Built-in.    (line  30)
 * BusyBox Awk:                           Other Versions.      (line  92)
@@ -32388,7 +32419,7 @@ Index
 * common extensions, single character fields: Single Character Fields.
                                                               (line   6)
 * common extensions, \x escape sequence: Escape Sequences.    (line  61)
-* comp.lang.awk newsgroup:               Bugs.                (line  41)
+* comp.lang.awk newsgroup:               Usenet.              (line  11)
 * comparison expressions:                Typing and Comparison.
                                                               (line   9)
 * comparison expressions, as patterns:   Expression Patterns. (line  14)
@@ -32651,7 +32682,7 @@ Index
 * default keyword:                       Switch Statement.    (line   6)
 * Deifik, Scott:                         Acknowledgments.     (line  60)
 * Deifik, Scott <1>:                     Contributors.        (line  54)
-* Deifik, Scott <2>:                     Bugs.                (line  73)
+* Deifik, Scott <2>:                     Maintainers.         (line  14)
 * delete ARRAY:                          Delete.              (line  39)
 * delete breakpoint at location:         Breakpoint Control.  (line  36)
 * delete breakpoint by number:           Breakpoint Control.  (line  64)
@@ -32785,7 +32816,8 @@ Index
 * elements in arrays, scanning:          Scanning an Array.   (line   6)
 * elements of arrays:                    Reference to Elements.
                                                               (line   6)
-* email address for bug reports, bug-gawk@gnu.org: Bugs.      (line  30)
+* email address for bug reports, bug-gawk@gnu.org: Bug address.
+                                                              (line  22)
 * empty array elements:                  Reference to Elements.
                                                               (line  18)
 * empty pattern:                         Empty.               (line   6)
@@ -33149,7 +33181,7 @@ Index
                                                               (line  47)
 * G-d:                                   Acknowledgments.     (line  94)
 * G., Daniel Richard:                    Acknowledgments.     (line  60)
-* G., Daniel Richard <1>:                Bugs.                (line  73)
+* G., Daniel Richard <1>:                Maintainers.         (line  14)
 * Garfinkle, Scott:                      Contributors.        (line  35)
 * gawk program, dynamic profiling:       Profiling.           (line 178)
 * gawk version:                          Auto-set.            (line 198)
@@ -33604,7 +33636,7 @@ Index
 * mailing labels, printing:              Labels Program.      (line   6)
 * mailing list, GNITS:                   Acknowledgments.     (line  52)
 * Malmberg, John:                        Acknowledgments.     (line  60)
-* Malmberg, John <1>:                    Bugs.                (line  73)
+* Malmberg, John <1>:                    Maintainers.         (line  14)
 * Malmberg, John E.:                     Contributors.        (line 138)
 * mark parity:                           Ordinal Functions.   (line  45)
 * marked string extraction (internationalization): String Extraction.
@@ -33849,7 +33881,7 @@ Index
 * pipe, input:                           Getline/Pipe.        (line  10)
 * pipe, output:                          Redirection.         (line  57)
 * Pitts, Dave:                           Acknowledgments.     (line  60)
-* Pitts, Dave <1>:                       Bugs.                (line  73)
+* Pitts, Dave <1>:                       Maintainers.         (line  14)
 * Plauger, P.J.:                         Library Functions.   (line  12)
 * plug-in:                               Extension Intro.     (line   6)
 * plus sign (+), + operator:             Precedence.          (line  51)
@@ -34173,7 +34205,7 @@ Index
 * Robbins, Arnold <3>:                   Alarm Program.       (line   6)
 * Robbins, Arnold <4>:                   General Data Types.  (line   6)
 * Robbins, Arnold <5>:                   Contributors.        (line 145)
-* Robbins, Arnold <6>:                   Bugs.                (line  73)
+* Robbins, Arnold <6>:                   Maintainers.         (line  14)
 * Robbins, Arnold <7>:                   Future Extensions.   (line   6)
 * Robbins, Bill:                         Getline/Pipe.        (line  40)
 * Robbins, Harry:                        Acknowledgments.     (line  94)
@@ -34705,7 +34737,7 @@ Index
 * Yawitz, Efraim:                        Contributors.        (line 132)
 * Zaretskii, Eli:                        Acknowledgments.     (line  60)
 * Zaretskii, Eli <1>:                    Contributors.        (line  56)
-* Zaretskii, Eli <2>:                    Bugs.                (line  73)
+* Zaretskii, Eli <2>:                    Maintainers.         (line  14)
 * zerofile.awk program:                  Empty Files.         (line  20)
 * Zoulas, Christos:                      Contributors.        (line  67)
 
@@ -34713,563 +34745,566 @@ Index
 
 Tag Table:
 Node: Top1200
-Node: Foreword342138
-Node: Foreword446580
-Node: Preface48112
-Ref: Preface-Footnote-150984
-Ref: Preface-Footnote-251091
-Ref: Preface-Footnote-351325
-Node: History51467
-Node: Names53819
-Ref: Names-Footnote-154913
-Node: This Manual55060
-Ref: This Manual-Footnote-161545
-Node: Conventions61645
-Node: Manual History63999
-Ref: Manual History-Footnote-166994
-Ref: Manual History-Footnote-267035
-Node: How To Contribute67109
-Node: Acknowledgments68238
-Node: Getting Started73124
-Node: Running gawk75563
-Node: One-shot76753
-Node: Read Terminal78016
-Node: Long80048
-Node: Executable Scripts81561
-Ref: Executable Scripts-Footnote-184356
-Node: Comments84459
-Node: Quoting86943
-Node: DOS Quoting92460
-Node: Sample Data Files93135
-Node: Very Simple95730
-Node: Two Rules100632
-Node: More Complex102517
-Node: Statements/Lines105383
-Ref: Statements/Lines-Footnote-1109842
-Node: Other Features110107
-Node: When111043
-Ref: When-Footnote-1112797
-Node: Intro Summary112862
-Node: Invoking Gawk113746
-Node: Command Line115260
-Node: Options116058
-Ref: Options-Footnote-1131965
-Ref: Options-Footnote-2132195
-Node: Other Arguments132220
-Node: Naming Standard Input135167
-Node: Environment Variables136260
-Node: AWKPATH Variable136818
-Ref: AWKPATH Variable-Footnote-1140119
-Ref: AWKPATH Variable-Footnote-2140164
-Node: AWKLIBPATH Variable140425
-Node: Other Environment Variables141569
-Node: Exit Status145517
-Node: Include Files146194
-Node: Loading Shared Libraries149789
-Node: Obsolete151217
-Node: Undocumented151909
-Node: Invoking Summary152206
-Node: Regexp153866
-Node: Regexp Usage155320
-Node: Escape Sequences157357
-Node: Regexp Operators163371
-Ref: Regexp Operators-Footnote-1170787
-Ref: Regexp Operators-Footnote-2170934
-Node: Bracket Expressions171032
-Ref: table-char-classes173508
-Node: Leftmost Longest176645
-Node: Computed Regexps177948
-Node: GNU Regexp Operators181375
-Node: Case-sensitivity185054
-Ref: Case-sensitivity-Footnote-1187941
-Ref: Case-sensitivity-Footnote-2188176
-Node: Regexp Summary188284
-Node: Reading Files189750
-Node: Records191844
-Node: awk split records192577
-Node: gawk split records197508
-Ref: gawk split records-Footnote-1202048
-Node: Fields202085
-Ref: Fields-Footnote-1204865
-Node: Nonconstant Fields204951
-Ref: Nonconstant Fields-Footnote-1207187
-Node: Changing Fields207391
-Node: Field Separators213319
-Node: Default Field Splitting216017
-Node: Regexp Field Splitting217135
-Node: Single Character Fields220488
-Node: Command Line Field Separator221548
-Node: Full Line Fields224766
-Ref: Full Line Fields-Footnote-1226288
-Ref: Full Line Fields-Footnote-2226334
-Node: Field Splitting Summary226435
-Node: Constant Size228509
-Node: Splitting By Content233087
-Ref: Splitting By Content-Footnote-1237058
-Node: Multiple Line237221
-Ref: Multiple Line-Footnote-1243103
-Node: Getline243282
-Node: Plain Getline245486
-Node: Getline/Variable248125
-Node: Getline/File249274
-Node: Getline/Variable/File250660
-Ref: Getline/Variable/File-Footnote-1252263
-Node: Getline/Pipe252351
-Node: Getline/Variable/Pipe255056
-Node: Getline/Coprocess256189
-Node: Getline/Variable/Coprocess257454
-Node: Getline Notes258194
-Node: Getline Summary260989
-Ref: table-getline-variants261411
-Node: Read Timeout262159
-Ref: Read Timeout-Footnote-1266000
-Node: Command-line directories266058
-Node: Input Summary266962
-Node: Input Exercises270134
-Node: Printing270862
-Node: Print272638
-Node: Print Examples274095
-Node: Output Separators276875
-Node: OFMT278892
-Node: Printf280248
-Node: Basic Printf281033
-Node: Control Letters282607
-Node: Format Modifiers286595
-Node: Printf Examples292610
-Node: Redirection295096
-Node: Special FD301937
-Ref: Special FD-Footnote-1305105
-Node: Special Files305179
-Node: Other Inherited Files305796
-Node: Special Network306797
-Node: Special Caveats307657
-Node: Close Files And Pipes308606
-Ref: Close Files And Pipes-Footnote-1315799
-Ref: Close Files And Pipes-Footnote-2315947
-Node: Output Summary316098
-Node: Output Exercises317096
-Node: Expressions317775
-Node: Values318963
-Node: Constants319641
-Node: Scalar Constants320332
-Ref: Scalar Constants-Footnote-1321196
-Node: Nondecimal-numbers321446
-Node: Regexp Constants324459
-Node: Using Constant Regexps324985
-Node: Variables328148
-Node: Using Variables328805
-Node: Assignment Options330715
-Node: Conversion332588
-Node: Strings And Numbers333112
-Ref: Strings And Numbers-Footnote-1336175
-Node: Locale influences conversions336284
-Ref: table-locale-affects339042
-Node: All Operators339660
-Node: Arithmetic Ops340289
-Node: Concatenation342795
-Ref: Concatenation-Footnote-1345642
-Node: Assignment Ops345749
-Ref: table-assign-ops350740
-Node: Increment Ops352053
-Node: Truth Values and Conditions355513
-Node: Truth Values356587
-Node: Typing and Comparison357635
-Node: Variable Typing358455
-Node: Comparison Operators362079
-Ref: table-relational-ops362498
-Node: POSIX String Comparison365993
-Ref: POSIX String Comparison-Footnote-1367067
-Node: Boolean Ops367206
-Ref: Boolean Ops-Footnote-1371688
-Node: Conditional Exp371780
-Node: Function Calls373516
-Node: Precedence377393
-Node: Locales381052
-Node: Expressions Summary382684
-Node: Patterns and Actions385257
-Node: Pattern Overview386377
-Node: Regexp Patterns388054
-Node: Expression Patterns388596
-Node: Ranges392377
-Node: BEGIN/END395485
-Node: Using BEGIN/END396246
-Ref: Using BEGIN/END-Footnote-1398982
-Node: I/O And BEGIN/END399088
-Node: BEGINFILE/ENDFILE401402
-Node: Empty404309
-Node: Using Shell Variables404626
-Node: Action Overview406900
-Node: Statements409225
-Node: If Statement411073
-Node: While Statement412568
-Node: Do Statement414596
-Node: For Statement415744
-Node: Switch Statement418902
-Node: Break Statement421288
-Node: Continue Statement423380
-Node: Next Statement425207
-Node: Nextfile Statement427590
-Node: Exit Statement430242
-Node: Built-in Variables432645
-Node: User-modified433778
-Ref: User-modified-Footnote-1441403
-Node: Auto-set441465
-Ref: Auto-set-Footnote-1454821
-Ref: Auto-set-Footnote-2455027
-Node: ARGC and ARGV455083
-Node: Pattern Action Summary459296
-Node: Arrays461726
-Node: Array Basics463055
-Node: Array Intro463899
-Ref: figure-array-elements465874
-Ref: Array Intro-Footnote-1468578
-Node: Reference to Elements468706
-Node: Assigning Elements471170
-Node: Array Example471661
-Node: Scanning an Array473420
-Node: Controlling Scanning476442
-Ref: Controlling Scanning-Footnote-1481841
-Node: Numeric Array Subscripts482157
-Node: Uninitialized Subscripts484341
-Node: Delete485960
-Ref: Delete-Footnote-1488712
-Node: Multidimensional488769
-Node: Multiscanning491864
-Node: Arrays of Arrays493455
-Node: Arrays Summary498222
-Node: Functions500315
-Node: Built-in501353
-Node: Calling Built-in502434
-Node: Numeric Functions504430
-Ref: Numeric Functions-Footnote-1508458
-Ref: Numeric Functions-Footnote-2508815
-Ref: Numeric Functions-Footnote-3508863
-Node: String Functions509135
-Ref: String Functions-Footnote-1532639
-Ref: String Functions-Footnote-2532767
-Ref: String Functions-Footnote-3533015
-Node: Gory Details533102
-Ref: table-sub-escapes534893
-Ref: table-sub-proposed536412
-Ref: table-posix-sub537775
-Ref: table-gensub-escapes539316
-Ref: Gory Details-Footnote-1540139
-Node: I/O Functions540293
-Ref: table-system-return-values546875
-Ref: I/O Functions-Footnote-1548855
-Ref: I/O Functions-Footnote-2549003
-Node: Time Functions549123
-Ref: Time Functions-Footnote-1559645
-Ref: Time Functions-Footnote-2559713
-Ref: Time Functions-Footnote-3559871
-Ref: Time Functions-Footnote-4559982
-Ref: Time Functions-Footnote-5560094
-Ref: Time Functions-Footnote-6560321
-Node: Bitwise Functions560587
-Ref: table-bitwise-ops561181
-Ref: Bitwise Functions-Footnote-1565519
-Node: Type Functions565692
-Node: I18N Functions566848
-Node: User-defined568499
-Node: Definition Syntax569304
-Ref: Definition Syntax-Footnote-1574991
-Node: Function Example575062
-Ref: Function Example-Footnote-1577984
-Node: Function Caveats578006
-Node: Calling A Function578524
-Node: Variable Scope579482
-Node: Pass By Value/Reference582476
-Node: Return Statement585975
-Node: Dynamic Typing588954
-Node: Indirect Calls589884
-Ref: Indirect Calls-Footnote-1600135
-Node: Functions Summary600263
-Node: Library Functions602968
-Ref: Library Functions-Footnote-1606575
-Ref: Library Functions-Footnote-2606718
-Node: Library Names606889
-Ref: Library Names-Footnote-1610349
-Ref: Library Names-Footnote-2610572
-Node: General Functions610658
-Node: Strtonum Function611761
-Node: Assert Function614783
-Node: Round Function618109
-Node: Cliff Random Function619650
-Node: Ordinal Functions620666
-Ref: Ordinal Functions-Footnote-1623729
-Ref: Ordinal Functions-Footnote-2623981
-Node: Join Function624191
-Ref: Join Function-Footnote-1625961
-Node: Getlocaltime Function626161
-Node: Readfile Function629903
-Node: Shell Quoting631875
-Node: Data File Management633276
-Node: Filetrans Function633908
-Node: Rewind Function638004
-Node: File Checking639910
-Ref: File Checking-Footnote-1641244
-Node: Empty Files641445
-Node: Ignoring Assigns643424
-Node: Getopt Function644974
-Ref: Getopt Function-Footnote-1656443
-Node: Passwd Functions656643
-Ref: Passwd Functions-Footnote-1665482
-Node: Group Functions665570
-Ref: Group Functions-Footnote-1673468
-Node: Walking Arrays673675
-Node: Library Functions Summary676683
-Node: Library Exercises678089
-Node: Sample Programs678554
-Node: Running Examples679324
-Node: Clones680052
-Node: Cut Program681276
-Node: Egrep Program691205
-Ref: Egrep Program-Footnote-1698717
-Node: Id Program698827
-Node: Split Program702507
-Ref: Split Program-Footnote-1705966
-Node: Tee Program706095
-Node: Uniq Program708885
-Node: Wc Program716311
-Ref: Wc Program-Footnote-1720566
-Node: Miscellaneous Programs720660
-Node: Dupword Program721873
-Node: Alarm Program723903
-Node: Translate Program728758
-Ref: Translate Program-Footnote-1733323
-Node: Labels Program733593
-Ref: Labels Program-Footnote-1736944
-Node: Word Sorting737028
-Node: History Sorting741100
-Node: Extract Program742935
-Node: Simple Sed750464
-Node: Igawk Program753538
-Ref: Igawk Program-Footnote-1767869
-Ref: Igawk Program-Footnote-2768071
-Ref: Igawk Program-Footnote-3768193
-Node: Anagram Program768308
-Node: Signature Program771370
-Node: Programs Summary772617
-Node: Programs Exercises773831
-Ref: Programs Exercises-Footnote-1777960
-Node: Advanced Features778051
-Node: Nondecimal Data780041
-Node: Array Sorting781632
-Node: Controlling Array Traversal782332
-Ref: Controlling Array Traversal-Footnote-1790699
-Node: Array Sorting Functions790817
-Ref: Array Sorting Functions-Footnote-1795908
-Node: Two-way I/O796104
-Ref: Two-way I/O-Footnote-1802398
-Ref: Two-way I/O-Footnote-2802585
-Node: TCP/IP Networking802667
-Node: Profiling805785
-Node: Advanced Features Summary813324
-Node: Internationalization815260
-Node: I18N and L10N816740
-Node: Explaining gettext817427
-Ref: Explaining gettext-Footnote-1823319
-Ref: Explaining gettext-Footnote-2823504
-Node: Programmer i18n823669
-Ref: Programmer i18n-Footnote-1828524
-Node: Translator i18n828573
-Node: String Extraction829367
-Ref: String Extraction-Footnote-1830499
-Node: Printf Ordering830585
-Ref: Printf Ordering-Footnote-1833371
-Node: I18N Portability833435
-Ref: I18N Portability-Footnote-1835891
-Node: I18N Example835954
-Ref: I18N Example-Footnote-1838760
-Node: Gawk I18N838833
-Node: I18N Summary839478
-Node: Debugger840819
-Node: Debugging841841
-Node: Debugging Concepts842282
-Node: Debugging Terms844091
-Node: Awk Debugging846666
-Node: Sample Debugging Session847572
-Node: Debugger Invocation848106
-Node: Finding The Bug849492
-Node: List of Debugger Commands855970
-Node: Breakpoint Control857303
-Node: Debugger Execution Control860997
-Node: Viewing And Changing Data864359
-Node: Execution Stack867733
-Node: Debugger Info869370
-Node: Miscellaneous Debugger Commands873441
-Node: Readline Support878529
-Node: Limitations879425
-Node: Debugging Summary881534
-Node: Arbitrary Precision Arithmetic882707
-Node: Computer Arithmetic884123
-Ref: table-numeric-ranges887714
-Ref: Computer Arithmetic-Footnote-1888436
-Node: Math Definitions888493
-Ref: table-ieee-formats891807
-Ref: Math Definitions-Footnote-1892410
-Node: MPFR features892515
-Node: FP Math Caution894232
-Ref: FP Math Caution-Footnote-1895304
-Node: Inexactness of computations895673
-Node: Inexact representation896633
-Node: Comparing FP Values897993
-Node: Errors accumulate899075
-Node: Getting Accuracy900508
-Node: Try To Round903218
-Node: Setting precision904117
-Ref: table-predefined-precision-strings904814
-Node: Setting the rounding mode906644
-Ref: table-gawk-rounding-modes907018
-Ref: Setting the rounding mode-Footnote-1910426
-Node: Arbitrary Precision Integers910605
-Ref: Arbitrary Precision Integers-Footnote-1913589
-Node: POSIX Floating Point Problems913738
-Ref: POSIX Floating Point Problems-Footnote-1917620
-Node: Floating point summary917658
-Node: Dynamic Extensions919848
-Node: Extension Intro921401
-Node: Plugin License922667
-Node: Extension Mechanism Outline923464
-Ref: figure-load-extension923903
-Ref: figure-register-new-function925468
-Ref: figure-call-new-function926560
-Node: Extension API Description928622
-Node: Extension API Functions Introduction930070
-Node: General Data Types934882
-Ref: General Data Types-Footnote-1940837
-Node: Memory Allocation Functions941136
-Ref: Memory Allocation Functions-Footnote-1943981
-Node: Constructor Functions944080
-Node: Registration Functions945825
-Node: Extension Functions946510
-Node: Exit Callback Functions948809
-Node: Extension Version String950059
-Node: Input Parsers950722
-Node: Output Wrappers960604
-Node: Two-way processors965116
-Node: Printing Messages967381
-Ref: Printing Messages-Footnote-1968455
-Node: Updating ERRNO968608
-Node: Requesting Values969347
-Ref: table-value-types-returned970084
-Node: Accessing Parameters970967
-Node: Symbol Table Access972202
-Node: Symbol table by name972714
-Node: Symbol table by cookie974735
-Ref: Symbol table by cookie-Footnote-1978887
-Node: Cached values978951
-Ref: Cached values-Footnote-1982458
-Node: Array Manipulation982549
-Ref: Array Manipulation-Footnote-1983648
-Node: Array Data Types983685
-Ref: Array Data Types-Footnote-1986343
-Node: Array Functions986435
-Node: Flattening Arrays990293
-Node: Creating Arrays997201
-Node: Extension API Variables1001970
-Node: Extension Versioning1002606
-Ref: gawk-api-version1003043
-Node: Extension API Informational Variables1004799
-Node: Extension API Boilerplate1005863
-Node: Finding Extensions1009677
-Node: Extension Example1010236
-Node: Internal File Description1011034
-Node: Internal File Ops1015114
-Ref: Internal File Ops-Footnote-11026876
-Node: Using Internal File Ops1027016
-Ref: Using Internal File Ops-Footnote-11029399
-Node: Extension Samples1029673
-Node: Extension Sample File Functions1031202
-Node: Extension Sample Fnmatch1038851
-Node: Extension Sample Fork1040338
-Node: Extension Sample Inplace1041556
-Node: Extension Sample Ord1044766
-Node: Extension Sample Readdir1045602
-Ref: table-readdir-file-types1046491
-Node: Extension Sample Revout1047296
-Node: Extension Sample Rev2way1047885
-Node: Extension Sample Read write array1048625
-Node: Extension Sample Readfile1050567
-Node: Extension Sample Time1051662
-Node: Extension Sample API Tests1053010
-Node: gawkextlib1053502
-Node: Extension summary1055926
-Node: Extension Exercises1059618
-Node: Language History1061116
-Node: V7/SVR3.11062772
-Node: SVR41064924
-Node: POSIX1066358
-Node: BTL1067737
-Node: POSIX/GNU1068466
-Node: Feature History1073987
-Node: Common Extensions1087316
-Node: Ranges and Locales1088599
-Ref: Ranges and Locales-Footnote-11093215
-Ref: Ranges and Locales-Footnote-21093242
-Ref: Ranges and Locales-Footnote-31093477
-Node: Contributors1093698
-Node: History summary1099258
-Node: Installation1100638
-Node: Gawk Distribution1101582
-Node: Getting1102066
-Node: Extracting1103027
-Node: Distribution contents1104665
-Node: Unix Installation1110416
-Node: Quick Installation1111032
-Node: Additional Configuration Options1113459
-Node: Configuration Philosophy1115263
-Node: Non-Unix Installation1117632
-Node: PC Installation1118090
-Node: PC Binary Installation1119410
-Node: PC Compiling1121262
-Ref: PC Compiling-Footnote-11124056
-Node: PC Testing1124165
-Node: PC Using1125345
-Ref: PC Using-Footnote-11129498
-Node: Cygwin1129571
-Node: MSYS1130341
-Node: VMS Installation1130842
-Node: VMS Compilation1131633
-Ref: VMS Compilation-Footnote-11132862
-Node: VMS Dynamic Extensions1132920
-Node: VMS Installation Details1134605
-Node: VMS Running1136858
-Node: VMS GNV1141137
-Node: VMS Old Gawk1141872
-Node: Bugs1142343
-Node: Other Versions1146658
-Node: Installation summary1153242
-Node: Notes1154293
-Node: Compatibility Mode1155158
-Node: Additions1155940
-Node: Accessing The Source1156865
-Node: Adding Code1158300
-Node: New Ports1164519
-Node: Derived Files1169007
-Ref: Derived Files-Footnote-11174492
-Ref: Derived Files-Footnote-21174527
-Ref: Derived Files-Footnote-31175125
-Node: Future Extensions1175239
-Node: Implementation Limitations1175897
-Node: Extension Design1177080
-Node: Old Extension Problems1178234
-Ref: Old Extension Problems-Footnote-11179752
-Node: Extension New Mechanism Goals1179809
-Ref: Extension New Mechanism Goals-Footnote-11183173
-Node: Extension Other Design Decisions1183362
-Node: Extension Future Growth1185475
-Node: Old Extension Mechanism1186311
-Node: Notes summary1188074
-Node: Basic Concepts1189256
-Node: Basic High Level1189937
-Ref: figure-general-flow1190219
-Ref: figure-process-flow1190904
-Ref: Basic High Level-Footnote-11194205
-Node: Basic Data Typing1194390
-Node: Glossary1197718
-Node: Copying1229665
-Node: GNU Free Documentation License1267204
-Node: Index1292322
+Node: Foreword342345
+Node: Foreword446787
+Node: Preface48319
+Ref: Preface-Footnote-151191
+Ref: Preface-Footnote-251298
+Ref: Preface-Footnote-351532
+Node: History51674
+Node: Names54026
+Ref: Names-Footnote-155120
+Node: This Manual55267
+Ref: This Manual-Footnote-161752
+Node: Conventions61852
+Node: Manual History64206
+Ref: Manual History-Footnote-167201
+Ref: Manual History-Footnote-267242
+Node: How To Contribute67316
+Node: Acknowledgments68445
+Node: Getting Started73331
+Node: Running gawk75770
+Node: One-shot76960
+Node: Read Terminal78223
+Node: Long80255
+Node: Executable Scripts81768
+Ref: Executable Scripts-Footnote-184563
+Node: Comments84666
+Node: Quoting87150
+Node: DOS Quoting92667
+Node: Sample Data Files93342
+Node: Very Simple95937
+Node: Two Rules100839
+Node: More Complex102724
+Node: Statements/Lines105590
+Ref: Statements/Lines-Footnote-1110049
+Node: Other Features110314
+Node: When111250
+Ref: When-Footnote-1113004
+Node: Intro Summary113069
+Node: Invoking Gawk113953
+Node: Command Line115467
+Node: Options116265
+Ref: Options-Footnote-1132172
+Ref: Options-Footnote-2132402
+Node: Other Arguments132427
+Node: Naming Standard Input135374
+Node: Environment Variables136467
+Node: AWKPATH Variable137025
+Ref: AWKPATH Variable-Footnote-1140326
+Ref: AWKPATH Variable-Footnote-2140371
+Node: AWKLIBPATH Variable140632
+Node: Other Environment Variables141776
+Node: Exit Status145724
+Node: Include Files146401
+Node: Loading Shared Libraries149996
+Node: Obsolete151424
+Node: Undocumented152116
+Node: Invoking Summary152413
+Node: Regexp154073
+Node: Regexp Usage155527
+Node: Escape Sequences157564
+Node: Regexp Operators163578
+Ref: Regexp Operators-Footnote-1170994
+Ref: Regexp Operators-Footnote-2171141
+Node: Bracket Expressions171239
+Ref: table-char-classes173715
+Node: Leftmost Longest176852
+Node: Computed Regexps178155
+Node: GNU Regexp Operators181582
+Node: Case-sensitivity185261
+Ref: Case-sensitivity-Footnote-1188148
+Ref: Case-sensitivity-Footnote-2188383
+Node: Regexp Summary188491
+Node: Reading Files189957
+Node: Records192051
+Node: awk split records192784
+Node: gawk split records197715
+Ref: gawk split records-Footnote-1202255
+Node: Fields202292
+Ref: Fields-Footnote-1205072
+Node: Nonconstant Fields205158
+Ref: Nonconstant Fields-Footnote-1207394
+Node: Changing Fields207598
+Node: Field Separators213526
+Node: Default Field Splitting216224
+Node: Regexp Field Splitting217342
+Node: Single Character Fields220695
+Node: Command Line Field Separator221755
+Node: Full Line Fields224973
+Ref: Full Line Fields-Footnote-1226495
+Ref: Full Line Fields-Footnote-2226541
+Node: Field Splitting Summary226642
+Node: Constant Size228716
+Node: Splitting By Content233294
+Ref: Splitting By Content-Footnote-1237265
+Node: Multiple Line237428
+Ref: Multiple Line-Footnote-1243310
+Node: Getline243489
+Node: Plain Getline245693
+Node: Getline/Variable248332
+Node: Getline/File249481
+Node: Getline/Variable/File250867
+Ref: Getline/Variable/File-Footnote-1252470
+Node: Getline/Pipe252558
+Node: Getline/Variable/Pipe255263
+Node: Getline/Coprocess256396
+Node: Getline/Variable/Coprocess257661
+Node: Getline Notes258401
+Node: Getline Summary261196
+Ref: table-getline-variants261618
+Node: Read Timeout262366
+Ref: Read Timeout-Footnote-1266207
+Node: Command-line directories266265
+Node: Input Summary267169
+Node: Input Exercises270341
+Node: Printing271069
+Node: Print272845
+Node: Print Examples274302
+Node: Output Separators277082
+Node: OFMT279099
+Node: Printf280455
+Node: Basic Printf281240
+Node: Control Letters282814
+Node: Format Modifiers286802
+Node: Printf Examples292817
+Node: Redirection295303
+Node: Special FD302144
+Ref: Special FD-Footnote-1305312
+Node: Special Files305386
+Node: Other Inherited Files306003
+Node: Special Network307004
+Node: Special Caveats307864
+Node: Close Files And Pipes308813
+Ref: Close Files And Pipes-Footnote-1316006
+Ref: Close Files And Pipes-Footnote-2316154
+Node: Output Summary316305
+Node: Output Exercises317303
+Node: Expressions317982
+Node: Values319170
+Node: Constants319848
+Node: Scalar Constants320539
+Ref: Scalar Constants-Footnote-1321403
+Node: Nondecimal-numbers321653
+Node: Regexp Constants324666
+Node: Using Constant Regexps325192
+Node: Variables328355
+Node: Using Variables329012
+Node: Assignment Options330922
+Node: Conversion332795
+Node: Strings And Numbers333319
+Ref: Strings And Numbers-Footnote-1336382
+Node: Locale influences conversions336491
+Ref: table-locale-affects339249
+Node: All Operators339867
+Node: Arithmetic Ops340496
+Node: Concatenation343002
+Ref: Concatenation-Footnote-1345849
+Node: Assignment Ops345956
+Ref: table-assign-ops350947
+Node: Increment Ops352260
+Node: Truth Values and Conditions355720
+Node: Truth Values356794
+Node: Typing and Comparison357842
+Node: Variable Typing358662
+Node: Comparison Operators362286
+Ref: table-relational-ops362705
+Node: POSIX String Comparison366200
+Ref: POSIX String Comparison-Footnote-1367274
+Node: Boolean Ops367413
+Ref: Boolean Ops-Footnote-1371895
+Node: Conditional Exp371987
+Node: Function Calls373723
+Node: Precedence377600
+Node: Locales381259
+Node: Expressions Summary382891
+Node: Patterns and Actions385464
+Node: Pattern Overview386584
+Node: Regexp Patterns388261
+Node: Expression Patterns388803
+Node: Ranges392584
+Node: BEGIN/END395692
+Node: Using BEGIN/END396453
+Ref: Using BEGIN/END-Footnote-1399189
+Node: I/O And BEGIN/END399295
+Node: BEGINFILE/ENDFILE401609
+Node: Empty404516
+Node: Using Shell Variables404833
+Node: Action Overview407107
+Node: Statements409432
+Node: If Statement411280
+Node: While Statement412775
+Node: Do Statement414803
+Node: For Statement415951
+Node: Switch Statement419109
+Node: Break Statement421495
+Node: Continue Statement423587
+Node: Next Statement425414
+Node: Nextfile Statement427797
+Node: Exit Statement430449
+Node: Built-in Variables432852
+Node: User-modified433985
+Ref: User-modified-Footnote-1441610
+Node: Auto-set441672
+Ref: Auto-set-Footnote-1455028
+Ref: Auto-set-Footnote-2455234
+Node: ARGC and ARGV455290
+Node: Pattern Action Summary459503
+Node: Arrays461933
+Node: Array Basics463262
+Node: Array Intro464106
+Ref: figure-array-elements466081
+Ref: Array Intro-Footnote-1468785
+Node: Reference to Elements468913
+Node: Assigning Elements471377
+Node: Array Example471868
+Node: Scanning an Array473627
+Node: Controlling Scanning476649
+Ref: Controlling Scanning-Footnote-1482048
+Node: Numeric Array Subscripts482364
+Node: Uninitialized Subscripts484548
+Node: Delete486167
+Ref: Delete-Footnote-1488919
+Node: Multidimensional488976
+Node: Multiscanning492071
+Node: Arrays of Arrays493662
+Node: Arrays Summary498429
+Node: Functions500522
+Node: Built-in501560
+Node: Calling Built-in502641
+Node: Numeric Functions504637
+Ref: Numeric Functions-Footnote-1508665
+Ref: Numeric Functions-Footnote-2509022
+Ref: Numeric Functions-Footnote-3509070
+Node: String Functions509342
+Ref: String Functions-Footnote-1532846
+Ref: String Functions-Footnote-2532974
+Ref: String Functions-Footnote-3533222
+Node: Gory Details533309
+Ref: table-sub-escapes535100
+Ref: table-sub-proposed536619
+Ref: table-posix-sub537982
+Ref: table-gensub-escapes539523
+Ref: Gory Details-Footnote-1540346
+Node: I/O Functions540500
+Ref: table-system-return-values547082
+Ref: I/O Functions-Footnote-1549062
+Ref: I/O Functions-Footnote-2549210
+Node: Time Functions549330
+Ref: Time Functions-Footnote-1559852
+Ref: Time Functions-Footnote-2559920
+Ref: Time Functions-Footnote-3560078
+Ref: Time Functions-Footnote-4560189
+Ref: Time Functions-Footnote-5560301
+Ref: Time Functions-Footnote-6560528
+Node: Bitwise Functions560794
+Ref: table-bitwise-ops561388
+Ref: Bitwise Functions-Footnote-1565726
+Node: Type Functions565899
+Node: I18N Functions567055
+Node: User-defined568706
+Node: Definition Syntax569511
+Ref: Definition Syntax-Footnote-1575198
+Node: Function Example575269
+Ref: Function Example-Footnote-1578191
+Node: Function Caveats578213
+Node: Calling A Function578731
+Node: Variable Scope579689
+Node: Pass By Value/Reference582683
+Node: Return Statement586182
+Node: Dynamic Typing589161
+Node: Indirect Calls590091
+Ref: Indirect Calls-Footnote-1600342
+Node: Functions Summary600470
+Node: Library Functions603175
+Ref: Library Functions-Footnote-1606782
+Ref: Library Functions-Footnote-2606925
+Node: Library Names607096
+Ref: Library Names-Footnote-1610556
+Ref: Library Names-Footnote-2610779
+Node: General Functions610865
+Node: Strtonum Function611968
+Node: Assert Function614990
+Node: Round Function618316
+Node: Cliff Random Function619857
+Node: Ordinal Functions620873
+Ref: Ordinal Functions-Footnote-1623936
+Ref: Ordinal Functions-Footnote-2624188
+Node: Join Function624398
+Ref: Join Function-Footnote-1626168
+Node: Getlocaltime Function626368
+Node: Readfile Function630110
+Node: Shell Quoting632082
+Node: Data File Management633483
+Node: Filetrans Function634115
+Node: Rewind Function638211
+Node: File Checking640117
+Ref: File Checking-Footnote-1641451
+Node: Empty Files641652
+Node: Ignoring Assigns643631
+Node: Getopt Function645181
+Ref: Getopt Function-Footnote-1656650
+Node: Passwd Functions656850
+Ref: Passwd Functions-Footnote-1665689
+Node: Group Functions665777
+Ref: Group Functions-Footnote-1673675
+Node: Walking Arrays673882
+Node: Library Functions Summary676890
+Node: Library Exercises678296
+Node: Sample Programs678761
+Node: Running Examples679531
+Node: Clones680259
+Node: Cut Program681483
+Node: Egrep Program691412
+Ref: Egrep Program-Footnote-1698924
+Node: Id Program699034
+Node: Split Program702714
+Ref: Split Program-Footnote-1706173
+Node: Tee Program706302
+Node: Uniq Program709092
+Node: Wc Program716518
+Ref: Wc Program-Footnote-1720773
+Node: Miscellaneous Programs720867
+Node: Dupword Program722080
+Node: Alarm Program724110
+Node: Translate Program728965
+Ref: Translate Program-Footnote-1733530
+Node: Labels Program733800
+Ref: Labels Program-Footnote-1737151
+Node: Word Sorting737235
+Node: History Sorting741307
+Node: Extract Program743142
+Node: Simple Sed750671
+Node: Igawk Program753745
+Ref: Igawk Program-Footnote-1768076
+Ref: Igawk Program-Footnote-2768278
+Ref: Igawk Program-Footnote-3768400
+Node: Anagram Program768515
+Node: Signature Program771577
+Node: Programs Summary772824
+Node: Programs Exercises774038
+Ref: Programs Exercises-Footnote-1778167
+Node: Advanced Features778258
+Node: Nondecimal Data780248
+Node: Array Sorting781839
+Node: Controlling Array Traversal782539
+Ref: Controlling Array Traversal-Footnote-1790906
+Node: Array Sorting Functions791024
+Ref: Array Sorting Functions-Footnote-1796115
+Node: Two-way I/O796311
+Ref: Two-way I/O-Footnote-1802605
+Ref: Two-way I/O-Footnote-2802792
+Node: TCP/IP Networking802874
+Node: Profiling805992
+Node: Advanced Features Summary813531
+Node: Internationalization815467
+Node: I18N and L10N816947
+Node: Explaining gettext817634
+Ref: Explaining gettext-Footnote-1823526
+Ref: Explaining gettext-Footnote-2823711
+Node: Programmer i18n823876
+Ref: Programmer i18n-Footnote-1828731
+Node: Translator i18n828780
+Node: String Extraction829574
+Ref: String Extraction-Footnote-1830706
+Node: Printf Ordering830792
+Ref: Printf Ordering-Footnote-1833578
+Node: I18N Portability833642
+Ref: I18N Portability-Footnote-1836098
+Node: I18N Example836161
+Ref: I18N Example-Footnote-1838967
+Node: Gawk I18N839040
+Node: I18N Summary839685
+Node: Debugger841026
+Node: Debugging842048
+Node: Debugging Concepts842489
+Node: Debugging Terms844298
+Node: Awk Debugging846873
+Node: Sample Debugging Session847779
+Node: Debugger Invocation848313
+Node: Finding The Bug849699
+Node: List of Debugger Commands856177
+Node: Breakpoint Control857510
+Node: Debugger Execution Control861204
+Node: Viewing And Changing Data864566
+Node: Execution Stack867940
+Node: Debugger Info869577
+Node: Miscellaneous Debugger Commands873648
+Node: Readline Support878736
+Node: Limitations879632
+Node: Debugging Summary881741
+Node: Arbitrary Precision Arithmetic882914
+Node: Computer Arithmetic884330
+Ref: table-numeric-ranges887921
+Ref: Computer Arithmetic-Footnote-1888643
+Node: Math Definitions888700
+Ref: table-ieee-formats892014
+Ref: Math Definitions-Footnote-1892617
+Node: MPFR features892722
+Node: FP Math Caution894439
+Ref: FP Math Caution-Footnote-1895511
+Node: Inexactness of computations895880
+Node: Inexact representation896840
+Node: Comparing FP Values898200
+Node: Errors accumulate899282
+Node: Getting Accuracy900715
+Node: Try To Round903425
+Node: Setting precision904324
+Ref: table-predefined-precision-strings905021
+Node: Setting the rounding mode906851
+Ref: table-gawk-rounding-modes907225
+Ref: Setting the rounding mode-Footnote-1910633
+Node: Arbitrary Precision Integers910812
+Ref: Arbitrary Precision Integers-Footnote-1913796
+Node: POSIX Floating Point Problems913945
+Ref: POSIX Floating Point Problems-Footnote-1917827
+Node: Floating point summary917865
+Node: Dynamic Extensions920055
+Node: Extension Intro921608
+Node: Plugin License922874
+Node: Extension Mechanism Outline923671
+Ref: figure-load-extension924110
+Ref: figure-register-new-function925675
+Ref: figure-call-new-function926767
+Node: Extension API Description928829
+Node: Extension API Functions Introduction930277
+Node: General Data Types935089
+Ref: General Data Types-Footnote-1941044
+Node: Memory Allocation Functions941343
+Ref: Memory Allocation Functions-Footnote-1944188
+Node: Constructor Functions944287
+Node: Registration Functions946032
+Node: Extension Functions946717
+Node: Exit Callback Functions949016
+Node: Extension Version String950266
+Node: Input Parsers950929
+Node: Output Wrappers960811
+Node: Two-way processors965323
+Node: Printing Messages967588
+Ref: Printing Messages-Footnote-1968662
+Node: Updating ERRNO968815
+Node: Requesting Values969554
+Ref: table-value-types-returned970291
+Node: Accessing Parameters971174
+Node: Symbol Table Access972409
+Node: Symbol table by name972921
+Node: Symbol table by cookie974942
+Ref: Symbol table by cookie-Footnote-1979094
+Node: Cached values979158
+Ref: Cached values-Footnote-1982665
+Node: Array Manipulation982756
+Ref: Array Manipulation-Footnote-1983855
+Node: Array Data Types983892
+Ref: Array Data Types-Footnote-1986550
+Node: Array Functions986642
+Node: Flattening Arrays990500
+Node: Creating Arrays997408
+Node: Extension API Variables1002177
+Node: Extension Versioning1002813
+Ref: gawk-api-version1003250
+Node: Extension API Informational Variables1005006
+Node: Extension API Boilerplate1006070
+Node: Finding Extensions1009884
+Node: Extension Example1010443
+Node: Internal File Description1011241
+Node: Internal File Ops1015321
+Ref: Internal File Ops-Footnote-11027083
+Node: Using Internal File Ops1027223
+Ref: Using Internal File Ops-Footnote-11029606
+Node: Extension Samples1029880
+Node: Extension Sample File Functions1031409
+Node: Extension Sample Fnmatch1039058
+Node: Extension Sample Fork1040545
+Node: Extension Sample Inplace1041763
+Node: Extension Sample Ord1044973
+Node: Extension Sample Readdir1045809
+Ref: table-readdir-file-types1046698
+Node: Extension Sample Revout1047503
+Node: Extension Sample Rev2way1048092
+Node: Extension Sample Read write array1048832
+Node: Extension Sample Readfile1050774
+Node: Extension Sample Time1051869
+Node: Extension Sample API Tests1053217
+Node: gawkextlib1053709
+Node: Extension summary1056133
+Node: Extension Exercises1059825
+Node: Language History1061323
+Node: V7/SVR3.11062979
+Node: SVR41065131
+Node: POSIX1066565
+Node: BTL1067944
+Node: POSIX/GNU1068673
+Node: Feature History1074194
+Node: Common Extensions1087523
+Node: Ranges and Locales1088806
+Ref: Ranges and Locales-Footnote-11093422
+Ref: Ranges and Locales-Footnote-21093449
+Ref: Ranges and Locales-Footnote-31093684
+Node: Contributors1093905
+Node: History summary1099465
+Node: Installation1100845
+Node: Gawk Distribution1101789
+Node: Getting1102273
+Node: Extracting1103234
+Node: Distribution contents1104872
+Node: Unix Installation1110623
+Node: Quick Installation1111239
+Node: Additional Configuration Options1113666
+Node: Configuration Philosophy1115470
+Node: Non-Unix Installation1117839
+Node: PC Installation1118297
+Node: PC Binary Installation1119617
+Node: PC Compiling1121469
+Ref: PC Compiling-Footnote-11124263
+Node: PC Testing1124372
+Node: PC Using1125552
+Ref: PC Using-Footnote-11129705
+Node: Cygwin1129778
+Node: MSYS1130548
+Node: VMS Installation1131049
+Node: VMS Compilation1131840
+Ref: VMS Compilation-Footnote-11133069
+Node: VMS Dynamic Extensions1133127
+Node: VMS Installation Details1134812
+Node: VMS Running1137065
+Node: VMS GNV1141344
+Node: VMS Old Gawk1142079
+Node: Bugs1142550
+Node: Bug address1143213
+Node: Usenet1145610
+Node: Maintainers1146385
+Node: Other Versions1147761
+Node: Installation summary1154345
+Node: Notes1155396
+Node: Compatibility Mode1156261
+Node: Additions1157043
+Node: Accessing The Source1157968
+Node: Adding Code1159403
+Node: New Ports1165622
+Node: Derived Files1170110
+Ref: Derived Files-Footnote-11175595
+Ref: Derived Files-Footnote-21175630
+Ref: Derived Files-Footnote-31176228
+Node: Future Extensions1176342
+Node: Implementation Limitations1177000
+Node: Extension Design1178183
+Node: Old Extension Problems1179337
+Ref: Old Extension Problems-Footnote-11180855
+Node: Extension New Mechanism Goals1180912
+Ref: Extension New Mechanism Goals-Footnote-11184276
+Node: Extension Other Design Decisions1184465
+Node: Extension Future Growth1186578
+Node: Old Extension Mechanism1187414
+Node: Notes summary1189177
+Node: Basic Concepts1190359
+Node: Basic High Level1191040
+Ref: figure-general-flow1191322
+Ref: figure-process-flow1192007
+Ref: Basic High Level-Footnote-11195308
+Node: Basic Data Typing1195493
+Node: Glossary1198821
+Node: Copying1230768
+Node: GNU Free Documentation License1268307
+Node: Index1293425
 
 End Tag Table
diff --git a/doc/gawk.texi b/doc/gawk.texi
index e4a15076..fe3be3bc 100644
--- a/doc/gawk.texi
+++ b/doc/gawk.texi
@@ -1007,6 +1007,9 @@ particular records in a file and perform operations upon them.
 * VMS Old Gawk::                        An old version comes with some VMS
                                         systems.
 * Bugs::                                Reporting Problems and Bugs.
+* Bug address::                         Where to send reports to.
+* Usenet::                              Where not to send reports to.
+* Maintainers::                         Maintainers of non-*nix ports.
 * Other Versions::                      Other freely available @command{awk}
                                         implementations.
 * Installation summary::                Summary of installation.
@@ -38329,7 +38332,6 @@ $ @kbd{gawk :== $sys$common:[syshlp.examples.tcpip.snmp]gawk.exe}
 This is apparently @value{PVERSION} 2.15.6, which is extremely old. We
 recommend compiling and using the current version.
 
-
 @node Bugs
 @appendixsec Reporting Problems and Bugs
 @cindex archaeologists
@@ -38345,6 +38347,15 @@ If you have problems with @command{gawk} or think that you have found a bug,
 report it to the developers; we cannot promise to do anything,
 but we might well want to fix it.
 
+@menu
+* Bug address::                 Where to send reports to.
+* Usenet::                      Where not to send reports to.
+* Maintainers::                 Maintainers of non-*nix ports.
+@end menu
+
+@node Bug address
+@appendixsubsec Submitting Bug Reports
+
 Before reporting a bug, make sure you have really found a genuine bug.
 Carefully reread the documentation and see if it says you can do
 what you're trying to do.  If it's not clear whether you should be able
@@ -38377,40 +38388,6 @@ understood in common by all the maintainers.}
 In addition, please be sure to send all mail in @emph{plain text},
 not (or not exclusively) in HTML.
 
-@cindex @code{comp.lang.awk} newsgroup
-@quotation CAUTION
-Do @emph{not} try to report bugs in @command{gawk} by
-posting to the Usenet/Internet newsgroup @code{comp.lang.awk}.
-The @command{gawk} developers do occasionally read this newsgroup,
-but there is no guarantee that we will see your posting.  The steps described
-here are the only officially recognized way for reporting bugs.
-Really.
-@end quotation
-
-@ignore
-Date: Sun, 17 May 2015 19:50:14 -0400
-From: Chet Ramey <chet.ramey@case.edu>
-Reply-To: chet.ramey@case.edu
-Organization: ITS, Case Western Reserve University
-To: Aharon Robbins <arnold@skeeve.com>
-CC: chet.ramey@case.edu
-
-....
-I gave up on usenet a couple of years ago and haven't really looked back.
-It's like sports talk radio -- you feel smarter for not having read it.
-
-And another one:
-
-Date: Thu, 11 Jun 2015 09:00:56 -0400
-From: Chet Ramey <chet.ramey@case.edu>
-
-My memory was imperfect.  Back in June 2009, I wrote:
-
-"That's the nice thing about open source, right?  You can take your ball
-and run to another section of the playground.  Then, if you like mixing
-metaphors, you can throw rocks from there."
-@end ignore
-
 @quotation NOTE
 Many distributions of GNU/Linux and the various BSD-based operating systems
 have their own bug reporting systems.  If you report a bug using your distribution's
@@ -38428,6 +38405,45 @@ Non-bug suggestions are always welcome as well.  If you have questions
 about things that are unclear in the documentation or are just obscure
 features, ask on the bug list; we will try to help you out if we can.
 
+@node Usenet
+@appendixsubsec Please Don't Post Bug Reports to USENET
+
+@quotation
+@c Date: Sun, 17 May 2015 19:50:14 -0400
+@c From: Chet Ramey <chet.ramey@case.edu>
+@c Reply-To: chet.ramey@case.edu
+@c Organization: ITS, Case Western Reserve University
+@c To: Aharon Robbins <arnold@skeeve.com>
+@c CC: chet.ramey@case.edu
+I gave up on Usenet a couple of years ago and haven't really looked back.
+It's like sports talk radio---you feel smarter for not having read it.
+@author Chet Ramey
+@end quotation
+
+@cindex @code{comp.lang.awk} newsgroup
+Please do @emph{not} try to report bugs in @command{gawk} by posting to the
+Usenet/Internet newsgroup @code{comp.lang.awk}.  Although some of the
+@command{gawk} developers occasionally read this newgroup, the primary
+@command{gawk} maintainer no longer does.  Thus it's virtually guaranteed
+that he will @emph{not} see your posting.  The steps described here are
+the only officially recognized way for reporting bugs.  Really.
+
+@ignore
+And another one:
+
+Date: Thu, 11 Jun 2015 09:00:56 -0400
+From: Chet Ramey <chet.ramey@case.edu>
+
+My memory was imperfect.  Back in June 2009, I wrote:
+
+"That's the nice thing about open source, right?  You can take your ball
+and run to another section of the playground.  Then, if you like mixing
+metaphors, you can throw rocks from there."
+@end ignore
+
+@node Maintainers
+@appendixsubsec Reporting Problems with Non-Unix Ports
+
 If you find bugs in one of the non-Unix ports of @command{gawk},
 send an email to the bug list, with a copy to the
 person who maintains that port.  The maintainers are named in the following list,
diff --git a/doc/gawktexi.in b/doc/gawktexi.in
index 29af53e4..509b17d3 100644
--- a/doc/gawktexi.in
+++ b/doc/gawktexi.in
@@ -1002,6 +1002,9 @@ particular records in a file and perform operations upon them.
 * VMS Old Gawk::                        An old version comes with some VMS
                                         systems.
 * Bugs::                                Reporting Problems and Bugs.
+* Bug address::                         Where to send reports to.
+* Usenet::                              Where not to send reports to.
+* Maintainers::                         Maintainers of non-*nix ports.
 * Other Versions::                      Other freely available @command{awk}
                                         implementations.
 * Installation summary::                Summary of installation.
@@ -37420,7 +37423,6 @@ $ @kbd{gawk :== $sys$common:[syshlp.examples.tcpip.snmp]gawk.exe}
 This is apparently @value{PVERSION} 2.15.6, which is extremely old. We
 recommend compiling and using the current version.
 
-
 @node Bugs
 @appendixsec Reporting Problems and Bugs
 @cindex archaeologists
@@ -37436,6 +37438,15 @@ If you have problems with @command{gawk} or think that you have found a bug,
 report it to the developers; we cannot promise to do anything,
 but we might well want to fix it.
 
+@menu
+* Bug address::                 Where to send reports to.
+* Usenet::                      Where not to send reports to.
+* Maintainers::                 Maintainers of non-*nix ports.
+@end menu
+
+@node Bug address
+@appendixsubsec Submitting Bug Reports
+
 Before reporting a bug, make sure you have really found a genuine bug.
 Carefully reread the documentation and see if it says you can do
 what you're trying to do.  If it's not clear whether you should be able
@@ -37468,40 +37479,6 @@ understood in common by all the maintainers.}
 In addition, please be sure to send all mail in @emph{plain text},
 not (or not exclusively) in HTML.
 
-@cindex @code{comp.lang.awk} newsgroup
-@quotation CAUTION
-Do @emph{not} try to report bugs in @command{gawk} by
-posting to the Usenet/Internet newsgroup @code{comp.lang.awk}.
-The @command{gawk} developers do occasionally read this newsgroup,
-but there is no guarantee that we will see your posting.  The steps described
-here are the only officially recognized way for reporting bugs.
-Really.
-@end quotation
-
-@ignore
-Date: Sun, 17 May 2015 19:50:14 -0400
-From: Chet Ramey <chet.ramey@case.edu>
-Reply-To: chet.ramey@case.edu
-Organization: ITS, Case Western Reserve University
-To: Aharon Robbins <arnold@skeeve.com>
-CC: chet.ramey@case.edu
-
-....
-I gave up on usenet a couple of years ago and haven't really looked back.
-It's like sports talk radio -- you feel smarter for not having read it.
-
-And another one:
-
-Date: Thu, 11 Jun 2015 09:00:56 -0400
-From: Chet Ramey <chet.ramey@case.edu>
-
-My memory was imperfect.  Back in June 2009, I wrote:
-
-"That's the nice thing about open source, right?  You can take your ball
-and run to another section of the playground.  Then, if you like mixing
-metaphors, you can throw rocks from there."
-@end ignore
-
 @quotation NOTE
 Many distributions of GNU/Linux and the various BSD-based operating systems
 have their own bug reporting systems.  If you report a bug using your distribution's
@@ -37519,6 +37496,45 @@ Non-bug suggestions are always welcome as well.  If you have questions
 about things that are unclear in the documentation or are just obscure
 features, ask on the bug list; we will try to help you out if we can.
 
+@node Usenet
+@appendixsubsec Please Don't Post Bug Reports to USENET
+
+@quotation
+@c Date: Sun, 17 May 2015 19:50:14 -0400
+@c From: Chet Ramey <chet.ramey@case.edu>
+@c Reply-To: chet.ramey@case.edu
+@c Organization: ITS, Case Western Reserve University
+@c To: Aharon Robbins <arnold@skeeve.com>
+@c CC: chet.ramey@case.edu
+I gave up on Usenet a couple of years ago and haven't really looked back.
+It's like sports talk radio---you feel smarter for not having read it.
+@author Chet Ramey
+@end quotation
+
+@cindex @code{comp.lang.awk} newsgroup
+Please do @emph{not} try to report bugs in @command{gawk} by posting to the
+Usenet/Internet newsgroup @code{comp.lang.awk}.  Although some of the
+@command{gawk} developers occasionally read this newgroup, the primary
+@command{gawk} maintainer no longer does.  Thus it's virtually guaranteed
+that he will @emph{not} see your posting.  The steps described here are
+the only officially recognized way for reporting bugs.  Really.
+
+@ignore
+And another one:
+
+Date: Thu, 11 Jun 2015 09:00:56 -0400
+From: Chet Ramey <chet.ramey@case.edu>
+
+My memory was imperfect.  Back in June 2009, I wrote:
+
+"That's the nice thing about open source, right?  You can take your ball
+and run to another section of the playground.  Then, if you like mixing
+metaphors, you can throw rocks from there."
+@end ignore
+
+@node Maintainers
+@appendixsubsec Reporting Problems with Non-Unix Ports
+
 If you find bugs in one of the non-Unix ports of @command{gawk},
 send an email to the bug list, with a copy to the
 person who maintains that port.  The maintainers are named in the following list,