diff options
| -rw-r--r-- | doc/ChangeLog | 4 | ||||
| -rw-r--r-- | doc/gawk.info | 33 | ||||
| -rw-r--r-- | doc/gawk.texi | 28 | ||||
| -rw-r--r-- | doc/gawktexi.in | 27 |
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. |