Merge branch 'gawk-4.1-stable'

4 files changed, 582 insertions, 576 deletions

diff --git a/doc/ChangeLog b/doc/ChangeLog
index 93441078..70fa1abd 100644
--- a/doc/ChangeLog
+++ b/doc/ChangeLog
@@ -1,3 +1,7 @@
+2015-02-19         Arnold D. Robbins     <arnold@skeeve.com>
+
+	* gawktexi.in: More O'Reilly fixes.
+
 2015-02-17         Arnold D. Robbins     <arnold@skeeve.com>
 
 	* gawktexi.in: A few minor formatting fixes to sync with O'Reilly
diff --git a/doc/gawk.info b/doc/gawk.info
index d299f965..012d95a9 100644
--- a/doc/gawk.info
+++ b/doc/gawk.info
@@ -10184,15 +10184,14 @@ description of each variable.)
 
 `IGNORECASE #'
      If `IGNORECASE' is nonzero or non-null, then all string comparisons
-     and all regular expression matching are case-independent.  Thus,
-     regexp matching with `~' and `!~', as well as the `gensub()',
+     and all regular expression matching are case-independent.  This
+     applies to regexp matching with `~' and `!~', the `gensub()',
      `gsub()', `index()', `match()', `patsplit()', `split()', and
      `sub()' functions, record termination with `RS', and field
-     splitting with `FS' and `FPAT', all ignore case when doing their
-     particular regexp operations.  However, the value of `IGNORECASE'
-     does _not_ affect array subscripting and it does not affect field
-     splitting when using a single-character field separator.  *Note
-     Case-sensitivity::.
+     splitting with `FS' and `FPAT'.  However, the value of
+     `IGNORECASE' does _not_ affect array subscripting and it does not
+     affect field splitting when using a single-character field
+     separator.  *Note Case-sensitivity::.
 
 `LINT #'
      When this variable is true (nonzero or non-null), `gawk' behaves
@@ -14318,61 +14317,7 @@ names of the two comparison functions:
      -|     rsort: <100.0 95.6 93.4 87.1>
 
    Another example where indirect functions calls are useful can be
-found in processing arrays.  *note Walking Arrays::, presented a simple
-function for "walking" an array of arrays.  That function simply
-printed the name and value of each scalar array element. However, it is
-easy to generalize that function, by passing in the name of a function
-to call when walking an array. The modified function looks like this:
-
-     function process_array(arr, name, process, do_arrays,   i, new_name)
-     {
-         for (i in arr) {
-             new_name = (name "[" i "]")
-             if (isarray(arr[i])) {
-                 if (do_arrays)
-                     @process(new_name, arr[i])
-                 process_array(arr[i], new_name, process, do_arrays)
-             } else
-                 @process(new_name, arr[i])
-         }
-     }
-
-   The arguments are as follows:
-
-`arr'
-     The array.
-
-`name'
-     The name of the array (a string).
-
-`process'
-     The name of the function to call.
-
-`do_arrays'
-     If this is true, the function can handle elements that are
-     subarrays.
-
-   If subarrays are to be processed, that is done before walking them
-further.
-
-   When run with the following scaffolding, the function produces the
-same results as does the earlier `walk_array()' function:
-
-     BEGIN {
-         a[1] = 1
-         a[2][1] = 21
-         a[2][2] = 22
-         a[3] = 3
-         a[4][1][1] = 411
-         a[4][2] = 42
-
-         process_array(a, "a", "do_print", 0)
-     }
-
-     function do_print(name, element)
-     {
-         printf "%s = %s\n", name, element
-     }
+found in processing arrays. This is described in *note Walking Arrays::.
 
    Remember that you must supply a leading `@' in front of an indirect
 function call.
@@ -16349,6 +16294,61 @@ value.  Here is a main program to demonstrate:
      -| a[4][1][1] = 411
      -| a[4][2] = 42
 
+   The function just presented simply prints the name and value of each
+scalar array element. However, it is easy to generalize it, by passing
+in the name of a function to call when walking an array. The modified
+function looks like this:
+
+     function process_array(arr, name, process, do_arrays,   i, new_name)
+     {
+         for (i in arr) {
+             new_name = (name "[" i "]")
+             if (isarray(arr[i])) {
+                 if (do_arrays)
+                     @process(new_name, arr[i])
+                 process_array(arr[i], new_name, process, do_arrays)
+             } else
+                 @process(new_name, arr[i])
+         }
+     }
+
+   The arguments are as follows:
+
+`arr'
+     The array.
+
+`name'
+     The name of the array (a string).
+
+`process'
+     The name of the function to call.
+
+`do_arrays'
+     If this is true, the function can handle elements that are
+     subarrays.
+
+   If subarrays are to be processed, that is done before walking them
+further.
+
+   When run with the following scaffolding, the function produces the
+same results as does the earlier version of `walk_array()':
+
+     BEGIN {
+         a[1] = 1
+         a[2][1] = 21
+         a[2][2] = 22
+         a[3] = 3
+         a[4][1][1] = 411
+         a[4][2] = 42
+
+         process_array(a, "a", "do_print", 0)
+     }
+
+     function do_print(name, element)
+     {
+         printf "%s = %s\n", name, element
+     }
+
 
 File: gawk.info,  Node: Library Functions Summary,  Next: Library Exercises,  Prev: Walking Arrays,  Up: Library Functions
 
@@ -16383,7 +16383,7 @@ File: gawk.info,  Node: Library Functions Summary,  Next: Library Exercises,  Pr
           Two sets of routines that parallel the C library versions
 
     Traversing arrays of arrays
-          A simple function to traverse an array of arrays to any depth
+          Two functions that traverse an array of arrays to any depth
 
 
 
@@ -32674,7 +32674,7 @@ Index
                                                               (line   6)
 * differences in awk and gawk, line continuations: Conditional Exp.
                                                               (line  34)
-* differences in awk and gawk, LINT variable: User-modified.  (line  88)
+* differences in awk and gawk, LINT variable: User-modified.  (line  87)
 * differences in awk and gawk, match() function: String Functions.
                                                               (line 263)
 * differences in awk and gawk, print/printf statements: Format Modifiers.
@@ -32699,7 +32699,7 @@ Index
                                                               (line  77)
 * differences in awk and gawk, SYMTAB variable: Auto-set.     (line 283)
 * differences in awk and gawk, TEXTDOMAIN variable: User-modified.
-                                                              (line 152)
+                                                              (line 151)
 * differences in awk and gawk, trunc-mod operation: Arithmetic Ops.
                                                               (line  66)
 * directories, command-line:             Command-line directories.
@@ -33162,7 +33162,7 @@ Index
                                                               (line   6)
 * gawk, interval expressions and:        Regexp Operators.    (line 139)
 * gawk, line continuation in:            Conditional Exp.     (line  34)
