Indexing improvements.

4 files changed, 130 insertions, 76 deletions

diff --git a/doc/ChangeLog b/doc/ChangeLog
index 99b81306..6bb4e9c0 100644
--- a/doc/ChangeLog
+++ b/doc/ChangeLog
@@ -1,3 +1,7 @@
+2014-03-10         Arnold D. Robbins     <arnold@skeeve.com>
+
+	* gawktexi.in: Finish indexing improvements. (For now, anyway.)
+
 2014-03-08         Arnold D. Robbins     <arnold@skeeve.com>
 
 	* gawktexi.in: Minor edits to the discussion of the memory allocation
diff --git a/doc/gawk.info b/doc/gawk.info
index 9a569829..a275d9c2 100644
--- a/doc/gawk.info
+++ b/doc/gawk.info
@@ -25928,6 +25928,9 @@ Info file, in approximate chronological order:
 
    * Anders Wallin helped keep the VMS port going for several years.
 
+   * Assaf Gordon contributed the code to implement the `--sandbox'
+     option.
+
    * John Haque made the following contributions:
 
         - The modifications to convert `gawk' into a byte-code
@@ -31292,12 +31295,12 @@ Index
 * for statement, looping over arrays:    Scanning an Array.   (line  20)
 * fork() extension function:             Extension Sample Fork.
                                                               (line  11)
+* format specifiers:                     Basic Printf.        (line  15)
 * format specifiers, mixing regular with positional specifiers: Printf Ordering.
                                                               (line  57)
 * format specifiers, printf statement:   Control Letters.     (line   6)
 * format specifiers, strftime() function (gawk): Time Functions.
                                                               (line  88)
-* format strings:                        Basic Printf.        (line  15)
 * formats, numeric output:               OFMT.                (line   6)
 * formatting output:                     Printf.              (line   6)
 * forward slash (/):                     Regexp.              (line  10)
@@ -31522,6 +31525,12 @@ Index
 * gettext() function (C library):        Explaining gettext.  (line  62)
 * gettimeofday() extension function:     Extension Sample Time.
                                                               (line  13)
+* git utility <1>:                       Adding Code.         (line 111)
+* git utility <2>:                       Accessing The Source.
+                                                              (line  10)
+* git utility <3>:                       Other Versions.      (line  29)
+* git utility:                           gawkextlib.          (line  29)
+* git, use of for gawk source code:      Derived Files.       (line   6)
 * GMP:                                   Arbitrary Precision Arithmetic.
                                                               (line   6)
 * GNITS mailing list:                    Acknowledgments.     (line  52)
@@ -31538,6 +31547,7 @@ Index
 * GNU/Linux <1>:                         Glossary.            (line 624)
 * GNU/Linux <2>:                         I18N Example.        (line  55)
 * GNU/Linux:                             Manual History.      (line  28)
+* Gordon, Assaf:                         Contributors.        (line 105)
 * GPL (General Public License) <1>:      Glossary.            (line 314)
 * GPL (General Public License):          Manual History.      (line  11)
 * GPL (General Public License), printing: Options.            (line  88)
@@ -31555,7 +31565,7 @@ Index
                                                               (line  66)
 * Hankerson, Darrel <1>:                 Contributors.        (line  60)
 * Hankerson, Darrel:                     Acknowledgments.     (line  60)
-* Haque, John:                           Contributors.        (line 105)
+* Haque, John:                           Contributors.        (line 108)
 * Hartholz, Elaine:                      Acknowledgments.     (line  38)
 * Hartholz, Marshall:                    Acknowledgments.     (line  38)
 * Hasegawa, Isamu:                       Contributors.        (line  94)
@@ -31643,9 +31653,9 @@ Index
 * installing gawk:                       Installation.        (line   6)
 * INT signal (MS-Windows):               Profiling.           (line 214)
 * int() function:                        Numeric Functions.   (line  23)
-* integer, arbitrary precision:          Arbitrary Precision Integers.
-                                                              (line   6)
 * integers:                              General Arithmetic.  (line   6)
+* integers, arbitrary precision:         Arbitrary Precision Integers.
+                                                              (line   6)
 * integers, unsigned:                    General Arithmetic.  (line  15)
 * interacting with other programs:       I/O Functions.       (line  72)
 * internationalization <1>:              I18N and L10N.       (line   6)
