summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorArnold D. Robbins <arnold@skeeve.com>2019-01-03 21:13:01 +0200
committerArnold D. Robbins <arnold@skeeve.com>2019-01-03 21:13:01 +0200
commit45b0abf522c3be35a2766eae0022d0bf8aefbaa8 (patch)
tree10f1433be92c8e9c2898a4cbe888e8c6f3939275
parent7f2f9cfa86928914fefb28338fcbdfbc36754edd (diff)
downloadgawk-45b0abf522c3be35a2766eae0022d0bf8aefbaa8.tar.gz
Small indexing fixes.
-rw-r--r--doc/ChangeLog5
-rw-r--r--doc/gawk.info464
-rw-r--r--doc/gawk.texi32
-rw-r--r--doc/gawktexi.in32
4 files changed, 275 insertions, 258 deletions
diff --git a/doc/ChangeLog b/doc/ChangeLog
index 6af2d876..36ed9bab 100644
--- a/doc/ChangeLog
+++ b/doc/ChangeLog
@@ -1,3 +1,8 @@
+2019-01-03 Arnold D. Robbins <arnold@skeeve.com>
+
+ * gawktexi.in: Some small indexing fixes. Thanks to Antonio
+ Giovanni Colombo for pointing them out.
+
2018-12-18 Arnold D. Robbins <arnold@skeeve.com>
* gawktexi.in: Added more indexing to the debugger chapter.
diff --git a/doc/gawk.info b/doc/gawk.info
index 9fba2e1f..af1d26c5 100644
--- a/doc/gawk.info
+++ b/doc/gawk.info
@@ -20871,9 +20871,9 @@ result as the final version of your program.
recreate an 'awk' program, profiling and pretty-printing automatically
disable 'gawk''s default optimizations.
- Pretty printing also preserves the original format of numeric
-constants; if you used an octal or hexadecimal value in your source
-code, it will appear that way in the output.
+ Profiling and pretty-printing also preserve the original format of
+numeric constants; if you used an octal or hexadecimal value in your
+source code, it will appear that way in the output.
---------- Footnotes ----------
@@ -33373,7 +33373,6 @@ Index
* arrays: Arrays. (line 6)
* arrays of arrays: Arrays of Arrays. (line 6)
* arrays, an example of using: Array Example. (line 6)
-* arrays, and IGNORECASE variable: Array Intro. (line 100)
* arrays, as parameters to functions: Pass By Value/Reference.
(line 44)
* arrays, associative: Array Intro. (line 48)
@@ -33387,6 +33386,7 @@ Index
(line 48)
* arrays, elements, retrieving number of: String Functions. (line 42)
* arrays, for statement and: Scanning an Array. (line 20)
+* arrays, IGNORECASE variable and: Array Intro. (line 100)
* arrays, indexing: Array Intro. (line 48)
* arrays, merging into strings: Join Function. (line 6)
* arrays, multidimensional: Multidimensional. (line 10)
@@ -33560,7 +33560,6 @@ Index
* BEGIN pattern: Field Separators. (line 44)
* BEGIN pattern <1>: BEGIN/END. (line 6)
* BEGIN pattern <2>: Using BEGIN/END. (line 6)
-* BEGIN pattern, and profiling: Profiling. (line 62)
* BEGIN pattern, assert() user-defined function and: Assert Function.
(line 83)
* BEGIN pattern, Boolean patterns and: Expression Patterns. (line 70)
@@ -33575,6 +33574,7 @@ Index
(line 20)
* BEGIN pattern, operators and: Using BEGIN/END. (line 17)
* BEGIN pattern, print statement and: I/O And BEGIN/END. (line 15)
+* BEGIN pattern, profiling and: Profiling. (line 62)
* BEGIN pattern, pwcat program: Passwd Functions. (line 143)
* BEGIN pattern, running awk programs and: Cut Program. (line 63)
* BEGIN pattern, TEXTDOMAIN variable and: Programmer i18n. (line 60)
@@ -33698,13 +33698,13 @@ Index
* caret (^), ^= operator: Assignment Ops. (line 129)
* caret (^), ^= operator <1>: Precedence. (line 94)
* case keyword: Switch Statement. (line 6)
-* case sensitivity, and regexps: User-modified. (line 79)
-* case sensitivity, and string comparisons: User-modified. (line 79)
* case sensitivity, array indices and: Array Intro. (line 100)
* case sensitivity, converting case: String Functions. (line 528)
* case sensitivity, example programs: Library Functions. (line 53)
* case sensitivity, gawk: Case-sensitivity. (line 26)
* case sensitivity, regexps and: Case-sensitivity. (line 6)
+* case sensitivity, regexps and <1>: User-modified. (line 79)
+* case sensitivity, string comparisons and: User-modified. (line 79)
* CGI, awk scripts for: Options. (line 139)
* character classes, See bracket expressions: Regexp Operators.
(line 56)
@@ -33847,7 +33847,7 @@ Index
* converting, strings to numbers <1>: Bitwise Functions. (line 109)
* CONVFMT variable: Strings And Numbers. (line 29)
* CONVFMT variable <1>: User-modified. (line 30)
-* CONVFMT variable, and array subscripts: Numeric Array Subscripts.
+* CONVFMT variable, array subscripts and: Numeric Array Subscripts.
(line 6)
* cookie: Glossary. (line 255)
* coprocesses: Redirection. (line 96)
@@ -34237,7 +34237,6 @@ Index
(line 10)
* END pattern: BEGIN/END. (line 6)
* END pattern <1>: Using BEGIN/END. (line 6)
-* END pattern, and profiling: Profiling. (line 62)
* END pattern, assert() user-defined function and: Assert Function.
(line 75)
* END pattern, Boolean patterns and: Expression Patterns. (line 70)
@@ -34248,6 +34247,7 @@ Index
(line 44)
* END pattern, operators and: Using BEGIN/END. (line 17)
* END pattern, print statement and: I/O And BEGIN/END. (line 15)
+* END pattern, profiling and: Profiling. (line 62)
* ENDFILE pattern: BEGINFILE/ENDFILE. (line 6)
* ENDFILE pattern, Boolean patterns and: Expression Patterns. (line 70)
* endfile() user-defined function: Filetrans Function. (line 62)
@@ -34823,8 +34823,8 @@ Index
* ignore breakpoint: Breakpoint Control. (line 87)
* ignore debugger command: Breakpoint Control. (line 87)
* IGNORECASE variable: User-modified. (line 79)
-* IGNORECASE variable, and array indices: Array Intro. (line 100)
-* IGNORECASE variable, and array sorting functions: Array Sorting Functions.
+* IGNORECASE variable, array indices and: Array Intro. (line 100)
+* IGNORECASE variable, array sorting functions and: Array Sorting Functions.
(line 83)
* IGNORECASE variable, in example programs: Library Functions.
(line 53)
@@ -35159,11 +35159,11 @@ Index
* null strings <2>: Truth Values. (line 6)
* null strings <3>: Basic Data Typing. (line 26)
* null strings in gawk arguments, quoting and: Quoting. (line 82)
-* null strings, and deleting array elements: Delete. (line 27)
* null strings, as array subscripts: Uninitialized Subscripts.
(line 43)
* null strings, converting numbers to strings: Strings And Numbers.
(line 21)
+* null strings, deleting array elements and: Delete. (line 27)
* null strings, matching: String Functions. (line 542)
* number as string of bits: Bitwise Functions. (line 109)
* number of array elements: String Functions. (line 201)
@@ -35403,6 +35403,9 @@ Index
* predefined variables, -v option, setting with: Options. (line 41)
* predefined variables, conveying information: Auto-set. (line 6)
* predefined variables, user-modifiable: User-modified. (line 6)
+* pretty printing: Options. (line 235)
+* pretty printing <1>: Profiling. (line 220)
+* pretty-printing, profiling, difference with: Profiling. (line 227)
* print debugger command: Viewing And Changing Data.
(line 35)
* print statement: Printing. (line 16)
@@ -35448,15 +35451,16 @@ Index
* PROCINFO array: Auto-set. (line 148)
* PROCINFO array <1>: Time Functions. (line 49)
* PROCINFO array <2>: Passwd Functions. (line 6)
-* PROCINFO array, and communications via ptys: Two-way I/O. (line 114)
-* PROCINFO array, and group membership: Group Functions. (line 6)
-* PROCINFO array, and user and group ID numbers: Id Program. (line 15)
+* PROCINFO array, communications via ptys and: Two-way I/O. (line 114)
+* PROCINFO array, group membership and: Group Functions. (line 6)
* PROCINFO array, testing the field splitting: Passwd Functions.
(line 154)
+* PROCINFO array, user and group ID numbers and: Id Program. (line 15)
* PROCINFO, values of sorted_in: Controlling Scanning.
(line 26)
* profiling awk programs: Profiling. (line 6)
* profiling awk programs, dynamically: Profiling. (line 177)
+* profiling, pretty-printing, difference with: Profiling. (line 227)
* program identifiers: Auto-set. (line 193)
* program, definition of: Getting Started. (line 21)
* programming conventions, --non-decimal-data option: Nondecimal Data.
@@ -35917,7 +35921,7 @@ Index
* subscripts in arrays, uninitialized variables as: Uninitialized Subscripts.
(line 6)
* SUBSEP variable: User-modified. (line 149)
-* SUBSEP variable, and multidimensional arrays: Multidimensional.
+* SUBSEP variable, multidimensional arrays and: Multidimensional.
(line 16)
* substitute in string: String Functions. (line 89)
* substr: String Functions. (line 487)
@@ -36540,219 +36544,219 @@ Ref: Two-way I/O-Footnote-1835796
Ref: Two-way I/O-Footnote-2835983
Node: TCP/IP Networking836065
Node: Profiling839183
-Ref: Profiling-Footnote-1847855
-Node: Advanced Features Summary848178
-Node: Internationalization850022
-Node: I18N and L10N851502
-Node: Explaining gettext852189
-Ref: Explaining gettext-Footnote-1858081
-Ref: Explaining gettext-Footnote-2858266
-Node: Programmer i18n858431
-Ref: Programmer i18n-Footnote-1863380
-Node: Translator i18n863429
-Node: String Extraction864223
-Ref: String Extraction-Footnote-1865355
-Node: Printf Ordering865441
-Ref: Printf Ordering-Footnote-1868227
-Node: I18N Portability868291
-Ref: I18N Portability-Footnote-1870747
-Node: I18N Example870810
-Ref: I18N Example-Footnote-1873616
-Node: Gawk I18N873689
-Node: I18N Summary874334
-Node: Debugger875675
-Node: Debugging876695
-Node: Debugging Concepts877136
-Node: Debugging Terms878945
-Node: Awk Debugging881520
-Ref: Awk Debugging-Footnote-1882465
-Node: Sample Debugging Session882597
-Node: Debugger Invocation883131
-Node: Finding The Bug884517
-Node: List of Debugger Commands890991
-Node: Breakpoint Control892324
-Node: Debugger Execution Control896018
-Node: Viewing And Changing Data899380
-Node: Execution Stack902754
-Node: Debugger Info904391
-Node: Miscellaneous Debugger Commands908462
-Node: Readline Support913524
-Node: Limitations914420
-Node: Debugging Summary916529
-Node: Arbitrary Precision Arithmetic917808
-Node: Computer Arithmetic919293
-Ref: table-numeric-ranges923059
-Ref: table-floating-point-ranges923552
-Ref: Computer Arithmetic-Footnote-1924210
-Node: Math Definitions924267
-Ref: table-ieee-formats927583
-Ref: Math Definitions-Footnote-1928186
-Node: MPFR features928291
-Node: FP Math Caution930009
-Ref: FP Math Caution-Footnote-1931081
-Node: Inexactness of computations931450
-Node: Inexact representation932410
-Node: Comparing FP Values933770
-Node: Errors accumulate935011
-Node: Getting Accuracy936444
-Node: Try To Round939154
-Node: Setting precision940053
-Ref: table-predefined-precision-strings940750
-Node: Setting the rounding mode942580
-Ref: table-gawk-rounding-modes942954
-Ref: Setting the rounding mode-Footnote-1946885
-Node: Arbitrary Precision Integers947064
-Ref: Arbitrary Precision Integers-Footnote-1950239
-Node: Checking for MPFR950388
-Node: POSIX Floating Point Problems951862
-Ref: POSIX Floating Point Problems-Footnote-1956147
-Node: Floating point summary956185
-Node: Dynamic Extensions958375
-Node: Extension Intro959928
-Node: Plugin License961194
-Node: Extension Mechanism Outline961991
-Ref: figure-load-extension962430
-Ref: figure-register-new-function963995
-Ref: figure-call-new-function965087
-Node: Extension API Description967149
-Node: Extension API Functions Introduction968791
-Node: General Data Types974331
-Ref: General Data Types-Footnote-1982692
-Node: Memory Allocation Functions982991
-Ref: Memory Allocation Functions-Footnote-1987201
-Node: Constructor Functions987300
-Node: Registration Functions990886
-Node: Extension Functions991571
-Node: Exit Callback Functions996786
-Node: Extension Version String998036
-Node: Input Parsers998699
-Node: Output Wrappers1011420
-Node: Two-way processors1015932
-Node: Printing Messages1018197
-Ref: Printing Messages-Footnote-11019368
-Node: Updating ERRNO1019521
-Node: Requesting Values1020260
-Ref: table-value-types-returned1020997
-Node: Accessing Parameters1021933
-Node: Symbol Table Access1023168
-Node: Symbol table by name1023680
-Node: Symbol table by cookie1025469
-Ref: Symbol table by cookie-Footnote-11029654
-Node: Cached values1029718
-Ref: Cached values-Footnote-11033254
-Node: Array Manipulation1033407
-Ref: Array Manipulation-Footnote-11034498
-Node: Array Data Types1034535
-Ref: Array Data Types-Footnote-11037193
-Node: Array Functions1037285
-Node: Flattening Arrays1041783
-Node: Creating Arrays1048759
-Node: Redirection API1053526
-Node: Extension API Variables1056359
-Node: Extension Versioning1057070
-Ref: gawk-api-version1057499
-Node: Extension GMP/MPFR Versioning1059230
-Node: Extension API Informational Variables1060858
-Node: Extension API Boilerplate1061931
-Node: Changes from API V11065905
-Node: Finding Extensions1067477
-Node: Extension Example1068036
-Node: Internal File Description1068834
-Node: Internal File Ops1072914
-Ref: Internal File Ops-Footnote-11084264
-Node: Using Internal File Ops1084404
-Ref: Using Internal File Ops-Footnote-11086787
-Node: Extension Samples1087061
-Node: Extension Sample File Functions1088590
-Node: Extension Sample Fnmatch1096239
-Node: Extension Sample Fork1097726
-Node: Extension Sample Inplace1098944
-Node: Extension Sample Ord1102161
-Node: Extension Sample Readdir1102997
-Ref: table-readdir-file-types1103886
-Node: Extension Sample Revout1104691
-Node: Extension Sample Rev2way1105280
-Node: Extension Sample Read write array1106020
-Node: Extension Sample Readfile1107962
-Node: Extension Sample Time1109057
-Node: Extension Sample API Tests1110405
-Node: gawkextlib1110897
-Node: Extension summary1113815
-Node: Extension Exercises1117517
-Node: Language History1119015
-Node: V7/SVR3.11120671
-Node: SVR41122823
-Node: POSIX1124257
-Node: BTL1125637
-Node: POSIX/GNU1126366
-Node: Feature History1132144
-Node: Common Extensions1148003
-Node: Ranges and Locales1149286
-Ref: Ranges and Locales-Footnote-11153902
-Ref: Ranges and Locales-Footnote-21153929
-Ref: Ranges and Locales-Footnote-31154164
-Node: Contributors1154385
-Node: History summary1160330
-Node: Installation1161710
-Node: Gawk Distribution1162654
-Node: Getting1163138
-Node: Extracting1164101
-Node: Distribution contents1165739
-Node: Unix Installation1172219
-Node: Quick Installation1172901
-Node: Shell Startup Files1175315
-Node: Additional Configuration Options1176404
-Node: Configuration Philosophy1178697
-Node: Non-Unix Installation1181066
-Node: PC Installation1181526
-Node: PC Binary Installation1182364
-Node: PC Compiling1182799
-Node: PC Using1183916
-Node: Cygwin1187131
-Node: MSYS1188230
-Node: VMS Installation1188731
-Node: VMS Compilation1189522
-Ref: VMS Compilation-Footnote-11190751
-Node: VMS Dynamic Extensions1190809
-Node: VMS Installation Details1192494
-Node: VMS Running1194747
-Node: VMS GNV1199026
-Node: VMS Old Gawk1199761
-Node: Bugs1200232
-Node: Bug address1200895
-Node: Usenet1203877
-Node: Maintainers1204881
-Node: Other Versions1206142
-Node: Installation summary1213056
-Node: Notes1214258
-Node: Compatibility Mode1215052
-Node: Additions1215834
-Node: Accessing The Source1216759
-Node: Adding Code1218196
-Node: New Ports1224415
-Node: Derived Files1228903
-Ref: Derived Files-Footnote-11234549
-Ref: Derived Files-Footnote-21234584
-Ref: Derived Files-Footnote-31235182
-Node: Future Extensions1235296
-Node: Implementation Limitations1235954
-Node: Extension Design1237137
-Node: Old Extension Problems1238281
-Ref: Old Extension Problems-Footnote-11239799
-Node: Extension New Mechanism Goals1239856
-Ref: Extension New Mechanism Goals-Footnote-11243220
-Node: Extension Other Design Decisions1243409
-Node: Extension Future Growth1245522
-Node: Notes summary1246358
-Node: Basic Concepts1247533
-Node: Basic High Level1248214
-Ref: figure-general-flow1248496
-Ref: figure-process-flow1249181
-Ref: Basic High Level-Footnote-11252482
-Node: Basic Data Typing1252667
-Node: Glossary1255995
-Node: Copying1287833
-Node: GNU Free Documentation License1325376
-Node: Index1350496
+Ref: Profiling-Footnote-1847868
+Node: Advanced Features Summary848191
+Node: Internationalization850035
+Node: I18N and L10N851515
+Node: Explaining gettext852202
+Ref: Explaining gettext-Footnote-1858094
+Ref: Explaining gettext-Footnote-2858279
+Node: Programmer i18n858444
+Ref: Programmer i18n-Footnote-1863393
+Node: Translator i18n863442
+Node: String Extraction864236
+Ref: String Extraction-Footnote-1865368
+Node: Printf Ordering865454
+Ref: Printf Ordering-Footnote-1868240
+Node: I18N Portability868304
+Ref: I18N Portability-Footnote-1870760
+Node: I18N Example870823
+Ref: I18N Example-Footnote-1873629
+Node: Gawk I18N873702
+Node: I18N Summary874347
+Node: Debugger875688
+Node: Debugging876708
+Node: Debugging Concepts877149
+Node: Debugging Terms878958
+Node: Awk Debugging881533
+Ref: Awk Debugging-Footnote-1882478
+Node: Sample Debugging Session882610
+Node: Debugger Invocation883144
+Node: Finding The Bug884530
+Node: List of Debugger Commands891004
+Node: Breakpoint Control892337
+Node: Debugger Execution Control896031
+Node: Viewing And Changing Data899393
+Node: Execution Stack902767
+Node: Debugger Info904404
+Node: Miscellaneous Debugger Commands908475
+Node: Readline Support913537
+Node: Limitations914433
+Node: Debugging Summary916542
+Node: Arbitrary Precision Arithmetic917821
+Node: Computer Arithmetic919306
+Ref: table-numeric-ranges923072
+Ref: table-floating-point-ranges923565
+Ref: Computer Arithmetic-Footnote-1924223
+Node: Math Definitions924280
+Ref: table-ieee-formats927596
+Ref: Math Definitions-Footnote-1928199
+Node: MPFR features928304
+Node: FP Math Caution930022
+Ref: FP Math Caution-Footnote-1931094
+Node: Inexactness of computations931463
+Node: Inexact representation932423
+Node: Comparing FP Values933783
+Node: Errors accumulate935024
+Node: Getting Accuracy936457
+Node: Try To Round939167
+Node: Setting precision940066
+Ref: table-predefined-precision-strings940763
+Node: Setting the rounding mode942593
+Ref: table-gawk-rounding-modes942967
+Ref: Setting the rounding mode-Footnote-1946898
+Node: Arbitrary Precision Integers947077
+Ref: Arbitrary Precision Integers-Footnote-1950252
+Node: Checking for MPFR950401
+Node: POSIX Floating Point Problems951875
+Ref: POSIX Floating Point Problems-Footnote-1956160
+Node: Floating point summary956198
+Node: Dynamic Extensions958388
+Node: Extension Intro959941
+Node: Plugin License961207
+Node: Extension Mechanism Outline962004
+Ref: figure-load-extension962443
+Ref: figure-register-new-function964008
+Ref: figure-call-new-function965100
+Node: Extension API Description967162
+Node: Extension API Functions Introduction968804
+Node: General Data Types974344
+Ref: General Data Types-Footnote-1982705
+Node: Memory Allocation Functions983004
+Ref: Memory Allocation Functions-Footnote-1987214
+Node: Constructor Functions987313
+Node: Registration Functions990899
+Node: Extension Functions991584
+Node: Exit Callback Functions996799
+Node: Extension Version String998049
+Node: Input Parsers998712
+Node: Output Wrappers1011433
+Node: Two-way processors1015945
+Node: Printing Messages1018210
+Ref: Printing Messages-Footnote-11019381
+Node: Updating ERRNO1019534
+Node: Requesting Values1020273
+Ref: table-value-types-returned1021010
+Node: Accessing Parameters1021946
+Node: Symbol Table Access1023181
+Node: Symbol table by name1023693
+Node: Symbol table by cookie1025482
+Ref: Symbol table by cookie-Footnote-11029667
+Node: Cached values1029731
+Ref: Cached values-Footnote-11033267
+Node: Array Manipulation1033420
+Ref: Array Manipulation-Footnote-11034511
+Node: Array Data Types1034548
+Ref: Array Data Types-Footnote-11037206
+Node: Array Functions1037298
+Node: Flattening Arrays1041796
+Node: Creating Arrays1048772
+Node: Redirection API1053539
+Node: Extension API Variables1056372
+Node: Extension Versioning1057083
+Ref: gawk-api-version1057512
+Node: Extension GMP/MPFR Versioning1059243
+Node: Extension API Informational Variables1060871
+Node: Extension API Boilerplate1061944
+Node: Changes from API V11065918
+Node: Finding Extensions1067490
+Node: Extension Example1068049
+Node: Internal File Description1068847
+Node: Internal File Ops1072927
+Ref: Internal File Ops-Footnote-11084277
+Node: Using Internal File Ops1084417
+Ref: Using Internal File Ops-Footnote-11086800
+Node: Extension Samples1087074
+Node: Extension Sample File Functions1088603
+Node: Extension Sample Fnmatch1096252
+Node: Extension Sample Fork1097739
+Node: Extension Sample Inplace1098957
+Node: Extension Sample Ord1102174
+Node: Extension Sample Readdir1103010
+Ref: table-readdir-file-types1103899
+Node: Extension Sample Revout1104704
+Node: Extension Sample Rev2way1105293
+Node: Extension Sample Read write array1106033
+Node: Extension Sample Readfile1107975
+Node: Extension Sample Time1109070
+Node: Extension Sample API Tests1110418
+Node: gawkextlib1110910
+Node: Extension summary1113828
+Node: Extension Exercises1117530
+Node: Language History1119028
+Node: V7/SVR3.11120684
+Node: SVR41122836
+Node: POSIX1124270
+Node: BTL1125650
+Node: POSIX/GNU1126379
+Node: Feature History1132157
+Node: Common Extensions1148016
+Node: Ranges and Locales1149299
+Ref: Ranges and Locales-Footnote-11153915
+Ref: Ranges and Locales-Footnote-21153942
+Ref: Ranges and Locales-Footnote-31154177
+Node: Contributors1154398
+Node: History summary1160343
+Node: Installation1161723
+Node: Gawk Distribution1162667
+Node: Getting1163151
+Node: Extracting1164114
+Node: Distribution contents1165752
+Node: Unix Installation1172232
+Node: Quick Installation1172914
+Node: Shell Startup Files1175328
+Node: Additional Configuration Options1176417
+Node: Configuration Philosophy1178710
+Node: Non-Unix Installation1181079
+Node: PC Installation1181539
+Node: PC Binary Installation1182377
+Node: PC Compiling1182812
+Node: PC Using1183929
+Node: Cygwin1187144
+Node: MSYS1188243
+Node: VMS Installation1188744
+Node: VMS Compilation1189535
+Ref: VMS Compilation-Footnote-11190764
+Node: VMS Dynamic Extensions1190822
+Node: VMS Installation Details1192507
+Node: VMS Running1194760
+Node: VMS GNV1199039
+Node: VMS Old Gawk1199774
+Node: Bugs1200245
+Node: Bug address1200908
+Node: Usenet1203890
+Node: Maintainers1204894
+Node: Other Versions1206155
+Node: Installation summary1213069
+Node: Notes1214271
+Node: Compatibility Mode1215065
+Node: Additions1215847
+Node: Accessing The Source1216772
+Node: Adding Code1218209
+Node: New Ports1224428
+Node: Derived Files1228916
+Ref: Derived Files-Footnote-11234562
+Ref: Derived Files-Footnote-21234597
+Ref: Derived Files-Footnote-31235195
+Node: Future Extensions1235309
+Node: Implementation Limitations1235967
+Node: Extension Design1237150
+Node: Old Extension Problems1238294
+Ref: Old Extension Problems-Footnote-11239812
+Node: Extension New Mechanism Goals1239869
+Ref: Extension New Mechanism Goals-Footnote-11243233
+Node: Extension Other Design Decisions1243422
+Node: Extension Future Growth1245535
+Node: Notes summary1246371
+Node: Basic Concepts1247546
+Node: Basic High Level1248227
+Ref: figure-general-flow1248509
+Ref: figure-process-flow1249194
+Ref: Basic High Level-Footnote-11252495
+Node: Basic Data Typing1252680
+Node: Glossary1256008
+Node: Copying1287846
+Node: GNU Free Documentation License1325389
+Node: Index1350509