-* gawk, LINT variable in:                User-modified.       (line  88)
+* gawk, LINT variable in:                User-modified.       (line  87)
 * gawk, list of contributors to:         Contributors.        (line   6)
 * gawk, MS-DOS version of:               PC Using.            (line  10)
 * gawk, MS-Windows version of:           PC Using.            (line  10)
@@ -33188,7 +33188,7 @@ Index
 * gawk, splitting fields and:            Constant Size.       (line  87)
 * gawk, string-translation functions:    I18N Functions.      (line   6)
 * gawk, SYMTAB array in:                 Auto-set.            (line 283)
-* gawk, TEXTDOMAIN variable in:          User-modified.       (line 152)
+* gawk, TEXTDOMAIN variable in:          User-modified.       (line 151)
 * gawk, timestamps:                      Time Functions.      (line   6)
 * gawk, uses for:                        Preface.             (line  34)
 * gawk, versions of, information about, printing: Options.    (line 300)
@@ -33392,7 +33392,7 @@ Index
 * internationalization:                  I18N Functions.      (line   6)
 * internationalization, localization <1>: Internationalization.
                                                               (line  13)
-* internationalization, localization:    User-modified.       (line 152)
+* internationalization, localization:    User-modified.       (line 151)
 * internationalization, localization, character classes: Bracket Expressions.
                                                               (line 101)
 * internationalization, localization, gawk and: Internationalization.
@@ -33502,7 +33502,7 @@ Index
 * lines, duplicate, removing:            History Sorting.     (line   6)
 * lines, matching ranges of:             Ranges.              (line   6)
 * lines, skipping between markers:       Ranges.              (line  43)
-* lint checking:                         User-modified.       (line  88)
+* lint checking:                         User-modified.       (line  87)
 * lint checking, array elements:         Delete.              (line  34)
 * lint checking, array subscripts:       Uninitialized Subscripts.
                                                               (line  43)
@@ -33512,7 +33512,7 @@ Index
                                                               (line 339)
 * lint checking, undefined functions:    Pass By Value/Reference.
                                                               (line  85)
-* LINT variable:                         User-modified.       (line  88)
+* LINT variable:                         User-modified.       (line  87)
 * Linux <1>:                             Glossary.            (line 753)
 * Linux <2>:                             I18N Example.        (line  55)
 * Linux:                                 Manual History.      (line  28)
@@ -33684,11 +33684,11 @@ Index
 * obsolete features:                     Obsolete.            (line   6)
 * octal numbers:                         Nondecimal-numbers.  (line   6)
 * octal values, enabling interpretation of: Options.          (line 211)
-* OFMT variable <1>:                     User-modified.       (line 105)
+* OFMT variable <1>:                     User-modified.       (line 104)
 * OFMT variable <2>:                     Strings And Numbers. (line  57)
 * OFMT variable:                         OFMT.                (line  15)
 * OFMT variable, POSIX awk and:          OFMT.                (line  27)
-* OFS variable <1>:                      User-modified.       (line 114)
+* OFS variable <1>:                      User-modified.       (line 113)
 * OFS variable <2>:                      Output Separators.   (line   6)
 * OFS variable:                          Changing Fields.     (line  64)
 * OpenBSD:                               Glossary.            (line 753)
@@ -33741,7 +33741,7 @@ Index
                                                               (line  12)
 * ord() user-defined function:           Ordinal Functions.   (line  16)
 * order of evaluation, concatenation:    Concatenation.       (line  41)
-* ORS variable <1>:                      User-modified.       (line 119)
+* ORS variable <1>:                      User-modified.       (line 118)
 * ORS variable:                          Output Separators.   (line  21)
 * output field separator, See OFS variable: Changing Fields.  (line  64)
 * output record separator, See ORS variable: Output Separators.
@@ -33881,7 +33881,7 @@ Index
 * POSIX, gawk extensions not included in: POSIX/GNU.          (line   6)
 * POSIX, programs, implementing in awk:  Clones.              (line   6)
 * POSIXLY_CORRECT environment variable:  Options.             (line 339)
-* PREC variable:                         User-modified.       (line 124)
+* PREC variable:                         User-modified.       (line 123)
 * precedence <1>:                        Precedence.          (line   6)
 * precedence:                            Increment Ops.       (line  60)
 * precedence, regexp operators:          Regexp Operators.    (line 156)
@@ -33896,7 +33896,7 @@ Index
 * print statement, commas, omitting:     Print Examples.      (line  31)
 * print statement, I/O operators in:     Precedence.          (line  71)
 * print statement, line continuations and: Print Examples.    (line  76)
-* print statement, OFMT variable and:    User-modified.       (line 114)
+* print statement, OFMT variable and:    User-modified.       (line 113)
 * print statement, See Also redirection, of output: Redirection.
                                                               (line  17)
 * print statement, sprintf() function and: Round Function.    (line   6)
@@ -34011,7 +34011,7 @@ Index
 * readfile() user-defined function:      Readfile Function.   (line  30)
 * reading input files:                   Reading Files.       (line   6)
 * recipe for a programming language:     History.             (line   6)
-* record separators <1>:                 User-modified.       (line 133)
+* record separators <1>:                 User-modified.       (line 132)
 * record separators:                     awk split records.   (line   6)
 * record separators, changing:           awk split records.   (line  85)
 * record separators, regular expressions as: awk split records.
@@ -34123,8 +34123,8 @@ Index
 * round to nearest integer:              Numeric Functions.   (line  38)
 * round() user-defined function:         Round Function.      (line  16)
 * rounding numbers:                      Round Function.      (line   6)
-* ROUNDMODE variable:                    User-modified.       (line 128)
-* RS variable <1>:                       User-modified.       (line 133)
+* ROUNDMODE variable:                    User-modified.       (line 127)
+* RS variable <1>:                       User-modified.       (line 132)
 * RS variable:                           awk split records.   (line  12)
 * RS variable, multiline records and:    Multiple Line.       (line  17)
 * rshift:                                Bitwise Functions.   (line  53)
@@ -34181,12 +34181,12 @@ Index
 * separators, field, FIELDWIDTHS variable and: User-modified. (line  37)
 * separators, field, FPAT variable and:  User-modified.       (line  43)
 * separators, field, POSIX and:          Fields.              (line   6)
-* separators, for records <1>:           User-modified.       (line 133)
+* separators, for records <1>:           User-modified.       (line 132)
 * separators, for records:               awk split records.   (line   6)
 * separators, for records, regular expressions as: awk split records.
                                                               (line 125)
 * separators, for statements in actions: Action Overview.     (line  19)
-* separators, subscript:                 User-modified.       (line 146)
+* separators, subscript:                 User-modified.       (line 145)
 * set breakpoint:                        Breakpoint Control.  (line  11)
 * set debugger command:                  Viewing And Changing Data.
                                                               (line  59)