@@ -31791,10 +31801,15 @@ Index
 * login information:                     Passwd Functions.    (line  16)
 * long options:                          Command Line.        (line  13)
 * loops:                                 While Statement.     (line   6)
+* loops, break statement and:            Break Statement.     (line   6)
 * loops, continue statements and:        For Statement.       (line  64)
 * loops, count for header:               Profiling.           (line 131)
+* loops, do-while:                       Do Statement.        (line   6)
 * loops, exiting:                        Break Statement.     (line   6)
+* loops, for, array scanning:            Scanning an Array.   (line   6)
+* loops, for, iterative:                 For Statement.       (line   6)
 * loops, See Also while statement:       While Statement.     (line   6)
+* loops, while:                          While Statement.     (line   6)
 * ls utility:                            More Complex.        (line  15)
 * lshift() function (gawk):              Bitwise Functions.   (line  46)
 * lvalues/rvalues:                       Assignment Ops.      (line  32)
@@ -32191,10 +32206,10 @@ Index
 * programming conventions, private variable names: Library Names.
                                                               (line  23)
 * programming language, recipe for:      History.             (line   6)
-* Programming languages, Ada:            Glossary.            (line  20)
+* programming languages, Ada:            Glossary.            (line  20)
 * programming languages, data-driven vs. procedural: Getting Started.
                                                               (line  12)
-* Programming languages, Java:           Glossary.            (line 388)
+* programming languages, Java:           Glossary.            (line 388)
 * programming, basic steps:              Basic High Level.    (line  20)
 * programming, concepts:                 Basic Concepts.      (line   6)
 * pwcat program:                         Passwd Functions.    (line  23)
@@ -32331,7 +32346,7 @@ Index
 * RLENGTH variable, match() function and: String Functions.   (line 220)
 * Robbins, Arnold <1>:                   Future Extensions.   (line   6)
 * Robbins, Arnold <2>:                   Bugs.                (line  32)
-* Robbins, Arnold <3>:                   Contributors.        (line 132)
+* Robbins, Arnold <3>:                   Contributors.        (line 135)
 * Robbins, Arnold <4>:                   General Data Types.  (line   6)
 * Robbins, Arnold <5>:                   Alarm Program.       (line   6)
 * Robbins, Arnold <6>:                   Passwd Functions.    (line  90)
@@ -32372,7 +32387,7 @@ Index
                                                               (line  68)
 * sandbox mode:                          Options.             (line 279)
 * scalar values:                         Basic Data Typing.   (line  13)
-* Schorr, Andrew <1>:                    Contributors.        (line 128)
+* Schorr, Andrew <1>:                    Contributors.        (line 131)
 * Schorr, Andrew:                        Acknowledgments.     (line  60)
 * Schreiber, Bert:                       Acknowledgments.     (line  38)
 * Schreiber, Rita:                       Acknowledgments.     (line  38)
@@ -32507,6 +32522,7 @@ Index
 * source code, mawk:                     Other Versions.      (line  44)
 * source code, mixing:                   Options.             (line 117)
 * source code, pawk:                     Other Versions.      (line  78)
+* source code, pawk (Python version):    Other Versions.      (line 124)
 * source code, QSE Awk:                  Other Versions.      (line 130)
 * source code, QuikTrim Awk:             Other Versions.      (line 134)
 * source code, Solaris awk:              Other Versions.      (line  96)
@@ -32807,7 +32823,7 @@ Index
 * xgettext utility:                      String Extraction.   (line  13)
 * XOR bitwise operation:                 Bitwise Functions.   (line   6)
 * xor() function (gawk):                 Bitwise Functions.   (line  55)
-* Yawitz, Efraim:                        Contributors.        (line 126)
+* Yawitz, Efraim:                        Contributors.        (line 129)
 * Zaretskii, Eli <1>:                    Bugs.                (line  70)
 * Zaretskii, Eli <2>:                    Contributors.        (line  55)
 * Zaretskii, Eli:                        Acknowledgments.     (line  60)
@@ -33308,62 +33324,62 @@ Ref: Ranges and Locales-Footnote-11034539
 Ref: Ranges and Locales-Footnote-21034566
 Ref: Ranges and Locales-Footnote-31034800
 Node: Contributors1035021
