Indexing fixes.

4 files changed, 64 insertions, 28 deletions

diff --git a/doc/ChangeLog b/doc/ChangeLog
index 40f76755..09d5f942 100644
--- a/doc/ChangeLog
+++ b/doc/ChangeLog
@@ -1,3 +1,7 @@
+2019-01-13         Arnold D. Robbins     <arnold@skeeve.com>
+
+	* gawktexi.in: Work on the indexing.
+
 2019-01-11         Arnold D. Robbins     <arnold@skeeve.com>
 
 	* gawktexi.in (I18N Example): $LC_MESSAGES is involved here
diff --git a/doc/gawk.info b/doc/gawk.info
index ee209f9f..d182b646 100644
--- a/doc/gawk.info
+++ b/doc/gawk.info
@@ -33074,7 +33074,7 @@ Index
 * - (hyphen), -- operator <1>:           Precedence.          (line  45)
 * - (hyphen), -= operator:               Assignment Ops.      (line 129)
 * - (hyphen), -= operator <1>:           Precedence.          (line  94)
-* - (hyphen), filenames beginning with:  Options.             (line  60)
+* - (hyphen), file names beginning with: Options.             (line  60)
 * - (hyphen), in bracket expressions:    Bracket Expressions. (line  25)
 * --assign option:                       Options.             (line  32)
 * --bignum option:                       Options.             (line 217)
@@ -33388,6 +33388,10 @@ Index
                                                               (line   6)
 * array scanning order, controlling:     Controlling Scanning.
                                                               (line  14)
+* array subscripts, null strings as:     Uninitialized Subscripts.
+                                                              (line  43)
+* array subscripts, numbers as:          Numeric Array Subscripts.
+                                                              (line   6)
 * array, number of elements:             String Functions.    (line 201)
 * arrays:                                Arrays.              (line   6)
 * arrays of arrays:                      Arrays of Arrays.    (line   6)
@@ -33446,7 +33450,7 @@ Index
 * assignment operators:                  Assignment Ops.      (line   6)
 * assignment operators, evaluation order: Assignment Ops.     (line 110)
 * assignment operators, lvalues/rvalues: Assignment Ops.      (line  31)
-* assignments as filenames:              Ignoring Assigns.    (line   6)
+* assignments as file names:             Ignoring Assigns.    (line   6)
 * associative arrays:                    Array Intro.         (line  48)
 * asterisk (*), * operator, as multiplication operator: Precedence.
                                                               (line  54)
@@ -34406,6 +34410,8 @@ Index
 * field numbers:                         Nonconstant Fields.  (line   6)
 * field operator $:                      Fields.              (line  19)
 * field operators, dollar sign as:       Fields.              (line  19)
+* field separator, backslash (\) as:     Command Line Field Separator.
+                                                              (line  24)
 * field separator, in multiline records: Multiple Line.       (line  41)
 * field separator, on command line:      Command Line Field Separator.
                                                               (line   6)
@@ -34421,6 +34427,8 @@ Index
                                                               (line   6)
 * field separators, See Also OFS:        Changing Fields.     (line  64)
 * field separators, spaces as:           Cut Program.         (line 103)
+* field separators, whitespace as:       Default Field Splitting.
+                                                              (line   6)
 * fields:                                Reading Files.       (line  14)
 * fields <1>:                            Fields.              (line   6)
 * fields <2>:                            Basic High Level.    (line  62)
@@ -34439,13 +34447,13 @@ Index
 * FIELDWIDTHS variable <1>:              User-modified.       (line  37)
 * file descriptors:                      Special FD.          (line   6)
 * file inclusion, @include directive:    Include Files.       (line   8)
+* file names, assignments as:            Ignoring Assigns.    (line   6)
 * file names, distinguishing:            Auto-set.            (line  55)
 * file names, in compatibility mode:     Special Caveats.     (line   9)
 * file names, standard streams in gawk:  Special FD.          (line  48)
 * FILENAME variable:                     Reading Files.       (line   6)
 * FILENAME variable <1>:                 Auto-set.            (line 108)
 * FILENAME variable, getline, setting with: Getline Notes.    (line  19)
-* filenames, assignments as:             Ignoring Assigns.    (line   6)
 * files, .gmo:                           Explaining gettext.  (line  42)
 * files, .gmo, specifying directory of:  Explaining gettext.  (line  54)
 * files, .gmo, specifying directory of <1>: Programmer i18n.  (line  48)