@@ -34318,7 +34318,7 @@ Index
 * split.awk program:                     Split Program.       (line  30)
 * sprintf <1>:                           String Functions.    (line 384)
 * sprintf:                               OFMT.                (line  15)
-* sprintf() function, OFMT variable and: User-modified.       (line 114)
+* sprintf() function, OFMT variable and: User-modified.       (line 113)
 * sprintf() function, print/printf statements and: Round Function.
                                                               (line   6)
 * sqrt:                                  Numeric Functions.   (line  92)
@@ -34380,7 +34380,7 @@ Index
                                                               (line  43)
 * sub() function, arguments of:          String Functions.    (line 463)
 * sub() function, escape processing:     Gory Details.        (line   6)
-* subscript separators:                  User-modified.       (line 146)
+* subscript separators:                  User-modified.       (line 145)
 * subscripts in arrays, multidimensional: Multidimensional.   (line  10)
 * subscripts in arrays, multidimensional, scanning: Multiscanning.
                                                               (line  11)
@@ -34388,7 +34388,7 @@ Index
                                                               (line   6)
 * subscripts in arrays, uninitialized variables as: Uninitialized Subscripts.
                                                               (line   6)
-* SUBSEP variable:                       User-modified.       (line 146)
+* SUBSEP variable:                       User-modified.       (line 145)
 * SUBSEP variable, and multidimensional arrays: Multidimensional.
                                                               (line  16)
 * substitute in string:                  String Functions.    (line  90)
@@ -34427,7 +34427,7 @@ Index
 * text, printing:                        Print.               (line  22)
 * text, printing, unduplicated lines of: Uniq Program.        (line   6)
 * TEXTDOMAIN variable <1>:               Programmer i18n.     (line   8)
-* TEXTDOMAIN variable:                   User-modified.       (line 152)
+* TEXTDOMAIN variable:                   User-modified.       (line 151)
 * TEXTDOMAIN variable, BEGIN pattern and: Programmer i18n.    (line  60)
 * TEXTDOMAIN variable, portability and:  I18N Portability.    (line  20)
 * textdomain() function (C library):     Explaining gettext.  (line  28)
@@ -34866,361 +34866,361 @@ Node: Nextfile Statement426905
 Node: Exit Statement429533
 Node: Built-in Variables431944
 Node: User-modified433077