-Node: Installation1040166
-Node: Gawk Distribution1041060
-Node: Getting1041544
-Node: Extracting1042370
-Node: Distribution contents1044062
-Node: Unix Installation1049767
-Node: Quick Installation1050384
-Node: Additional Configuration Options1052830
-Node: Configuration Philosophy1054566
-Node: Non-Unix Installation1056920
-Node: PC Installation1057378
-Node: PC Binary Installation1058677
-Node: PC Compiling1060525
-Node: PC Testing1063469
-Node: PC Using1064645
-Node: Cygwin1068813
-Node: MSYS1069622
-Node: VMS Installation1070136
-Node: VMS Compilation1070900
-Ref: VMS Compilation-Footnote-11072152
-Node: VMS Dynamic Extensions1072210
-Node: VMS Installation Details1073583
-Node: VMS Running1075834
-Node: VMS GNV1078668
-Node: VMS Old Gawk1079391
-Node: Bugs1079861
-Node: Other Versions1083779
-Node: Notes1089863
-Node: Compatibility Mode1090663
-Node: Additions1091446
-Node: Accessing The Source1092373
-Node: Adding Code1093813
-Node: New Ports1099858
-Node: Derived Files1103993
-Ref: Derived Files-Footnote-11109314
-Ref: Derived Files-Footnote-21109348
-Ref: Derived Files-Footnote-31109948
-Node: Future Extensions1110046
-Node: Implementation Limitations1110629
-Node: Extension Design1111881
-Node: Old Extension Problems1113035
-Ref: Old Extension Problems-Footnote-11114543
-Node: Extension New Mechanism Goals1114600
-Ref: Extension New Mechanism Goals-Footnote-11117965
-Node: Extension Other Design Decisions1118151
-Node: Extension Future Growth1120257
-Node: Old Extension Mechanism1121093
-Node: Basic Concepts1122833
-Node: Basic High Level1123514
-Ref: figure-general-flow1123785
-Ref: figure-process-flow1124384
-Ref: Basic High Level-Footnote-11127613
-Node: Basic Data Typing1127798
-Node: Glossary1131153
-Node: Copying1156615
-Node: GNU Free Documentation License1194172
-Node: Index1219309
+Node: Installation1040248
+Node: Gawk Distribution1041142
+Node: Getting1041626
+Node: Extracting1042452
+Node: Distribution contents1044144
+Node: Unix Installation1049849
+Node: Quick Installation1050466
+Node: Additional Configuration Options1052912
+Node: Configuration Philosophy1054648
+Node: Non-Unix Installation1057002
+Node: PC Installation1057460
+Node: PC Binary Installation1058759
+Node: PC Compiling1060607
+Node: PC Testing1063551
+Node: PC Using1064727
+Node: Cygwin1068895
+Node: MSYS1069704
+Node: VMS Installation1070218
+Node: VMS Compilation1070982
+Ref: VMS Compilation-Footnote-11072234
+Node: VMS Dynamic Extensions1072292
+Node: VMS Installation Details1073665
+Node: VMS Running1075916
+Node: VMS GNV1078750
+Node: VMS Old Gawk1079473
+Node: Bugs1079943
+Node: Other Versions1083861
+Node: Notes1089945
+Node: Compatibility Mode1090745
+Node: Additions1091528
+Node: Accessing The Source1092455
+Node: Adding Code1093895
+Node: New Ports1099940
+Node: Derived Files1104075
+Ref: Derived Files-Footnote-11109396
+Ref: Derived Files-Footnote-21109430
+Ref: Derived Files-Footnote-31110030
+Node: Future Extensions1110128
+Node: Implementation Limitations1110711
+Node: Extension Design1111963
+Node: Old Extension Problems1113117
+Ref: Old Extension Problems-Footnote-11114625
+Node: Extension New Mechanism Goals1114682
+Ref: Extension New Mechanism Goals-Footnote-11118047
+Node: Extension Other Design Decisions1118233
+Node: Extension Future Growth1120339
+Node: Old Extension Mechanism1121175
+Node: Basic Concepts1122915
+Node: Basic High Level1123596
+Ref: figure-general-flow1123867
+Ref: figure-process-flow1124466
+Ref: Basic High Level-Footnote-11127695
+Node: Basic Data Typing1127880
+Node: Glossary1131235
+Node: Copying1156697
+Node: GNU Free Documentation License1194254
+Node: Index1219391
 
 End Tag Table
