diff options
author | Arnold D. Robbins <arnold@skeeve.com> | 2019-01-03 21:13:01 +0200 |
---|---|---|
committer | Arnold D. Robbins <arnold@skeeve.com> | 2019-01-03 21:13:01 +0200 |
commit | 45b0abf522c3be35a2766eae0022d0bf8aefbaa8 (patch) | |
tree | 10f1433be92c8e9c2898a4cbe888e8c6f3939275 | |
parent | 7f2f9cfa86928914fefb28338fcbdfbc36754edd (diff) | |
download | egawk-45b0abf522c3be35a2766eae0022d0bf8aefbaa8.tar.gz egawk-45b0abf522c3be35a2766eae0022d0bf8aefbaa8.tar.bz2 egawk-45b0abf522c3be35a2766eae0022d0bf8aefbaa8.zip |
Small indexing fixes.
-rw-r--r-- | doc/ChangeLog | 5 | ||||
-rw-r--r-- | doc/gawk.info | 464 | ||||
-rw-r--r-- | doc/gawk.texi | 32 | ||||
-rw-r--r-- | doc/gawktexi.in | 32 |
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. |