-Ref: User-modified-Footnote-1440780
-Node: Auto-set440842
-Ref: Auto-set-Footnote-1454551
-Ref: Auto-set-Footnote-2454756
-Node: ARGC and ARGV454812
-Node: Pattern Action Summary459030
-Node: Arrays461463
-Node: Array Basics462792
-Node: Array Intro463636
-Ref: figure-array-elements465570
-Ref: Array Intro-Footnote-1468190
-Node: Reference to Elements468318
-Node: Assigning Elements470780
-Node: Array Example471271
-Node: Scanning an Array473030
-Node: Controlling Scanning476050
-Ref: Controlling Scanning-Footnote-1481444
-Node: Numeric Array Subscripts481760
-Node: Uninitialized Subscripts483945
-Node: Delete485562
-Ref: Delete-Footnote-1488311
-Node: Multidimensional488368
-Node: Multiscanning491465
-Node: Arrays of Arrays493054
-Node: Arrays Summary497808
-Node: Functions499899
-Node: Built-in500938
-Node: Calling Built-in502016
-Node: Numeric Functions504011
-Ref: Numeric Functions-Footnote-1508829
-Ref: Numeric Functions-Footnote-2509186
-Ref: Numeric Functions-Footnote-3509234
-Node: String Functions509506
-Ref: String Functions-Footnote-1533007
-Ref: String Functions-Footnote-2533136
-Ref: String Functions-Footnote-3533384
-Node: Gory Details533471
-Ref: table-sub-escapes535252
-Ref: table-sub-proposed536767
-Ref: table-posix-sub538129
-Ref: table-gensub-escapes539666
-Ref: Gory Details-Footnote-1540499
-Node: I/O Functions540650
-Ref: I/O Functions-Footnote-1547886
-Node: Time Functions548033
-Ref: Time Functions-Footnote-1558542
-Ref: Time Functions-Footnote-2558610
-Ref: Time Functions-Footnote-3558768
-Ref: Time Functions-Footnote-4558879
-Ref: Time Functions-Footnote-5558991
-Ref: Time Functions-Footnote-6559218
-Node: Bitwise Functions559484
-Ref: table-bitwise-ops560046
-Ref: Bitwise Functions-Footnote-1564374
-Node: Type Functions564546
-Node: I18N Functions565698
-Node: User-defined567345
-Node: Definition Syntax568150
-Ref: Definition Syntax-Footnote-1573809
-Node: Function Example573880
-Ref: Function Example-Footnote-1576801
-Node: Function Caveats576823
-Node: Calling A Function577341
-Node: Variable Scope578299
-Node: Pass By Value/Reference581292
-Node: Return Statement584789
-Node: Dynamic Typing587768
-Node: Indirect Calls588697
-Ref: Indirect Calls-Footnote-1600003
-Node: Functions Summary600131
-Node: Library Functions602833
-Ref: Library Functions-Footnote-1606441
-Ref: Library Functions-Footnote-2606584
-Node: Library Names606755
-Ref: Library Names-Footnote-1610213
-Ref: Library Names-Footnote-2610436
-Node: General Functions610522
-Node: Strtonum Function611625
-Node: Assert Function614647
-Node: Round Function617971
-Node: Cliff Random Function619512
-Node: Ordinal Functions620528
-Ref: Ordinal Functions-Footnote-1623591
-Ref: Ordinal Functions-Footnote-2623843
-Node: Join Function624054
-Ref: Join Function-Footnote-1625824
-Node: Getlocaltime Function626024
-Node: Readfile Function629768
-Node: Shell Quoting631740
-Node: Data File Management633141
-Node: Filetrans Function633773
-Node: Rewind Function637869
-Node: File Checking639255
-Ref: File Checking-Footnote-1640588
-Node: Empty Files640789
-Node: Ignoring Assigns642768
-Node: Getopt Function644318
-Ref: Getopt Function-Footnote-1655782
-Node: Passwd Functions655982
-Ref: Passwd Functions-Footnote-1664822
-Node: Group Functions664910
-Ref: Group Functions-Footnote-1672807
-Node: Walking Arrays673012
-Node: Library Functions Summary674612
-Node: Library Exercises676016
-Node: Sample Programs677296
-Node: Running Examples678066
-Node: Clones678794
-Node: Cut Program680018
-Node: Egrep Program689738
-Ref: Egrep Program-Footnote-1697241
-Node: Id Program697351
-Node: Split Program701027
-Ref: Split Program-Footnote-1704481
-Node: Tee Program704609
-Node: Uniq Program707398
-Node: Wc Program714817
-Ref: Wc Program-Footnote-1719067
-Node: Miscellaneous Programs719161
-Node: Dupword Program720374
-Node: Alarm Program722405
-Node: Translate Program727210
-Ref: Translate Program-Footnote-1731773
-Node: Labels Program732043
-Ref: Labels Program-Footnote-1735394
-Node: Word Sorting735478
-Node: History Sorting739548
-Node: Extract Program741383
-Node: Simple Sed748907
-Node: Igawk Program751977
-Ref: Igawk Program-Footnote-1766303
-Ref: Igawk Program-Footnote-2766504
-Ref: Igawk Program-Footnote-3766626
-Node: Anagram Program766741
-Node: Signature Program769802
-Node: Programs Summary771049
-Node: Programs Exercises772270
-Ref: Programs Exercises-Footnote-1776401
-Node: Advanced Features776492
-Node: Nondecimal Data778474
-Node: Array Sorting780064
-Node: Controlling Array Traversal780764
-Ref: Controlling Array Traversal-Footnote-1789130
-Node: Array Sorting Functions789248
-Ref: Array Sorting Functions-Footnote-1793134
-Node: Two-way I/O793330
-Ref: Two-way I/O-Footnote-1798275
-Ref: Two-way I/O-Footnote-2798461
-Node: TCP/IP Networking798543
-Node: Profiling801415
-Node: Advanced Features Summary809686
-Node: Internationalization811619
-Node: I18N and L10N813099
-Node: Explaining gettext813785
-Ref: Explaining gettext-Footnote-1818810
-Ref: Explaining gettext-Footnote-2818994
-Node: Programmer i18n819159
-Ref: Programmer i18n-Footnote-1824035
-Node: Translator i18n824084
-Node: String Extraction824878
-Ref: String Extraction-Footnote-1826009
-Node: Printf Ordering826095
-Ref: Printf Ordering-Footnote-1828881
-Node: I18N Portability828945
-Ref: I18N Portability-Footnote-1831401
-Node: I18N Example831464
-Ref: I18N Example-Footnote-1834267
-Node: Gawk I18N834339
-Node: I18N Summary834983
-Node: Debugger836323
-Node: Debugging837345
-Node: Debugging Concepts837786
-Node: Debugging Terms839596
-Node: Awk Debugging842168
-Node: Sample Debugging Session843074
-Node: Debugger Invocation843608
-Node: Finding The Bug844993
-Node: List of Debugger Commands851472
-Node: Breakpoint Control852804
-Node: Debugger Execution Control856481
-Node: Viewing And Changing Data859840
-Node: Execution Stack863216
-Node: Debugger Info864851
-Node: Miscellaneous Debugger Commands868896
-Node: Readline Support873897
-Node: Limitations874791
-Node: Debugging Summary876906
-Node: Arbitrary Precision Arithmetic878080
-Node: Computer Arithmetic879496
-Ref: table-numeric-ranges883095
-Ref: Computer Arithmetic-Footnote-1883619
-Node: Math Definitions883676
-Ref: table-ieee-formats886971
-Ref: Math Definitions-Footnote-1887575
-Node: MPFR features887680
-Node: FP Math Caution889351
-Ref: FP Math Caution-Footnote-1890401
-Node: Inexactness of computations890770
-Node: Inexact representation891729
-Node: Comparing FP Values893087
-Node: Errors accumulate894169
-Node: Getting Accuracy895601
-Node: Try To Round898305
-Node: Setting precision899204
-Ref: table-predefined-precision-strings899888
-Node: Setting the rounding mode901717
-Ref: table-gawk-rounding-modes902081
-Ref: Setting the rounding mode-Footnote-1905533
-Node: Arbitrary Precision Integers905712
-Ref: Arbitrary Precision Integers-Footnote-1910610
-Node: POSIX Floating Point Problems910759
-Ref: POSIX Floating Point Problems-Footnote-1914638
-Node: Floating point summary914676
-Node: Dynamic Extensions916872
-Node: Extension Intro918424
-Node: Plugin License919689
-Node: Extension Mechanism Outline920486
-Ref: figure-load-extension920914
-Ref: figure-register-new-function922394
-Ref: figure-call-new-function923398
-Node: Extension API Description925385
-Node: Extension API Functions Introduction926835
-Node: General Data Types931656
-Ref: General Data Types-Footnote-1937556
-Node: Memory Allocation Functions937855
-Ref: Memory Allocation Functions-Footnote-1940694
-Node: Constructor Functions940793
-Node: Registration Functions942532
-Node: Extension Functions943217
-Node: Exit Callback Functions945514
-Node: Extension Version String946762
-Node: Input Parsers947425
-Node: Output Wrappers957300
-Node: Two-way processors961813
-Node: Printing Messages964076
-Ref: Printing Messages-Footnote-1965152
-Node: Updating `ERRNO'965304
-Node: Requesting Values966044
-Ref: table-value-types-returned966771
-Node: Accessing Parameters967728
-Node: Symbol Table Access968962
-Node: Symbol table by name969476
-Node: Symbol table by cookie971496
-Ref: Symbol table by cookie-Footnote-1975641
-Node: Cached values975704
-Ref: Cached values-Footnote-1979200
-Node: Array Manipulation979291
-Ref: Array Manipulation-Footnote-1980389
-Node: Array Data Types980426
-Ref: Array Data Types-Footnote-1983081
-Node: Array Functions983173
-Node: Flattening Arrays987032
-Node: Creating Arrays993934
-Node: Extension API Variables998705
-Node: Extension Versioning999341
-Node: Extension API Informational Variables1001232
-Node: Extension API Boilerplate1002297
-Node: Finding Extensions1006106
-Node: Extension Example1006666
-Node: Internal File Description1007438
-Node: Internal File Ops1011505
-Ref: Internal File Ops-Footnote-11023256
-Node: Using Internal File Ops1023396
-Ref: Using Internal File Ops-Footnote-11025779
-Node: Extension Samples1026052
-Node: Extension Sample File Functions1027580
-Node: Extension Sample Fnmatch1035261
-Node: Extension Sample Fork1036749
-Node: Extension Sample Inplace1037964
-Node: Extension Sample Ord1039640
-Node: Extension Sample Readdir1040476
-Ref: table-readdir-file-types1041353
-Node: Extension Sample Revout1042164
-Node: Extension Sample Rev2way1042753
-Node: Extension Sample Read write array1043493
-Node: Extension Sample Readfile1045433
-Node: Extension Sample Time1046528
-Node: Extension Sample API Tests1047876
-Node: gawkextlib1048367
-Node: Extension summary1051045
-Node: Extension Exercises1054734
-Node: Language History1055456
-Node: V7/SVR3.11057112
-Node: SVR41059265
-Node: POSIX1060699
-Node: BTL1062080
-Node: POSIX/GNU1062811
-Node: Feature History1068556
-Node: Common Extensions1082282
-Node: Ranges and Locales1083654
-Ref: Ranges and Locales-Footnote-11088273
-Ref: Ranges and Locales-Footnote-21088300
-Ref: Ranges and Locales-Footnote-31088535
-Node: Contributors1088756
-Node: History summary1094296
-Node: Installation1095675
-Node: Gawk Distribution1096621
-Node: Getting1097105
-Node: Extracting1097928
-Node: Distribution contents1099565
-Node: Unix Installation1105667
-Node: Quick Installation1106350
-Node: Shell Startup Files1108761
-Node: Additional Configuration Options1109840
-Node: Configuration Philosophy1111644
-Node: Non-Unix Installation1114013
-Node: PC Installation1114471
-Node: PC Binary Installation1115791
-Node: PC Compiling1117639
-Ref: PC Compiling-Footnote-11120660
-Node: PC Testing1120769
-Node: PC Using1121945
-Node: Cygwin1126060
-Node: MSYS1126830
-Node: VMS Installation1127331
-Node: VMS Compilation1128123
-Ref: VMS Compilation-Footnote-11129352
-Node: VMS Dynamic Extensions1129410
-Node: VMS Installation Details1131094
-Node: VMS Running1133345
-Node: VMS GNV1136185
-Node: VMS Old Gawk1136920
-Node: Bugs1137390
-Node: Other Versions1141279
-Node: Installation summary1147713
-Node: Notes1148772
-Node: Compatibility Mode1149637
-Node: Additions1150419
-Node: Accessing The Source1151344
-Node: Adding Code1152779
-Node: New Ports1158936
-Node: Derived Files1163418
-Ref: Derived Files-Footnote-11168893
-Ref: Derived Files-Footnote-21168927
-Ref: Derived Files-Footnote-31169523
-Node: Future Extensions1169637
-Node: Implementation Limitations1170243
-Node: Extension Design1171491
-Node: Old Extension Problems1172645
-Ref: Old Extension Problems-Footnote-11174162
-Node: Extension New Mechanism Goals1174219
-Ref: Extension New Mechanism Goals-Footnote-11177579
-Node: Extension Other Design Decisions1177768
-Node: Extension Future Growth1179876
-Node: Old Extension Mechanism1180712
-Node: Notes summary1182474
-Node: Basic Concepts1183660
-Node: Basic High Level1184341
-Ref: figure-general-flow1184613
-Ref: figure-process-flow1185212
-Ref: Basic High Level-Footnote-11188441
-Node: Basic Data Typing1188626
-Node: Glossary1191954
-Node: Copying1223883
-Node: GNU Free Documentation License1261439
-Node: Index1286575
+Ref: User-modified-Footnote-1440711
+Node: Auto-set440773
+Ref: Auto-set-Footnote-1454482
+Ref: Auto-set-Footnote-2454687
+Node: ARGC and ARGV454743
+Node: Pattern Action Summary458961
+Node: Arrays461394
+Node: Array Basics462723
+Node: Array Intro463567
+Ref: figure-array-elements465501
+Ref: Array Intro-Footnote-1468121
+Node: Reference to Elements468249
+Node: Assigning Elements470711
+Node: Array Example471202
+Node: Scanning an Array472961
+Node: Controlling Scanning475981
+Ref: Controlling Scanning-Footnote-1481375
+Node: Numeric Array Subscripts481691
+Node: Uninitialized Subscripts483876
+Node: Delete485493
+Ref: Delete-Footnote-1488242
+Node: Multidimensional488299
+Node: Multiscanning491396
+Node: Arrays of Arrays492985
+Node: Arrays Summary497739
+Node: Functions499830
+Node: Built-in500869
+Node: Calling Built-in501947
+Node: Numeric Functions503942
+Ref: Numeric Functions-Footnote-1508760
+Ref: Numeric Functions-Footnote-2509117
+Ref: Numeric Functions-Footnote-3509165
+Node: String Functions509437
+Ref: String Functions-Footnote-1532938
+Ref: String Functions-Footnote-2533067
+Ref: String Functions-Footnote-3533315
+Node: Gory Details533402
+Ref: table-sub-escapes535183
+Ref: table-sub-proposed536698
+Ref: table-posix-sub538060
+Ref: table-gensub-escapes539597
+Ref: Gory Details-Footnote-1540430
+Node: I/O Functions540581
+Ref: I/O Functions-Footnote-1547817
+Node: Time Functions547964
+Ref: Time Functions-Footnote-1558473
+Ref: Time Functions-Footnote-2558541
+Ref: Time Functions-Footnote-3558699
+Ref: Time Functions-Footnote-4558810
+Ref: Time Functions-Footnote-5558922
+Ref: Time Functions-Footnote-6559149
+Node: Bitwise Functions559415
+Ref: table-bitwise-ops559977
+Ref: Bitwise Functions-Footnote-1564305
+Node: Type Functions564477
+Node: I18N Functions565629
+Node: User-defined567276
+Node: Definition Syntax568081
+Ref: Definition Syntax-Footnote-1573740
+Node: Function Example573811
+Ref: Function Example-Footnote-1576732
+Node: Function Caveats576754
+Node: Calling A Function577272
+Node: Variable Scope578230
+Node: Pass By Value/Reference581223
+Node: Return Statement584720
+Node: Dynamic Typing587699
+Node: Indirect Calls588628
+Ref: Indirect Calls-Footnote-1598493
+Node: Functions Summary598621
+Node: Library Functions601323
+Ref: Library Functions-Footnote-1604931
+Ref: Library Functions-Footnote-2605074
+Node: Library Names605245
+Ref: Library Names-Footnote-1608703
+Ref: Library Names-Footnote-2608926
+Node: General Functions609012
+Node: Strtonum Function610115
+Node: Assert Function613137
+Node: Round Function616461
+Node: Cliff Random Function618002
+Node: Ordinal Functions619018
+Ref: Ordinal Functions-Footnote-1622081
+Ref: Ordinal Functions-Footnote-2622333
+Node: Join Function622544
+Ref: Join Function-Footnote-1624314
+Node: Getlocaltime Function624514
+Node: Readfile Function628258
+Node: Shell Quoting630230
+Node: Data File Management631631
+Node: Filetrans Function632263
+Node: Rewind Function636359
+Node: File Checking637745
+Ref: File Checking-Footnote-1639078
+Node: Empty Files639279
+Node: Ignoring Assigns641258
+Node: Getopt Function642808
+Ref: Getopt Function-Footnote-1654272
+Node: Passwd Functions654472
+Ref: Passwd Functions-Footnote-1663312
+Node: Group Functions663400
+Ref: Group Functions-Footnote-1671297
+Node: Walking Arrays671502
+Node: Library Functions Summary674508
+Node: Library Exercises675910
+Node: Sample Programs677190
+Node: Running Examples677960
+Node: Clones678688
+Node: Cut Program679912
+Node: Egrep Program689632
+Ref: Egrep Program-Footnote-1697135
+Node: Id Program697245
+Node: Split Program700921
+Ref: Split Program-Footnote-1704375
+Node: Tee Program704503
+Node: Uniq Program707292
+Node: Wc Program714711
+Ref: Wc Program-Footnote-1718961
+Node: Miscellaneous Programs719055
+Node: Dupword Program720268
+Node: Alarm Program722299
+Node: Translate Program727104
+Ref: Translate Program-Footnote-1731667
+Node: Labels Program731937
+Ref: Labels Program-Footnote-1735288
+Node: Word Sorting735372
+Node: History Sorting739442
+Node: Extract Program741277
+Node: Simple Sed748801
+Node: Igawk Program751871
+Ref: Igawk Program-Footnote-1766197
+Ref: Igawk Program-Footnote-2766398
+Ref: Igawk Program-Footnote-3766520
+Node: Anagram Program766635
+Node: Signature Program769696
+Node: Programs Summary770943
+Node: Programs Exercises772164
+Ref: Programs Exercises-Footnote-1776295
+Node: Advanced Features776386
+Node: Nondecimal Data778368
+Node: Array Sorting779958
+Node: Controlling Array Traversal780658
+Ref: Controlling Array Traversal-Footnote-1789024
+Node: Array Sorting Functions789142
+Ref: Array Sorting Functions-Footnote-1793028
+Node: Two-way I/O793224
+Ref: Two-way I/O-Footnote-1798169
+Ref: Two-way I/O-Footnote-2798355
+Node: TCP/IP Networking798437
+Node: Profiling801309
+Node: Advanced Features Summary809580
+Node: Internationalization811513
+Node: I18N and L10N812993
+Node: Explaining gettext813679
+Ref: Explaining gettext-Footnote-1818704
+Ref: Explaining gettext-Footnote-2818888
+Node: Programmer i18n819053
+Ref: Programmer i18n-Footnote-1823929
+Node: Translator i18n823978
+Node: String Extraction824772
+Ref: String Extraction-Footnote-1825903
+Node: Printf Ordering825989
+Ref: Printf Ordering-Footnote-1828775
+Node: I18N Portability828839
+Ref: I18N Portability-Footnote-1831295
+Node: I18N Example831358
+Ref: I18N Example-Footnote-1834161
+Node: Gawk I18N834233
+Node: I18N Summary834877
+Node: Debugger836217
+Node: Debugging837239
+Node: Debugging Concepts837680
+Node: Debugging Terms839490
+Node: Awk Debugging842062
+Node: Sample Debugging Session842968
+Node: Debugger Invocation843502
+Node: Finding The Bug844887
+Node: List of Debugger Commands851366
+Node: Breakpoint Control852698
+Node: Debugger Execution Control856375
+Node: Viewing And Changing Data859734
+Node: Execution Stack863110
+Node: Debugger Info864745
+Node: Miscellaneous Debugger Commands868790
+Node: Readline Support873791
+Node: Limitations874685
+Node: Debugging Summary876800
+Node: Arbitrary Precision Arithmetic877974
+Node: Computer Arithmetic879390
+Ref: table-numeric-ranges882989
+Ref: Computer Arithmetic-Footnote-1883513
+Node: Math Definitions883570
+Ref: table-ieee-formats886865
+Ref: Math Definitions-Footnote-1887469
+Node: MPFR features887574
+Node: FP Math Caution889245
+Ref: FP Math Caution-Footnote-1890295
+Node: Inexactness of computations890664
+Node: Inexact representation891623
+Node: Comparing FP Values892981
+Node: Errors accumulate894063
+Node: Getting Accuracy895495
+Node: Try To Round898199
+Node: Setting precision899098
+Ref: table-predefined-precision-strings899782
+Node: Setting the rounding mode901611
+Ref: table-gawk-rounding-modes901975
+Ref: Setting the rounding mode-Footnote-1905427
+Node: Arbitrary Precision Integers905606
+Ref: Arbitrary Precision Integers-Footnote-1910504
+Node: POSIX Floating Point Problems910653
+Ref: POSIX Floating Point Problems-Footnote-1914532
+Node: Floating point summary914570
+Node: Dynamic Extensions916766
+Node: Extension Intro918318
+Node: Plugin License919583
+Node: Extension Mechanism Outline920380
+Ref: figure-load-extension920808
+Ref: figure-register-new-function922288
+Ref: figure-call-new-function923292
+Node: Extension API Description925279
+Node: Extension API Functions Introduction926729
+Node: General Data Types931550
+Ref: General Data Types-Footnote-1937450
+Node: Memory Allocation Functions937749
+Ref: Memory Allocation Functions-Footnote-1940588
+Node: Constructor Functions940687
+Node: Registration Functions942426
+Node: Extension Functions943111
+Node: Exit Callback Functions945408
+Node: Extension Version String946656
+Node: Input Parsers947319
+Node: Output Wrappers957194
+Node: Two-way processors961707
+Node: Printing Messages963970
+Ref: Printing Messages-Footnote-1965046
+Node: Updating `ERRNO'965198
+Node: Requesting Values965938
+Ref: table-value-types-returned966665
+Node: Accessing Parameters967622
+Node: Symbol Table Access968856
+Node: Symbol table by name969370
+Node: Symbol table by cookie971390
+Ref: Symbol table by cookie-Footnote-1975535
+Node: Cached values975598
+Ref: Cached values-Footnote-1979094
+Node: Array Manipulation979185
+Ref: Array Manipulation-Footnote-1980283
+Node: Array Data Types980320
+Ref: Array Data Types-Footnote-1982975
+Node: Array Functions983067
+Node: Flattening Arrays986926
+Node: Creating Arrays993828
+Node: Extension API Variables998599
+Node: Extension Versioning999235
+Node: Extension API Informational Variables1001126
+Node: Extension API Boilerplate1002191
+Node: Finding Extensions1006000
+Node: Extension Example1006560
+Node: Internal File Description1007332
+Node: Internal File Ops1011399
+Ref: Internal File Ops-Footnote-11023150
+Node: Using Internal File Ops1023290
+Ref: Using Internal File Ops-Footnote-11025673
+Node: Extension Samples1025946
+Node: Extension Sample File Functions1027474
+Node: Extension Sample Fnmatch1035155
+Node: Extension Sample Fork1036643
+Node: Extension Sample Inplace1037858
+Node: Extension Sample Ord1039534
+Node: Extension Sample Readdir1040370
+Ref: table-readdir-file-types1041247
+Node: Extension Sample Revout1042058
+Node: Extension Sample Rev2way1042647
+Node: Extension Sample Read write array1043387
+Node: Extension Sample Readfile1045327
+Node: Extension Sample Time1046422
+Node: Extension Sample API Tests1047770
+Node: gawkextlib1048261
+Node: Extension summary1050939
+Node: Extension Exercises1054628
+Node: Language History1055350
+Node: V7/SVR3.11057006
+Node: SVR41059159
+Node: POSIX1060593
+Node: BTL1061974
+Node: POSIX/GNU1062705
+Node: Feature History1068450
+Node: Common Extensions1082176
+Node: Ranges and Locales1083548
+Ref: Ranges and Locales-Footnote-11088167
+Ref: Ranges and Locales-Footnote-21088194
+Ref: Ranges and Locales-Footnote-31088429
+Node: Contributors1088650
+Node: History summary1094190
+Node: Installation1095569
+Node: Gawk Distribution1096515
+Node: Getting1096999
+Node: Extracting1097822
+Node: Distribution contents1099459
+Node: Unix Installation1105561
+Node: Quick Installation1106244
+Node: Shell Startup Files1108655
+Node: Additional Configuration Options1109734
+Node: Configuration Philosophy1111538
+Node: Non-Unix Installation1113907
+Node: PC Installation1114365
+Node: PC Binary Installation1115685
+Node: PC Compiling1117533
+Ref: PC Compiling-Footnote-11120554
+Node: PC Testing1120663
+Node: PC Using1121839
+Node: Cygwin1125954
+Node: MSYS1126724
+Node: VMS Installation1127225
+Node: VMS Compilation1128017
+Ref: VMS Compilation-Footnote-11129246
+Node: VMS Dynamic Extensions1129304
+Node: VMS Installation Details1130988
+Node: VMS Running1133239
+Node: VMS GNV1136079
+Node: VMS Old Gawk1136814
+Node: Bugs1137284
+Node: Other Versions1141173
+Node: Installation summary1147607
+Node: Notes1148666
+Node: Compatibility Mode1149531
+Node: Additions1150313
+Node: Accessing The Source1151238
+Node: Adding Code1152673
+Node: New Ports1158830
+Node: Derived Files1163312
+Ref: Derived Files-Footnote-11168787
+Ref: Derived Files-Footnote-21168821
+Ref: Derived Files-Footnote-31169417
+Node: Future Extensions1169531
+Node: Implementation Limitations1170137
+Node: Extension Design1171385
+Node: Old Extension Problems1172539
+Ref: Old Extension Problems-Footnote-11174056
+Node: Extension New Mechanism Goals1174113
+Ref: Extension New Mechanism Goals-Footnote-11177473
+Node: Extension Other Design Decisions1177662
+Node: Extension Future Growth1179770
+Node: Old Extension Mechanism1180606
+Node: Notes summary1182368
+Node: Basic Concepts1183554
+Node: Basic High Level1184235
+Ref: figure-general-flow1184507
+Ref: figure-process-flow1185106
+Ref: Basic High Level-Footnote-11188335
+Node: Basic Data Typing1188520
+Node: Glossary1191848
+Node: Copying1223777
+Node: GNU Free Documentation License1261333
+Node: Index1286469
 
 End Tag Table