diff --git a/doc/gawk.texi b/doc/gawk.texi
index 09beef82..d6844144 100644
--- a/doc/gawk.texi
+++ b/doc/gawk.texi
@@ -8359,7 +8359,7 @@ parentheses are necessary if any of the item expressions use the @samp{>}
 relational operator; otherwise, it can be confused with an output redirection
 (@pxref{Redirection}).
 
-@cindex format strings
+@cindex format specifiers
 The difference between @code{printf} and @code{print} is the @var{format}
 argument.  This is an expression whose value is taken as a string; it
 specifies how to output each of the other arguments.  It is called the
@@ -12706,6 +12706,7 @@ the first thing on its line.
 @subsection The @code{while} Statement
 @cindex @code{while} statement
 @cindex loops
+@cindex loops, @code{while}
 @cindex loops, See Also @code{while} statement
 
 In programming, a @dfn{loop} is a part of a program that can
@@ -12766,6 +12767,7 @@ program is harder to read without it.
 @node Do Statement
 @subsection The @code{do}-@code{while} Statement
 @cindex @code{do}-@code{while} statement
+@cindex loops, @code{do}-@code{while}
 
 The @code{do} loop is a variation of the @code{while} looping statement.
 The @code{do} loop executes the @var{body} once and then repeats the
@@ -12811,6 +12813,7 @@ occasionally is there a real use for a @code{do} statement.
 @node For Statement
 @subsection The @code{for} Statement
 @cindex @code{for} statement
+@cindex loops, @code{for}, iterative
 
 The @code{for} statement makes it more convenient to count iterations of a
 loop.  The general form of the @code{for} statement looks like this:
@@ -12983,6 +12986,7 @@ it is not available.
 @subsection The @code{break} Statement
 @cindex @code{break} statement
 @cindex loops, exiting
+@cindex loops, @code{break} statement and
 
 The @code{break} statement jumps out of the innermost @code{for},
 @code{while}, or @code{do} loop that encloses it.  The following example