@@ -34505,9 +34513,9 @@ Index
 * flag variables:                        Boolean Ops.         (line  69)
 * flag variables <1>:                    Tee Program.         (line  20)
 * floating-point, numbers:               Computer Arithmetic. (line  49)
-* floating-point, numbers, arbitrary precision: Arbitrary Precision Arithmetic.
+* floating-point, numbers, arbitrary-precision: Arbitrary Precision Arithmetic.
                                                               (line   6)
-* floating-point, numbers, arbitrary-precision: Computer Arithmetic.
+* floating-point, numbers, arbitrary-precision <1>: Computer Arithmetic.
                                                               (line  61)
 * floating-point, numbers, double-precision: Computer Arithmetic.
                                                               (line  61)
@@ -34557,11 +34565,11 @@ Index
 * FS variable, --field-separator option and: Options.         (line  21)
 * FS variable, as null string:           Single Character Fields.
                                                               (line  20)
-* FS variable, as TAB character:         Options.             (line 279)
 * FS variable, changing value of:        Field Separators.    (line  34)
 * FS variable, running awk programs and: Cut Program.         (line  63)
 * FS variable, setting from command line: Command Line Field Separator.
                                                               (line   6)
+* FS variable, TAB character as:         Options.             (line 279)
 * FS, containing ^:                      Regexp Field Splitting.
                                                               (line  59)
 * FS, in multiline records:              Multiple Line.       (line  41)
@@ -34836,7 +34844,7 @@ Index
 * hyphen (-), -- operator <1>:           Precedence.          (line  45)
 * hyphen (-), -= operator:               Assignment Ops.      (line 129)
 * hyphen (-), -= operator <1>:           Precedence.          (line  94)
-* hyphen (-), filenames beginning with:  Options.             (line  60)
+* hyphen (-), file names beginning with: Options.             (line  60)
 * hyphen (-), in bracket expressions:    Bracket Expressions. (line  25)
 * i debugger command (alias for info):   Debugger Info.       (line  13)
 * id utility:                            Id Program.          (line   6)
@@ -34949,7 +34957,7 @@ Index
 * Java implementation of awk:            Other Versions.      (line 121)
 * Java programming language:             Glossary.            (line 466)
 * jawk:                                  Other Versions.      (line 121)
-* Jedi knights:                          Undocumented.        (line   6)
+* jedi knights:                          Undocumented.        (line   6)
 * Johansen, Chris:                       Signature Program.   (line  25)
 * join() user-defined function:          Join Function.       (line  18)
 * Kahrs, Ju"rgen:                        Acknowledgments.     (line  60)
@@ -34968,7 +34976,7 @@ Index
 * Kernighan, Brian <9>:                  Basic Data Typing.   (line  54)
 * Kernighan, Brian <10>:                 Glossary.            (line 204)
 * kill command, dynamic profiling:       Profiling.           (line 186)
-* Knights, jedi:                         Undocumented.        (line   6)
+* knights, jedi:                         Undocumented.        (line   6)
 * Kwok, Conrad:                          Contributors.        (line  35)
 * l debugger command (alias for list):   Miscellaneous Debugger Commands.
                                                               (line  73)
@@ -35307,13 +35315,16 @@ Index
 * patsplit:                              String Functions.    (line 297)
 * patterns:                              Patterns and Actions.
                                                               (line   6)
+* patterns, Boolean expressions as:      Expression Patterns. (line  39)
 * patterns, comparison expressions as:   Expression Patterns. (line  14)
 * patterns, counts, in a profile:        Profiling.           (line 118)
 * patterns, default:                     Very Simple.         (line  35)
 * patterns, empty:                       Empty.               (line   6)
-* patterns, expressions as:              Regexp Patterns.     (line   6)
+* patterns, expressions as:              Expression Patterns. (line   6)
 * patterns, ranges in:                   Ranges.              (line   6)
 * patterns, regexp constants as:         Expression Patterns. (line  34)