diff --git a/doc/gawk.texi b/doc/gawk.texi
index f603ca52..d9e19ba1 100644
--- a/doc/gawk.texi
+++ b/doc/gawk.texi
@@ -14592,12 +14592,13 @@ is to simply say @samp{FS = FS}, perhaps with an explanatory comment.
 @cindex regular expressions, case sensitivity
 @item IGNORECASE #
 If @code{IGNORECASE} is nonzero or non-null, then all string comparisons
-and all regular expression matching are case-independent.  Thus, regexp
-matching with @samp{~} and @samp{!~}, as well as the @code{gensub()},
-@code{gsub()}, @code{index()}, @code{match()}, @code{patsplit()},
-@code{split()}, and @code{sub()}
-functions, record termination with @code{RS}, and field splitting with
-@code{FS} and @code{FPAT}, all ignore case when doing their particular regexp operations.
+and all regular expression matching are case-independent.
+This applies to
+regexp matching with @samp{~} and @samp{!~},
+the @code{gensub()}, @code{gsub()}, @code{index()}, @code{match()},
+@code{patsplit()}, @code{split()}, and @code{sub()} functions,
+record termination with @code{RS}, and field splitting with
+@code{FS} and @code{FPAT}.
 However, the value of @code{IGNORECASE} does @emph{not} affect array subscripting
 and it does not affect field splitting when using a single-character
 field separator.
