diff options
Diffstat (limited to 'doc/gawk.info')
| -rw-r--r-- | doc/gawk.info | 478 |
1 files changed, 237 insertions, 241 deletions
diff --git a/doc/gawk.info b/doc/gawk.info index 6f5c2a31..e059a12e 100644 --- a/doc/gawk.info +++ b/doc/gawk.info @@ -20772,7 +20772,8 @@ output. They are as follows: structure of the program and the precedence rules. For example, '(3 + 5) * 4' means add three and five, then multiply the total by four. However, '3 + 5 * 4' has no parentheses, and means '3 + (5 * - 4)'. + 4)'. However, explicit parentheses in the source program are + retained. * Parentheses are used around the arguments to 'print' and 'printf' only when the 'print' or 'printf' statement is followed by a @@ -20794,10 +20795,11 @@ representation. Also, things such as: come out as: /foo/ { - print $0 + print } -which is correct, but possibly unexpected. +which is correct, but possibly unexpected. (If a program uses both +'print $0' and plain 'print', that distinction is retained.) Besides creating profiles when a program has completed, 'gawk' can produce a profile while it is running. This is useful if your 'awk' @@ -20853,7 +20855,10 @@ without any execution counts. profiling, and that created when pretty-printing. Pretty-printed output preserves the original comments that were in the program, although their placement may not correspond exactly to their original locations in the -source code.(1) +source code. However, no comments should be lost. Also, 'gawk' does +the best it can to preserve the distinction between comments at the end +of a statement and comments on lines by themselves. This isn't always +perfect, though. However, as a deliberate design decision, profiling output _omits_ the original program's comments. This allows you to focus on the @@ -20873,14 +20878,6 @@ disable 'gawk''s default optimizations. constants; if you used an octal or hexadecimal value in your source code, it will appear that way in the output. - ---------- Footnotes ---------- - - (1) 'gawk' does the best it can to preserve the distinction between -comments at the end of a statement and comments on lines by themselves. -Due to implementation constraints, it does not always do so correctly, -particularly for 'switch' statements. The 'gawk' maintainers hope to -improve this in a subsequent release. - File: gawk.info, Node: Advanced Features Summary, Prev: Profiling, Up: Advanced Features @@ -34156,7 +34153,7 @@ Index * dump debugger command: Miscellaneous Debugger Commands. (line 9) * dupword.awk program: Dupword Program. (line 31) -* dynamic profiling: Profiling. (line 177) +* dynamic profiling: Profiling. (line 179) * dynamically loaded extensions: Dynamic Extensions. (line 6) * e debugger command (alias for enable): Breakpoint Control. (line 73) * EBCDIC: Ordinal Functions. (line 45) @@ -34545,7 +34542,7 @@ Index * G., Daniel Richard: Acknowledgments. (line 60) * G., Daniel Richard <1>: Maintainers. (line 14) * Garfinkle, Scott: Contributors. (line 35) -* gawk program, dynamic profiling: Profiling. (line 177) +* gawk program, dynamic profiling: Profiling. (line 179) * gawk version: Auto-set. (line 241) * gawk, ARGIND variable in: Other Arguments. (line 15) * gawk, awk and: Preface. (line 21) @@ -34750,7 +34747,7 @@ Index * history expansion, in debugger: Readline Support. (line 6) * histsort.awk program: History Sorting. (line 25) * Hughes, Phil: Acknowledgments. (line 43) -* HUP signal, for dynamic profiling: Profiling. (line 209) +* HUP signal, for dynamic profiling: Profiling. (line 211) * hyphen (-), - operator: Precedence. (line 51) * hyphen (-), - operator <1>: Precedence. (line 57) * hyphen (-), -- operator: Increment Ops. (line 48) @@ -34832,7 +34829,7 @@ Index * installing gawk: Installation. (line 6) * instruction tracing, in debugger: Debugger Info. (line 90) * int: Numeric Functions. (line 24) -* INT signal (MS-Windows): Profiling. (line 212) +* INT signal (MS-Windows): Profiling. (line 214) * integer array indices: Numeric Array Subscripts. (line 31) * integers, arbitrary precision: Arbitrary Precision Integers. @@ -34888,7 +34885,7 @@ Index * Kernighan, Brian <8>: Other Versions. (line 13) * Kernighan, Brian <9>: Basic Data Typing. (line 54) * Kernighan, Brian <10>: Glossary. (line 204) -* kill command, dynamic profiling: Profiling. (line 186) +* kill command, dynamic profiling: Profiling. (line 188) * Knights, jedi: Undocumented. (line 6) * Kwok, Conrad: Contributors. (line 35) * l debugger command (alias for list): Miscellaneous Debugger Commands. @@ -35402,7 +35399,7 @@ Index * PROCINFO, values of sorted_in: Controlling Scanning. (line 26) * profiling awk programs: Profiling. (line 6) -* profiling awk programs, dynamically: Profiling. (line 177) +* profiling awk programs, dynamically: Profiling. (line 179) * program identifiers: Auto-set. (line 193) * program, definition of: Getting Started. (line 21) * programming conventions, --non-decimal-data option: Nondecimal Data. @@ -35439,7 +35436,7 @@ Index * QuikTrim Awk: Other Versions. (line 135) * quit debugger command: Miscellaneous Debugger Commands. (line 100) -* QUIT signal (MS-Windows): Profiling. (line 212) +* QUIT signal (MS-Windows): Profiling. (line 214) * quoting in gawk command lines: Long. (line 26) * quoting in gawk command lines, tricks for: Quoting. (line 91) * quoting, for small awk programs: Comments. (line 27) @@ -35729,15 +35726,15 @@ Index (line 130) * sidebar, Using \n in Bracket Expressions of Dynamic Regexps: Computed Regexps. (line 58) -* SIGHUP signal, for dynamic profiling: Profiling. (line 209) -* SIGINT signal (MS-Windows): Profiling. (line 212) -* signals, HUP/SIGHUP, for profiling: Profiling. (line 209) -* signals, INT/SIGINT (MS-Windows): Profiling. (line 212) -* signals, QUIT/SIGQUIT (MS-Windows): Profiling. (line 212) -* signals, USR1/SIGUSR1, for profiling: Profiling. (line 186) +* SIGHUP signal, for dynamic profiling: Profiling. (line 211) +* SIGINT signal (MS-Windows): Profiling. (line 214) +* signals, HUP/SIGHUP, for profiling: Profiling. (line 211) +* signals, INT/SIGINT (MS-Windows): Profiling. (line 214) +* signals, QUIT/SIGQUIT (MS-Windows): Profiling. (line 214) +* signals, USR1/SIGUSR1, for profiling: Profiling. (line 188) * signature program: Signature Program. (line 6) -* SIGQUIT signal (MS-Windows): Profiling. (line 212) -* SIGUSR1 signal, for dynamic profiling: Profiling. (line 186) +* SIGQUIT signal (MS-Windows): Profiling. (line 214) +* SIGUSR1 signal, for dynamic profiling: Profiling. (line 188) * silent debugger command: Debugger Execution Control. (line 10) * sin: Numeric Functions. (line 75) @@ -36017,7 +36014,7 @@ Index * user-modifiable variables: User-modified. (line 6) * users, information about, printing: Id Program. (line 6) * users, information about, retrieving: Passwd Functions. (line 16) -* USR1 signal, for dynamic profiling: Profiling. (line 186) +* USR1 signal, for dynamic profiling: Profiling. (line 188) * values, numeric: Basic Data Typing. (line 13) * values, string: Basic Data Typing. (line 13) * variable assignments and input files: Other Arguments. (line 26) @@ -36485,218 +36482,217 @@ Ref: Two-way I/O-Footnote-1835647 Ref: Two-way I/O-Footnote-2835834 Node: TCP/IP Networking835916 Node: Profiling839034 -Ref: Profiling-Footnote-1847706 -Node: Advanced Features Summary848029 -Node: Internationalization849873 -Node: I18N and L10N851353 -Node: Explaining gettext852040 -Ref: Explaining gettext-Footnote-1857932 -Ref: Explaining gettext-Footnote-2858117 -Node: Programmer i18n858282 -Ref: Programmer i18n-Footnote-1863231 -Node: Translator i18n863280 -Node: String Extraction864074 -Ref: String Extraction-Footnote-1865206 -Node: Printf Ordering865292 -Ref: Printf Ordering-Footnote-1868078 -Node: I18N Portability868142 -Ref: I18N Portability-Footnote-1870598 -Node: I18N Example870661 -Ref: I18N Example-Footnote-1873467 -Node: Gawk I18N873540 -Node: I18N Summary874185 -Node: Debugger875526 -Node: Debugging876549 -Node: Debugging Concepts876990 -Node: Debugging Terms878799 -Node: Awk Debugging881374 -Node: Sample Debugging Session882280 -Node: Debugger Invocation882814 -Node: Finding The Bug884200 -Node: List of Debugger Commands890678 -Node: Breakpoint Control892011 -Node: Debugger Execution Control895705 -Node: Viewing And Changing Data899067 -Node: Execution Stack902441 -Node: Debugger Info904078 -Node: Miscellaneous Debugger Commands908149 -Node: Readline Support913211 -Node: Limitations914107 -Node: Debugging Summary916216 -Node: Arbitrary Precision Arithmetic917495 -Node: Computer Arithmetic918980 -Ref: table-numeric-ranges922746 -Ref: table-floating-point-ranges923239 -Ref: Computer Arithmetic-Footnote-1923897 -Node: Math Definitions923954 -Ref: table-ieee-formats927270 -Ref: Math Definitions-Footnote-1927873 -Node: MPFR features927978 -Node: FP Math Caution929696 -Ref: FP Math Caution-Footnote-1930768 -Node: Inexactness of computations931137 -Node: Inexact representation932097 -Node: Comparing FP Values933457 -Node: Errors accumulate934698 -Node: Getting Accuracy936131 -Node: Try To Round938841 -Node: Setting precision939740 -Ref: table-predefined-precision-strings940437 -Node: Setting the rounding mode942267 -Ref: table-gawk-rounding-modes942641 -Ref: Setting the rounding mode-Footnote-1946572 -Node: Arbitrary Precision Integers946751 -Ref: Arbitrary Precision Integers-Footnote-1949926 -Node: Checking for MPFR950075 -Node: POSIX Floating Point Problems951549 -Ref: POSIX Floating Point Problems-Footnote-1955834 -Node: Floating point summary955872 -Node: Dynamic Extensions958062 -Node: Extension Intro959615 -Node: Plugin License960881 -Node: Extension Mechanism Outline961678 -Ref: figure-load-extension962117 -Ref: figure-register-new-function963682 -Ref: figure-call-new-function964774 -Node: Extension API Description966836 -Node: Extension API Functions Introduction968478 -Node: General Data Types974018 -Ref: General Data Types-Footnote-1982379 -Node: Memory Allocation Functions982678 -Ref: Memory Allocation Functions-Footnote-1986888 -Node: Constructor Functions986987 -Node: Registration Functions990573 -Node: Extension Functions991258 -Node: Exit Callback Functions996473 -Node: Extension Version String997723 -Node: Input Parsers998386 -Node: Output Wrappers1011107 -Node: Two-way processors1015619 -Node: Printing Messages1017884 -Ref: Printing Messages-Footnote-11019055 -Node: Updating ERRNO1019208 -Node: Requesting Values1019947 -Ref: table-value-types-returned1020684 -Node: Accessing Parameters1021620 -Node: Symbol Table Access1022855 -Node: Symbol table by name1023367 -Node: Symbol table by cookie1025156 -Ref: Symbol table by cookie-Footnote-11029341 -Node: Cached values1029405 -Ref: Cached values-Footnote-11032941 -Node: Array Manipulation1033094 -Ref: Array Manipulation-Footnote-11034185 -Node: Array Data Types1034222 -Ref: Array Data Types-Footnote-11036880 -Node: Array Functions1036972 -Node: Flattening Arrays1041470 -Node: Creating Arrays1048446 -Node: Redirection API1053213 -Node: Extension API Variables1056046 -Node: Extension Versioning1056757 -Ref: gawk-api-version1057186 -Node: Extension GMP/MPFR Versioning1058917 -Node: Extension API Informational Variables1060545 -Node: Extension API Boilerplate1061618 -Node: Changes from API V11065592 -Node: Finding Extensions1067164 -Node: Extension Example1067723 -Node: Internal File Description1068521 -Node: Internal File Ops1072601 -Ref: Internal File Ops-Footnote-11083951 -Node: Using Internal File Ops1084091 -Ref: Using Internal File Ops-Footnote-11086474 -Node: Extension Samples1086748 -Node: Extension Sample File Functions1088277 -Node: Extension Sample Fnmatch1095926 -Node: Extension Sample Fork1097413 -Node: Extension Sample Inplace1098631 -Node: Extension Sample Ord1101848 -Node: Extension Sample Readdir1102684 -Ref: table-readdir-file-types1103573 -Node: Extension Sample Revout1104378 -Node: Extension Sample Rev2way1104967 -Node: Extension Sample Read write array1105707 -Node: Extension Sample Readfile1107649 -Node: Extension Sample Time1108744 -Node: Extension Sample API Tests1110092 -Node: gawkextlib1110584 -Node: Extension summary1113502 -Node: Extension Exercises1117204 -Node: Language History1118702 -Node: V7/SVR3.11120358 -Node: SVR41122510 -Node: POSIX1123944 -Node: BTL1125324 -Node: POSIX/GNU1126053 -Node: Feature History1131831 -Node: Common Extensions1147690 -Node: Ranges and Locales1148973 -Ref: Ranges and Locales-Footnote-11153589 -Ref: Ranges and Locales-Footnote-21153616 -Ref: Ranges and Locales-Footnote-31153851 -Node: Contributors1154072 -Node: History summary1160017 -Node: Installation1161397 -Node: Gawk Distribution1162341 -Node: Getting1162825 -Node: Extracting1163788 -Node: Distribution contents1165426 -Node: Unix Installation1171906 -Node: Quick Installation1172588 -Node: Shell Startup Files1175002 -Node: Additional Configuration Options1176091 -Node: Configuration Philosophy1178256 -Node: Non-Unix Installation1180625 -Node: PC Installation1181085 -Node: PC Binary Installation1181923 -Node: PC Compiling1182358 -Node: PC Using1183475 -Node: Cygwin1186690 -Node: MSYS1187789 -Node: VMS Installation1188290 -Node: VMS Compilation1189081 -Ref: VMS Compilation-Footnote-11190310 -Node: VMS Dynamic Extensions1190368 -Node: VMS Installation Details1192053 -Node: VMS Running1194306 -Node: VMS GNV1198585 -Node: VMS Old Gawk1199320 -Node: Bugs1199791 -Node: Bug address1200454 -Node: Usenet1203436 -Node: Maintainers1204440 -Node: Other Versions1205701 -Node: Installation summary1212259 -Node: Notes1213461 -Node: Compatibility Mode1214255 -Node: Additions1215037 -Node: Accessing The Source1215962 -Node: Adding Code1217399 -Node: New Ports1223618 -Node: Derived Files1228106 -Ref: Derived Files-Footnote-11233752 -Ref: Derived Files-Footnote-21233787 -Ref: Derived Files-Footnote-31234385 -Node: Future Extensions1234499 -Node: Implementation Limitations1235157 -Node: Extension Design1236340 -Node: Old Extension Problems1237484 -Ref: Old Extension Problems-Footnote-11239002 -Node: Extension New Mechanism Goals1239059 -Ref: Extension New Mechanism Goals-Footnote-11242423 -Node: Extension Other Design Decisions1242612 -Node: Extension Future Growth1244725 -Node: Notes summary1245561 -Node: Basic Concepts1246736 -Node: Basic High Level1247417 -Ref: figure-general-flow1247699 -Ref: figure-process-flow1248384 -Ref: Basic High Level-Footnote-11251685 -Node: Basic Data Typing1251870 -Node: Glossary1255198 -Node: Copying1287036 -Node: GNU Free Documentation License1324579 -Node: Index1349699 +Node: Advanced Features Summary848039 +Node: Internationalization849883 +Node: I18N and L10N851363 +Node: Explaining gettext852050 +Ref: Explaining gettext-Footnote-1857942 +Ref: Explaining gettext-Footnote-2858127 +Node: Programmer i18n858292 +Ref: Programmer i18n-Footnote-1863241 +Node: Translator i18n863290 +Node: String Extraction864084 +Ref: String Extraction-Footnote-1865216 +Node: Printf Ordering865302 +Ref: Printf Ordering-Footnote-1868088 +Node: I18N Portability868152 +Ref: I18N Portability-Footnote-1870608 +Node: I18N Example870671 +Ref: I18N Example-Footnote-1873477 +Node: Gawk I18N873550 +Node: I18N Summary874195 +Node: Debugger875536 +Node: Debugging876559 +Node: Debugging Concepts877000 +Node: Debugging Terms878809 +Node: Awk Debugging881384 +Node: Sample Debugging Session882290 +Node: Debugger Invocation882824 +Node: Finding The Bug884210 +Node: List of Debugger Commands890688 +Node: Breakpoint Control892021 +Node: Debugger Execution Control895715 +Node: Viewing And Changing Data899077 +Node: Execution Stack902451 +Node: Debugger Info904088 +Node: Miscellaneous Debugger Commands908159 +Node: Readline Support913221 +Node: Limitations914117 +Node: Debugging Summary916226 +Node: Arbitrary Precision Arithmetic917505 +Node: Computer Arithmetic918990 +Ref: table-numeric-ranges922756 +Ref: table-floating-point-ranges923249 +Ref: Computer Arithmetic-Footnote-1923907 +Node: Math Definitions923964 +Ref: table-ieee-formats927280 +Ref: Math Definitions-Footnote-1927883 +Node: MPFR features927988 +Node: FP Math Caution929706 +Ref: FP Math Caution-Footnote-1930778 +Node: Inexactness of computations931147 +Node: Inexact representation932107 +Node: Comparing FP Values933467 +Node: Errors accumulate934708 +Node: Getting Accuracy936141 +Node: Try To Round938851 +Node: Setting precision939750 +Ref: table-predefined-precision-strings940447 +Node: Setting the rounding mode942277 +Ref: table-gawk-rounding-modes942651 +Ref: Setting the rounding mode-Footnote-1946582 +Node: Arbitrary Precision Integers946761 +Ref: Arbitrary Precision Integers-Footnote-1949936 +Node: Checking for MPFR950085 +Node: POSIX Floating Point Problems951559 +Ref: POSIX Floating Point Problems-Footnote-1955844 +Node: Floating point summary955882 +Node: Dynamic Extensions958072 +Node: Extension Intro959625 +Node: Plugin License960891 +Node: Extension Mechanism Outline961688 +Ref: figure-load-extension962127 +Ref: figure-register-new-function963692 +Ref: figure-call-new-function964784 +Node: Extension API Description966846 +Node: Extension API Functions Introduction968488 +Node: General Data Types974028 +Ref: General Data Types-Footnote-1982389 +Node: Memory Allocation Functions982688 +Ref: Memory Allocation Functions-Footnote-1986898 +Node: Constructor Functions986997 +Node: Registration Functions990583 +Node: Extension Functions991268 +Node: Exit Callback Functions996483 +Node: Extension Version String997733 +Node: Input Parsers998396 +Node: Output Wrappers1011117 +Node: Two-way processors1015629 +Node: Printing Messages1017894 +Ref: Printing Messages-Footnote-11019065 +Node: Updating ERRNO1019218 +Node: Requesting Values1019957 +Ref: table-value-types-returned1020694 +Node: Accessing Parameters1021630 +Node: Symbol Table Access1022865 +Node: Symbol table by name1023377 +Node: Symbol table by cookie1025166 +Ref: Symbol table by cookie-Footnote-11029351 +Node: Cached values1029415 +Ref: Cached values-Footnote-11032951 +Node: Array Manipulation1033104 +Ref: Array Manipulation-Footnote-11034195 +Node: Array Data Types1034232 +Ref: Array Data Types-Footnote-11036890 +Node: Array Functions1036982 +Node: Flattening Arrays1041480 +Node: Creating Arrays1048456 +Node: Redirection API1053223 +Node: Extension API Variables1056056 +Node: Extension Versioning1056767 +Ref: gawk-api-version1057196 +Node: Extension GMP/MPFR Versioning1058927 +Node: Extension API Informational Variables1060555 +Node: Extension API Boilerplate1061628 +Node: Changes from API V11065602 +Node: Finding Extensions1067174 +Node: Extension Example1067733 +Node: Internal File Description1068531 +Node: Internal File Ops1072611 +Ref: Internal File Ops-Footnote-11083961 +Node: Using Internal File Ops1084101 +Ref: Using Internal File Ops-Footnote-11086484 +Node: Extension Samples1086758 +Node: Extension Sample File Functions1088287 +Node: Extension Sample Fnmatch1095936 +Node: Extension Sample Fork1097423 +Node: Extension Sample Inplace1098641 +Node: Extension Sample Ord1101858 +Node: Extension Sample Readdir1102694 +Ref: table-readdir-file-types1103583 +Node: Extension Sample Revout1104388 +Node: Extension Sample Rev2way1104977 +Node: Extension Sample Read write array1105717 +Node: Extension Sample Readfile1107659 +Node: Extension Sample Time1108754 +Node: Extension Sample API Tests1110102 +Node: gawkextlib1110594 +Node: Extension summary1113512 +Node: Extension Exercises1117214 +Node: Language History1118712 +Node: V7/SVR3.11120368 +Node: SVR41122520 +Node: POSIX1123954 +Node: BTL1125334 +Node: POSIX/GNU1126063 +Node: Feature History1131841 +Node: Common Extensions1147700 +Node: Ranges and Locales1148983 +Ref: Ranges and Locales-Footnote-11153599 +Ref: Ranges and Locales-Footnote-21153626 +Ref: Ranges and Locales-Footnote-31153861 +Node: Contributors1154082 +Node: History summary1160027 +Node: Installation1161407 +Node: Gawk Distribution1162351 +Node: Getting1162835 +Node: Extracting1163798 +Node: Distribution contents1165436 +Node: Unix Installation1171916 +Node: Quick Installation1172598 +Node: Shell Startup Files1175012 +Node: Additional Configuration Options1176101 +Node: Configuration Philosophy1178266 +Node: Non-Unix Installation1180635 +Node: PC Installation1181095 +Node: PC Binary Installation1181933 +Node: PC Compiling1182368 +Node: PC Using1183485 +Node: Cygwin1186700 +Node: MSYS1187799 +Node: VMS Installation1188300 +Node: VMS Compilation1189091 +Ref: VMS Compilation-Footnote-11190320 +Node: VMS Dynamic Extensions1190378 +Node: VMS Installation Details1192063 +Node: VMS Running1194316 +Node: VMS GNV1198595 +Node: VMS Old Gawk1199330 +Node: Bugs1199801 +Node: Bug address1200464 +Node: Usenet1203446 +Node: Maintainers1204450 +Node: Other Versions1205711 +Node: Installation summary1212269 +Node: Notes1213471 +Node: Compatibility Mode1214265 +Node: Additions1215047 +Node: Accessing The Source1215972 +Node: Adding Code1217409 +Node: New Ports1223628 +Node: Derived Files1228116 +Ref: Derived Files-Footnote-11233762 +Ref: Derived Files-Footnote-21233797 +Ref: Derived Files-Footnote-31234395 +Node: Future Extensions1234509 +Node: Implementation Limitations1235167 +Node: Extension Design1236350 +Node: Old Extension Problems1237494 +Ref: Old Extension Problems-Footnote-11239012 +Node: Extension New Mechanism Goals1239069 +Ref: Extension New Mechanism Goals-Footnote-11242433 +Node: Extension Other Design Decisions1242622 +Node: Extension Future Growth1244735 +Node: Notes summary1245571 +Node: Basic Concepts1246746 +Node: Basic High Level1247427 +Ref: figure-general-flow1247709 +Ref: figure-process-flow1248394 +Ref: Basic High Level-Footnote-11251695 +Node: Basic Data Typing1251880 +Node: Glossary1255208 +Node: Copying1287046 +Node: GNU Free Documentation License1324589 +Node: Index1349709 End Tag Table |