Merge branch 'master' into feature/typed-regex

4 files changed, 736 insertions, 663 deletions

diff --git a/doc/ChangeLog b/doc/ChangeLog
index 294743ba..b8f37013 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 21aedf25..72703060 100644
--- a/doc/gawk.info
+++ b/doc/gawk.info
@@ -648,6 +648,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.
@@ -28987,11 +28990,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
@@ -29015,12 +29029,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
@@ -29038,12 +29046,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:
 
@@ -32885,7 +32916,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)
@@ -32893,8 +32924,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)
@@ -32999,7 +33030,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)
@@ -33262,7 +33293,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)
@@ -33398,7 +33429,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)
@@ -33761,7 +33793,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 177)
 * gawk version:                          Auto-set.            (line 221)
@@ -34224,7 +34256,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.
@@ -34467,7 +34499,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)
@@ -34790,7 +34822,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)
@@ -35324,7 +35356,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)
 
@@ -35332,570 +35364,573 @@ Index
 
 Tag Table:
 Node: Top1200
-Node: Foreword342506
-Node: Foreword446948
-Node: Preface48480
-Ref: Preface-Footnote-151352
-Ref: Preface-Footnote-251459
-Ref: Preface-Footnote-351693
-Node: History51835
-Node: Names54187
-Ref: Names-Footnote-155281
-Node: This Manual55428
-Ref: This Manual-Footnote-161913
-Node: Conventions62013
-Node: Manual History64367
-Ref: Manual History-Footnote-167362
-Ref: Manual History-Footnote-267403
-Node: How To Contribute67477
-Node: Acknowledgments68606
-Node: Getting Started73492
-Node: Running gawk75931
-Node: One-shot77121
-Node: Read Terminal78384
-Node: Long80416
-Node: Executable Scripts81929
-Ref: Executable Scripts-Footnote-184724
-Node: Comments84827
-Node: Quoting87311
-Node: DOS Quoting92828
-Node: Sample Data Files93503
-Node: Very Simple96098
-Node: Two Rules101000
-Node: More Complex102885
-Node: Statements/Lines105751
-Ref: Statements/Lines-Footnote-1110210
-Node: Other Features110475
-Node: When111411
-Ref: When-Footnote-1113165
-Node: Intro Summary113230
-Node: Invoking Gawk114114
-Node: Command Line115628
-Node: Options116426
-Ref: Options-Footnote-1132525
-Ref: Options-Footnote-2132755
-Node: Other Arguments132780
-Node: Naming Standard Input135727
-Node: Environment Variables136820
-Node: AWKPATH Variable137378
-Ref: AWKPATH Variable-Footnote-1140789
-Ref: AWKPATH Variable-Footnote-2140834
-Node: AWKLIBPATH Variable141095
-Node: Other Environment Variables142352
-Node: Exit Status146173
-Node: Include Files146850
-Node: Loading Shared Libraries150445
-Node: Obsolete151873
-Node: Undocumented152565
-Node: Invoking Summary152862
-Node: Regexp154522
-Node: Regexp Usage156041
-Node: Escape Sequences158078
-Node: Regexp Operators164310
-Ref: Regexp Operators-Footnote-1171726
-Ref: Regexp Operators-Footnote-2171873
-Node: Bracket Expressions171971
-Ref: table-char-classes174447
-Node: Leftmost Longest177584
-Node: Computed Regexps178887
-Node: GNU Regexp Operators182314
-Node: Case-sensitivity185993
-Ref: Case-sensitivity-Footnote-1188889
-Ref: Case-sensitivity-Footnote-2189124
-Node: Strong Regexp Constants189232
-Node: Regexp Summary192174
-Node: Reading Files193780
-Node: Records195943
-Node: awk split records196676
-Node: gawk split records201607
-Ref: gawk split records-Footnote-1206147
-Node: Fields206184
-Node: Nonconstant Fields208925
-Ref: Nonconstant Fields-Footnote-1211161
-Node: Changing Fields211365
-Node: Field Separators217293
-Node: Default Field Splitting219991
-Node: Regexp Field Splitting221109
-Node: Single Character Fields224462
-Node: Command Line Field Separator225522
-Node: Full Line Fields228740
-Ref: Full Line Fields-Footnote-1230262
-Ref: Full Line Fields-Footnote-2230308
-Node: Field Splitting Summary230409
-Node: Constant Size232483
-Node: Splitting By Content237061
-Ref: Splitting By Content-Footnote-1241032
-Node: Multiple Line241195
-Ref: Multiple Line-Footnote-1247077
-Node: Getline247256
-Node: Plain Getline249723
-Node: Getline/Variable252362
-Node: Getline/File253511
-Node: Getline/Variable/File254897
-Ref: Getline/Variable/File-Footnote-1256500
-Node: Getline/Pipe256588
-Node: Getline/Variable/Pipe259293
-Node: Getline/Coprocess260426
-Node: Getline/Variable/Coprocess261691
-Node: Getline Notes262431
-Node: Getline Summary265226
-Ref: table-getline-variants265648
-Node: Read Timeout266396
-Ref: Read Timeout-Footnote-1270302
-Node: Retrying Input270360
-Node: Command-line directories271559
-Node: Input Summary272465
-Node: Input Exercises275637
-Node: Printing276365
-Node: Print278199
-Node: Print Examples279656
-Node: Output Separators282436
-Node: OFMT284453
-Node: Printf285809
-Node: Basic Printf286594
-Node: Control Letters288168
-Node: Format Modifiers292156
-Node: Printf Examples298171
-Node: Redirection300657
-Node: Special FD307498
-Ref: Special FD-Footnote-1310666
-Node: Special Files310740
-Node: Other Inherited Files311357
-Node: Special Network312358
-Node: Special Caveats313218
-Node: Close Files And Pipes314167
-Ref: table-close-pipe-return-values321074
-Ref: Close Files And Pipes-Footnote-1321857
-Ref: Close Files And Pipes-Footnote-2322005
-Node: Nonfatal322157
-Node: Output Summary324482
-Node: Output Exercises325704
-Node: Expressions326383
-Node: Values327571
-Node: Constants328249
-Node: Scalar Constants328940
-Ref: Scalar Constants-Footnote-1329804
-Node: Nondecimal-numbers330054
-Node: Regexp Constants333067
-Node: Using Constant Regexps333593
-Node: Variables336756
-Node: Using Variables337413
-Node: Assignment Options339323
-Node: Conversion341196
-Node: Strings And Numbers341720
-Ref: Strings And Numbers-Footnote-1344783
-Node: Locale influences conversions344892
-Ref: table-locale-affects347650
-Node: All Operators348268
-Node: Arithmetic Ops348897
-Node: Concatenation351403
-Ref: Concatenation-Footnote-1354250
-Node: Assignment Ops354357
-Ref: table-assign-ops359348
-Node: Increment Ops360661
-Node: Truth Values and Conditions364121
-Node: Truth Values365195
-Node: Typing and Comparison366243
-Node: Variable Typing367063
-Node: Comparison Operators370687
-Ref: table-relational-ops371106
-Node: POSIX String Comparison374601
-Ref: POSIX String Comparison-Footnote-1376296
-Ref: POSIX String Comparison-Footnote-2376435
-Node: Boolean Ops376519
-Ref: Boolean Ops-Footnote-1381001
-Node: Conditional Exp381093
-Node: Function Calls382829
-Node: Precedence386706
-Node: Locales390365
-Node: Expressions Summary391997
-Node: Patterns and Actions394570
-Node: Pattern Overview395690
-Node: Regexp Patterns397367
-Node: Expression Patterns397909
-Node: Ranges401690
-Node: BEGIN/END404798
-Node: Using BEGIN/END405559
-Ref: Using BEGIN/END-Footnote-1408295
-Node: I/O And BEGIN/END408401
-Node: BEGINFILE/ENDFILE410715
-Node: Empty413622
-Node: Using Shell Variables413939
-Node: Action Overview416213
-Node: Statements418538
-Node: If Statement420386
-Node: While Statement421881
-Node: Do Statement423909
-Node: For Statement425057
-Node: Switch Statement428215
-Node: Break Statement430601
-Node: Continue Statement432693
-Node: Next Statement434520
-Node: Nextfile Statement436903
-Node: Exit Statement439555
-Node: Built-in Variables441958
-Node: User-modified443091
-Node: Auto-set450677
-Ref: Auto-set-Footnote-1465330
-Ref: Auto-set-Footnote-2465536
-Node: ARGC and ARGV465592
-Node: Pattern Action Summary469805
-Node: Arrays472235
-Node: Array Basics473564
-Node: Array Intro474408
-Ref: figure-array-elements476383
-Ref: Array Intro-Footnote-1479087
-Node: Reference to Elements479215
-Node: Assigning Elements481679
-Node: Array Example482170
-Node: Scanning an Array483929
-Node: Controlling Scanning486951
-Ref: Controlling Scanning-Footnote-1492350
-Node: Numeric Array Subscripts492666
-Node: Uninitialized Subscripts494850
-Node: Delete496469
-Ref: Delete-Footnote-1499221
-Node: Multidimensional499278
-Node: Multiscanning502373
-Node: Arrays of Arrays503964
-Node: Arrays Summary508731
-Node: Functions510824
-Node: Built-in511862
-Node: Calling Built-in512943
-Node: Numeric Functions514939
-Ref: Numeric Functions-Footnote-1519772
-Ref: Numeric Functions-Footnote-2520129
-Ref: Numeric Functions-Footnote-3520177
-Node: String Functions520449
-Ref: String Functions-Footnote-1543953
-Ref: String Functions-Footnote-2544081
-Ref: String Functions-Footnote-3544329
-Node: Gory Details544416
-Ref: table-sub-escapes546207
-Ref: table-sub-proposed547726
-Ref: table-posix-sub549089
-Ref: table-gensub-escapes550630
-Ref: Gory Details-Footnote-1551453
-Node: I/O Functions551607
-Ref: table-system-return-values558189
-Ref: I/O Functions-Footnote-1560169
-Ref: I/O Functions-Footnote-2560317
-Node: Time Functions560437
-Ref: Time Functions-Footnote-1570959
-Ref: Time Functions-Footnote-2571027
-Ref: Time Functions-Footnote-3571185
-Ref: Time Functions-Footnote-4571296
-Ref: Time Functions-Footnote-5571408
-Ref: Time Functions-Footnote-6571635
-Node: Bitwise Functions571901
-Ref: table-bitwise-ops572495
-Ref: Bitwise Functions-Footnote-1576833
-Node: Type Functions577006
-Node: I18N Functions579667
-Node: User-defined581318
-Node: Definition Syntax582123
-Ref: Definition Syntax-Footnote-1587810
-Node: Function Example587881
-Ref: Function Example-Footnote-1590803
-Node: Function Caveats590825
-Node: Calling A Function591343
-Node: Variable Scope592301
-Node: Pass By Value/Reference595295
-Node: Return Statement598794
-Node: Dynamic Typing601773
-Node: Indirect Calls602703
-Ref: Indirect Calls-Footnote-1612954
-Node: Functions Summary613082
-Node: Library Functions615787
-Ref: Library Functions-Footnote-1619394
-Ref: Library Functions-Footnote-2619537
-Node: Library Names619708
-Ref: Library Names-Footnote-1623168
-Ref: Library Names-Footnote-2623391
-Node: General Functions623477
-Node: Strtonum Function624580
-Node: Assert Function627602
-Node: Round Function630928
-Node: Cliff Random Function632469
-Node: Ordinal Functions633485
-Ref: Ordinal Functions-Footnote-1636548
-Ref: Ordinal Functions-Footnote-2636800
-Node: Join Function637010
-Ref: Join Function-Footnote-1638780
-Node: Getlocaltime Function638980
-Node: Readfile Function642722
-Node: Shell Quoting644694
-Node: Data File Management646095
-Node: Filetrans Function646727
-Node: Rewind Function650823
-Node: File Checking652729
-Ref: File Checking-Footnote-1654063
-Node: Empty Files654264
-Node: Ignoring Assigns656243
-Node: Getopt Function657793
-Ref: Getopt Function-Footnote-1669262
-Node: Passwd Functions669462
-Ref: Passwd Functions-Footnote-1678301
-Node: Group Functions678389
-Ref: Group Functions-Footnote-1686287
-Node: Walking Arrays686494
-Node: Library Functions Summary689502
-Node: Library Exercises690908
-Node: Sample Programs691373
-Node: Running Examples692143
-Node: Clones692871
-Node: Cut Program694095
-Node: Egrep Program704024
-Ref: Egrep Program-Footnote-1711536
-Node: Id Program711646
-Node: Split Program715326
-Ref: Split Program-Footnote-1718785
-Node: Tee Program718914
-Node: Uniq Program721704
-Node: Wc Program729130
-Ref: Wc Program-Footnote-1733385
-Node: Miscellaneous Programs733479
-Node: Dupword Program734692
-Node: Alarm Program736722
-Node: Translate Program741577
-Ref: Translate Program-Footnote-1746142
-Node: Labels Program746412
-Ref: Labels Program-Footnote-1749763
-Node: Word Sorting749847
-Node: History Sorting753919
-Node: Extract Program755754
-Node: Simple Sed763283
-Node: Igawk Program766357
-Ref: Igawk Program-Footnote-1780688
-Ref: Igawk Program-Footnote-2780890
-Ref: Igawk Program-Footnote-3781012
-Node: Anagram Program781127
-Node: Signature Program784189
-Node: Programs Summary785436
-Node: Programs Exercises786650
-Ref: Programs Exercises-Footnote-1790779
-Node: Advanced Features790870
-Node: Nondecimal Data792860
-Node: Array Sorting794451
-Node: Controlling Array Traversal795151
-Ref: Controlling Array Traversal-Footnote-1803518
-Node: Array Sorting Functions803636
-Ref: Array Sorting Functions-Footnote-1808727
-Node: Two-way I/O808923
-Ref: Two-way I/O-Footnote-1815473
-Ref: Two-way I/O-Footnote-2815660
-Node: TCP/IP Networking815742
-Node: Profiling818860
-Ref: Profiling-Footnote-1827353
-Node: Advanced Features Summary827676
-Node: Internationalization829520
-Node: I18N and L10N831000
-Node: Explaining gettext831687
-Ref: Explaining gettext-Footnote-1837579
-Ref: Explaining gettext-Footnote-2837764
-Node: Programmer i18n837929
-Ref: Programmer i18n-Footnote-1842784
-Node: Translator i18n842833
-Node: String Extraction843627
-Ref: String Extraction-Footnote-1844759
-Node: Printf Ordering844845
-Ref: Printf Ordering-Footnote-1847631
-Node: I18N Portability847695
-Ref: I18N Portability-Footnote-1850151
-Node: I18N Example850214
-Ref: I18N Example-Footnote-1853020
-Node: Gawk I18N853093
-Node: I18N Summary853738
-Node: Debugger855079
-Node: Debugging856101
-Node: Debugging Concepts856542
-Node: Debugging Terms858351
-Node: Awk Debugging860926
-Node: Sample Debugging Session861832
-Node: Debugger Invocation862366
-Node: Finding The Bug863752
-Node: List of Debugger Commands870230
-Node: Breakpoint Control871563
-Node: Debugger Execution Control875257
-Node: Viewing And Changing Data878619
-Node: Execution Stack881993
-Node: Debugger Info883630
-Node: Miscellaneous Debugger Commands887701
-Node: Readline Support892789
-Node: Limitations893685
-Ref: Limitations-Footnote-1897916
-Node: Debugging Summary897967
-Node: Arbitrary Precision Arithmetic899246
-Node: Computer Arithmetic900662
-Ref: table-numeric-ranges904253
-Ref: Computer Arithmetic-Footnote-1904975
-Node: Math Definitions905032
-Ref: table-ieee-formats908346
-Ref: Math Definitions-Footnote-1908949
-Node: MPFR features909054
-Node: FP Math Caution910771
-Ref: FP Math Caution-Footnote-1911843
-Node: Inexactness of computations912212
-Node: Inexact representation913172
-Node: Comparing FP Values914532
-Node: Errors accumulate915614
-Node: Getting Accuracy917047
-Node: Try To Round919757
-Node: Setting precision920656
-Ref: table-predefined-precision-strings921353
-Node: Setting the rounding mode923183
-Ref: table-gawk-rounding-modes923557
-Ref: Setting the rounding mode-Footnote-1926965
-Node: Arbitrary Precision Integers927144
-Ref: Arbitrary Precision Integers-Footnote-1932061
-Node: POSIX Floating Point Problems932210
-Ref: POSIX Floating Point Problems-Footnote-1936092
-Node: Floating point summary936130
-Node: Dynamic Extensions938320
-Node: Extension Intro939873
-Node: Plugin License941139
-Node: Extension Mechanism Outline941936
-Ref: figure-load-extension942375
-Ref: figure-register-new-function943940
-Ref: figure-call-new-function945032
-Node: Extension API Description947094
-Node: Extension API Functions Introduction948626
-Node: General Data Types953485
-Ref: General Data Types-Footnote-1959440
-Node: Memory Allocation Functions959739
-Ref: Memory Allocation Functions-Footnote-1962584
-Node: Constructor Functions962683
-Node: Registration Functions964428
-Node: Extension Functions965113
-Node: Exit Callback Functions967736
-Node: Extension Version String968986
-Node: Input Parsers969649
-Node: Output Wrappers979531
-Node: Two-way processors984043
-Node: Printing Messages986308
-Ref: Printing Messages-Footnote-1987479
-Node: Updating ERRNO987632
-Node: Requesting Values988371
-Ref: table-value-types-returned989108
-Node: Accessing Parameters989991
-Node: Symbol Table Access991226
-Node: Symbol table by name991738
-Node: Symbol table by cookie993759
-Ref: Symbol table by cookie-Footnote-1997911
-Node: Cached values997975
-Ref: Cached values-Footnote-11001482
-Node: Array Manipulation1001573
-Ref: Array Manipulation-Footnote-11002664
-Node: Array Data Types1002701
-Ref: Array Data Types-Footnote-11005359
-Node: Array Functions1005451
-Node: Flattening Arrays1009309
-Node: Creating Arrays1016217
-Node: Redirection API1020986
-Node: Extension API Variables1023817
-Node: Extension Versioning1024450
-Ref: gawk-api-version1024887
-Node: Extension API Informational Variables1026643
-Node: Extension API Boilerplate1027707
-Node: Finding Extensions1031521
-Node: Extension Example1032080
-Node: Internal File Description1032878
-Node: Internal File Ops1036958
-Ref: Internal File Ops-Footnote-11048720
-Node: Using Internal File Ops1048860
-Ref: Using Internal File Ops-Footnote-11051243
-Node: Extension Samples1051517
-Node: Extension Sample File Functions1053046
-Node: Extension Sample Fnmatch1060695
-Node: Extension Sample Fork1062182
-Node: Extension Sample Inplace1063400
-Node: Extension Sample Ord1066610
-Node: Extension Sample Readdir1067446
-Ref: table-readdir-file-types1068335
-Node: Extension Sample Revout1069140
-Node: Extension Sample Rev2way1069729
-Node: Extension Sample Read write array1070469
-Node: Extension Sample Readfile1072411
-Node: Extension Sample Time1073506
-Node: Extension Sample API Tests1074854
-Node: gawkextlib1075346
-Node: Extension summary1077793
-Node: Extension Exercises1081495
-Node: Language History1082993
-Node: V7/SVR3.11084649
-Node: SVR41086801
-Node: POSIX1088235
-Node: BTL1089614
-Node: POSIX/GNU1090343
-Node: Feature History1096205
-Node: Common Extensions1110575
-Node: Ranges and Locales1111858
-Ref: Ranges and Locales-Footnote-11116474
-Ref: Ranges and Locales-Footnote-21116501
-Ref: Ranges and Locales-Footnote-31116736
-Node: Contributors1116957
-Node: History summary1122517
-Node: Installation1123897
-Node: Gawk Distribution1124841
-Node: Getting1125325
-Node: Extracting1126286
-Node: Distribution contents1127924
-Node: Unix Installation1134018
-Node: Quick Installation1134700
-Node: Shell Startup Files1137114
-Node: Additional Configuration Options1138192
-Node: Configuration Philosophy1139997
-Node: Non-Unix Installation1142366
-Node: PC Installation1142824
-Node: PC Binary Installation1144144
-Node: PC Compiling1145996
-Ref: PC Compiling-Footnote-11148790
-Node: PC Testing1148899
-Node: PC Using1150079
-Ref: PC Using-Footnote-11154232
-Node: Cygwin1154305
-Node: MSYS1155075
-Node: VMS Installation1155576
-Node: VMS Compilation1156367
-Ref: VMS Compilation-Footnote-11157596
-Node: VMS Dynamic Extensions1157654
-Node: VMS Installation Details1159339
-Node: VMS Running1161592
-Node: VMS GNV1165871
-Node: VMS Old Gawk1166606
-Node: Bugs1167077
-Node: Other Versions1171392
-Node: Installation summary1177976
-Node: Notes1179027
-Node: Compatibility Mode1179892
-Node: Additions1180674
-Node: Accessing The Source1181599
-Node: Adding Code1183034
-Node: New Ports1189253
-Node: Derived Files1193741
-Ref: Derived Files-Footnote-11199226
-Ref: Derived Files-Footnote-21199261
-Ref: Derived Files-Footnote-31199859
-Node: Future Extensions1199973
-Node: Implementation Limitations1200631
-Node: Extension Design1201814
-Node: Old Extension Problems1202968
-Ref: Old Extension Problems-Footnote-11204486
-Node: Extension New Mechanism Goals1204543
-Ref: Extension New Mechanism Goals-Footnote-11207907
-Node: Extension Other Design Decisions1208096
-Node: Extension Future Growth1210209
-Node: Old Extension Mechanism1211045
-Node: Notes summary1212808
-Node: Basic Concepts1213990
-Node: Basic High Level1214671
-Ref: figure-general-flow1214953
-Ref: figure-process-flow1215638
-Ref: Basic High Level-Footnote-11218939
-Node: Basic Data Typing1219124
-Node: Glossary1222452
-Node: Copying1254399
-Node: GNU Free Documentation License1291938
-Node: Index1317056
+Node: Foreword342713
+Node: Foreword447155
+Node: Preface48687
+Ref: Preface-Footnote-151559
+Ref: Preface-Footnote-251666
+Ref: Preface-Footnote-351900
+Node: History52042
+Node: Names54394
+Ref: Names-Footnote-155488
+Node: This Manual55635
+Ref: This Manual-Footnote-162120
+Node: Conventions62220
+Node: Manual History64574
+Ref: Manual History-Footnote-167569
+Ref: Manual History-Footnote-267610
+Node: How To Contribute67684
+Node: Acknowledgments68813
+Node: Getting Started73699
+Node: Running gawk76138
+Node: One-shot77328
+Node: Read Terminal78591
+Node: Long80623
+Node: Executable Scripts82136
+Ref: Executable Scripts-Footnote-184931
+Node: Comments85034
+Node: Quoting87518
+Node: DOS Quoting93035
+Node: Sample Data Files93710
+Node: Very Simple96305
+Node: Two Rules101207
+Node: More Complex103092
+Node: Statements/Lines105958
+Ref: Statements/Lines-Footnote-1110417
+Node: Other Features110682
+Node: When111618
+Ref: When-Footnote-1113372
+Node: Intro Summary113437
+Node: Invoking Gawk114321
+Node: Command Line115835
+Node: Options116633
+Ref: Options-Footnote-1132732
+Ref: Options-Footnote-2132962
+Node: Other Arguments132987
+Node: Naming Standard Input135934
+Node: Environment Variables137027
+Node: AWKPATH Variable137585
+Ref: AWKPATH Variable-Footnote-1140996
+Ref: AWKPATH Variable-Footnote-2141041
+Node: AWKLIBPATH Variable141302
+Node: Other Environment Variables142559
+Node: Exit Status146380
+Node: Include Files147057
+Node: Loading Shared Libraries150652
+Node: Obsolete152080
+Node: Undocumented152772
+Node: Invoking Summary153069
+Node: Regexp154729
+Node: Regexp Usage156248
+Node: Escape Sequences158285
+Node: Regexp Operators164517
+Ref: Regexp Operators-Footnote-1171933
+Ref: Regexp Operators-Footnote-2172080
+Node: Bracket Expressions172178
+Ref: table-char-classes174654
+Node: Leftmost Longest177791
+Node: Computed Regexps179094
+Node: GNU Regexp Operators182521
+Node: Case-sensitivity186200
+Ref: Case-sensitivity-Footnote-1189096
+Ref: Case-sensitivity-Footnote-2189331
+Node: Strong Regexp Constants189439
+Node: Regexp Summary192381
+Node: Reading Files193987
+Node: Records196150
+Node: awk split records196883
+Node: gawk split records201814
+Ref: gawk split records-Footnote-1206354
+Node: Fields206391
+Node: Nonconstant Fields209132
+Ref: Nonconstant Fields-Footnote-1211368
+Node: Changing Fields211572
+Node: Field Separators217500
+Node: Default Field Splitting220198
+Node: Regexp Field Splitting221316
+Node: Single Character Fields224669
+Node: Command Line Field Separator225729
+Node: Full Line Fields228947
+Ref: Full Line Fields-Footnote-1230469
+Ref: Full Line Fields-Footnote-2230515
+Node: Field Splitting Summary230616
+Node: Constant Size232690
+Node: Splitting By Content237268
+Ref: Splitting By Content-Footnote-1241239
+Node: Multiple Line241402
+Ref: Multiple Line-Footnote-1247284
+Node: Getline247463
+Node: Plain Getline249930
+Node: Getline/Variable252569
+Node: Getline/File253718
+Node: Getline/Variable/File255104
+Ref: Getline/Variable/File-Footnote-1256707
+Node: Getline/Pipe256795
+Node: Getline/Variable/Pipe259500
+Node: Getline/Coprocess260633
+Node: Getline/Variable/Coprocess261898
+Node: Getline Notes262638
+Node: Getline Summary265433
+Ref: table-getline-variants265855
+Node: Read Timeout266603
+Ref: Read Timeout-Footnote-1270509
+Node: Retrying Input270567
+Node: Command-line directories271766
+Node: Input Summary272672
+Node: Input Exercises275844
+Node: Printing276572
+Node: Print278406
+Node: Print Examples279863
+Node: Output Separators282643
+Node: OFMT284660
+Node: Printf286016
+Node: Basic Printf286801
+Node: Control Letters288375
+Node: Format Modifiers292363
+Node: Printf Examples298378
+Node: Redirection300864
+Node: Special FD307705
+Ref: Special FD-Footnote-1310873
+Node: Special Files310947
+Node: Other Inherited Files311564
+Node: Special Network312565
+Node: Special Caveats313425
+Node: Close Files And Pipes314374
+Ref: table-close-pipe-return-values321281
+Ref: Close Files And Pipes-Footnote-1322064
+Ref: Close Files And Pipes-Footnote-2322212
+Node: Nonfatal322364
+Node: Output Summary324689
+Node: Output Exercises325911
+Node: Expressions326590
+Node: Values327778
+Node: Constants328456
+Node: Scalar Constants329147
+Ref: Scalar Constants-Footnote-1330011
+Node: Nondecimal-numbers330261
+Node: Regexp Constants333274
+Node: Using Constant Regexps333800
+Node: Variables336963
+Node: Using Variables337620
+Node: Assignment Options339530
+Node: Conversion341403
+Node: Strings And Numbers341927
+Ref: Strings And Numbers-Footnote-1344990
+Node: Locale influences conversions345099
+Ref: table-locale-affects347857
+Node: All Operators348475
+Node: Arithmetic Ops349104
+Node: Concatenation351610
+Ref: Concatenation-Footnote-1354457
+Node: Assignment Ops354564
+Ref: table-assign-ops359555
+Node: Increment Ops360868
+Node: Truth Values and Conditions364328
+Node: Truth Values365402
+Node: Typing and Comparison366450
+Node: Variable Typing367270
+Node: Comparison Operators370894
+Ref: table-relational-ops371313
+Node: POSIX String Comparison374808
+Ref: POSIX String Comparison-Footnote-1376503
+Ref: POSIX String Comparison-Footnote-2376642
+Node: Boolean Ops376726
+Ref: Boolean Ops-Footnote-1381208
+Node: Conditional Exp381300
+Node: Function Calls383036
+Node: Precedence386913
+Node: Locales390572
+Node: Expressions Summary392204
+Node: Patterns and Actions394777
+Node: Pattern Overview395897
+Node: Regexp Patterns397574
+Node: Expression Patterns398116
+Node: Ranges401897
+Node: BEGIN/END405005
+Node: Using BEGIN/END405766
+Ref: Using BEGIN/END-Footnote-1408502
+Node: I/O And BEGIN/END408608
+Node: BEGINFILE/ENDFILE410922
+Node: Empty413829
+Node: Using Shell Variables414146
+Node: Action Overview416420
+Node: Statements418745
+Node: If Statement420593
+Node: While Statement422088
+Node: Do Statement424116
+Node: For Statement425264
+Node: Switch Statement428422
+Node: Break Statement430808
+Node: Continue Statement432900
+Node: Next Statement434727
+Node: Nextfile Statement437110
+Node: Exit Statement439762
+Node: Built-in Variables442165
+Node: User-modified443298
+Node: Auto-set450884
+Ref: Auto-set-Footnote-1465537
+Ref: Auto-set-Footnote-2465743
+Node: ARGC and ARGV465799
+Node: Pattern Action Summary470012
+Node: Arrays472442
+Node: Array Basics473771
+Node: Array Intro474615
+Ref: figure-array-elements476590
+Ref: Array Intro-Footnote-1479294
+Node: Reference to Elements479422
+Node: Assigning Elements481886
+Node: Array Example482377
+Node: Scanning an Array484136
+Node: Controlling Scanning487158
+Ref: Controlling Scanning-Footnote-1492557
+Node: Numeric Array Subscripts492873
+Node: Uninitialized Subscripts495057
+Node: Delete496676
+Ref: Delete-Footnote-1499428
+Node: Multidimensional499485
+Node: Multiscanning502580
+Node: Arrays of Arrays504171
+Node: Arrays Summary508938
+Node: Functions511031
+Node: Built-in512069
+Node: Calling Built-in513150
+Node: Numeric Functions515146
+Ref: Numeric Functions-Footnote-1519979
+Ref: Numeric Functions-Footnote-2520336
+Ref: Numeric Functions-Footnote-3520384
+Node: String Functions520656
+Ref: String Functions-Footnote-1544160
+Ref: String Functions-Footnote-2544288
+Ref: String Functions-Footnote-3544536
+Node: Gory Details544623
+Ref: table-sub-escapes546414
+Ref: table-sub-proposed547933
+Ref: table-posix-sub549296
+Ref: table-gensub-escapes550837
+Ref: Gory Details-Footnote-1551660
+Node: I/O Functions551814
+Ref: table-system-return-values558396
+Ref: I/O Functions-Footnote-1560376
+Ref: I/O Functions-Footnote-2560524
+Node: Time Functions560644
+Ref: Time Functions-Footnote-1571166
+Ref: Time Functions-Footnote-2571234
+Ref: Time Functions-Footnote-3571392
+Ref: Time Functions-Footnote-4571503
+Ref: Time Functions-Footnote-5571615
+Ref: Time Functions-Footnote-6571842
+Node: Bitwise Functions572108
+Ref: table-bitwise-ops572702
+Ref: Bitwise Functions-Footnote-1577040
+Node: Type Functions577213
+Node: I18N Functions579874
+Node: User-defined581525
+Node: Definition Syntax582330
+Ref: Definition Syntax-Footnote-1588017
+Node: Function Example588088
+Ref: Function Example-Footnote-1591010
+Node: Function Caveats591032
+Node: Calling A Function591550
+Node: Variable Scope592508
+Node: Pass By Value/Reference595502
+Node: Return Statement599001
+Node: Dynamic Typing601980
+Node: Indirect Calls602910
+Ref: Indirect Calls-Footnote-1613161
+Node: Functions Summary613289
+Node: Library Functions615994
+Ref: Library Functions-Footnote-1619601
+Ref: Library Functions-Footnote-2619744
+Node: Library Names619915
+Ref: Library Names-Footnote-1623375
+Ref: Library Names-Footnote-2623598
+Node: General Functions623684
+Node: Strtonum Function624787
+Node: Assert Function627809
+Node: Round Function631135
+Node: Cliff Random Function632676
+Node: Ordinal Functions633692
+Ref: Ordinal Functions-Footnote-1636755
+Ref: Ordinal Functions-Footnote-2637007
+Node: Join Function637217
+Ref: Join Function-Footnote-1638987
+Node: Getlocaltime Function639187
+Node: Readfile Function642929
+Node: Shell Quoting644901
+Node: Data File Management646302
+Node: Filetrans Function646934
+Node: Rewind Function651030
+Node: File Checking652936
+Ref: File Checking-Footnote-1654270
+Node: Empty Files654471
+Node: Ignoring Assigns656450
+Node: Getopt Function658000
+Ref: Getopt Function-Footnote-1669469
+Node: Passwd Functions669669
+Ref: Passwd Functions-Footnote-1678508
+Node: Group Functions678596
+Ref: Group Functions-Footnote-1686494
+Node: Walking Arrays686701
+Node: Library Functions Summary689709
+Node: Library Exercises691115
+Node: Sample Programs691580
+Node: Running Examples692350
+Node: Clones693078
+Node: Cut Program694302
+Node: Egrep Program704231
+Ref: Egrep Program-Footnote-1711743
+Node: Id Program711853
+Node: Split Program715533
+Ref: Split Program-Footnote-1718992
+Node: Tee Program719121
+Node: Uniq Program721911
+Node: Wc Program729337
+Ref: Wc Program-Footnote-1733592
+Node: Miscellaneous Programs733686
+Node: Dupword Program734899
+Node: Alarm Program736929
+Node: Translate Program741784
+Ref: Translate Program-Footnote-1746349
+Node: Labels Program746619
+Ref: Labels Program-Footnote-1749970
+Node: Word Sorting750054
+Node: History Sorting754126
+Node: Extract Program755961
+Node: Simple Sed763490
+Node: Igawk Program766564
+Ref: Igawk Program-Footnote-1780895
+Ref: Igawk Program-Footnote-2781097
+Ref: Igawk Program-Footnote-3781219
+Node: Anagram Program781334
+Node: Signature Program784396
+Node: Programs Summary785643
+Node: Programs Exercises786857
+Ref: Programs Exercises-Footnote-1790986
+Node: Advanced Features791077
+Node: Nondecimal Data793067
+Node: Array Sorting794658
+Node: Controlling Array Traversal795358
+Ref: Controlling Array Traversal-Footnote-1803725
+Node: Array Sorting Functions803843
+Ref: Array Sorting Functions-Footnote-1808934
+Node: Two-way I/O809130
+Ref: Two-way I/O-Footnote-1815680
+Ref: Two-way I/O-Footnote-2815867
+Node: TCP/IP Networking815949
+Node: Profiling819067
+Ref: Profiling-Footnote-1827560
+Node: Advanced Features Summary827883
+Node: Internationalization829727
+Node: I18N and L10N831207
+Node: Explaining gettext831894
+Ref: Explaining gettext-Footnote-1837786
+Ref: Explaining gettext-Footnote-2837971
+Node: Programmer i18n838136
+Ref: Programmer i18n-Footnote-1842991
+Node: Translator i18n843040
+Node: String Extraction843834
+Ref: String Extraction-Footnote-1844966
+Node: Printf Ordering845052
+Ref: Printf Ordering-Footnote-1847838
+Node: I18N Portability847902
+Ref: I18N Portability-Footnote-1850358
+Node: I18N Example850421
+Ref: I18N Example-Footnote-1853227
+Node: Gawk I18N853300
+Node: I18N Summary853945
+Node: Debugger855286
+Node: Debugging856308
+Node: Debugging Concepts856749
+Node: Debugging Terms858558
+Node: Awk Debugging861133
+Node: Sample Debugging Session862039
+Node: Debugger Invocation862573
+Node: Finding The Bug863959
+Node: List of Debugger Commands870437
+Node: Breakpoint Control871770
+Node: Debugger Execution Control875464
+Node: Viewing And Changing Data878826
+Node: Execution Stack882200
+Node: Debugger Info883837
+Node: Miscellaneous Debugger Commands887908
+Node: Readline Support892996
+Node: Limitations893892
+Ref: Limitations-Footnote-1898123
+Node: Debugging Summary898174
+Node: Arbitrary Precision Arithmetic899453
+Node: Computer Arithmetic900869
+Ref: table-numeric-ranges904460
+Ref: Computer Arithmetic-Footnote-1905182
+Node: Math Definitions905239
+Ref: table-ieee-formats908553
+Ref: Math Definitions-Footnote-1909156
+Node: MPFR features909261
+Node: FP Math Caution910978
+Ref: FP Math Caution-Footnote-1912050
+Node: Inexactness of computations912419
+Node: Inexact representation913379
+Node: Comparing FP Values914739
+Node: Errors accumulate915821
+Node: Getting Accuracy917254
+Node: Try To Round919964
+Node: Setting precision920863
+Ref: table-predefined-precision-strings921560
+Node: Setting the rounding mode923390
+Ref: table-gawk-rounding-modes923764
+Ref: Setting the rounding mode-Footnote-1927172
+Node: Arbitrary Precision Integers927351
+Ref: Arbitrary Precision Integers-Footnote-1932268
+Node: POSIX Floating Point Problems932417
+Ref: POSIX Floating Point Problems-Footnote-1936299
+Node: Floating point summary936337
+Node: Dynamic Extensions938527
+Node: Extension Intro940080
+Node: Plugin License941346
+Node: Extension Mechanism Outline942143
+Ref: figure-load-extension942582
+Ref: figure-register-new-function944147
+Ref: figure-call-new-function945239
+Node: Extension API Description947301
+Node: Extension API Functions Introduction948833
+Node: General Data Types953692
+Ref: General Data Types-Footnote-1959647
+Node: Memory Allocation Functions959946
+Ref: Memory Allocation Functions-Footnote-1962791
+Node: Constructor Functions962890
+Node: Registration Functions964635
+Node: Extension Functions965320
+Node: Exit Callback Functions967943
+Node: Extension Version String969193
+Node: Input Parsers969856
+Node: Output Wrappers979738
+Node: Two-way processors984250
+Node: Printing Messages986515
+Ref: Printing Messages-Footnote-1987686
+Node: Updating ERRNO987839
+Node: Requesting Values988578
+Ref: table-value-types-returned989315
+Node: Accessing Parameters990198
+Node: Symbol Table Access991433
+Node: Symbol table by name991945
+Node: Symbol table by cookie993966
+Ref: Symbol table by cookie-Footnote-1998118
+Node: Cached values998182
+Ref: Cached values-Footnote-11001689
+Node: Array Manipulation1001780
+Ref: Array Manipulation-Footnote-11002871
+Node: Array Data Types1002908
+Ref: Array Data Types-Footnote-11005566
+Node: Array Functions1005658
+Node: Flattening Arrays1009516
+Node: Creating Arrays1016424
+Node: Redirection API1021193
+Node: Extension API Variables1024024
+Node: Extension Versioning1024657
+Ref: gawk-api-version1025094
+Node: Extension API Informational Variables1026850
+Node: Extension API Boilerplate1027914
+Node: Finding Extensions1031728
+Node: Extension Example1032287
+Node: Internal File Description1033085
+Node: Internal File Ops1037165
+Ref: Internal File Ops-Footnote-11048927
+Node: Using Internal File Ops1049067
+Ref: Using Internal File Ops-Footnote-11051450
+Node: Extension Samples1051724
+Node: Extension Sample File Functions1053253
+Node: Extension Sample Fnmatch1060902
+Node: Extension Sample Fork1062389
+Node: Extension Sample Inplace1063607
+Node: Extension Sample Ord1066817
+Node: Extension Sample Readdir1067653
+Ref: table-readdir-file-types1068542
+Node: Extension Sample Revout1069347
+Node: Extension Sample Rev2way1069936
+Node: Extension Sample Read write array1070676
+Node: Extension Sample Readfile1072618
+Node: Extension Sample Time1073713
+Node: Extension Sample API Tests1075061
+Node: gawkextlib1075553
+Node: Extension summary1078000
+Node: Extension Exercises1081702
+Node: Language History1083200
+Node: V7/SVR3.11084856
+Node: SVR41087008
+Node: POSIX1088442
+Node: BTL1089821
+Node: POSIX/GNU1090550
+Node: Feature History1096412
+Node: Common Extensions1110782
+Node: Ranges and Locales1112065
+Ref: Ranges and Locales-Footnote-11116681
+Ref: Ranges and Locales-Footnote-21116708
+Ref: Ranges and Locales-Footnote-31116943
+Node: Contributors1117164
+Node: History summary1122724
+Node: Installation1124104
+Node: Gawk Distribution1125048
+Node: Getting1125532
+Node: Extracting1126493
+Node: Distribution contents1128131
+Node: Unix Installation1134225
+Node: Quick Installation1134907
+Node: Shell Startup Files1137321
+Node: Additional Configuration Options1138399
+Node: Configuration Philosophy1140204
+Node: Non-Unix Installation1142573
+Node: PC Installation1143031
+Node: PC Binary Installation1144351
+Node: PC Compiling1146203
+Ref: PC Compiling-Footnote-11148997
+Node: PC Testing1149106
+Node: PC Using1150286
+Ref: PC Using-Footnote-11154439
+Node: Cygwin1154512
+Node: MSYS1155282
+Node: VMS Installation1155783
+Node: VMS Compilation1156574
+Ref: VMS Compilation-Footnote-11157803
+Node: VMS Dynamic Extensions1157861
+Node: VMS Installation Details1159546
+Node: VMS Running1161799
+Node: VMS GNV1166078
+Node: VMS Old Gawk1166813
+Node: Bugs1167284
+Node: Bug address1167947
+Node: Usenet1170344
+Node: Maintainers1171119
+Node: Other Versions1172495
+Node: Installation summary1179079
+Node: Notes1180130
+Node: Compatibility Mode1180995
+Node: Additions1181777
+Node: Accessing The Source1182702
+Node: Adding Code1184137
+Node: New Ports1190356
+Node: Derived Files1194844
+Ref: Derived Files-Footnote-11200329
+Ref: Derived Files-Footnote-21200364
+Ref: Derived Files-Footnote-31200962
+Node: Future Extensions1201076
+Node: Implementation Limitations1201734
+Node: Extension Design1202917
+Node: Old Extension Problems1204071
+Ref: Old Extension Problems-Footnote-11205589
+Node: Extension New Mechanism Goals1205646
+Ref: Extension New Mechanism Goals-Footnote-11209010
+Node: Extension Other Design Decisions1209199
+Node: Extension Future Growth1211312
+Node: Old Extension Mechanism1212148
+Node: Notes summary1213911
+Node: Basic Concepts1215093
+Node: Basic High Level1215774
+Ref: figure-general-flow1216056
+Ref: figure-process-flow1216741
+Ref: Basic High Level-Footnote-11220042
+Node: Basic Data Typing1220227
+Node: Glossary1223555
+Node: Copying1255502
+Node: GNU Free Documentation License1293041
+Node: Index1318159
 
 End Tag Table
diff --git a/doc/gawk.texi b/doc/gawk.texi
index b24445e3..5270d419 100644
--- a/doc/gawk.texi
+++ b/doc/gawk.texi
@@ -1012,6 +1012,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.
@@ -39120,7 +39123,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
@@ -39136,6 +39138,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
@@ -39168,40 +39179,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
@@ -39219,6 +39196,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 647bb0fb..322f3a2f 100644
--- a/doc/gawktexi.in
+++ b/doc/gawktexi.in
@@ -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.
@@ -38202,7 +38205,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
@@ -38218,6 +38220,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
@@ -38250,40 +38261,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
@@ -38301,6 +38278,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,