@@ -20358,67 +20359,7 @@ $ @kbd{gawk -f quicksort.awk -f indirectcall.awk class_data2}
 @end example
 
 Another example where indirect functions calls are useful can be found in
-processing arrays.  @DBREF{Walking Arrays} presented a simple function
-for ``walking'' an array of arrays.  That function simply printed the
-name and value of each scalar array element. However, it is easy to
-generalize that function, by passing in the name of a function to call
-when walking an array. The modified function looks like this:
-
-@example
-@c file eg/lib/processarray.awk
-function process_array(arr, name, process, do_arrays,   i, new_name)
-@{
-    for (i in arr) @{
-        new_name = (name "[" i "]")
-        if (isarray(arr[i])) @{
-            if (do_arrays)
-                @@process(new_name, arr[i])
-            process_array(arr[i], new_name, process, do_arrays)
-        @} else
-            @@process(new_name, arr[i])
-    @}
-@}
-@c endfile
-@end example
-
-The arguments are as follows:
-
-@table @code
-@item arr
-The array.
-
-@item name
-The name of the array (a string).
-
-@item process
-The name of the function to call.
-
-@item do_arrays
-If this is true, the function can handle elements that are subarrays.
-@end table
-
-If subarrays are to be processed, that is done before walking them further.
-
-When run with the following scaffolding, the function produces the same
-results as does the earlier @code{walk_array()} function:
-
-@example
-BEGIN @{
-    a[1] = 1
-    a[2][1] = 21
-    a[2][2] = 22
-    a[3] = 3
-    a[4][1][1] = 411
-    a[4][2] = 42
-
-    process_array(a, "a", "do_print", 0)
-@}
-
-function do_print(name, element)
-@{
-    printf "%s = %s\n", name, element
-@}
-@end example
+processing arrays. This is described in @ref{Walking Arrays}.
 
 Remember that you must supply a leading @samp{@@} in front of an indirect function call.
 