End Tag Table
diff --git a/doc/gawk.texi b/doc/gawk.texi
index 4928769d..256e0c13 100644
--- a/doc/gawk.texi
+++ b/doc/gawk.texi
@@ -4128,6 +4128,7 @@ that this option may disappear in a future version of @command{gawk}.
Force the use of the locale's decimal point character
when parsing numeric input data (@pxref{Locales}).
+@cindex pretty printing
@item @option{-o}[@var{file}]
@itemx @option{--pretty-print}[@code{=}@var{file}]
@cindex @option{-o} option
@@ -15345,8 +15346,8 @@ is to simply say @samp{FS = FS}, perhaps with an explanatory comment.
@cindex @command{gawk}, @code{IGNORECASE} variable in
@cindex @code{IGNORECASE} variable
@cindex differences in @command{awk} and @command{gawk}, @code{IGNORECASE} variable
-@cindex case sensitivity, and string comparisons
-@cindex case sensitivity, and regexps
+@cindex case sensitivity, string comparisons and
+@cindex case sensitivity, regexps and
@cindex regular expressions, case sensitivity
@item IGNORECASE #
If @code{IGNORECASE} is nonzero or non-null, then all string comparisons
@@ -16572,8 +16573,8 @@ automatically converts it to a string.
@cindex @command{gawk}, @code{IGNORECASE} variable in
@cindex case sensitivity, array indices and
-@cindex arrays, and @code{IGNORECASE} variable
-@cindex @code{IGNORECASE} variable, and array indices
+@cindex arrays, @code{IGNORECASE} variable and
+@cindex @code{IGNORECASE} variable, array indices and
The value of @code{IGNORECASE} has no effect upon array subscripting.
The identical string value used to store an array element must be used
to retrieve it.
@@ -17056,7 +17057,7 @@ sorting arrays; see @ref{Array Sorting Functions}.
@cindex numbers, as array subscripts
@cindex arrays, numeric subscripts
@cindex subscripts in arrays, numbers as
-@cindex @code{CONVFMT} variable, and array subscripts
+@cindex @code{CONVFMT} variable, array subscripts and
An important aspect to remember about arrays is that @emph{array subscripts
are always strings}. When a numeric value is used as a subscript,
it is converted to a string value before being used for subscripting
@@ -17213,7 +17214,7 @@ if (4 in foo)
print "This will never be printed"
@end example
-@cindex null strings, and deleting array elements
+@cindex null strings, deleting array elements and
It is important to note that deleting an element is @emph{not} the
same as assigning it a null value (the empty string, @code{""}).
For example:
@@ -17308,7 +17309,7 @@ languages, including @command{awk}) to refer to an element of a
two-dimensional array named @code{grid} is with
@code{grid[@var{x},@var{y}]}.
-@cindex @code{SUBSEP} variable, and multidimensional arrays
+@cindex @code{SUBSEP} variable, multidimensional arrays and
Multidimensional arrays are supported in @command{awk} through
concatenation of indices into one string.
@command{awk} converts the indices into strings
@@ -23735,7 +23736,7 @@ uses these functions.
@cindex functions, library, group database@comma{} reading
@cindex group database, reading
@cindex database, group, reading
-@cindex @code{PROCINFO} array, and group membership
+@cindex @code{PROCINFO} array, group membership and
@cindex @code{getgrent()} function (C library)
@cindex @code{getgrent()} user-defined function
@cindex groups@comma{} information about
@@ -25034,7 +25035,7 @@ $ @kbd{id}
@print{} uid=1000(arnold) gid=1000(arnold) groups=1000(arnold),4(adm),7(lp),27(sudo)
@end example
-@cindex @code{PROCINFO} array, and user and group ID numbers
+@cindex @code{PROCINFO} array, user and group ID numbers and
This information is part of what is provided by @command{gawk}'s
@code{PROCINFO} array (@pxref{Built-in Variables}).
However, the @command{id} utility provides a more palatable output than just
@@ -28449,7 +28450,7 @@ both arrays use the values.
@c Document It And Call It A Feature. Sigh.
@cindex @command{gawk}, @code{IGNORECASE} variable in
@cindex arrays, sorting, and @code{IGNORECASE} variable
-@cindex @code{IGNORECASE} variable, and array sorting functions
+@cindex @code{IGNORECASE} variable, array sorting functions and
Because @code{IGNORECASE} affects string comparisons, the value
of @code{IGNORECASE} also affects sorting for both @code{asort()} and @code{asorti()}.
Note also that the locale's sorting order does @emph{not}
@@ -28697,7 +28698,7 @@ or @code{getline}.
@end quotation
@cindex @command{gawk}, @code{PROCINFO} array in
-@cindex @code{PROCINFO} array, and communications via ptys
+@cindex @code{PROCINFO} array, communications via ptys and
You may also use pseudo-ttys (ptys) for
two-way communication instead of pipes, if your system supports them.
This is done on a per-command basis, by setting a special element
@@ -28982,8 +28983,8 @@ Here is the @file{awkprof.out} that results from running the
illustrates that @command{awk} programmers sometimes get up very early
in the morning to work):
-@cindex @code{BEGIN} pattern, and profiling
-@cindex @code{END} pattern, and profiling
+@cindex @code{BEGIN} pattern, profiling and
+@cindex @code{END} pattern, profiling and
@example
# gawk profile, created Mon Sep 29 05:16:21 2014
@@ -29213,6 +29214,7 @@ keyboard. The @code{INT} signal is generated by the
@kbd{Ctrl-c} or @kbd{Ctrl-BREAK} key, while the
@code{QUIT} signal is generated by the @kbd{Ctrl-\} key.
+@cindex pretty printing
Finally, @command{gawk} also accepts another option, @option{--pretty-print}.
When called this way, @command{gawk} ``pretty-prints'' the program into
@file{awkprof.out}, without any execution counts.
@@ -29222,6 +29224,8 @@ Once upon a time, the @option{--pretty-print} option would also run
your program. This is is no longer the case.
@end quotation
+@cindex profiling, pretty-printing, difference with
+@cindex pretty-printing, profiling, difference with
There is a significant difference between the output created when
profiling, and that created when pretty-printing. Pretty-printed output
preserves the original comments that were in the program, although their
@@ -29247,7 +29251,7 @@ Because the internal representation of your program is formatted to
recreate an @command{awk} program, profiling and pretty-printing
automatically disable @command{gawk}'s default optimizations.
-Pretty printing also preserves the original format of numeric
+Profiling and pretty-printing also preserve the original format of numeric
constants; if you used an octal or hexadecimal value in your source
code, it will appear that way in the output.
diff --git a/doc/gawktexi.in b/doc/gawktexi.in
index f7540936..01eef9ad 100644
--- a/doc/gawktexi.in
+++ b/doc/gawktexi.in
@@ -4038,6 +4038,7 @@ that this option may disappear in a future version of @command{gawk}.
Force the use of the locale's decimal point character
when parsing numeric input data (@pxref{Locales}).
+@cindex pretty printing
@item @option{-o}[@var{file}]
@itemx @option{--pretty-print}[@code{=}@var{file}]
@cindex @option{-o} option
@@ -14663,8 +14664,8 @@ is to simply say @samp{FS = FS}, perhaps with an explanatory comment.
@cindex @command{gawk}, @code{IGNORECASE} variable in
@cindex @code{IGNORECASE} variable
@cindex differences in @command{awk} and @command{gawk}, @code{IGNORECASE} variable
-@cindex case sensitivity, and string comparisons
-@cindex case sensitivity, and regexps
+@cindex case sensitivity, string comparisons and
+@cindex case sensitivity, regexps and
@cindex regular expressions, case sensitivity
@item IGNORECASE #
If @code{IGNORECASE} is nonzero or non-null, then all string comparisons
@@ -15844,8 +15845,8 @@ automatically converts it to a string.
@cindex @command{gawk}, @code{IGNORECASE} variable in
@cindex case sensitivity, array indices and
-@cindex arrays, and @code{IGNORECASE} variable
-@cindex @code{IGNORECASE} variable, and array indices
+@cindex arrays, @code{IGNORECASE} variable and
+@cindex @code{IGNORECASE} variable, array indices and
The value of @code{IGNORECASE} has no effect upon array subscripting.
The identical string value used to store an array element must be used
to retrieve it.
@@ -16328,7 +16329,7 @@ sorting arrays; see @ref{Array Sorting Functions}.
@cindex numbers, as array subscripts
@cindex arrays, numeric subscripts
@cindex subscripts in arrays, numbers as
-@cindex @code{CONVFMT} variable, and array subscripts
+@cindex @code{CONVFMT} variable, array subscripts and
An important aspect to remember about arrays is that @emph{array subscripts
are always strings}. When a numeric value is used as a subscript,
it is converted to a string value before being used for subscripting
@@ -16485,7 +16486,7 @@ if (4 in foo)
print "This will never be printed"
@end example
-@cindex null strings, and deleting array elements
+@cindex null strings, deleting array elements and
It is important to note that deleting an element is @emph{not} the
same as assigning it a null value (the empty string, @code{""}).
For example:
@@ -16580,7 +16581,7 @@ languages, including @command{awk}) to refer to an element of a
two-dimensional array named @code{grid} is with
@code{grid[@var{x},@var{y}]}.
-@cindex @code{SUBSEP} variable, and multidimensional arrays
+@cindex @code{SUBSEP} variable, multidimensional arrays and
Multidimensional arrays are supported in @command{awk} through
concatenation of indices into one string.
@command{awk} converts the indices into strings
@@ -22748,7 +22749,7 @@ uses these functions.
@cindex functions, library, group database@comma{} reading
@cindex group database, reading
@cindex database, group, reading
-@cindex @code{PROCINFO} array, and group membership
+@cindex @code{PROCINFO} array, group membership and
@cindex @code{getgrent()} function (C library)
@cindex @code{getgrent()} user-defined function
@cindex groups@comma{} information about
@@ -24047,7 +24048,7 @@ $ @kbd{id}
@print{} uid=1000(arnold) gid=1000(arnold) groups=1000(arnold),4(adm),7(lp),27(sudo)
@end example
-@cindex @code{PROCINFO} array, and user and group ID numbers
+@cindex @code{PROCINFO} array, user and group ID numbers and
This information is part of what is provided by @command{gawk}'s
@code{PROCINFO} array (@pxref{Built-in Variables}).
However, the @command{id} utility provides a more palatable output than just
@@ -27462,7 +27463,7 @@ both arrays use the values.
@c Document It And Call It A Feature. Sigh.
@cindex @command{gawk}, @code{IGNORECASE} variable in
@cindex arrays, sorting, and @code{IGNORECASE} variable
-@cindex @code{IGNORECASE} variable, and array sorting functions
+@cindex @code{IGNORECASE} variable, array sorting functions and
Because @code{IGNORECASE} affects string comparisons, the value
of @code{IGNORECASE} also affects sorting for both @code{asort()} and @code{asorti()}.
Note also that the locale's sorting order does @emph{not}
@@ -27710,7 +27711,7 @@ or @code{getline}.
@end quotation
@cindex @command{gawk}, @code{PROCINFO} array in
-@cindex @code{PROCINFO} array, and communications via ptys
+@cindex @code{PROCINFO} array, communications via ptys and
You may also use pseudo-ttys (ptys) for
two-way communication instead of pipes, if your system supports them.
This is done on a per-command basis, by setting a special element
@@ -27995,8 +27996,8 @@ Here is the @file{awkprof.out} that results from running the
illustrates that @command{awk} programmers sometimes get up very early
in the morning to work):
-@cindex @code{BEGIN} pattern, and profiling
-@cindex @code{END} pattern, and profiling
+@cindex @code{BEGIN} pattern, profiling and
+@cindex @code{END} pattern, profiling and
@example
# gawk profile, created Mon Sep 29 05:16:21 2014
@@ -28226,6 +28227,7 @@ keyboard. The @code{INT} signal is generated by the
@kbd{Ctrl-c} or @kbd{Ctrl-BREAK} key, while the
@code{QUIT} signal is generated by the @kbd{Ctrl-\} key.
+@cindex pretty printing
Finally, @command{gawk} also accepts another option, @option{--pretty-print}.
When called this way, @command{gawk} ``pretty-prints'' the program into
@file{awkprof.out}, without any execution counts.
@@ -28235,6 +28237,8 @@ Once upon a time, the @option{--pretty-print} option would also run
your program. This is is no longer the case.
@end quotation
+@cindex profiling, pretty-printing, difference with
+@cindex pretty-printing, profiling, difference with
There is a significant difference between the output created when
profiling, and that created when pretty-printing. Pretty-printed output
preserves the original comments that were in the program, although their
@@ -28260,7 +28264,7 @@ Because the internal representation of your program is formatted to
recreate an @command{awk} program, profiling and pretty-printing
automatically disable @command{gawk}'s default optimizations.
-Pretty printing also preserves the original format of numeric
+Profiling and pretty-printing also preserve the original format of numeric
constants; if you used an octal or hexadecimal value in your source
code, it will appear that way in the output.