@@ -14620,6 +14624,7 @@ END @{
 @subsection Scanning All Elements of an Array
 @cindex elements in arrays, scanning
 @cindex arrays, scanning
+@cindex loops, @code{for}, array scanning
 
 In programs that use arrays, it is often necessary to use a loop that
 executes once for each element of an array.  In other languages, where
@@ -29310,7 +29315,7 @@ the problem at hand is often the correct approach in such situations.
 
 @node Arbitrary Precision Integers
 @section Arbitrary Precision Integer Arithmetic with @command{gawk}
-@cindex integer, arbitrary precision
+@cindex integers, arbitrary precision
 
 If one of the options @option{--bignum} or @option{-M} is specified,
 @command{gawk} performs all
@@ -33060,6 +33065,7 @@ The @code{time} extension described earlier (@pxref{Extension Sample
 Time}) was originally from this project but has been moved in to the
 main @command{gawk} distribution.
 
+@cindex @command{git} utility
 You can check out the code for the @code{gawkextlib} project
 using the @uref{http://git-scm.com, GIT} distributed source
 code control system.  The command is as follows:
@@ -34690,6 +34696,11 @@ environments.
 Anders Wallin helped keep the VMS port going for several years.
 
 @item
+@cindex Gordon, Assaf
+Assaf Gordon contributed the code to implement the
+@option{--sandbox} option.
+
+@item
 @cindex Haque, John
 John Haque made the following contributions:
 
@@ -36100,6 +36111,7 @@ It is available in several archive formats:
 @uref{http://www.cs.princeton.edu/~bwk/btl.mirror/awk.zip}
 @end table
 
+@cindex @command{git} utility
 You can also retrieve it from Git Hub:
 
 @example
@@ -36228,6 +36240,7 @@ This is an embeddable @command{awk} interpreter derived from
 @uref{http://repo.hu/projects/libmawk/}.
 
 @item @code{pawk}
+@cindex source code, @command{pawk} (Python version)
 @cindex @code{pawk}, @command{awk}-like facilities for Python
 This is a Python module that claims to bring @command{awk}-like
 features to Python. See @uref{https://github.com/alecthomas/pawk}
@@ -36333,6 +36346,7 @@ As @command{gawk} is Free Software, the source code is always available.
 @ref{Gawk Distribution}, describes how to get and build the formal,
 released versions of @command{gawk}.
 
+@cindex @command{git} utility
 However, if you want to modify @command{gawk} and contribute back your
 changes, you will probably wish to work with the development version.
 To do so, you will need to access the @command{gawk} source code
@@ -36508,6 +36522,7 @@ If possible, please update the @command{man} page as well.
 
 You will also have to sign paperwork for your documentation changes.
 
+@cindex @command{git} utility
 @item
 Submit changes as unified diffs.
 Use @samp{diff -u -r -N} to compare
@@ -36641,6 +36656,8 @@ coding style and brace layout that suits your taste.
 @node Derived Files
 @appendixsubsec Why Generated Files Are Kept In @command{git}
 
+@c STARTOFRANGE gawkgit
+@cindex @command{git}, use of for @command{gawk} source code
 @c From emails written March 22, 2012, to the gawk developers list.
 
 If you look at the @command{gawk} source in the @command{git}
@@ -36820,7 +36837,7 @@ wget http://git.savannah.gnu.org/cgit/gawk.git/snapshot/gawk-@var{branchname}.ta
 
 @noindent
 to retrieve a snapshot of the given branch.
-
+@c ENDOFRANGE gawkgit
 
 @node Future Extensions
 @appendixsec Probable Future Extensions
@@ -37399,7 +37416,7 @@ better written in another language.
 You can get it from @uref{http://awk.info/?awk100/aaa}.
 
 @cindex Ada programming language
-@cindex Programming languages, Ada
+@cindex programming languages, Ada
 @item Ada
 A programming language originally defined by the U.S.@: Department of
 Defense for embedded programming. It was designed to enforce good
@@ -37882,7 +37899,7 @@ information about the name of the organization and its language-independent
 three-letter acronym.
 
 @cindex Java programming language
-@cindex Programming languages, Java
+@cindex programming languages, Java
 @item Java
 A modern programming language originally developed by Sun Microsystems
 (now Oracle) supporting Object-Oriented programming.  Although usually
diff --git a/doc/gawktexi.in b/doc/gawktexi.in
index 6d7c5055..1fe75843 100644
--- a/doc/gawktexi.in
+++ b/doc/gawktexi.in
@@ -7977,7 +7977,7 @@ parentheses are necessary if any of the item expressions use the @samp{>}
 relational operator; otherwise, it can be confused with an output redirection
 (@pxref{Redirection}).
 
-@cindex format strings
+@cindex format specifiers
 The difference between @code{printf} and @code{print} is the @var{format}
 argument.  This is an expression whose value is taken as a string; it
 specifies how to output each of the other arguments.  It is called the
@@ -12083,6 +12083,7 @@ the first thing on its line.
 @subsection The @code{while} Statement
 @cindex @code{while} statement
 @cindex loops
+@cindex loops, @code{while}
 @cindex loops, See Also @code{while} statement
 
 In programming, a @dfn{loop} is a part of a program that can
@@ -12143,6 +12144,7 @@ program is harder to read without it.
 @node Do Statement
 @subsection The @code{do}-@code{while} Statement
 @cindex @code{do}-@code{while} statement
+@cindex loops, @code{do}-@code{while}
 
 The @code{do} loop is a variation of the @code{while} looping statement.
 The @code{do} loop executes the @var{body} once and then repeats the
@@ -12188,6 +12190,7 @@ occasionally is there a real use for a @code{do} statement.
 @node For Statement
 @subsection The @code{for} Statement
 @cindex @code{for} statement
+@cindex loops, @code{for}, iterative
 
 The @code{for} statement makes it more convenient to count iterations of a
 loop.  The general form of the @code{for} statement looks like this:
@@ -12360,6 +12363,7 @@ it is not available.
 @subsection The @code{break} Statement
 @cindex @code{break} statement
 @cindex loops, exiting
+@cindex loops, @code{break} statement and
 
 The @code{break} statement jumps out of the innermost @code{for},
 @code{while}, or @code{do} loop that encloses it.  The following example
@@ -13951,6 +13955,7 @@ END @{
 @subsection Scanning All Elements of an Array
 @cindex elements in arrays, scanning
 @cindex arrays, scanning
+@cindex loops, @code{for}, array scanning
 
 In programs that use arrays, it is often necessary to use a loop that
 executes once for each element of an array.  In other languages, where
@@ -28451,7 +28456,7 @@ the problem at hand is often the correct approach in such situations.
 
 @node Arbitrary Precision Integers
 @section Arbitrary Precision Integer Arithmetic with @command{gawk}
-@cindex integer, arbitrary precision
+@cindex integers, arbitrary precision
 
 If one of the options @option{--bignum} or @option{-M} is specified,
 @command{gawk} performs all
@@ -32201,6 +32206,7 @@ The @code{time} extension described earlier (@pxref{Extension Sample
 Time}) was originally from this project but has been moved in to the
 main @command{gawk} distribution.
 
+@cindex @command{git} utility
 You can check out the code for the @code{gawkextlib} project
 using the @uref{http://git-scm.com, GIT} distributed source
 code control system.  The command is as follows:
@@ -33831,6 +33837,11 @@ environments.
 Anders Wallin helped keep the VMS port going for several years.
 
 @item
+@cindex Gordon, Assaf
+Assaf Gordon contributed the code to implement the
+@option{--sandbox} option.
+
+@item
 @cindex Haque, John
 John Haque made the following contributions:
 
@@ -35241,6 +35252,7 @@ It is available in several archive formats:
 @uref{http://www.cs.princeton.edu/~bwk/btl.mirror/awk.zip}
 @end table
 
+@cindex @command{git} utility
 You can also retrieve it from Git Hub:
 
 @example
@@ -35369,6 +35381,7 @@ This is an embeddable @command{awk} interpreter derived from
 @uref{http://repo.hu/projects/libmawk/}.
 
 @item @code{pawk}
+@cindex source code, @command{pawk} (Python version)
 @cindex @code{pawk}, @command{awk}-like facilities for Python
 This is a Python module that claims to bring @command{awk}-like
 features to Python. See @uref{https://github.com/alecthomas/pawk}
@@ -35474,6 +35487,7 @@ As @command{gawk} is Free Software, the source code is always available.
 @ref{Gawk Distribution}, describes how to get and build the formal,
 released versions of @command{gawk}.
 
+@cindex @command{git} utility
 However, if you want to modify @command{gawk} and contribute back your
 changes, you will probably wish to work with the development version.
 To do so, you will need to access the @command{gawk} source code
@@ -35649,6 +35663,7 @@ If possible, please update the @command{man} page as well.
 
 You will also have to sign paperwork for your documentation changes.
 
+@cindex @command{git} utility
 @item
 Submit changes as unified diffs.
 Use @samp{diff -u -r -N} to compare
@@ -35782,6 +35797,8 @@ coding style and brace layout that suits your taste.
 @node Derived Files
 @appendixsubsec Why Generated Files Are Kept In @command{git}
 
+@c STARTOFRANGE gawkgit
+@cindex @command{git}, use of for @command{gawk} source code
 @c From emails written March 22, 2012, to the gawk developers list.
 
 If you look at the @command{gawk} source in the @command{git}
@@ -35961,7 +35978,7 @@ wget http://git.savannah.gnu.org/cgit/gawk.git/snapshot/gawk-@var{branchname}.ta
 
 @noindent
 to retrieve a snapshot of the given branch.
-
+@c ENDOFRANGE gawkgit
 
 @node Future Extensions
 @appendixsec Probable Future Extensions
@@ -36540,7 +36557,7 @@ better written in another language.
 You can get it from @uref{http://awk.info/?awk100/aaa}.
 
 @cindex Ada programming language
-@cindex Programming languages, Ada
+@cindex programming languages, Ada
 @item Ada
 A programming language originally defined by the U.S.@: Department of
 Defense for embedded programming. It was designed to enforce good
@@ -37023,7 +37040,7 @@ information about the name of the organization and its language-independent
 three-letter acronym.
 
 @cindex Java programming language
-@cindex Programming languages, Java
+@cindex programming languages, Java
 @item Java
 A modern programming language originally developed by Sun Microsystems
 (now Oracle) supporting Object-Oriented programming.  Although usually