@@ -23049,6 +22990,66 @@ $ @kbd{gawk -f walk_array.awk}
 @print{} a[4][2] = 42
 @end example
 
+The function just presented simply prints the
+name and value of each scalar array element. However, it is easy to
+generalize it, by passing in the name of a function to call
+when walking an array. The modified function looks like this:
+
+@example
+@c file eg/lib/processarray.awk
+function process_array(arr, name, process, do_arrays,   i, new_name)
+@{
+    for (i in arr) @{
+        new_name = (name "[" i "]")
+        if (isarray(arr[i])) @{
+            if (do_arrays)
+                @@process(new_name, arr[i])
+            process_array(arr[i], new_name, process, do_arrays)
+        @} else
+            @@process(new_name, arr[i])
+    @}
+@}
+@c endfile
+@end example
+
+The arguments are as follows:
+
+@table @code
+@item arr
+The array.
+
+@item name
+The name of the array (a string).
+
+@item process
+The name of the function to call.
+
+@item do_arrays
+If this is true, the function can handle elements that are subarrays.
+@end table
+
+If subarrays are to be processed, that is done before walking them further.
+
+When run with the following scaffolding, the function produces the same
+results as does the earlier version of @code{walk_array()}:
+
+@example
+BEGIN @{
+    a[1] = 1
+    a[2][1] = 21
+    a[2][2] = 22
+    a[3] = 3
+    a[4][1][1] = 411
+    a[4][2] = 42
+
+    process_array(a, "a", "do_print", 0)
+@}
+
+function do_print(name, element)
+@{
+    printf "%s = %s\n", name, element
+@}
+@end example
 
 @node Library Functions Summary
 @section Summary
