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 986c97d4..2c7bf82b 100644 --- a/doc/gawk.info +++ b/doc/gawk.info @@ -20794,7 +20794,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 @@ -20816,10 +20817,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' @@ -20875,7 +20877,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 @@ -20895,14 +20900,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 @@ -34183,7 +34180,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) @@ -34572,7 +34569,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 263) * gawk, ARGIND variable in: Other Arguments. (line 15) * gawk, awk and: Preface. (line 21) @@ -34777,7 +34774,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) @@ -34859,7 +34856,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. @@ -34915,7 +34912,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. @@ -35430,7 +35427,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. @@ -35467,7 +35464,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) @@ -35757,15 +35754,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) @@ -36045,7 +36042,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) @@ -36513,218 +36510,217 @@ Ref: Two-way I/O-Footnote-1836195 Ref: Two-way I/O-Footnote-2836382 Node: TCP/IP Networking836464 Node: Profiling839582 -Ref: Profiling-Footnote-1848254 -Node: Advanced Features Summary848577 -Node: Internationalization850421 -Node: I18N and L10N851901 -Node: Explaining gettext852588 -Ref: Explaining gettext-Footnote-1858480 -Ref: Explaining gettext-Footnote-2858665 -Node: Programmer i18n858830 -Ref: Programmer i18n-Footnote-1863779 -Node: Translator i18n863828 -Node: String Extraction864622 -Ref: String Extraction-Footnote-1865754 -Node: Printf Ordering865840 -Ref: Printf Ordering-Footnote-1868626 -Node: I18N Portability868690 -Ref: I18N Portability-Footnote-1871146 -Node: I18N Example871209 -Ref: I18N Example-Footnote-1874015 -Node: Gawk I18N874088 -Node: I18N Summary874733 -Node: Debugger876074 -Node: Debugging877097 -Node: Debugging Concepts877538 -Node: Debugging Terms879347 -Node: Awk Debugging881922 -Node: Sample Debugging Session882828 -Node: Debugger Invocation883362 -Node: Finding The Bug884748 -Node: List of Debugger Commands891226 -Node: Breakpoint Control892559 -Node: Debugger Execution Control896253 -Node: Viewing And Changing Data899615 -Node: Execution Stack902989 -Node: Debugger Info904626 -Node: Miscellaneous Debugger Commands908697 -Node: Readline Support913759 -Node: Limitations914655 -Node: Debugging Summary916764 -Node: Arbitrary Precision Arithmetic918043 -Node: Computer Arithmetic919528 -Ref: table-numeric-ranges923294 -Ref: table-floating-point-ranges923787 -Ref: Computer Arithmetic-Footnote-1924445 -Node: Math Definitions924502 -Ref: table-ieee-formats927818 -Ref: Math Definitions-Footnote-1928421 -Node: MPFR features928526 -Node: FP Math Caution930244 -Ref: FP Math Caution-Footnote-1931316 -Node: Inexactness of computations931685 -Node: Inexact representation932645 -Node: Comparing FP Values934005 -Node: Errors accumulate935246 -Node: Getting Accuracy936679 -Node: Try To Round939389 -Node: Setting precision940288 -Ref: table-predefined-precision-strings940985 -Node: Setting the rounding mode942815 -Ref: table-gawk-rounding-modes943189 -Ref: Setting the rounding mode-Footnote-1947120 -Node: Arbitrary Precision Integers947299 -Ref: Arbitrary Precision Integers-Footnote-1950474 -Node: Checking for MPFR950623 -Node: POSIX Floating Point Problems952097 -Ref: POSIX Floating Point Problems-Footnote-1956382 -Node: Floating point summary956420 -Node: Dynamic Extensions958610 -Node: Extension Intro960163 -Node: Plugin License961429 -Node: Extension Mechanism Outline962226 -Ref: figure-load-extension962665 -Ref: figure-register-new-function964230 -Ref: figure-call-new-function965322 -Node: Extension API Description967384 -Node: Extension API Functions Introduction969026 -Node: General Data Types974566 -Ref: General Data Types-Footnote-1982927 -Node: Memory Allocation Functions983226 -Ref: Memory Allocation Functions-Footnote-1987436 -Node: Constructor Functions987535 -Node: Registration Functions991121 -Node: Extension Functions991806 -Node: Exit Callback Functions997021 -Node: Extension Version String998271 -Node: Input Parsers998934 -Node: Output Wrappers1011655 -Node: Two-way processors1016167 -Node: Printing Messages1018432 -Ref: Printing Messages-Footnote-11019603 -Node: Updating ERRNO1019756 -Node: Requesting Values1020495 -Ref: table-value-types-returned1021232 -Node: Accessing Parameters1022168 -Node: Symbol Table Access1023403 -Node: Symbol table by name1023915 -Node: Symbol table by cookie1025704 -Ref: Symbol table by cookie-Footnote-11029889 -Node: Cached values1029953 -Ref: Cached values-Footnote-11033489 -Node: Array Manipulation1033642 -Ref: Array Manipulation-Footnote-11034733 -Node: Array Data Types1034770 -Ref: Array Data Types-Footnote-11037428 -Node: Array Functions1037520 -Node: Flattening Arrays1042018 -Node: Creating Arrays1048994 -Node: Redirection API1053761 -Node: Extension API Variables1056594 -Node: Extension Versioning1057305 -Ref: gawk-api-version1057734 -Node: Extension GMP/MPFR Versioning1059465 -Node: Extension API Informational Variables1061093 -Node: Extension API Boilerplate1062166 -Node: Changes from API V11066140 -Node: Finding Extensions1067712 -Node: Extension Example1068271 -Node: Internal File Description1069069 -Node: Internal File Ops1073149 -Ref: Internal File Ops-Footnote-11084499 -Node: Using Internal File Ops1084639 -Ref: Using Internal File Ops-Footnote-11087022 -Node: Extension Samples1087296 -Node: Extension Sample File Functions1088825 -Node: Extension Sample Fnmatch1096474 -Node: Extension Sample Fork1097961 -Node: Extension Sample Inplace1099179 -Node: Extension Sample Ord1102396 -Node: Extension Sample Readdir1103232 -Ref: table-readdir-file-types1104121 -Node: Extension Sample Revout1104926 -Node: Extension Sample Rev2way1105515 -Node: Extension Sample Read write array1106255 -Node: Extension Sample Readfile1108197 -Node: Extension Sample Time1109292 -Node: Extension Sample API Tests1110640 -Node: gawkextlib1111132 -Node: Extension summary1114050 -Node: Extension Exercises1117752 -Node: Language History1119250 -Node: V7/SVR3.11120906 -Node: SVR41123058 -Node: POSIX1124492 -Node: BTL1125872 -Node: POSIX/GNU1126601 -Node: Feature History1132379 -Node: Common Extensions1148425 -Node: Ranges and Locales1149708 -Ref: Ranges and Locales-Footnote-11154324 -Ref: Ranges and Locales-Footnote-21154351 -Ref: Ranges and Locales-Footnote-31154586 -Node: Contributors1154807 -Node: History summary1160752 -Node: Installation1162132 -Node: Gawk Distribution1163076 -Node: Getting1163560 -Node: Extracting1164523 -Node: Distribution contents1166161 -Node: Unix Installation1172641 -Node: Quick Installation1173323 -Node: Shell Startup Files1175737 -Node: Additional Configuration Options1176826 -Node: Configuration Philosophy1178991 -Node: Non-Unix Installation1181360 -Node: PC Installation1181820 -Node: PC Binary Installation1182658 -Node: PC Compiling1183093 -Node: PC Using1184210 -Node: Cygwin1187425 -Node: MSYS1188524 -Node: VMS Installation1189025 -Node: VMS Compilation1189816 -Ref: VMS Compilation-Footnote-11191045 -Node: VMS Dynamic Extensions1191103 -Node: VMS Installation Details1192788 -Node: VMS Running1195041 -Node: VMS GNV1199320 -Node: VMS Old Gawk1200055 -Node: Bugs1200526 -Node: Bug address1201189 -Node: Usenet1204171 -Node: Maintainers1205175 -Node: Other Versions1206436 -Node: Installation summary1212994 -Node: Notes1214196 -Node: Compatibility Mode1214990 -Node: Additions1215772 -Node: Accessing The Source1216697 -Node: Adding Code1218134 -Node: New Ports1224353 -Node: Derived Files1228841 -Ref: Derived Files-Footnote-11234487 -Ref: Derived Files-Footnote-21234522 -Ref: Derived Files-Footnote-31235120 -Node: Future Extensions1235234 -Node: Implementation Limitations1235892 -Node: Extension Design1237075 -Node: Old Extension Problems1238219 -Ref: Old Extension Problems-Footnote-11239737 -Node: Extension New Mechanism Goals1239794 -Ref: Extension New Mechanism Goals-Footnote-11243158 -Node: Extension Other Design Decisions1243347 -Node: Extension Future Growth1245460 -Node: Notes summary1246296 -Node: Basic Concepts1247471 -Node: Basic High Level1248152 -Ref: figure-general-flow1248434 -Ref: figure-process-flow1249119 -Ref: Basic High Level-Footnote-11252420 -Node: Basic Data Typing1252605 -Node: Glossary1255933 -Node: Copying1287771 -Node: GNU Free Documentation License1325314 -Node: Index1350434 +Node: Advanced Features Summary848587 +Node: Internationalization850431 +Node: I18N and L10N851911 +Node: Explaining gettext852598 +Ref: Explaining gettext-Footnote-1858490 +Ref: Explaining gettext-Footnote-2858675 +Node: Programmer i18n858840 +Ref: Programmer i18n-Footnote-1863789 +Node: Translator i18n863838 +Node: String Extraction864632 +Ref: String Extraction-Footnote-1865764 +Node: Printf Ordering865850 +Ref: Printf Ordering-Footnote-1868636 +Node: I18N Portability868700 +Ref: I18N Portability-Footnote-1871156 +Node: I18N Example871219 +Ref: I18N Example-Footnote-1874025 +Node: Gawk I18N874098 +Node: I18N Summary874743 +Node: Debugger876084 +Node: Debugging877107 +Node: Debugging Concepts877548 +Node: Debugging Terms879357 +Node: Awk Debugging881932 +Node: Sample Debugging Session882838 +Node: Debugger Invocation883372 +Node: Finding The Bug884758 +Node: List of Debugger Commands891236 +Node: Breakpoint Control892569 +Node: Debugger Execution Control896263 +Node: Viewing And Changing Data899625 +Node: Execution Stack902999 +Node: Debugger Info904636 +Node: Miscellaneous Debugger Commands908707 +Node: Readline Support913769 +Node: Limitations914665 +Node: Debugging Summary916774 +Node: Arbitrary Precision Arithmetic918053 +Node: Computer Arithmetic919538 +Ref: table-numeric-ranges923304 +Ref: table-floating-point-ranges923797 +Ref: Computer Arithmetic-Footnote-1924455 +Node: Math Definitions924512 +Ref: table-ieee-formats927828 +Ref: Math Definitions-Footnote-1928431 +Node: MPFR features928536 +Node: FP Math Caution930254 +Ref: FP Math Caution-Footnote-1931326 +Node: Inexactness of computations931695 +Node: Inexact representation932655 +Node: Comparing FP Values934015 +Node: Errors accumulate935256 +Node: Getting Accuracy936689 +Node: Try To Round939399 +Node: Setting precision940298 +Ref: table-predefined-precision-strings940995 +Node: Setting the rounding mode942825 +Ref: table-gawk-rounding-modes943199 +Ref: Setting the rounding mode-Footnote-1947130 +Node: Arbitrary Precision Integers947309 +Ref: Arbitrary Precision Integers-Footnote-1950484 +Node: Checking for MPFR950633 +Node: POSIX Floating Point Problems952107 +Ref: POSIX Floating Point Problems-Footnote-1956392 +Node: Floating point summary956430 +Node: Dynamic Extensions958620 +Node: Extension Intro960173 +Node: Plugin License961439 +Node: Extension Mechanism Outline962236 +Ref: figure-load-extension962675 +Ref: figure-register-new-function964240 +Ref: figure-call-new-function965332 +Node: Extension API Description967394 +Node: Extension API Functions Introduction969036 +Node: General Data Types974576 +Ref: General Data Types-Footnote-1982937 +Node: Memory Allocation Functions983236 +Ref: Memory Allocation Functions-Footnote-1987446 +Node: Constructor Functions987545 +Node: Registration Functions991131 +Node: Extension Functions991816 +Node: Exit Callback Functions997031 +Node: Extension Version String998281 +Node: Input Parsers998944 +Node: Output Wrappers1011665 +Node: Two-way processors1016177 +Node: Printing Messages1018442 +Ref: Printing Messages-Footnote-11019613 +Node: Updating ERRNO1019766 +Node: Requesting Values1020505 +Ref: table-value-types-returned1021242 +Node: Accessing Parameters1022178 +Node: Symbol Table Access1023413 +Node: Symbol table by name1023925 +Node: Symbol table by cookie1025714 +Ref: Symbol table by cookie-Footnote-11029899 +Node: Cached values1029963 +Ref: Cached values-Footnote-11033499 +Node: Array Manipulation1033652 +Ref: Array Manipulation-Footnote-11034743 +Node: Array Data Types1034780 +Ref: Array Data Types-Footnote-11037438 +Node: Array Functions1037530 +Node: Flattening Arrays1042028 +Node: Creating Arrays1049004 +Node: Redirection API1053771 +Node: Extension API Variables1056604 +Node: Extension Versioning1057315 +Ref: gawk-api-version1057744 +Node: Extension GMP/MPFR Versioning1059475 +Node: Extension API Informational Variables1061103 +Node: Extension API Boilerplate1062176 +Node: Changes from API V11066150 +Node: Finding Extensions1067722 +Node: Extension Example1068281 +Node: Internal File Description1069079 +Node: Internal File Ops1073159 +Ref: Internal File Ops-Footnote-11084509 +Node: Using Internal File Ops1084649 +Ref: Using Internal File Ops-Footnote-11087032 +Node: Extension Samples1087306 +Node: Extension Sample File Functions1088835 +Node: Extension Sample Fnmatch1096484 +Node: Extension Sample Fork1097971 +Node: Extension Sample Inplace1099189 +Node: Extension Sample Ord1102406 +Node: Extension Sample Readdir1103242 +Ref: table-readdir-file-types1104131 +Node: Extension Sample Revout1104936 +Node: Extension Sample Rev2way1105525 +Node: Extension Sample Read write array1106265 +Node: Extension Sample Readfile1108207 +Node: Extension Sample Time1109302 +Node: Extension Sample API Tests1110650 +Node: gawkextlib1111142 +Node: Extension summary1114060 +Node: Extension Exercises1117762 +Node: Language History1119260 +Node: V7/SVR3.11120916 +Node: SVR41123068 +Node: POSIX1124502 +Node: BTL1125882 +Node: POSIX/GNU1126611 +Node: Feature History1132389 +Node: Common Extensions1148435 +Node: Ranges and Locales1149718 +Ref: Ranges and Locales-Footnote-11154334 +Ref: Ranges and Locales-Footnote-21154361 +Ref: Ranges and Locales-Footnote-31154596 +Node: Contributors1154817 +Node: History summary1160762 +Node: Installation1162142 +Node: Gawk Distribution1163086 +Node: Getting1163570 +Node: Extracting1164533 +Node: Distribution contents1166171 +Node: Unix Installation1172651 +Node: Quick Installation1173333 +Node: Shell Startup Files1175747 +Node: Additional Configuration Options1176836 +Node: Configuration Philosophy1179001 +Node: Non-Unix Installation1181370 +Node: PC Installation1181830 +Node: PC Binary Installation1182668 +Node: PC Compiling1183103 +Node: PC Using1184220 +Node: Cygwin1187435 +Node: MSYS1188534 +Node: VMS Installation1189035 +Node: VMS Compilation1189826 +Ref: VMS Compilation-Footnote-11191055 +Node: VMS Dynamic Extensions1191113 +Node: VMS Installation Details1192798 +Node: VMS Running1195051 +Node: VMS GNV1199330 +Node: VMS Old Gawk1200065 +Node: Bugs1200536 +Node: Bug address1201199 +Node: Usenet1204181 +Node: Maintainers1205185 +Node: Other Versions1206446 +Node: Installation summary1213004 +Node: Notes1214206 +Node: Compatibility Mode1215000 +Node: Additions1215782 +Node: Accessing The Source1216707 +Node: Adding Code1218144 +Node: New Ports1224363 +Node: Derived Files1228851 +Ref: Derived Files-Footnote-11234497 +Ref: Derived Files-Footnote-21234532 +Ref: Derived Files-Footnote-31235130 +Node: Future Extensions1235244 +Node: Implementation Limitations1235902 +Node: Extension Design1237085 +Node: Old Extension Problems1238229 +Ref: Old Extension Problems-Footnote-11239747 +Node: Extension New Mechanism Goals1239804 +Ref: Extension New Mechanism Goals-Footnote-11243168 +Node: Extension Other Design Decisions1243357 +Node: Extension Future Growth1245470 +Node: Notes summary1246306 +Node: Basic Concepts1247481 +Node: Basic High Level1248162 +Ref: figure-general-flow1248444 +Ref: figure-process-flow1249129 +Ref: Basic High Level-Footnote-11252430 +Node: Basic Data Typing1252615 +Node: Glossary1255943 +Node: Copying1287781 +Node: GNU Free Documentation License1325324 +Node: Index1350444 End Tag Table |