+* patterns, regular expressions as:      Regexp Usage.        (line   6)
+* patterns, regular expressions as <1>:  Regexp Patterns.     (line   6)
 * patterns, types of:                    Pattern Overview.    (line  15)
 * pawk (profiling version of Brian Kernighan's awk): Other Versions.
                                                               (line  78)
@@ -35561,6 +35572,7 @@ Index
 * record separators:                     awk split records.   (line   6)
 * record separators <1>:                 User-modified.       (line 136)
 * record separators, changing:           awk split records.   (line  85)
+* record separators, newlines as:        awk split records.   (line  12)
 * record separators, regular expressions as: awk split records.
                                                               (line 131)
 * record separators, with multiline records: Multiple Line.   (line  10)
@@ -35834,6 +35846,7 @@ Index
 * single quote ('), in shell commands:   Quoting.             (line  48)
 * single quote ('), vs. apostrophe:      Comments.            (line  27)
 * single quote ('), with double quotes:  Quoting.             (line  73)
+* single records, treating files as:     gawk split records.  (line  92)
 * single-character fields:               Single Character Fields.
                                                               (line   6)
 * single-precision:                      Computer Arithmetic. (line  61)
diff --git a/doc/gawk.texi b/doc/gawk.texi
index 9990605d..7627fdf4 100644
--- a/doc/gawk.texi
+++ b/doc/gawk.texi
@@ -3867,8 +3867,8 @@ are not treated as options even if they begin with @samp{-}.  This
 interpretation of @option{--} follows the POSIX argument parsing
 conventions.
 
-@cindex @code{-} (hyphen), filenames beginning with
-@cindex hyphen (@code{-}), filenames beginning with
+@cindex @code{-} (hyphen), file names beginning with
+@cindex hyphen (@code{-}), file names beginning with
 This is useful if you have @value{FN}s that start with @samp{-},
 or in shell scripts, if you have @value{FN}s that will be specified
 by the user that could start with @samp{-}.
@@ -4203,7 +4203,7 @@ Newlines are not allowed after @samp{?} or @samp{:}
 (@pxref{Conditional Exp}).
 
 
-@cindex @code{FS} variable, as TAB character
+@cindex @code{FS} variable, TAB character as
 @item
 Specifying @samp{-Ft} on the command line does not set the value
 of @code{FS} to be a single TAB character
@@ -4923,8 +4923,8 @@ in case some option becomes obsolete in a future version of @command{gawk}.
 @cindex features, undocumented
 @cindex Skywalker, Luke
 @cindex Kenobi, Obi-Wan
-@cindex Jedi knights
-@cindex Knights, jedi
+@cindex jedi knights
+@cindex knights, jedi
 @quotation
 @i{Use the Source, Luke!}
 @author Obi-Wan
@@ -5095,6 +5095,7 @@ regular expressions work, we present more complicated instances.
 @node Regexp Usage
 @section How to Use Regular Expressions
 
+@cindex patterns, regular expressions as
 @cindex regular expressions, as patterns
 A regular expression can be used as a pattern by enclosing it in
 slashes.  Then the regular expression is tested against the
@@ -6491,6 +6492,7 @@ This is why records are, by default, single lines.
 To use a different character for the record separator,
 simply assign that character to the predefined variable @code{RS}.
 
+@cindex record separators, newlines as
 @cindex newlines, as record separators
 @cindex @code{RS} variable
 Like any other variable,
@@ -6775,6 +6777,7 @@ character as a record separator. However, this is a special case:
 
 @cindex records, treating files as
 @cindex treating files, as single records
+@cindex single records, treating files as
 @xref{Readfile Function} for an interesting way to read
 whole files.  If you are using @command{gawk}, see @ref{Extension Sample
 Readfile} for another option.
@@ -6826,6 +6829,7 @@ character as a record separator. However, this is a special case:
 
 @cindex records, treating files as
 @cindex treating files, as single records
+@cindex single records, treating files as
 @xref{Readfile Function} for an interesting way to read
 whole files.  If you are using @command{gawk}, see @ref{Extension Sample
 Readfile} for another option.
@@ -7293,6 +7297,7 @@ can massage it first with a separate @command{awk} program.)
 @node Default Field Splitting
 @subsection Whitespace Normally Separates Fields
 
+@cindex field separators, whitespace as
 @cindex whitespace, as field separators
 Fields are normally separated by whitespace sequences
 (spaces, TABs, and newlines), not by single spaces.  Two spaces in a row do not
@@ -7487,6 +7492,7 @@ awk -F\\\\ '@dots{}' files @dots{}
 @end example
 
 @noindent
+@cindex field separator, backslash (@code{\}) as
 @cindex @code{\} (backslash), as field separator
 @cindex backslash (@code{\}), as field separator
 Because @samp{\} is used for quoting in the shell, @command{awk} sees
@@ -13848,7 +13854,7 @@ The empty pattern matches every input record.
 
 @node Regexp Patterns
 @subsection Regular Expressions as Patterns
-@cindex patterns, expressions as
+@cindex patterns, regular expressions as
 @cindex regular expressions, as patterns
 
 Regular expressions are one of the first kinds of patterns presented
@@ -13866,6 +13872,7 @@ END            @{ print buzzwords, "buzzwords seen" @}
 @node Expression Patterns
 @subsection Expressions as Patterns
 @cindex expressions, as patterns
+@cindex patterns, expressions as
 
 Any @command{awk} expression is valid as an @command{awk} pattern.
 The pattern matches if the expression's value is nonzero (if a
@@ -13919,6 +13926,7 @@ appears in the current input record. Thus, as a pattern, @code{/li/}
 matches any record containing @samp{li}.
 
 @cindex Boolean expressions, as patterns
+@cindex patterns, Boolean expressions as
 Boolean expressions are also commonly used as patterns.
 Whether the pattern
 matches an input record depends on whether its subexpressions match.
@@ -17059,6 +17067,7 @@ sorting arrays; see @ref{Array Sorting Functions}.
 @section Using Numbers to Subscript Arrays
 
 @cindex numbers, as array subscripts
+@cindex array subscripts, numbers as
 @cindex arrays, numeric subscripts
 @cindex subscripts in arrays, numbers as
 @cindex @code{CONVFMT} variable, array subscripts and
@@ -17172,6 +17181,7 @@ Here, the @samp{++} forces @code{lines} to be numeric, thus making
 the ``old value'' numeric zero. This is then converted to @code{"0"}
 as the array subscript.
 
+@cindex array subscripts, null strings as
 @cindex null strings, as array subscripts
 @cindex dark corner, array subscripts
 @cindex lint checking, array subscripts
@@ -22964,8 +22974,8 @@ not @samp{<}.
 @node Ignoring Assigns
 @subsection Treating Assignments as @value{FFN}s
 
-@cindex assignments as filenames
-@cindex filenames, assignments as
+@cindex assignments as file names
+@cindex file names, assignments as
 Occasionally, you might not want @command{awk} to process command-line
 variable assignments
 (@pxref{Assignment Options}).
@@ -31654,7 +31664,7 @@ program being debugged, but occasionally it can.
 @cindex arbitrary precision
 @cindex multiple precision
 @cindex infinite precision
-@cindex floating-point, numbers@comma{} arbitrary precision
+@cindex floating-point, numbers@comma{} arbitrary-precision
 
 This @value{CHAPTER} introduces some basic concepts relating to
 how computers do arithmetic and defines some important terms.
diff --git a/doc/gawktexi.in b/doc/gawktexi.in
index 2cda4028..be3b746c 100644
--- a/doc/gawktexi.in
+++ b/doc/gawktexi.in
@@ -3777,8 +3777,8 @@ are not treated as options even if they begin with @samp{-}.  This
 interpretation of @option{--} follows the POSIX argument parsing
 conventions.
 
-@cindex @code{-} (hyphen), filenames beginning with
-@cindex hyphen (@code{-}), filenames beginning with
+@cindex @code{-} (hyphen), file names beginning with
+@cindex hyphen (@code{-}), file names beginning with
 This is useful if you have @value{FN}s that start with @samp{-},
 or in shell scripts, if you have @value{FN}s that will be specified
 by the user that could start with @samp{-}.
@@ -4113,7 +4113,7 @@ Newlines are not allowed after @samp{?} or @samp{:}
 (@pxref{Conditional Exp}).
 
 
-@cindex @code{FS} variable, as TAB character
+@cindex @code{FS} variable, TAB character as
 @item
 Specifying @samp{-Ft} on the command line does not set the value
 of @code{FS} to be a single TAB character
@@ -4833,8 +4833,8 @@ in case some option becomes obsolete in a future version of @command{gawk}.
 @cindex features, undocumented
 @cindex Skywalker, Luke
 @cindex Kenobi, Obi-Wan
-@cindex Jedi knights
-@cindex Knights, jedi
+@cindex jedi knights
+@cindex knights, jedi
 @quotation
 @i{Use the Source, Luke!}
 @author Obi-Wan
@@ -5005,6 +5005,7 @@ regular expressions work, we present more complicated instances.
 @node Regexp Usage
 @section How to Use Regular Expressions
 
+@cindex patterns, regular expressions as
 @cindex regular expressions, as patterns
 A regular expression can be used as a pattern by enclosing it in
 slashes.  Then the regular expression is tested against the
@@ -6274,6 +6275,7 @@ This is why records are, by default, single lines.
 To use a different character for the record separator,
 simply assign that character to the predefined variable @code{RS}.
 
+@cindex record separators, newlines as
 @cindex newlines, as record separators
 @cindex @code{RS} variable
 Like any other variable,
@@ -6553,6 +6555,7 @@ character as a record separator. However, this is a special case:
 
 @cindex records, treating files as
 @cindex treating files, as single records
+@cindex single records, treating files as
 @xref{Readfile Function} for an interesting way to read
 whole files.  If you are using @command{gawk}, see @ref{Extension Sample
 Readfile} for another option.
@@ -6988,6 +6991,7 @@ can massage it first with a separate @command{awk} program.)
 @node Default Field Splitting
 @subsection Whitespace Normally Separates Fields
 
+@cindex field separators, whitespace as
 @cindex whitespace, as field separators
 Fields are normally separated by whitespace sequences
 (spaces, TABs, and newlines), not by single spaces.  Two spaces in a row do not
@@ -7182,6 +7186,7 @@ awk -F\\\\ '@dots{}' files @dots{}
 @end example
 
 @noindent
+@cindex field separator, backslash (@code{\}) as
 @cindex @code{\} (backslash), as field separator
 @cindex backslash (@code{\}), as field separator
 Because @samp{\} is used for quoting in the shell, @command{awk} sees
@@ -13166,7 +13171,7 @@ The empty pattern matches every input record.
 
 @node Regexp Patterns
 @subsection Regular Expressions as Patterns
-@cindex patterns, expressions as
+@cindex patterns, regular expressions as
 @cindex regular expressions, as patterns
 
 Regular expressions are one of the first kinds of patterns presented
@@ -13184,6 +13189,7 @@ END            @{ print buzzwords, "buzzwords seen" @}
 @node Expression Patterns
 @subsection Expressions as Patterns
 @cindex expressions, as patterns
+@cindex patterns, expressions as
 
 Any @command{awk} expression is valid as an @command{awk} pattern.
 The pattern matches if the expression's value is nonzero (if a
@@ -13237,6 +13243,7 @@ appears in the current input record. Thus, as a pattern, @code{/li/}
 matches any record containing @samp{li}.
 
 @cindex Boolean expressions, as patterns
+@cindex patterns, Boolean expressions as
 Boolean expressions are also commonly used as patterns.
 Whether the pattern
 matches an input record depends on whether its subexpressions match.
@@ -16331,6 +16338,7 @@ sorting arrays; see @ref{Array Sorting Functions}.
 @section Using Numbers to Subscript Arrays
 
 @cindex numbers, as array subscripts
+@cindex array subscripts, numbers as
 @cindex arrays, numeric subscripts
 @cindex subscripts in arrays, numbers as
 @cindex @code{CONVFMT} variable, array subscripts and
@@ -16444,6 +16452,7 @@ Here, the @samp{++} forces @code{lines} to be numeric, thus making
 the ``old value'' numeric zero. This is then converted to @code{"0"}
 as the array subscript.
 
+@cindex array subscripts, null strings as
 @cindex null strings, as array subscripts
 @cindex dark corner, array subscripts
 @cindex lint checking, array subscripts
@@ -21977,8 +21986,8 @@ not @samp{<}.
 @node Ignoring Assigns
 @subsection Treating Assignments as @value{FFN}s
 
-@cindex assignments as filenames
-@cindex filenames, assignments as
+@cindex assignments as file names
+@cindex file names, assignments as
 Occasionally, you might not want @command{awk} to process command-line
 variable assignments
 (@pxref{Assignment Options}).
@@ -30667,7 +30676,7 @@ program being debugged, but occasionally it can.
 @cindex arbitrary precision
 @cindex multiple precision
 @cindex infinite precision
-@cindex floating-point, numbers@comma{} arbitrary precision
+@cindex floating-point, numbers@comma{} arbitrary-precision
 
 This @value{CHAPTER} introduces some basic concepts relating to
 how computers do arithmetic and defines some important terms.