@@ -23087,7 +23088,7 @@ An @command{awk} version of the standard C @code{getopt()} function
 Two sets of routines that parallel the C library versions
 
 @item Traversing arrays of arrays
-A simple function to traverse an array of arrays to any depth
+Two functions that traverse an array of arrays to any depth
 @end table
 @c end nested list
 
diff --git a/doc/gawktexi.in b/doc/gawktexi.in
index accb1a2a..2a24a374 100644
--- a/doc/gawktexi.in
+++ b/doc/gawktexi.in
@@ -13920,12 +13920,13 @@ is to simply say @samp{FS = FS}, perhaps with an explanatory comment.
 @cindex regular expressions, case sensitivity
 @item IGNORECASE #
 If @code{IGNORECASE} is nonzero or non-null, then all string comparisons
-and all regular expression matching are case-independent.  Thus, regexp
-matching with @samp{~} and @samp{!~}, as well as the @code{gensub()},
-@code{gsub()}, @code{index()}, @code{match()}, @code{patsplit()},
-@code{split()}, and @code{sub()}
-functions, record termination with @code{RS}, and field splitting with
-@code{FS} and @code{FPAT}, all ignore case when doing their particular regexp operations.
+and all regular expression matching are case-independent.
+This applies to
+regexp matching with @samp{~} and @samp{!~},
+the @code{gensub()}, @code{gsub()}, @code{index()}, @code{match()},
+@code{patsplit()}, @code{split()}, and @code{sub()} functions,
+record termination with @code{RS}, and field splitting with
+@code{FS} and @code{FPAT}.
 However, the value of @code{IGNORECASE} does @emph{not} affect array subscripting
 and it does not affect field splitting when using a single-character
 field separator.
@@ -19479,67 +19480,7 @@ $ @kbd{gawk -f quicksort.awk -f indirectcall.awk class_data2}
 @end example
 
 Another example where indirect functions calls are useful can be found in
-processing arrays.  @DBREF{Walking Arrays} presented a simple function
-for ``walking'' an array of arrays.  That function simply printed the
-name and value of each scalar array element. However, it is easy to
-generalize that function, by passing in the name of a function to call
-when walking an array. The modified function looks like this:
-
-@example
-@c file eg/lib/processarray.awk
-function process_array(arr, name, process, do_arrays,   i, new_name)
-@{
-    for (i in arr) @{
-        new_name = (name "[" i "]")
-        if (isarray(arr[i])) @{
-            if (do_arrays)
-                @@process(new_name, arr[i])
-            process_array(arr[i], new_name, process, do_arrays)
-        @} else
-            @@process(new_name, arr[i])
-    @}
-@}
-@c endfile
-@end example
-
-The arguments are as follows:
-
-@table @code
-@item arr
-The array.
-
-@item name
-The name of the array (a string).
-
-@item process
-The name of the function to call.
-
-@item do_arrays
-If this is true, the function can handle elements that are subarrays.
-@end table
-
-If subarrays are to be processed, that is done before walking them further.
-
-When run with the following scaffolding, the function produces the same
-results as does the earlier @code{walk_array()} function:
-
-@example
-BEGIN @{
-    a[1] = 1
-    a[2][1] = 21
-    a[2][2] = 22
-    a[3] = 3
-    a[4][1][1] = 411
-    a[4][2] = 42
-
-    process_array(a, "a", "do_print", 0)
-@}
-
-function do_print(name, element)
-@{
-    printf "%s = %s\n", name, element
-@}
-@end example
+processing arrays. This is described in @ref{Walking Arrays}.
 
 Remember that you must supply a leading @samp{@@} in front of an indirect function call.
 
@@ -22140,6 +22081,66 @@ $ @kbd{gawk -f walk_array.awk}
 @print{} a[4][2] = 42
 @end example
 
+The function just presented simply prints the
+name and value of each scalar array element. However, it is easy to
+generalize it, by passing in the name of a function to call
+when walking an array. The modified function looks like this:
+
+@example
+@c file eg/lib/processarray.awk
+function process_array(arr, name, process, do_arrays,   i, new_name)
+@{
+    for (i in arr) @{
+        new_name = (name "[" i "]")
+        if (isarray(arr[i])) @{
+            if (do_arrays)
+                @@process(new_name, arr[i])
+            process_array(arr[i], new_name, process, do_arrays)
+        @} else
+            @@process(new_name, arr[i])
+    @}
+@}
+@c endfile
+@end example
+
+The arguments are as follows:
+
+@table @code
+@item arr
+The array.
+
+@item name
+The name of the array (a string).
+
+@item process
+The name of the function to call.
+
+@item do_arrays
+If this is true, the function can handle elements that are subarrays.
+@end table
+
+If subarrays are to be processed, that is done before walking them further.
+
+When run with the following scaffolding, the function produces the same
+results as does the earlier version of @code{walk_array()}:
+
+@example
+BEGIN @{
+    a[1] = 1
+    a[2][1] = 21
+    a[2][2] = 22
+    a[3] = 3
+    a[4][1][1] = 411
+    a[4][2] = 42
+
+    process_array(a, "a", "do_print", 0)
+@}
+
+function do_print(name, element)
+@{
+    printf "%s = %s\n", name, element
+@}
+@end example
 
 @node Library Functions Summary
 @section Summary
@@ -22178,7 +22179,7 @@ An @command{awk} version of the standard C @code{getopt()} function
 Two sets of routines that parallel the C library versions
 
 @item Traversing arrays of arrays
-A simple function to traverse an array of arrays to any depth
+Two functions that traverse an array of arrays to any depth
 @end table
 @c end nested list