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 60713f8f..e0738357 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 @@ -34197,7 +34194,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) @@ -34586,7 +34583,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) @@ -34793,7 +34790,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) @@ -34875,7 +34872,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. @@ -34931,7 +34928,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. @@ -35446,7 +35443,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. @@ -35483,7 +35480,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) @@ -35773,15 +35770,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) @@ -36062,7 +36059,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) @@ -36530,218 +36527,217 @@ Ref: Two-way I/O-Footnote-1836301 Ref: Two-way I/O-Footnote-2836488 Node: TCP/IP Networking836570 Node: Profiling839688 -Ref: Profiling-Footnote-1848360 -Node: Advanced Features Summary848683 -Node: Internationalization850527 -Node: I18N and L10N852007 -Node: Explaining gettext852694 -Ref: Explaining gettext-Footnote-1858586 -Ref: Explaining gettext-Footnote-2858771 -Node: Programmer i18n858936 -Ref: Programmer i18n-Footnote-1863885 -Node: Translator i18n863934 -Node: String Extraction864728 -Ref: String Extraction-Footnote-1865860 -Node: Printf Ordering865946 -Ref: Printf Ordering-Footnote-1868732 -Node: I18N Portability868796 -Ref: I18N Portability-Footnote-1871252 -Node: I18N Example871315 -Ref: I18N Example-Footnote-1874121 -Node: Gawk I18N874194 -Node: I18N Summary874839 -Node: Debugger876180 -Node: Debugging877203 -Node: Debugging Concepts877644 -Node: Debugging Terms879453 -Node: Awk Debugging882028 -Node: Sample Debugging Session882934 -Node: Debugger Invocation883468 -Node: Finding The Bug884854 -Node: List of Debugger Commands891332 -Node: Breakpoint Control892665 -Node: Debugger Execution Control896359 -Node: Viewing And Changing Data899721 -Node: Execution Stack903095 -Node: Debugger Info904732 -Node: Miscellaneous Debugger Commands908803 -Node: Readline Support913865 -Node: Limitations914761 -Node: Debugging Summary916870 -Node: Arbitrary Precision Arithmetic918149 -Node: Computer Arithmetic919634 -Ref: table-numeric-ranges923400 -Ref: table-floating-point-ranges923893 -Ref: Computer Arithmetic-Footnote-1924551 -Node: Math Definitions924608 -Ref: table-ieee-formats927924 -Ref: Math Definitions-Footnote-1928527 -Node: MPFR features928632 -Node: FP Math Caution930350 -Ref: FP Math Caution-Footnote-1931422 -Node: Inexactness of computations931791 -Node: Inexact representation932751 -Node: Comparing FP Values934111 -Node: Errors accumulate935352 -Node: Getting Accuracy936785 -Node: Try To Round939495 -Node: Setting precision940394 -Ref: table-predefined-precision-strings941091 -Node: Setting the rounding mode942921 -Ref: table-gawk-rounding-modes943295 -Ref: Setting the rounding mode-Footnote-1947226 -Node: Arbitrary Precision Integers947405 -Ref: Arbitrary Precision Integers-Footnote-1950580 -Node: Checking for MPFR950729 -Node: POSIX Floating Point Problems952203 -Ref: POSIX Floating Point Problems-Footnote-1956488 -Node: Floating point summary956526 -Node: Dynamic Extensions958716 -Node: Extension Intro960269 -Node: Plugin License961535 -Node: Extension Mechanism Outline962332 -Ref: figure-load-extension962771 -Ref: figure-register-new-function964336 -Ref: figure-call-new-function965428 -Node: Extension API Description967490 -Node: Extension API Functions Introduction969132 -Node: General Data Types974672 -Ref: General Data Types-Footnote-1983033 -Node: Memory Allocation Functions983332 -Ref: Memory Allocation Functions-Footnote-1987542 -Node: Constructor Functions987641 -Node: Registration Functions991227 -Node: Extension Functions991912 -Node: Exit Callback Functions997127 -Node: Extension Version String998377 -Node: Input Parsers999040 -Node: Output Wrappers1011761 -Node: Two-way processors1016273 -Node: Printing Messages1018538 -Ref: Printing Messages-Footnote-11019709 -Node: Updating ERRNO1019862 -Node: Requesting Values1020601 -Ref: table-value-types-returned1021338 -Node: Accessing Parameters1022274 -Node: Symbol Table Access1023509 -Node: Symbol table by name1024021 -Node: Symbol table by cookie1025810 -Ref: Symbol table by cookie-Footnote-11029995 -Node: Cached values1030059 -Ref: Cached values-Footnote-11033595 -Node: Array Manipulation1033748 -Ref: Array Manipulation-Footnote-11034839 -Node: Array Data Types1034876 -Ref: Array Data Types-Footnote-11037534 -Node: Array Functions1037626 -Node: Flattening Arrays1042124 -Node: Creating Arrays1049100 -Node: Redirection API1053867 -Node: Extension API Variables1056700 -Node: Extension Versioning1057411 -Ref: gawk-api-version1057840 -Node: Extension GMP/MPFR Versioning1059571 -Node: Extension API Informational Variables1061199 -Node: Extension API Boilerplate1062272 -Node: Changes from API V11066246 -Node: Finding Extensions1067818 -Node: Extension Example1068377 -Node: Internal File Description1069175 -Node: Internal File Ops1073255 -Ref: Internal File Ops-Footnote-11084605 -Node: Using Internal File Ops1084745 -Ref: Using Internal File Ops-Footnote-11087128 -Node: Extension Samples1087402 -Node: Extension Sample File Functions1088931 -Node: Extension Sample Fnmatch1096580 -Node: Extension Sample Fork1098067 -Node: Extension Sample Inplace1099285 -Node: Extension Sample Ord1102502 -Node: Extension Sample Readdir1103338 -Ref: table-readdir-file-types1104227 -Node: Extension Sample Revout1105032 -Node: Extension Sample Rev2way1105621 -Node: Extension Sample Read write array1106361 -Node: Extension Sample Readfile1108303 -Node: Extension Sample Time1109398 -Node: Extension Sample API Tests1110746 -Node: gawkextlib1111238 -Node: Extension summary1114156 -Node: Extension Exercises1117858 -Node: Language History1119356 -Node: V7/SVR3.11121012 -Node: SVR41123164 -Node: POSIX1124598 -Node: BTL1125978 -Node: POSIX/GNU1126707 -Node: Feature History1132485 -Node: Common Extensions1148531 -Node: Ranges and Locales1149814 -Ref: Ranges and Locales-Footnote-11154430 -Ref: Ranges and Locales-Footnote-21154457 -Ref: Ranges and Locales-Footnote-31154692 -Node: Contributors1154913 -Node: History summary1160858 -Node: Installation1162238 -Node: Gawk Distribution1163182 -Node: Getting1163666 -Node: Extracting1164629 -Node: Distribution contents1166267 -Node: Unix Installation1172747 -Node: Quick Installation1173429 -Node: Shell Startup Files1175843 -Node: Additional Configuration Options1176932 -Node: Configuration Philosophy1179097 -Node: Non-Unix Installation1181466 -Node: PC Installation1181926 -Node: PC Binary Installation1182764 -Node: PC Compiling1183199 -Node: PC Using1184316 -Node: Cygwin1187869 -Node: MSYS1188968 -Node: VMS Installation1189469 -Node: VMS Compilation1190260 -Ref: VMS Compilation-Footnote-11191489 -Node: VMS Dynamic Extensions1191547 -Node: VMS Installation Details1193232 -Node: VMS Running1195485 -Node: VMS GNV1199764 -Node: VMS Old Gawk1200499 -Node: Bugs1200970 -Node: Bug address1201633 -Node: Usenet1204615 -Node: Maintainers1205619 -Node: Other Versions1206880 -Node: Installation summary1213794 -Node: Notes1214996 -Node: Compatibility Mode1215790 -Node: Additions1216572 -Node: Accessing The Source1217497 -Node: Adding Code1218934 -Node: New Ports1225153 -Node: Derived Files1229641 -Ref: Derived Files-Footnote-11235287 -Ref: Derived Files-Footnote-21235322 -Ref: Derived Files-Footnote-31235920 -Node: Future Extensions1236034 -Node: Implementation Limitations1236692 -Node: Extension Design1237875 -Node: Old Extension Problems1239019 -Ref: Old Extension Problems-Footnote-11240537 -Node: Extension New Mechanism Goals1240594 -Ref: Extension New Mechanism Goals-Footnote-11243958 -Node: Extension Other Design Decisions1244147 -Node: Extension Future Growth1246260 -Node: Notes summary1247096 -Node: Basic Concepts1248271 -Node: Basic High Level1248952 -Ref: figure-general-flow1249234 -Ref: figure-process-flow1249919 -Ref: Basic High Level-Footnote-11253220 -Node: Basic Data Typing1253405 -Node: Glossary1256733 -Node: Copying1288571 -Node: GNU Free Documentation License1326114 -Node: Index1351234 +Node: Advanced Features Summary848693 +Node: Internationalization850537 +Node: I18N and L10N852017 +Node: Explaining gettext852704 +Ref: Explaining gettext-Footnote-1858596 +Ref: Explaining gettext-Footnote-2858781 +Node: Programmer i18n858946 +Ref: Programmer i18n-Footnote-1863895 +Node: Translator i18n863944 +Node: String Extraction864738 +Ref: String Extraction-Footnote-1865870 +Node: Printf Ordering865956 +Ref: Printf Ordering-Footnote-1868742 +Node: I18N Portability868806 +Ref: I18N Portability-Footnote-1871262 +Node: I18N Example871325 +Ref: I18N Example-Footnote-1874131 +Node: Gawk I18N874204 +Node: I18N Summary874849 +Node: Debugger876190 +Node: Debugging877213 +Node: Debugging Concepts877654 +Node: Debugging Terms879463 +Node: Awk Debugging882038 +Node: Sample Debugging Session882944 +Node: Debugger Invocation883478 +Node: Finding The Bug884864 +Node: List of Debugger Commands891342 +Node: Breakpoint Control892675 +Node: Debugger Execution Control896369 +Node: Viewing And Changing Data899731 +Node: Execution Stack903105 +Node: Debugger Info904742 +Node: Miscellaneous Debugger Commands908813 +Node: Readline Support913875 +Node: Limitations914771 +Node: Debugging Summary916880 +Node: Arbitrary Precision Arithmetic918159 +Node: Computer Arithmetic919644 +Ref: table-numeric-ranges923410 +Ref: table-floating-point-ranges923903 +Ref: Computer Arithmetic-Footnote-1924561 +Node: Math Definitions924618 +Ref: table-ieee-formats927934 +Ref: Math Definitions-Footnote-1928537 +Node: MPFR features928642 +Node: FP Math Caution930360 +Ref: FP Math Caution-Footnote-1931432 +Node: Inexactness of computations931801 +Node: Inexact representation932761 +Node: Comparing FP Values934121 +Node: Errors accumulate935362 +Node: Getting Accuracy936795 +Node: Try To Round939505 +Node: Setting precision940404 +Ref: table-predefined-precision-strings941101 +Node: Setting the rounding mode942931 +Ref: table-gawk-rounding-modes943305 +Ref: Setting the rounding mode-Footnote-1947236 +Node: Arbitrary Precision Integers947415 +Ref: Arbitrary Precision Integers-Footnote-1950590 +Node: Checking for MPFR950739 +Node: POSIX Floating Point Problems952213 +Ref: POSIX Floating Point Problems-Footnote-1956498 +Node: Floating point summary956536 +Node: Dynamic Extensions958726 +Node: Extension Intro960279 +Node: Plugin License961545 +Node: Extension Mechanism Outline962342 +Ref: figure-load-extension962781 +Ref: figure-register-new-function964346 +Ref: figure-call-new-function965438 +Node: Extension API Description967500 +Node: Extension API Functions Introduction969142 +Node: General Data Types974682 +Ref: General Data Types-Footnote-1983043 +Node: Memory Allocation Functions983342 +Ref: Memory Allocation Functions-Footnote-1987552 +Node: Constructor Functions987651 +Node: Registration Functions991237 +Node: Extension Functions991922 +Node: Exit Callback Functions997137 +Node: Extension Version String998387 +Node: Input Parsers999050 +Node: Output Wrappers1011771 +Node: Two-way processors1016283 +Node: Printing Messages1018548 +Ref: Printing Messages-Footnote-11019719 +Node: Updating ERRNO1019872 +Node: Requesting Values1020611 +Ref: table-value-types-returned1021348 +Node: Accessing Parameters1022284 +Node: Symbol Table Access1023519 +Node: Symbol table by name1024031 +Node: Symbol table by cookie1025820 +Ref: Symbol table by cookie-Footnote-11030005 +Node: Cached values1030069 +Ref: Cached values-Footnote-11033605 +Node: Array Manipulation1033758 +Ref: Array Manipulation-Footnote-11034849 +Node: Array Data Types1034886 +Ref: Array Data Types-Footnote-11037544 +Node: Array Functions1037636 +Node: Flattening Arrays1042134 +Node: Creating Arrays1049110 +Node: Redirection API1053877 +Node: Extension API Variables1056710 +Node: Extension Versioning1057421 +Ref: gawk-api-version1057850 +Node: Extension GMP/MPFR Versioning1059581 +Node: Extension API Informational Variables1061209 +Node: Extension API Boilerplate1062282 +Node: Changes from API V11066256 +Node: Finding Extensions1067828 +Node: Extension Example1068387 +Node: Internal File Description1069185 +Node: Internal File Ops1073265 +Ref: Internal File Ops-Footnote-11084615 +Node: Using Internal File Ops1084755 +Ref: Using Internal File Ops-Footnote-11087138 +Node: Extension Samples1087412 +Node: Extension Sample File Functions1088941 +Node: Extension Sample Fnmatch1096590 +Node: Extension Sample Fork1098077 +Node: Extension Sample Inplace1099295 +Node: Extension Sample Ord1102512 +Node: Extension Sample Readdir1103348 +Ref: table-readdir-file-types1104237 +Node: Extension Sample Revout1105042 +Node: Extension Sample Rev2way1105631 +Node: Extension Sample Read write array1106371 +Node: Extension Sample Readfile1108313 +Node: Extension Sample Time1109408 +Node: Extension Sample API Tests1110756 +Node: gawkextlib1111248 +Node: Extension summary1114166 +Node: Extension Exercises1117868 +Node: Language History1119366 +Node: V7/SVR3.11121022 +Node: SVR41123174 +Node: POSIX1124608 +Node: BTL1125988 +Node: POSIX/GNU1126717 +Node: Feature History1132495 +Node: Common Extensions1148541 +Node: Ranges and Locales1149824 +Ref: Ranges and Locales-Footnote-11154440 +Ref: Ranges and Locales-Footnote-21154467 +Ref: Ranges and Locales-Footnote-31154702 +Node: Contributors1154923 +Node: History summary1160868 +Node: Installation1162248 +Node: Gawk Distribution1163192 +Node: Getting1163676 +Node: Extracting1164639 +Node: Distribution contents1166277 +Node: Unix Installation1172757 +Node: Quick Installation1173439 +Node: Shell Startup Files1175853 +Node: Additional Configuration Options1176942 +Node: Configuration Philosophy1179107 +Node: Non-Unix Installation1181476 +Node: PC Installation1181936 +Node: PC Binary Installation1182774 +Node: PC Compiling1183209 +Node: PC Using1184326 +Node: Cygwin1187879 +Node: MSYS1188978 +Node: VMS Installation1189479 +Node: VMS Compilation1190270 +Ref: VMS Compilation-Footnote-11191499 +Node: VMS Dynamic Extensions1191557 +Node: VMS Installation Details1193242 +Node: VMS Running1195495 +Node: VMS GNV1199774 +Node: VMS Old Gawk1200509 +Node: Bugs1200980 +Node: Bug address1201643 +Node: Usenet1204625 +Node: Maintainers1205629 +Node: Other Versions1206890 +Node: Installation summary1213804 +Node: Notes1215006 +Node: Compatibility Mode1215800 +Node: Additions1216582 +Node: Accessing The Source1217507 +Node: Adding Code1218944 +Node: New Ports1225163 +Node: Derived Files1229651 +Ref: Derived Files-Footnote-11235297 +Ref: Derived Files-Footnote-21235332 +Ref: Derived Files-Footnote-31235930 +Node: Future Extensions1236044 +Node: Implementation Limitations1236702 +Node: Extension Design1237885 +Node: Old Extension Problems1239029 +Ref: Old Extension Problems-Footnote-11240547 +Node: Extension New Mechanism Goals1240604 +Ref: Extension New Mechanism Goals-Footnote-11243968 +Node: Extension Other Design Decisions1244157 +Node: Extension Future Growth1246270 +Node: Notes summary1247106 +Node: Basic Concepts1248281 +Node: Basic High Level1248962 +Ref: figure-general-flow1249244 +Ref: figure-process-flow1249929 +Ref: Basic High Level-Footnote-11253230 +Node: Basic Data Typing1253415 +Node: Glossary1256743 +Node: Copying1288581 +Node: GNU Free Documentation License1326124 +Node: Index1351244 End Tag Table |