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 561a40f6..be729ca2 100644 --- a/doc/gawk.info +++ b/doc/gawk.info @@ -20795,7 +20795,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 @@ -20817,10 +20818,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' @@ -20876,7 +20878,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 @@ -20896,14 +20901,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 @@ -34198,7 +34195,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) @@ -34587,7 +34584,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 262) * gawk, ARGIND variable in: Other Arguments. (line 15) * gawk, awk and: Preface. (line 21) @@ -34794,7 +34791,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) @@ -34876,7 +34873,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. @@ -34932,7 +34929,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. @@ -35447,7 +35444,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. @@ -35484,7 +35481,7 @@ Index * QuikTrim Awk: Other Versions. (line 143) * 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) @@ -35774,15 +35771,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) @@ -36063,7 +36060,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) @@ -36531,218 +36528,217 @@ Ref: Two-way I/O-Footnote-1836330 Ref: Two-way I/O-Footnote-2836517 Node: TCP/IP Networking836599 Node: Profiling839717 -Ref: Profiling-Footnote-1848389 -Node: Advanced Features Summary848712 -Node: Internationalization850556 -Node: I18N and L10N852036 -Node: Explaining gettext852723 -Ref: Explaining gettext-Footnote-1858615 -Ref: Explaining gettext-Footnote-2858800 -Node: Programmer i18n858965 -Ref: Programmer i18n-Footnote-1863914 -Node: Translator i18n863963 -Node: String Extraction864757 -Ref: String Extraction-Footnote-1865889 -Node: Printf Ordering865975 -Ref: Printf Ordering-Footnote-1868761 -Node: I18N Portability868825 -Ref: I18N Portability-Footnote-1871281 -Node: I18N Example871344 -Ref: I18N Example-Footnote-1874150 -Node: Gawk I18N874223 -Node: I18N Summary874868 -Node: Debugger876209 -Node: Debugging877232 -Node: Debugging Concepts877673 -Node: Debugging Terms879482 -Node: Awk Debugging882057 -Node: Sample Debugging Session882963 -Node: Debugger Invocation883497 -Node: Finding The Bug884883 -Node: List of Debugger Commands891361 -Node: Breakpoint Control892694 -Node: Debugger Execution Control896388 -Node: Viewing And Changing Data899750 -Node: Execution Stack903124 -Node: Debugger Info904761 -Node: Miscellaneous Debugger Commands908832 -Node: Readline Support913894 -Node: Limitations914790 -Node: Debugging Summary916899 -Node: Arbitrary Precision Arithmetic918178 -Node: Computer Arithmetic919663 -Ref: table-numeric-ranges923429 -Ref: table-floating-point-ranges923922 -Ref: Computer Arithmetic-Footnote-1924580 -Node: Math Definitions924637 -Ref: table-ieee-formats927953 -Ref: Math Definitions-Footnote-1928556 -Node: MPFR features928661 -Node: FP Math Caution930379 -Ref: FP Math Caution-Footnote-1931451 -Node: Inexactness of computations931820 -Node: Inexact representation932780 -Node: Comparing FP Values934140 -Node: Errors accumulate935381 -Node: Getting Accuracy936814 -Node: Try To Round939524 -Node: Setting precision940423 -Ref: table-predefined-precision-strings941120 -Node: Setting the rounding mode942950 -Ref: table-gawk-rounding-modes943324 -Ref: Setting the rounding mode-Footnote-1947255 -Node: Arbitrary Precision Integers947434 -Ref: Arbitrary Precision Integers-Footnote-1950609 -Node: Checking for MPFR950758 -Node: POSIX Floating Point Problems952232 -Ref: POSIX Floating Point Problems-Footnote-1956517 -Node: Floating point summary956555 -Node: Dynamic Extensions958745 -Node: Extension Intro960298 -Node: Plugin License961564 -Node: Extension Mechanism Outline962361 -Ref: figure-load-extension962800 -Ref: figure-register-new-function964365 -Ref: figure-call-new-function965457 -Node: Extension API Description967519 -Node: Extension API Functions Introduction969161 -Node: General Data Types974701 -Ref: General Data Types-Footnote-1983062 -Node: Memory Allocation Functions983361 -Ref: Memory Allocation Functions-Footnote-1987571 -Node: Constructor Functions987670 -Node: Registration Functions991256 -Node: Extension Functions991941 -Node: Exit Callback Functions997156 -Node: Extension Version String998406 -Node: Input Parsers999069 -Node: Output Wrappers1011790 -Node: Two-way processors1016302 -Node: Printing Messages1018567 -Ref: Printing Messages-Footnote-11019738 -Node: Updating ERRNO1019891 -Node: Requesting Values1020630 -Ref: table-value-types-returned1021367 -Node: Accessing Parameters1022303 -Node: Symbol Table Access1023538 -Node: Symbol table by name1024050 -Node: Symbol table by cookie1025839 -Ref: Symbol table by cookie-Footnote-11030024 -Node: Cached values1030088 -Ref: Cached values-Footnote-11033624 -Node: Array Manipulation1033777 -Ref: Array Manipulation-Footnote-11034868 -Node: Array Data Types1034905 -Ref: Array Data Types-Footnote-11037563 -Node: Array Functions1037655 -Node: Flattening Arrays1042153 -Node: Creating Arrays1049129 -Node: Redirection API1053896 -Node: Extension API Variables1056729 -Node: Extension Versioning1057440 -Ref: gawk-api-version1057869 -Node: Extension GMP/MPFR Versioning1059600 -Node: Extension API Informational Variables1061228 -Node: Extension API Boilerplate1062301 -Node: Changes from API V11066275 -Node: Finding Extensions1067847 -Node: Extension Example1068406 -Node: Internal File Description1069204 -Node: Internal File Ops1073284 -Ref: Internal File Ops-Footnote-11084634 -Node: Using Internal File Ops1084774 -Ref: Using Internal File Ops-Footnote-11087157 -Node: Extension Samples1087431 -Node: Extension Sample File Functions1088960 -Node: Extension Sample Fnmatch1096609 -Node: Extension Sample Fork1098096 -Node: Extension Sample Inplace1099314 -Node: Extension Sample Ord1102531 -Node: Extension Sample Readdir1103367 -Ref: table-readdir-file-types1104256 -Node: Extension Sample Revout1105061 -Node: Extension Sample Rev2way1105650 -Node: Extension Sample Read write array1106390 -Node: Extension Sample Readfile1108332 -Node: Extension Sample Time1109427 -Node: Extension Sample API Tests1110775 -Node: gawkextlib1111267 -Node: Extension summary1114185 -Node: Extension Exercises1117887 -Node: Language History1119385 -Node: V7/SVR3.11121041 -Node: SVR41123193 -Node: POSIX1124627 -Node: BTL1126007 -Node: POSIX/GNU1126736 -Node: Feature History1132514 -Node: Common Extensions1148560 -Node: Ranges and Locales1149843 -Ref: Ranges and Locales-Footnote-11154459 -Ref: Ranges and Locales-Footnote-21154486 -Ref: Ranges and Locales-Footnote-31154721 -Node: Contributors1154942 -Node: History summary1160887 -Node: Installation1162267 -Node: Gawk Distribution1163211 -Node: Getting1163695 -Node: Extracting1164658 -Node: Distribution contents1166296 -Node: Unix Installation1172776 -Node: Quick Installation1173458 -Node: Shell Startup Files1175872 -Node: Additional Configuration Options1176961 -Node: Configuration Philosophy1179126 -Node: Non-Unix Installation1181495 -Node: PC Installation1181955 -Node: PC Binary Installation1182793 -Node: PC Compiling1183228 -Node: PC Using1184345 -Node: Cygwin1187898 -Node: MSYS1188997 -Node: VMS Installation1189498 -Node: VMS Compilation1190289 -Ref: VMS Compilation-Footnote-11191518 -Node: VMS Dynamic Extensions1191576 -Node: VMS Installation Details1193261 -Node: VMS Running1195514 -Node: VMS GNV1199793 -Node: VMS Old Gawk1200528 -Node: Bugs1200999 -Node: Bug address1201662 -Node: Usenet1204644 -Node: Maintainers1205648 -Node: Other Versions1206909 -Node: Installation summary1213823 -Node: Notes1215025 -Node: Compatibility Mode1215819 -Node: Additions1216601 -Node: Accessing The Source1217526 -Node: Adding Code1218963 -Node: New Ports1225182 -Node: Derived Files1229670 -Ref: Derived Files-Footnote-11235316 -Ref: Derived Files-Footnote-21235351 -Ref: Derived Files-Footnote-31235949 -Node: Future Extensions1236063 -Node: Implementation Limitations1236721 -Node: Extension Design1237904 -Node: Old Extension Problems1239048 -Ref: Old Extension Problems-Footnote-11240566 -Node: Extension New Mechanism Goals1240623 -Ref: Extension New Mechanism Goals-Footnote-11243987 -Node: Extension Other Design Decisions1244176 -Node: Extension Future Growth1246289 -Node: Notes summary1247125 -Node: Basic Concepts1248300 -Node: Basic High Level1248981 -Ref: figure-general-flow1249263 -Ref: figure-process-flow1249948 -Ref: Basic High Level-Footnote-11253249 -Node: Basic Data Typing1253434 -Node: Glossary1256762 -Node: Copying1288600 -Node: GNU Free Documentation License1326143 -Node: Index1351263 +Node: Advanced Features Summary848722 +Node: Internationalization850566 +Node: I18N and L10N852046 +Node: Explaining gettext852733 +Ref: Explaining gettext-Footnote-1858625 +Ref: Explaining gettext-Footnote-2858810 +Node: Programmer i18n858975 +Ref: Programmer i18n-Footnote-1863924 +Node: Translator i18n863973 +Node: String Extraction864767 +Ref: String Extraction-Footnote-1865899 +Node: Printf Ordering865985 +Ref: Printf Ordering-Footnote-1868771 +Node: I18N Portability868835 +Ref: I18N Portability-Footnote-1871291 +Node: I18N Example871354 +Ref: I18N Example-Footnote-1874160 +Node: Gawk I18N874233 +Node: I18N Summary874878 +Node: Debugger876219 +Node: Debugging877242 +Node: Debugging Concepts877683 +Node: Debugging Terms879492 +Node: Awk Debugging882067 +Node: Sample Debugging Session882973 +Node: Debugger Invocation883507 +Node: Finding The Bug884893 +Node: List of Debugger Commands891371 +Node: Breakpoint Control892704 +Node: Debugger Execution Control896398 +Node: Viewing And Changing Data899760 +Node: Execution Stack903134 +Node: Debugger Info904771 +Node: Miscellaneous Debugger Commands908842 +Node: Readline Support913904 +Node: Limitations914800 +Node: Debugging Summary916909 +Node: Arbitrary Precision Arithmetic918188 +Node: Computer Arithmetic919673 +Ref: table-numeric-ranges923439 +Ref: table-floating-point-ranges923932 +Ref: Computer Arithmetic-Footnote-1924590 +Node: Math Definitions924647 +Ref: table-ieee-formats927963 +Ref: Math Definitions-Footnote-1928566 +Node: MPFR features928671 +Node: FP Math Caution930389 +Ref: FP Math Caution-Footnote-1931461 +Node: Inexactness of computations931830 +Node: Inexact representation932790 +Node: Comparing FP Values934150 +Node: Errors accumulate935391 +Node: Getting Accuracy936824 +Node: Try To Round939534 +Node: Setting precision940433 +Ref: table-predefined-precision-strings941130 +Node: Setting the rounding mode942960 +Ref: table-gawk-rounding-modes943334 +Ref: Setting the rounding mode-Footnote-1947265 +Node: Arbitrary Precision Integers947444 +Ref: Arbitrary Precision Integers-Footnote-1950619 +Node: Checking for MPFR950768 +Node: POSIX Floating Point Problems952242 +Ref: POSIX Floating Point Problems-Footnote-1956527 +Node: Floating point summary956565 +Node: Dynamic Extensions958755 +Node: Extension Intro960308 +Node: Plugin License961574 +Node: Extension Mechanism Outline962371 +Ref: figure-load-extension962810 +Ref: figure-register-new-function964375 +Ref: figure-call-new-function965467 +Node: Extension API Description967529 +Node: Extension API Functions Introduction969171 +Node: General Data Types974711 +Ref: General Data Types-Footnote-1983072 +Node: Memory Allocation Functions983371 +Ref: Memory Allocation Functions-Footnote-1987581 +Node: Constructor Functions987680 +Node: Registration Functions991266 +Node: Extension Functions991951 +Node: Exit Callback Functions997166 +Node: Extension Version String998416 +Node: Input Parsers999079 +Node: Output Wrappers1011800 +Node: Two-way processors1016312 +Node: Printing Messages1018577 +Ref: Printing Messages-Footnote-11019748 +Node: Updating ERRNO1019901 +Node: Requesting Values1020640 +Ref: table-value-types-returned1021377 +Node: Accessing Parameters1022313 +Node: Symbol Table Access1023548 +Node: Symbol table by name1024060 +Node: Symbol table by cookie1025849 +Ref: Symbol table by cookie-Footnote-11030034 +Node: Cached values1030098 +Ref: Cached values-Footnote-11033634 +Node: Array Manipulation1033787 +Ref: Array Manipulation-Footnote-11034878 +Node: Array Data Types1034915 +Ref: Array Data Types-Footnote-11037573 +Node: Array Functions1037665 +Node: Flattening Arrays1042163 +Node: Creating Arrays1049139 +Node: Redirection API1053906 +Node: Extension API Variables1056739 +Node: Extension Versioning1057450 +Ref: gawk-api-version1057879 +Node: Extension GMP/MPFR Versioning1059610 +Node: Extension API Informational Variables1061238 +Node: Extension API Boilerplate1062311 +Node: Changes from API V11066285 +Node: Finding Extensions1067857 +Node: Extension Example1068416 +Node: Internal File Description1069214 +Node: Internal File Ops1073294 +Ref: Internal File Ops-Footnote-11084644 +Node: Using Internal File Ops1084784 +Ref: Using Internal File Ops-Footnote-11087167 +Node: Extension Samples1087441 +Node: Extension Sample File Functions1088970 +Node: Extension Sample Fnmatch1096619 +Node: Extension Sample Fork1098106 +Node: Extension Sample Inplace1099324 +Node: Extension Sample Ord1102541 +Node: Extension Sample Readdir1103377 +Ref: table-readdir-file-types1104266 +Node: Extension Sample Revout1105071 +Node: Extension Sample Rev2way1105660 +Node: Extension Sample Read write array1106400 +Node: Extension Sample Readfile1108342 +Node: Extension Sample Time1109437 +Node: Extension Sample API Tests1110785 +Node: gawkextlib1111277 +Node: Extension summary1114195 +Node: Extension Exercises1117897 +Node: Language History1119395 +Node: V7/SVR3.11121051 +Node: SVR41123203 +Node: POSIX1124637 +Node: BTL1126017 +Node: POSIX/GNU1126746 +Node: Feature History1132524 +Node: Common Extensions1148570 +Node: Ranges and Locales1149853 +Ref: Ranges and Locales-Footnote-11154469 +Ref: Ranges and Locales-Footnote-21154496 +Ref: Ranges and Locales-Footnote-31154731 +Node: Contributors1154952 +Node: History summary1160897 +Node: Installation1162277 +Node: Gawk Distribution1163221 +Node: Getting1163705 +Node: Extracting1164668 +Node: Distribution contents1166306 +Node: Unix Installation1172786 +Node: Quick Installation1173468 +Node: Shell Startup Files1175882 +Node: Additional Configuration Options1176971 +Node: Configuration Philosophy1179136 +Node: Non-Unix Installation1181505 +Node: PC Installation1181965 +Node: PC Binary Installation1182803 +Node: PC Compiling1183238 +Node: PC Using1184355 +Node: Cygwin1187908 +Node: MSYS1189007 +Node: VMS Installation1189508 +Node: VMS Compilation1190299 +Ref: VMS Compilation-Footnote-11191528 +Node: VMS Dynamic Extensions1191586 +Node: VMS Installation Details1193271 +Node: VMS Running1195524 +Node: VMS GNV1199803 +Node: VMS Old Gawk1200538 +Node: Bugs1201009 +Node: Bug address1201672 +Node: Usenet1204654 +Node: Maintainers1205658 +Node: Other Versions1206919 +Node: Installation summary1213833 +Node: Notes1215035 +Node: Compatibility Mode1215829 +Node: Additions1216611 +Node: Accessing The Source1217536 +Node: Adding Code1218973 +Node: New Ports1225192 +Node: Derived Files1229680 +Ref: Derived Files-Footnote-11235326 +Ref: Derived Files-Footnote-21235361 +Ref: Derived Files-Footnote-31235959 +Node: Future Extensions1236073 +Node: Implementation Limitations1236731 +Node: Extension Design1237914 +Node: Old Extension Problems1239058 +Ref: Old Extension Problems-Footnote-11240576 +Node: Extension New Mechanism Goals1240633 +Ref: Extension New Mechanism Goals-Footnote-11243997 +Node: Extension Other Design Decisions1244186 +Node: Extension Future Growth1246299 +Node: Notes summary1247135 +Node: Basic Concepts1248310 +Node: Basic High Level1248991 +Ref: figure-general-flow1249273 +Ref: figure-process-flow1249958 +Ref: Basic High Level-Footnote-11253259 +Node: Basic Data Typing1253444 +Node: Glossary1256772 +Node: Copying1288610 +Node: GNU Free Documentation License1326153 +Node: Index1351273 End Tag Table |