diff options
author | Arnold D. Robbins <arnold@skeeve.com> | 2019-01-04 12:30:41 +0200 |
---|---|---|
committer | Arnold D. Robbins <arnold@skeeve.com> | 2019-01-04 12:30:41 +0200 |
commit | f8f8129b0cf19bd3a001d9421c35aa3dd818d6d8 (patch) | |
tree | 38969e47001edb6a5ed886167a91fd63267f2d1c /doc | |
parent | 45b0abf522c3be35a2766eae0022d0bf8aefbaa8 (diff) | |
download | gawk-f8f8129b0cf19bd3a001d9421c35aa3dd818d6d8.tar.gz |
Small doc improvements.
Diffstat (limited to 'doc')
-rw-r--r-- | doc/ChangeLog | 4 | ||||
-rw-r--r-- | doc/gawk.info | 494 | ||||
-rw-r--r-- | doc/gawk.texi | 44 | ||||
-rw-r--r-- | doc/gawktexi.in | 44 |
4 files changed, 309 insertions, 277 deletions
diff --git a/doc/ChangeLog b/doc/ChangeLog index 36ed9bab..70e931a0 100644 --- a/doc/ChangeLog +++ b/doc/ChangeLog @@ -1,3 +1,7 @@ +2019-01-04 Arnold D. Robbins <arnold@skeeve.com> + + * gawktexi.in: Indexing fixes and small corrections. + 2019-01-03 Arnold D. Robbins <arnold@skeeve.com> * gawktexi.in: Some small indexing fixes. Thanks to Antonio diff --git a/doc/gawk.info b/doc/gawk.info index af1d26c5..bf75a180 100644 --- a/doc/gawk.info +++ b/doc/gawk.info @@ -20490,10 +20490,10 @@ driver and not passed through. CAUTION: Finally, coprocesses open up the possibility of "deadlock" between 'gawk' and the program running in the coprocess. This can occur if you send "too much" data to the coprocess before reading - any back; each process is blocked writing data with noone available - to read what they've already written. There is no workaround for - deadlock; careful programming and knowledge of the behavior of the - coprocess are required. + any back; each process is blocked writing data with no one + available to read what they've already written. There is no + workaround for deadlock; careful programming and knowledge of the + behavior of the coprocess are required. The following example, due to Andrew Schorr, demonstrates how using ptys can help deal with buffering deadlocks. @@ -33171,7 +33171,9 @@ Index * /inet/... special files (gawk): TCP/IP Networking. (line 6) * /inet4/... special files (gawk): TCP/IP Networking. (line 6) * /inet6/... special files (gawk): TCP/IP Networking. (line 6) +* : (colon), ?: operator: Precedence. (line 91) * ; (semicolon), AWKPATH variable and: PC Using. (line 13) +* ; (semicolon), separating rules: Statements/Lines. (line 90) * ; (semicolon), separating statements in actions: Statements/Lines. (line 90) * ; (semicolon), separating statements in actions <1>: Action Overview. @@ -33344,9 +33346,9 @@ Index (line 6) * arbitrary precision: Arbitrary Precision Arithmetic. (line 6) +* arbitrary precision <1>: Computer Arithmetic. (line 61) * arbitrary precision integers: Arbitrary Precision Integers. (line 6) -* arbitrary-precision: Computer Arithmetic. (line 61) * archaeologists: Bugs. (line 6) * arctangent: Numeric Functions. (line 12) * ARGC/ARGV variables: Auto-set. (line 15) @@ -33398,7 +33400,7 @@ Index * arrays, scanning: Scanning an Array. (line 6) * arrays, sorting: Array Sorting Functions. (line 6) -* arrays, sorting, and IGNORECASE variable: Array Sorting Functions. +* arrays, sorting, IGNORECASE variable and: Array Sorting Functions. (line 83) * arrays, sparse: Array Intro. (line 76) * arrays, subscripts, uninitialized variables as: Uninitialized Subscripts. @@ -33598,10 +33600,10 @@ Index * bit-manipulation functions: Bitwise Functions. (line 6) * bits2str() user-defined function: Bitwise Functions. (line 69) * bitwise AND: Bitwise Functions. (line 40) -* bitwise complement: Bitwise Functions. (line 44) +* bitwise complement: Bitwise Functions. (line 25) +* bitwise complement <1>: Bitwise Functions. (line 44) * bitwise OR: Bitwise Functions. (line 50) * bitwise XOR: Bitwise Functions. (line 57) -* bitwise, complement: Bitwise Functions. (line 25) * bitwise, operations: Bitwise Functions. (line 6) * bitwise, shift: Bitwise Functions. (line 32) * body, in actions: Statements. (line 10) @@ -33708,7 +33710,8 @@ Index * CGI, awk scripts for: Options. (line 139) * character classes, See bracket expressions: Regexp Operators. (line 56) -* character lists in regular expression: Bracket Expressions. (line 6) +* character lists in regular expressions: Bracket Expressions. + (line 6) * character lists, See bracket expressions: Regexp Operators. (line 56) * character sets (machine character encodings): Ordinal Functions. (line 45) @@ -33747,14 +33750,15 @@ Index * collating symbols: Bracket Expressions. (line 97) * Colombo, Antonio: Acknowledgments. (line 60) * Colombo, Antonio <1>: Contributors. (line 143) +* colon (:), ?: operator: Precedence. (line 91) * columns, aligning: Print Examples. (line 69) * columns, cutting: Cut Program. (line 6) * comma (,), in range patterns: Ranges. (line 6) * command completion, in debugger: Readline Support. (line 6) -* command line arguments, PROCINFO["argv"]: Auto-set. (line 154) * command line, arguments: Other Arguments. (line 6) * command line, arguments <1>: Auto-set. (line 15) -* command line, arguments <2>: ARGC and ARGV. (line 6) +* command line, arguments <2>: Auto-set. (line 154) +* command line, arguments <3>: ARGC and ARGV. (line 6) * command line, directories on: Command-line directories. (line 6) * command line, formats: Running gawk. (line 12) @@ -33829,6 +33833,8 @@ Index * constants, nondecimal: Nondecimal Data. (line 6) * constants, numeric: Scalar Constants. (line 6) * constants, types of: Constants. (line 6) +* continue debugger command: Debugger Execution Control. + (line 33) * continue program, in debugger: Debugger Execution Control. (line 33) * continue statement: Continue Statement. (line 6) @@ -34045,29 +34051,29 @@ Index * debugger commands, watch: Viewing And Changing Data. (line 66) * debugger commands, where (backtrace): Execution Stack. (line 13) -* debugger concepts: Debugging Terms. (line 6) -* debugger default list amount: Debugger Info. (line 69) -* debugger history file: Debugger Info. (line 81) -* debugger history size: Debugger Info. (line 65) -* debugger options: Debugger Info. (line 57) -* debugger prompt: Debugger Info. (line 78) * debugger, b command: Finding The Bug. (line 32) * debugger, backtrace command: Finding The Bug. (line 52) * debugger, break command: Finding The Bug. (line 32) * debugger, breakpoint command: Finding The Bug. (line 32) * debugger, bt command: Finding The Bug. (line 52) * debugger, command completion: Readline Support. (line 6) +* debugger, concepts: Debugging Terms. (line 6) +* debugger, default list amount: Debugger Info. (line 69) * debugger, history expansion: Readline Support. (line 6) +* debugger, history file: Debugger Info. (line 81) +* debugger, history size: Debugger Info. (line 65) * debugger, how to start: Debugger Invocation. (line 6) * debugger, instruction tracing: Debugger Info. (line 90) * debugger, limitations: Limitations. (line 6) * debugger, n command: Finding The Bug. (line 105) * debugger, next command: Finding The Bug. (line 105) +* debugger, options: Debugger Info. (line 57) * debugger, p command: Finding The Bug. (line 68) * debugger, print command: Finding The Bug. (line 68) * debugger, printing all array elements: Finding The Bug. (line 154) * debugger, printing single array elements: Finding The Bug. (line 140) * debugger, prompt: Debugger Invocation. (line 23) +* debugger, prompt <1>: Debugger Info. (line 78) * debugger, read commands from a file: Debugger Info. (line 97) * debugger, repeating commands: List of Debugger Commands. (line 21) @@ -34075,7 +34081,7 @@ Index * debugger, running the program: Finding The Bug. (line 39) * debugger, save commands to a file: Debugger Info. (line 92) * debugger, setting a breakpoint: Finding The Bug. (line 32) -* debugger, show stack frames: Finding The Bug. (line 52) +* debugger, stack frames, showing: Finding The Bug. (line 52) * debugging awk programs: Debugger. (line 6) * debugging gawk, bug reports: Bugs. (line 9) * debugging, example session: Sample Debugging Session. @@ -34086,8 +34092,8 @@ Index * Deifik, Scott: Acknowledgments. (line 60) * Deifik, Scott <1>: Contributors. (line 54) * delete ARRAY: Delete. (line 39) -* delete breakpoint at location: Breakpoint Control. (line 36) -* delete breakpoint by number: Breakpoint Control. (line 64) +* delete breakpoint, at location: Breakpoint Control. (line 36) +* delete breakpoint, by number: Breakpoint Control. (line 64) * delete debugger command: Breakpoint Control. (line 64) * delete statement: Delete. (line 6) * delete watchpoint: Viewing And Changing Data. @@ -34096,7 +34102,6 @@ Index * deleting entire arrays: Delete. (line 39) * Demaille, Akim: Acknowledgments. (line 60) * describe call stack frame, in debugger: Debugger Info. (line 27) -* differences between gawk and awk: String Functions. (line 201) * differences in awk and gawk, ARGC/ARGV variables: ARGC and ARGV. (line 89) * differences in awk and gawk, ARGIND variable: Auto-set. (line 44) @@ -34141,6 +34146,8 @@ Index (line 6) * differences in awk and gawk, input/output operators <1>: Redirection. (line 96) +* differences in awk and gawk, length() function: String Functions. + (line 201) * differences in awk and gawk, line continuations: Conditional Exp. (line 34) * differences in awk and gawk, LINT variable: User-modified. (line 90) @@ -34160,7 +34167,7 @@ Index (line 6) * differences in awk and gawk, RS/RT variables: gawk split records. (line 58) -* differences in awk and gawk, RT variable: Auto-set. (line 327) +* differences in awk and gawk, RS/RT variables <1>: Auto-set. (line 327) * differences in awk and gawk, single-character fields: Single Character Fields. (line 6) * differences in awk and gawk, split() function: String Functions. @@ -34309,7 +34316,7 @@ Index (line 64) * exit statement: Exit Statement. (line 6) * exit status, of gawk: Exit Status. (line 6) -* exit status, of VMS: VMS Running. (line 28) +* exit status, of gawk, on VMS: VMS Running. (line 28) * exit the debugger: Miscellaneous Debugger Commands. (line 64) * exit the debugger <1>: Miscellaneous Debugger Commands. @@ -34343,6 +34350,7 @@ Index * extensions distributed with gawk: Extension Samples. (line 6) * extensions, allocating memory: Memory Allocation Functions. (line 6) +* extensions, array manipulation in: Array Manipulation. (line 6) * extensions, Brian Kernighan's awk: BTL. (line 6) * extensions, Brian Kernighan's awk <1>: Common Extensions. (line 6) * extensions, common, ** operator: Arithmetic Ops. (line 30) @@ -35083,6 +35091,8 @@ Index * maximum precision supported by MPFR library: Auto-set. (line 255) * McIlroy, Doug: Glossary. (line 255) * McPhee, Patrick: Contributors. (line 103) +* memory, allocating for extensions: Memory Allocation Functions. + (line 6) * message object files: Explaining gettext. (line 42) * message object files, converting from portable object files: I18N Example. (line 66) @@ -35099,6 +35109,7 @@ Index * monetary information, localization: Explaining gettext. (line 104) * Moore, Duncan: Getline Notes. (line 40) * MPFR, checking availability of: Checking for MPFR. (line 6) +* MPFR, checking for: Checking for MPFR. (line 6) * msgfmt utility: I18N Example. (line 66) * multiple precision: Arbitrary Precision Arithmetic. (line 6) @@ -35694,6 +35705,7 @@ Index * sed utility <2>: Glossary. (line 16) * seeding random number generator: Numeric Functions. (line 64) * semicolon (;), AWKPATH variable and: PC Using. (line 13) +* semicolon (;), separating rules: Statements/Lines. (line 90) * semicolon (;), separating statements in actions: Statements/Lines. (line 90) * semicolon (;), separating statements in actions <1>: Action Overview. @@ -36540,223 +36552,223 @@ Ref: Controlling Array Traversal-Footnote-1822671 Node: Array Sorting Functions822789 Ref: Array Sorting Functions-Footnote-1827880 Node: Two-way I/O828076 -Ref: Two-way I/O-Footnote-1835796 -Ref: Two-way I/O-Footnote-2835983 -Node: TCP/IP Networking836065 -Node: Profiling839183 -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 +Ref: Two-way I/O-Footnote-1835797 +Ref: Two-way I/O-Footnote-2835984 +Node: TCP/IP Networking836066 +Node: Profiling839184 +Ref: Profiling-Footnote-1847869 +Node: Advanced Features Summary848192 +Node: Internationalization850036 +Node: I18N and L10N851516 +Node: Explaining gettext852203 +Ref: Explaining gettext-Footnote-1858095 +Ref: Explaining gettext-Footnote-2858280 +Node: Programmer i18n858445 +Ref: Programmer i18n-Footnote-1863394 +Node: Translator i18n863443 +Node: String Extraction864237 +Ref: String Extraction-Footnote-1865369 +Node: Printf Ordering865455 +Ref: Printf Ordering-Footnote-1868241 +Node: I18N Portability868305 +Ref: I18N Portability-Footnote-1870761 +Node: I18N Example870824 +Ref: I18N Example-Footnote-1873630 +Node: Gawk I18N873703 +Node: I18N Summary874348 +Node: Debugger875689 +Node: Debugging876709 +Node: Debugging Concepts877150 +Node: Debugging Terms878959 +Node: Awk Debugging881534 +Ref: Awk Debugging-Footnote-1882479 +Node: Sample Debugging Session882611 +Node: Debugger Invocation883145 +Node: Finding The Bug884531 +Node: List of Debugger Commands891005 +Node: Breakpoint Control892338 +Node: Debugger Execution Control896032 +Node: Viewing And Changing Data899394 +Node: Execution Stack902768 +Node: Debugger Info904405 +Node: Miscellaneous Debugger Commands908476 +Node: Readline Support913538 +Node: Limitations914434 +Node: Debugging Summary916543 +Node: Arbitrary Precision Arithmetic917822 +Node: Computer Arithmetic919307 +Ref: table-numeric-ranges923073 +Ref: table-floating-point-ranges923566 +Ref: Computer Arithmetic-Footnote-1924224 +Node: Math Definitions924281 +Ref: table-ieee-formats927597 +Ref: Math Definitions-Footnote-1928200 +Node: MPFR features928305 +Node: FP Math Caution930023 +Ref: FP Math Caution-Footnote-1931095 +Node: Inexactness of computations931464 +Node: Inexact representation932424 +Node: Comparing FP Values933784 +Node: Errors accumulate935025 +Node: Getting Accuracy936458 +Node: Try To Round939168 +Node: Setting precision940067 +Ref: table-predefined-precision-strings940764 +Node: Setting the rounding mode942594 +Ref: table-gawk-rounding-modes942968 +Ref: Setting the rounding mode-Footnote-1946899 +Node: Arbitrary Precision Integers947078 +Ref: Arbitrary Precision Integers-Footnote-1950253 +Node: Checking for MPFR950402 +Node: POSIX Floating Point Problems951876 +Ref: POSIX Floating Point Problems-Footnote-1956161 +Node: Floating point summary956199 +Node: Dynamic Extensions958389 +Node: Extension Intro959942 +Node: Plugin License961208 +Node: Extension Mechanism Outline962005 +Ref: figure-load-extension962444 +Ref: figure-register-new-function964009 +Ref: figure-call-new-function965101 +Node: Extension API Description967163 +Node: Extension API Functions Introduction968805 +Node: General Data Types974345 +Ref: General Data Types-Footnote-1982706 +Node: Memory Allocation Functions983005 +Ref: Memory Allocation Functions-Footnote-1987215 +Node: Constructor Functions987314 +Node: Registration Functions990900 +Node: Extension Functions991585 +Node: Exit Callback Functions996800 +Node: Extension Version String998050 +Node: Input Parsers998713 +Node: Output Wrappers1011434 +Node: Two-way processors1015946 +Node: Printing Messages1018211 +Ref: Printing Messages-Footnote-11019382 +Node: Updating ERRNO1019535 +Node: Requesting Values1020274 +Ref: table-value-types-returned1021011 +Node: Accessing Parameters1021947 +Node: Symbol Table Access1023182 +Node: Symbol table by name1023694 +Node: Symbol table by cookie1025483 +Ref: Symbol table by cookie-Footnote-11029668 +Node: Cached values1029732 +Ref: Cached values-Footnote-11033268 +Node: Array Manipulation1033421 +Ref: Array Manipulation-Footnote-11034512 +Node: Array Data Types1034549 +Ref: Array Data Types-Footnote-11037207 +Node: Array Functions1037299 +Node: Flattening Arrays1041797 +Node: Creating Arrays1048773 +Node: Redirection API1053540 +Node: Extension API Variables1056373 +Node: Extension Versioning1057084 +Ref: gawk-api-version1057513 +Node: Extension GMP/MPFR Versioning1059244 +Node: Extension API Informational Variables1060872 +Node: Extension API Boilerplate1061945 +Node: Changes from API V11065919 +Node: Finding Extensions1067491 +Node: Extension Example1068050 +Node: Internal File Description1068848 +Node: Internal File Ops1072928 +Ref: Internal File Ops-Footnote-11084278 +Node: Using Internal File Ops1084418 +Ref: Using Internal File Ops-Footnote-11086801 +Node: Extension Samples1087075 +Node: Extension Sample File Functions1088604 +Node: Extension Sample Fnmatch1096253 +Node: Extension Sample Fork1097740 +Node: Extension Sample Inplace1098958 +Node: Extension Sample Ord1102175 +Node: Extension Sample Readdir1103011 +Ref: table-readdir-file-types1103900 +Node: Extension Sample Revout1104705 +Node: Extension Sample Rev2way1105294 +Node: Extension Sample Read write array1106034 +Node: Extension Sample Readfile1107976 +Node: Extension Sample Time1109071 +Node: Extension Sample API Tests1110419 +Node: gawkextlib1110911 +Node: Extension summary1113829 +Node: Extension Exercises1117531 +Node: Language History1119029 +Node: V7/SVR3.11120685 +Node: SVR41122837 +Node: POSIX1124271 +Node: BTL1125651 +Node: POSIX/GNU1126380 +Node: Feature History1132158 +Node: Common Extensions1148017 +Node: Ranges and Locales1149300 +Ref: Ranges and Locales-Footnote-11153916 +Ref: Ranges and Locales-Footnote-21153943 +Ref: Ranges and Locales-Footnote-31154178 +Node: Contributors1154399 +Node: History summary1160344 +Node: Installation1161724 +Node: Gawk Distribution1162668 +Node: Getting1163152 +Node: Extracting1164115 +Node: Distribution contents1165753 +Node: Unix Installation1172233 +Node: Quick Installation1172915 +Node: Shell Startup Files1175329 +Node: Additional Configuration Options1176418 +Node: Configuration Philosophy1178711 +Node: Non-Unix Installation1181080 +Node: PC Installation1181540 +Node: PC Binary Installation1182378 +Node: PC Compiling1182813 +Node: PC Using1183930 +Node: Cygwin1187145 +Node: MSYS1188244 +Node: VMS Installation1188745 +Node: VMS Compilation1189536 +Ref: VMS Compilation-Footnote-11190765 +Node: VMS Dynamic Extensions1190823 +Node: VMS Installation Details1192508 +Node: VMS Running1194761 +Node: VMS GNV1199040 +Node: VMS Old Gawk1199775 +Node: Bugs1200246 +Node: Bug address1200909 +Node: Usenet1203891 +Node: Maintainers1204895 +Node: Other Versions1206156 +Node: Installation summary1213070 +Node: Notes1214272 +Node: Compatibility Mode1215066 +Node: Additions1215848 +Node: Accessing The Source1216773 +Node: Adding Code1218210 +Node: New Ports1224429 +Node: Derived Files1228917 +Ref: Derived Files-Footnote-11234563 +Ref: Derived Files-Footnote-21234598 +Ref: Derived Files-Footnote-31235196 +Node: Future Extensions1235310 +Node: Implementation Limitations1235968 +Node: Extension Design1237151 +Node: Old Extension Problems1238295 +Ref: Old Extension Problems-Footnote-11239813 +Node: Extension New Mechanism Goals1239870 +Ref: Extension New Mechanism Goals-Footnote-11243234 +Node: Extension Other Design Decisions1243423 +Node: Extension Future Growth1245536 +Node: Notes summary1246372 +Node: Basic Concepts1247547 +Node: Basic High Level1248228 +Ref: figure-general-flow1248510 +Ref: figure-process-flow1249195 +Ref: Basic High Level-Footnote-11252496 +Node: Basic Data Typing1252681 +Node: Glossary1256009 +Node: Copying1287847 +Node: GNU Free Documentation License1325390 +Node: Index1350510 End Tag Table diff --git a/doc/gawk.texi b/doc/gawk.texi index 256e0c13..518b268e 100644 --- a/doc/gawk.texi +++ b/doc/gawk.texi @@ -3589,6 +3589,8 @@ noticed because it is ``hidden'' inside the comment. Thus, the @cindex statements, multiple @cindex @code{;} (semicolon), separating statements in actions @cindex semicolon (@code{;}), separating statements in actions +@cindex @code{;} (semicolon), separating rules +@cindex semicolon (@code{;}), separating rules When @command{awk} statements within one rule are short, you might want to put more than one of them on a line. This is accomplished by separating the statements with a semicolon (@samp{;}). @@ -5732,7 +5734,7 @@ expressions are not available in regular expressions. @cindex bracket expressions @cindex bracket expressions, range expressions @cindex range expressions (regexps) -@cindex character lists in regular expression +@cindex character lists in regular expressions As mentioned earlier, a bracket expression matches any character among those listed between the opening and closing square brackets. @@ -13634,6 +13636,8 @@ Logical ``or.'' @cindex @code{?} (question mark), @code{?:} operator @cindex question mark (@code{?}), @code{?:} operator +@cindex @code{:} (colon), @code{?:} operator +@cindex colon (@code{:}), @code{?:} operator @item @code{?:} Conditional. This operator groups right to left. @@ -15674,7 +15678,7 @@ are guaranteed to be available: @table @code @item PROCINFO["argv"] -@cindex command line arguments, @code{PROCINFO["argv"]} +@cindex command line, arguments The @code{PROCINFO["argv"]} array contains all of the command-line arguments (after glob expansion and redirection processing on platforms where that must be done manually by the program) with subscripts ranging from 0 through @@ -15883,7 +15887,7 @@ if no match was found. @cindex @command{gawk}, @code{RT} variable in @cindex @code{RT} variable -@cindex differences in @command{awk} and @command{gawk}, @code{RT} variable +@cindex differences in @command{awk} and @command{gawk}, @code{RS}/@code{RT} variables @item @code{RT #} The input text that matched the text denoted by @code{RS}, the record separator. It is set every time a record is read. @@ -18226,7 +18230,7 @@ warning about this. @cindex common extensions, @code{length()} applied to an array @cindex extensions, common@comma{} @code{length()} applied to an array -@cindex differences between @command{gawk} and @command{awk} +@cindex differences in @command{awk} and @command{gawk}, @code{length()} function @cindex number of array elements @cindex array, number of elements With @command{gawk} and several other @command{awk} implementations, when given an @@ -19961,7 +19965,7 @@ Operands | 0 | 1 | 0 | 1 | 0 | 1 @end docbook @end float -@cindex bitwise, complement +@cindex bitwise complement @cindex complement, bitwise As you can see, the result of an AND operation is 1 only when @emph{both} bits are 1. @@ -28449,7 +28453,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 arrays, sorting, @code{IGNORECASE} variable and @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()}. @@ -28731,7 +28735,7 @@ driver and not passed through. Finally, coprocesses open up the possibility of @dfn{deadlock} between @command{gawk} and the program running in the coprocess. This can occur if you send ``too much'' data to the coprocess before reading any back; -each process is blocked writing data with noone available to read what +each process is blocked writing data with no one available to read what they've already written. There is no workaround for deadlock; careful programming and knowledge of the behavior of the coprocess are required. @end quotation @@ -30254,7 +30258,7 @@ functional program that you or someone else wrote). @node Debugging Terms @subsection Debugging Concepts -@cindex debugger concepts +@cindex debugger, concepts Before diving in to the details, we need to introduce several important concepts that apply to just about all debuggers. The following list defines terms used throughout the rest of @@ -30448,7 +30452,7 @@ let's see how we got to where we are. At the prompt, we type @samp{bt} (short for ``backtrace''), and the debugger responds with a listing of the current stack frames: -@cindex debugger, show stack frames +@cindex debugger, stack frames, showing @cindex debugger, @code{bt} command @cindex debugger, @code{backtrace} command @example @@ -30736,7 +30740,7 @@ it continues executing the program. @cindex debugger commands, @code{clear} @cindex @code{clear} debugger command -@cindex delete breakpoint at location +@cindex delete breakpoint, at location @cindex breakpoint at location, how to delete @item @code{clear} [[@var{filename}@code{:}]@var{n} | @var{function}] Without any argument, delete any breakpoint at the next instruction @@ -30773,7 +30777,7 @@ watchpoint is made unconditional). @cindex debugger commands, @code{delete} @cindex @code{delete} debugger command @cindex @code{d} debugger command (alias for @code{delete}) -@cindex delete breakpoint by number +@cindex delete breakpoint, by number @cindex breakpoint, delete by number @item @code{delete} [@var{n1 n2} @dots{}] [@var{n}--@var{m}] @itemx @code{d} [@var{n1 n2} @dots{}] [@var{n}--@var{m}] @@ -30872,6 +30876,7 @@ gawk> @cindex debugger commands, @code{c} (@code{continue}) @cindex debugger commands, @code{continue} @cindex continue program, in debugger +@cindex @code{continue} debugger command @item @code{continue} [@var{count}] @itemx @code{c} [@var{count}] Resume program execution. If continued from a breakpoint and @var{count} is @@ -31212,7 +31217,7 @@ from a file. The commands are: @cindex @code{option} debugger command @cindex @code{o} debugger command (alias for @code{option}) @cindex display debugger options -@cindex debugger options +@cindex debugger, options @item @code{option} [@var{name}[@code{=}@var{value}]] @itemx @code{o} [@var{name}[@code{=}@var{value}]] Without an argument, display the available debugger options @@ -31225,12 +31230,12 @@ The available options are: @c asis for docbook @table @asis @item @code{history_size} -@cindex debugger history size +@cindex debugger, history size Set the maximum number of lines to keep in the history file @file{./.gawk_history}. The default is 100. @item @code{listsize} -@cindex debugger default list amount +@cindex debugger, default list amount Specify the number of lines that @code{list} prints. The default is 15. @item @code{outfile} @@ -31240,11 +31245,11 @@ to standard output. An empty string (@code{""}) resets output to standard output. @item @code{prompt} -@cindex debugger prompt +@cindex debugger, prompt Change the debugger prompt. The default is @samp{@w{gawk> }}. @item @code{save_history} [@code{on} | @code{off}] -@cindex debugger history file +@cindex debugger, history file Save command history to file @file{./.gawk_history}. The default is @code{on}. @@ -31726,7 +31731,7 @@ the use of arbitrary-precision floating-point calculations. @cindex floating-point, numbers@comma{} arbitrary-precision @cindex single-precision @cindex double-precision -@cindex arbitrary-precision +@cindex arbitrary precision POSIX @command{awk} uses @dfn{double-precision} floating-point numbers, which can hold more digits than @dfn{single-precision} floating-point numbers. @command{gawk} has facilities for performing arbitrary-precision @@ -32667,6 +32672,7 @@ word sizes. See @cindex MPFR, checking availability of @cindex checking for MPFR +@cindex MPFR, checking for Occasionally, you might like to be able to check if @command{gawk} was invoked with the @option{-M} option, enabling arbitrary-precision arithmetic. You can do so with the following function, contributed @@ -33521,6 +33527,7 @@ process and reduces the time needed to create the value. @subsection Memory Allocation Functions and Convenience Macros @cindex allocating memory for extensions @cindex extensions, allocating memory +@cindex memory, allocating for extensions The API provides a number of @dfn{memory allocation} functions for allocating memory that can be passed to @command{gawk}, as well as a number of @@ -34913,6 +34920,7 @@ you should release any cached values that you created, using @node Array Manipulation @subsection Array Manipulation @cindex array manipulation in extensions +@cindex extensions, array manipulation in The primary data structure@footnote{OK, the only data structure.} in @command{awk} is the associative array (@pxref{Arrays}). @@ -40365,7 +40373,7 @@ flag is required to force Unix-style parsing rather than @code{DCL} parsing. If any other dash-type options (or multiple parameters such as @value{DF}s to process) are present, there is no ambiguity and @option{--} can be omitted. -@cindex exit status, of VMS +@cindex exit status, of @command{gawk}, on VMS The @code{exit} value is a Unix-style value and is encoded into a VMS exit status value when the program exits. diff --git a/doc/gawktexi.in b/doc/gawktexi.in index 01eef9ad..f6df019a 100644 --- a/doc/gawktexi.in +++ b/doc/gawktexi.in @@ -3499,6 +3499,8 @@ noticed because it is ``hidden'' inside the comment. Thus, the @cindex statements, multiple @cindex @code{;} (semicolon), separating statements in actions @cindex semicolon (@code{;}), separating statements in actions +@cindex @code{;} (semicolon), separating rules +@cindex semicolon (@code{;}), separating rules When @command{awk} statements within one rule are short, you might want to put more than one of them on a line. This is accomplished by separating the statements with a semicolon (@samp{;}). @@ -5559,7 +5561,7 @@ expressions are not available in regular expressions. @cindex bracket expressions @cindex bracket expressions, range expressions @cindex range expressions (regexps) -@cindex character lists in regular expression +@cindex character lists in regular expressions As mentioned earlier, a bracket expression matches any character among those listed between the opening and closing square brackets. @@ -12952,6 +12954,8 @@ Logical ``or.'' @cindex @code{?} (question mark), @code{?:} operator @cindex question mark (@code{?}), @code{?:} operator +@cindex @code{:} (colon), @code{?:} operator +@cindex colon (@code{:}), @code{?:} operator @item @code{?:} Conditional. This operator groups right to left. @@ -14992,7 +14996,7 @@ are guaranteed to be available: @table @code @item PROCINFO["argv"] -@cindex command line arguments, @code{PROCINFO["argv"]} +@cindex command line, arguments The @code{PROCINFO["argv"]} array contains all of the command-line arguments (after glob expansion and redirection processing on platforms where that must be done manually by the program) with subscripts ranging from 0 through @@ -15201,7 +15205,7 @@ if no match was found. @cindex @command{gawk}, @code{RT} variable in @cindex @code{RT} variable -@cindex differences in @command{awk} and @command{gawk}, @code{RT} variable +@cindex differences in @command{awk} and @command{gawk}, @code{RS}/@code{RT} variables @item @code{RT #} The input text that matched the text denoted by @code{RS}, the record separator. It is set every time a record is read. @@ -17498,7 +17502,7 @@ warning about this. @cindex common extensions, @code{length()} applied to an array @cindex extensions, common@comma{} @code{length()} applied to an array -@cindex differences between @command{gawk} and @command{awk} +@cindex differences in @command{awk} and @command{gawk}, @code{length()} function @cindex number of array elements @cindex array, number of elements With @command{gawk} and several other @command{awk} implementations, when given an @@ -19072,7 +19076,7 @@ Operands | 0 | 1 | 0 | 1 | 0 | 1 @end docbook @end float -@cindex bitwise, complement +@cindex bitwise complement @cindex complement, bitwise As you can see, the result of an AND operation is 1 only when @emph{both} bits are 1. @@ -27462,7 +27466,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 arrays, sorting, @code{IGNORECASE} variable and @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()}. @@ -27744,7 +27748,7 @@ driver and not passed through. Finally, coprocesses open up the possibility of @dfn{deadlock} between @command{gawk} and the program running in the coprocess. This can occur if you send ``too much'' data to the coprocess before reading any back; -each process is blocked writing data with noone available to read what +each process is blocked writing data with no one available to read what they've already written. There is no workaround for deadlock; careful programming and knowledge of the behavior of the coprocess are required. @end quotation @@ -29267,7 +29271,7 @@ functional program that you or someone else wrote). @node Debugging Terms @subsection Debugging Concepts -@cindex debugger concepts +@cindex debugger, concepts Before diving in to the details, we need to introduce several important concepts that apply to just about all debuggers. The following list defines terms used throughout the rest of @@ -29461,7 +29465,7 @@ let's see how we got to where we are. At the prompt, we type @samp{bt} (short for ``backtrace''), and the debugger responds with a listing of the current stack frames: -@cindex debugger, show stack frames +@cindex debugger, stack frames, showing @cindex debugger, @code{bt} command @cindex debugger, @code{backtrace} command @example @@ -29749,7 +29753,7 @@ it continues executing the program. @cindex debugger commands, @code{clear} @cindex @code{clear} debugger command -@cindex delete breakpoint at location +@cindex delete breakpoint, at location @cindex breakpoint at location, how to delete @item @code{clear} [[@var{filename}@code{:}]@var{n} | @var{function}] Without any argument, delete any breakpoint at the next instruction @@ -29786,7 +29790,7 @@ watchpoint is made unconditional). @cindex debugger commands, @code{delete} @cindex @code{delete} debugger command @cindex @code{d} debugger command (alias for @code{delete}) -@cindex delete breakpoint by number +@cindex delete breakpoint, by number @cindex breakpoint, delete by number @item @code{delete} [@var{n1 n2} @dots{}] [@var{n}--@var{m}] @itemx @code{d} [@var{n1 n2} @dots{}] [@var{n}--@var{m}] @@ -29885,6 +29889,7 @@ gawk> @cindex debugger commands, @code{c} (@code{continue}) @cindex debugger commands, @code{continue} @cindex continue program, in debugger +@cindex @code{continue} debugger command @item @code{continue} [@var{count}] @itemx @code{c} [@var{count}] Resume program execution. If continued from a breakpoint and @var{count} is @@ -30225,7 +30230,7 @@ from a file. The commands are: @cindex @code{option} debugger command @cindex @code{o} debugger command (alias for @code{option}) @cindex display debugger options -@cindex debugger options +@cindex debugger, options @item @code{option} [@var{name}[@code{=}@var{value}]] @itemx @code{o} [@var{name}[@code{=}@var{value}]] Without an argument, display the available debugger options @@ -30238,12 +30243,12 @@ The available options are: @c asis for docbook @table @asis @item @code{history_size} -@cindex debugger history size +@cindex debugger, history size Set the maximum number of lines to keep in the history file @file{./.gawk_history}. The default is 100. @item @code{listsize} -@cindex debugger default list amount +@cindex debugger, default list amount Specify the number of lines that @code{list} prints. The default is 15. @item @code{outfile} @@ -30253,11 +30258,11 @@ to standard output. An empty string (@code{""}) resets output to standard output. @item @code{prompt} -@cindex debugger prompt +@cindex debugger, prompt Change the debugger prompt. The default is @samp{@w{gawk> }}. @item @code{save_history} [@code{on} | @code{off}] -@cindex debugger history file +@cindex debugger, history file Save command history to file @file{./.gawk_history}. The default is @code{on}. @@ -30739,7 +30744,7 @@ the use of arbitrary-precision floating-point calculations. @cindex floating-point, numbers@comma{} arbitrary-precision @cindex single-precision @cindex double-precision -@cindex arbitrary-precision +@cindex arbitrary precision POSIX @command{awk} uses @dfn{double-precision} floating-point numbers, which can hold more digits than @dfn{single-precision} floating-point numbers. @command{gawk} has facilities for performing arbitrary-precision @@ -31641,6 +31646,7 @@ word sizes. See @cindex MPFR, checking availability of @cindex checking for MPFR +@cindex MPFR, checking for Occasionally, you might like to be able to check if @command{gawk} was invoked with the @option{-M} option, enabling arbitrary-precision arithmetic. You can do so with the following function, contributed @@ -32495,6 +32501,7 @@ process and reduces the time needed to create the value. @subsection Memory Allocation Functions and Convenience Macros @cindex allocating memory for extensions @cindex extensions, allocating memory +@cindex memory, allocating for extensions The API provides a number of @dfn{memory allocation} functions for allocating memory that can be passed to @command{gawk}, as well as a number of @@ -33887,6 +33894,7 @@ you should release any cached values that you created, using @node Array Manipulation @subsection Array Manipulation @cindex array manipulation in extensions +@cindex extensions, array manipulation in The primary data structure@footnote{OK, the only data structure.} in @command{awk} is the associative array (@pxref{Arrays}). @@ -39339,7 +39347,7 @@ flag is required to force Unix-style parsing rather than @code{DCL} parsing. If any other dash-type options (or multiple parameters such as @value{DF}s to process) are present, there is no ambiguity and @option{--} can be omitted. -@cindex exit status, of VMS +@cindex exit status, of @command{gawk}, on VMS The @code{exit} value is a Unix-style value and is encoded into a VMS exit status value when the program exits. |