diff options
Diffstat (limited to 'doc/gawk.info')
| -rw-r--r-- | doc/gawk.info | 435 |
1 files changed, 217 insertions, 218 deletions
diff --git a/doc/gawk.info b/doc/gawk.info index a91a2c63..d624d96d 100644 --- a/doc/gawk.info +++ b/doc/gawk.info @@ -22342,10 +22342,9 @@ The commands for viewing and changing variables inside of 'gawk' are: can do anything that an 'awk' program would do: assign values to variables, call functions, and so on. - NOTE: Do to implementation constraintss, using 'eval' to call - a user-defined function that returns a value does not work, - generating an error message. We hope to one day remove this - constraint. + NOTE: You cannot use 'eval' to execute a statement containing + any of the following: 'exit', 'getline', 'next', 'nextfile', + or 'return'. 'eval' PARAM, ... AWK STATEMENTS @@ -33979,7 +33978,7 @@ Index * assert() user-defined function: Assert Function. (line 28) * assertions: Assert Function. (line 6) * assign values to variables, in debugger: Viewing And Changing Data. - (line 63) + (line 62) * assignment operators: Assignment Ops. (line 6) * assignment operators, evaluation order: Assignment Ops. (line 110) * assignment operators, lvalues/rvalues: Assignment Ops. (line 31) @@ -34572,11 +34571,11 @@ Index * debugger commands, o (option): Debugger Info. (line 57) * debugger commands, option: Debugger Info. (line 57) * debugger commands, p (print): Viewing And Changing Data. - (line 40) + (line 39) * debugger commands, print: Viewing And Changing Data. - (line 40) + (line 39) * debugger commands, printf: Viewing And Changing Data. - (line 58) + (line 57) * debugger commands, q (quit): Miscellaneous Debugger Commands. (line 100) * debugger commands, quit: Miscellaneous Debugger Commands. @@ -34590,7 +34589,7 @@ Index * debugger commands, s (step): Debugger Execution Control. (line 68) * debugger commands, set: Viewing And Changing Data. - (line 63) + (line 62) * debugger commands, si (stepi): Debugger Execution Control. (line 75) * debugger commands, silent: Debugger Execution Control. @@ -34606,16 +34605,16 @@ Index * debugger commands, u (until): Debugger Execution Control. (line 82) * debugger commands, undisplay: Viewing And Changing Data. - (line 84) + (line 83) * debugger commands, until: Debugger Execution Control. (line 82) * debugger commands, unwatch: Viewing And Changing Data. - (line 88) + (line 87) * debugger commands, up: Execution Stack. (line 36) * debugger commands, w (watch): Viewing And Changing Data. - (line 71) + (line 70) * debugger commands, watch: Viewing And Changing Data. - (line 71) + (line 70) * debugger commands, where (backtrace): Execution Stack. (line 13) * debugger, b command: Finding The Bug. (line 32) * debugger, backtrace command: Finding The Bug. (line 52) @@ -34665,7 +34664,7 @@ Index * delete debugger command: Breakpoint Control. (line 64) * delete statement: Delete. (line 6) * delete watchpoint: Viewing And Changing Data. - (line 88) + (line 87) * deleting elements in arrays: Delete. (line 6) * deleting entire arrays: Delete. (line 39) * Demaille, Akim: Acknowledgments. (line 60) @@ -35889,7 +35888,7 @@ Index * output, records: Output Separators. (line 20) * output, standard: Special FD. (line 6) * p debugger command (alias for print): Viewing And Changing Data. - (line 40) + (line 39) * package, definition of: Global Namespace. (line 18) * Papadopoulos, Panos: Contributors. (line 131) * parent process ID of gawk process: Auto-set. (line 251) @@ -36033,7 +36032,7 @@ Index * pretty printing <1>: Profiling. (line 222) * pretty-printing, profiling, difference with: Profiling. (line 229) * print debugger command: Viewing And Changing Data. - (line 40) + (line 39) * print statement: Printing. (line 16) * print statement, BEGIN/END patterns and: I/O And BEGIN/END. (line 15) * print statement, commas, omitting: Print Examples. (line 30) @@ -36044,9 +36043,9 @@ Index (line 17) * print statement, sprintf() function and: Round Function. (line 6) * print variables, in debugger: Viewing And Changing Data. - (line 40) + (line 39) * printf debugger command: Viewing And Changing Data. - (line 58) + (line 57) * printf statement: Printing. (line 16) * printf statement <1>: Printf. (line 6) * printf statement, columns, aligning: Print Examples. (line 69) @@ -36347,10 +36346,10 @@ Index * separators, subscript: User-modified. (line 149) * set breakpoint: Breakpoint Control. (line 11) * set debugger command: Viewing And Changing Data. - (line 63) + (line 62) * set directory of message catalogs: I18N Functions. (line 11) * set watchpoint: Viewing And Changing Data. - (line 71) + (line 70) * shadowing of variable values: Definition Syntax. (line 77) * shell quoting, rules for: Quoting. (line 6) * shells, piping commands into: Redirection. (line 136) @@ -36509,7 +36508,7 @@ Index * stepi debugger command: Debugger Execution Control. (line 75) * stop automatic display, in debugger: Viewing And Changing Data. - (line 84) + (line 83) * stream editors: Full Line Fields. (line 22) * stream editors <1>: Simple Sed. (line 6) * strftime: Time Functions. (line 50) @@ -36679,7 +36678,7 @@ Index (line 29) * underscore (_), translatable string: Programmer i18n. (line 69) * undisplay debugger command: Viewing And Changing Data. - (line 84) + (line 83) * undocumented features: Undocumented. (line 6) * Unicode: Ordinal Functions. (line 45) * Unicode <1>: Ranges and Locales. (line 61) @@ -36700,7 +36699,7 @@ Index * until debugger command: Debugger Execution Control. (line 82) * unwatch debugger command: Viewing And Changing Data. - (line 88) + (line 87) * up debugger command: Execution Stack. (line 36) * uppercase names, namespace for: Default Namespace. (line 10) * user database, reading: Passwd Functions. (line 6) @@ -36761,7 +36760,7 @@ Index * vertical bar (|), || operator <1>: Precedence. (line 88) * Vinschen, Corinna: Acknowledgments. (line 60) * w debugger command (alias for watch): Viewing And Changing Data. - (line 71) + (line 70) * w utility: Fixed width data. (line 17) * wait() extension function: Extension Sample Fork. (line 22) @@ -36773,7 +36772,7 @@ Index * Wallin, Anders: Contributors. (line 106) * warnings, issuing: Options. (line 210) * watch debugger command: Viewing And Changing Data. - (line 71) + (line 70) * watchpoint (debugger): Debugging Terms. (line 42) * wc utility: Wc Program. (line 6) * wc.awk program: Wc Program. (line 46) @@ -37214,198 +37213,198 @@ Node: List of Debugger Commands895922 Node: Breakpoint Control897255 Node: Debugger Execution Control900949 Node: Viewing And Changing Data904311 -Node: Execution Stack907921 -Node: Debugger Info909558 -Node: Miscellaneous Debugger Commands913629 -Node: Readline Support918691 -Node: Limitations919587 -Node: Debugging Summary921696 -Node: Namespaces922975 -Node: Global Namespace924054 -Node: Qualified Names925452 -Node: Default Namespace926451 -Node: Changing The Namespace927192 -Node: Naming Rules928806 -Node: Internal Name Management930654 -Node: Namespace Example931696 -Node: Namespace And Features934258 -Node: Namespace Summary935693 -Node: Arbitrary Precision Arithmetic937170 -Node: Computer Arithmetic938657 -Ref: table-numeric-ranges942423 -Ref: table-floating-point-ranges942916 -Ref: Computer Arithmetic-Footnote-1943574 -Node: Math Definitions943631 -Ref: table-ieee-formats946947 -Ref: Math Definitions-Footnote-1947550 -Node: MPFR features947655 -Node: FP Math Caution949373 -Ref: FP Math Caution-Footnote-1950445 -Node: Inexactness of computations950814 -Node: Inexact representation951774 -Node: Comparing FP Values953134 -Node: Errors accumulate954375 -Node: Getting Accuracy955808 -Node: Try To Round958518 -Node: Setting precision959417 -Ref: table-predefined-precision-strings960114 -Node: Setting the rounding mode961944 -Ref: table-gawk-rounding-modes962318 -Ref: Setting the rounding mode-Footnote-1966249 -Node: Arbitrary Precision Integers966428 -Ref: Arbitrary Precision Integers-Footnote-1969603 -Node: Checking for MPFR969752 -Node: POSIX Floating Point Problems971226 -Ref: POSIX Floating Point Problems-Footnote-1975511 -Node: Floating point summary975549 -Node: Dynamic Extensions977739 -Node: Extension Intro979292 -Node: Plugin License980558 -Node: Extension Mechanism Outline981355 -Ref: figure-load-extension981794 -Ref: figure-register-new-function983359 -Ref: figure-call-new-function984451 -Node: Extension API Description986513 -Node: Extension API Functions Introduction988155 -Ref: table-api-std-headers989991 -Node: General Data Types993856 -Ref: General Data Types-Footnote-11002217 -Node: Memory Allocation Functions1002516 -Ref: Memory Allocation Functions-Footnote-11006726 -Node: Constructor Functions1006825 -Node: Registration Functions1010411 -Node: Extension Functions1011096 -Node: Exit Callback Functions1016418 -Node: Extension Version String1017668 -Node: Input Parsers1018331 -Node: Output Wrappers1031052 -Node: Two-way processors1035564 -Node: Printing Messages1037829 -Ref: Printing Messages-Footnote-11039000 -Node: Updating ERRNO1039153 -Node: Requesting Values1039892 -Ref: table-value-types-returned1040629 -Node: Accessing Parameters1041565 -Node: Symbol Table Access1042800 -Node: Symbol table by name1043312 -Ref: Symbol table by name-Footnote-11046336 -Node: Symbol table by cookie1046464 -Ref: Symbol table by cookie-Footnote-11050649 -Node: Cached values1050713 -Ref: Cached values-Footnote-11054249 -Node: Array Manipulation1054402 -Ref: Array Manipulation-Footnote-11055493 -Node: Array Data Types1055530 -Ref: Array Data Types-Footnote-11058188 -Node: Array Functions1058280 -Node: Flattening Arrays1062778 -Node: Creating Arrays1069754 -Node: Redirection API1074521 -Node: Extension API Variables1077354 -Node: Extension Versioning1078065 -Ref: gawk-api-version1078494 -Node: Extension GMP/MPFR Versioning1080225 -Node: Extension API Informational Variables1081853 -Node: Extension API Boilerplate1082926 -Node: Changes from API V11086900 -Node: Finding Extensions1088472 -Node: Extension Example1089031 -Node: Internal File Description1089829 -Node: Internal File Ops1093909 -Ref: Internal File Ops-Footnote-11105259 -Node: Using Internal File Ops1105399 -Ref: Using Internal File Ops-Footnote-11107782 -Node: Extension Samples1108056 -Node: Extension Sample File Functions1109585 -Node: Extension Sample Fnmatch1117234 -Node: Extension Sample Fork1118721 -Node: Extension Sample Inplace1119939 -Node: Extension Sample Ord1123243 -Node: Extension Sample Readdir1124079 -Ref: table-readdir-file-types1124968 -Node: Extension Sample Revout1125773 -Node: Extension Sample Rev2way1126362 -Node: Extension Sample Read write array1127102 -Node: Extension Sample Readfile1129044 -Node: Extension Sample Time1130139 -Node: Extension Sample API Tests1131487 -Node: gawkextlib1131979 -Node: Extension summary1134897 -Node: Extension Exercises1138599 -Node: Language History1139841 -Node: V7/SVR3.11141497 -Node: SVR41143649 -Node: POSIX1145083 -Node: BTL1146463 -Node: POSIX/GNU1147192 -Node: Feature History1152970 -Node: Common Extensions1169016 -Node: Ranges and Locales1170299 -Ref: Ranges and Locales-Footnote-11174915 -Ref: Ranges and Locales-Footnote-21174942 -Ref: Ranges and Locales-Footnote-31175177 -Node: Contributors1175398 -Node: History summary1181343 -Node: Installation1182723 -Node: Gawk Distribution1183667 -Node: Getting1184151 -Node: Extracting1185114 -Node: Distribution contents1186752 -Node: Unix Installation1193232 -Node: Quick Installation1193914 -Node: Shell Startup Files1196328 -Node: Additional Configuration Options1197417 -Node: Configuration Philosophy1199582 -Node: Non-Unix Installation1201951 -Node: PC Installation1202411 -Node: PC Binary Installation1203249 -Node: PC Compiling1203684 -Node: PC Using1204801 -Node: Cygwin1208354 -Node: MSYS1209453 -Node: VMS Installation1209954 -Node: VMS Compilation1210745 -Ref: VMS Compilation-Footnote-11211974 -Node: VMS Dynamic Extensions1212032 -Node: VMS Installation Details1213717 -Node: VMS Running1215970 -Node: VMS GNV1220249 -Node: VMS Old Gawk1220984 -Node: Bugs1221455 -Node: Bug address1222118 -Node: Usenet1225100 -Node: Maintainers1226104 -Node: Other Versions1227365 -Node: Installation summary1234279 -Node: Notes1235481 -Node: Compatibility Mode1236275 -Node: Additions1237057 -Node: Accessing The Source1237982 -Node: Adding Code1239419 -Node: New Ports1245638 -Node: Derived Files1250126 -Ref: Derived Files-Footnote-11255772 -Ref: Derived Files-Footnote-21255807 -Ref: Derived Files-Footnote-31256405 -Node: Future Extensions1256519 -Node: Implementation Limitations1257177 -Node: Extension Design1258360 -Node: Old Extension Problems1259504 -Ref: Old Extension Problems-Footnote-11261022 -Node: Extension New Mechanism Goals1261079 -Ref: Extension New Mechanism Goals-Footnote-11264443 -Node: Extension Other Design Decisions1264632 -Node: Extension Future Growth1266745 -Node: Notes summary1267581 -Node: Basic Concepts1268756 -Node: Basic High Level1269437 -Ref: figure-general-flow1269719 -Ref: figure-process-flow1270404 -Ref: Basic High Level-Footnote-11273705 -Node: Basic Data Typing1273890 -Node: Glossary1277218 -Node: Copying1309056 -Node: GNU Free Documentation License1346599 -Node: Index1371719 +Node: Execution Stack907852 +Node: Debugger Info909489 +Node: Miscellaneous Debugger Commands913560 +Node: Readline Support918622 +Node: Limitations919518 +Node: Debugging Summary921627 +Node: Namespaces922906 +Node: Global Namespace923985 +Node: Qualified Names925383 +Node: Default Namespace926382 +Node: Changing The Namespace927123 +Node: Naming Rules928737 +Node: Internal Name Management930585 +Node: Namespace Example931627 +Node: Namespace And Features934189 +Node: Namespace Summary935624 +Node: Arbitrary Precision Arithmetic937101 +Node: Computer Arithmetic938588 +Ref: table-numeric-ranges942354 +Ref: table-floating-point-ranges942847 +Ref: Computer Arithmetic-Footnote-1943505 +Node: Math Definitions943562 +Ref: table-ieee-formats946878 +Ref: Math Definitions-Footnote-1947481 +Node: MPFR features947586 +Node: FP Math Caution949304 +Ref: FP Math Caution-Footnote-1950376 +Node: Inexactness of computations950745 +Node: Inexact representation951705 +Node: Comparing FP Values953065 +Node: Errors accumulate954306 +Node: Getting Accuracy955739 +Node: Try To Round958449 +Node: Setting precision959348 +Ref: table-predefined-precision-strings960045 +Node: Setting the rounding mode961875 +Ref: table-gawk-rounding-modes962249 +Ref: Setting the rounding mode-Footnote-1966180 +Node: Arbitrary Precision Integers966359 +Ref: Arbitrary Precision Integers-Footnote-1969534 +Node: Checking for MPFR969683 +Node: POSIX Floating Point Problems971157 +Ref: POSIX Floating Point Problems-Footnote-1975442 +Node: Floating point summary975480 +Node: Dynamic Extensions977670 +Node: Extension Intro979223 +Node: Plugin License980489 +Node: Extension Mechanism Outline981286 +Ref: figure-load-extension981725 +Ref: figure-register-new-function983290 +Ref: figure-call-new-function984382 +Node: Extension API Description986444 +Node: Extension API Functions Introduction988086 +Ref: table-api-std-headers989922 +Node: General Data Types993787 +Ref: General Data Types-Footnote-11002148 +Node: Memory Allocation Functions1002447 +Ref: Memory Allocation Functions-Footnote-11006657 +Node: Constructor Functions1006756 +Node: Registration Functions1010342 +Node: Extension Functions1011027 +Node: Exit Callback Functions1016349 +Node: Extension Version String1017599 +Node: Input Parsers1018262 +Node: Output Wrappers1030983 +Node: Two-way processors1035495 +Node: Printing Messages1037760 +Ref: Printing Messages-Footnote-11038931 +Node: Updating ERRNO1039084 +Node: Requesting Values1039823 +Ref: table-value-types-returned1040560 +Node: Accessing Parameters1041496 +Node: Symbol Table Access1042731 +Node: Symbol table by name1043243 +Ref: Symbol table by name-Footnote-11046267 +Node: Symbol table by cookie1046395 +Ref: Symbol table by cookie-Footnote-11050580 +Node: Cached values1050644 +Ref: Cached values-Footnote-11054180 +Node: Array Manipulation1054333 +Ref: Array Manipulation-Footnote-11055424 +Node: Array Data Types1055461 +Ref: Array Data Types-Footnote-11058119 +Node: Array Functions1058211 +Node: Flattening Arrays1062709 +Node: Creating Arrays1069685 +Node: Redirection API1074452 +Node: Extension API Variables1077285 +Node: Extension Versioning1077996 +Ref: gawk-api-version1078425 +Node: Extension GMP/MPFR Versioning1080156 +Node: Extension API Informational Variables1081784 +Node: Extension API Boilerplate1082857 +Node: Changes from API V11086831 +Node: Finding Extensions1088403 +Node: Extension Example1088962 +Node: Internal File Description1089760 +Node: Internal File Ops1093840 +Ref: Internal File Ops-Footnote-11105190 +Node: Using Internal File Ops1105330 +Ref: Using Internal File Ops-Footnote-11107713 +Node: Extension Samples1107987 +Node: Extension Sample File Functions1109516 +Node: Extension Sample Fnmatch1117165 +Node: Extension Sample Fork1118652 +Node: Extension Sample Inplace1119870 +Node: Extension Sample Ord1123174 +Node: Extension Sample Readdir1124010 +Ref: table-readdir-file-types1124899 +Node: Extension Sample Revout1125704 +Node: Extension Sample Rev2way1126293 +Node: Extension Sample Read write array1127033 +Node: Extension Sample Readfile1128975 +Node: Extension Sample Time1130070 +Node: Extension Sample API Tests1131418 +Node: gawkextlib1131910 +Node: Extension summary1134828 +Node: Extension Exercises1138530 +Node: Language History1139772 +Node: V7/SVR3.11141428 +Node: SVR41143580 +Node: POSIX1145014 +Node: BTL1146394 +Node: POSIX/GNU1147123 +Node: Feature History1152901 +Node: Common Extensions1168947 +Node: Ranges and Locales1170230 +Ref: Ranges and Locales-Footnote-11174846 +Ref: Ranges and Locales-Footnote-21174873 +Ref: Ranges and Locales-Footnote-31175108 +Node: Contributors1175329 +Node: History summary1181274 +Node: Installation1182654 +Node: Gawk Distribution1183598 +Node: Getting1184082 +Node: Extracting1185045 +Node: Distribution contents1186683 +Node: Unix Installation1193163 +Node: Quick Installation1193845 +Node: Shell Startup Files1196259 +Node: Additional Configuration Options1197348 +Node: Configuration Philosophy1199513 +Node: Non-Unix Installation1201882 +Node: PC Installation1202342 +Node: PC Binary Installation1203180 +Node: PC Compiling1203615 +Node: PC Using1204732 +Node: Cygwin1208285 +Node: MSYS1209384 +Node: VMS Installation1209885 +Node: VMS Compilation1210676 +Ref: VMS Compilation-Footnote-11211905 +Node: VMS Dynamic Extensions1211963 +Node: VMS Installation Details1213648 +Node: VMS Running1215901 +Node: VMS GNV1220180 +Node: VMS Old Gawk1220915 +Node: Bugs1221386 +Node: Bug address1222049 +Node: Usenet1225031 +Node: Maintainers1226035 +Node: Other Versions1227296 +Node: Installation summary1234210 +Node: Notes1235412 +Node: Compatibility Mode1236206 +Node: Additions1236988 +Node: Accessing The Source1237913 +Node: Adding Code1239350 +Node: New Ports1245569 +Node: Derived Files1250057 +Ref: Derived Files-Footnote-11255703 +Ref: Derived Files-Footnote-21255738 +Ref: Derived Files-Footnote-31256336 +Node: Future Extensions1256450 +Node: Implementation Limitations1257108 +Node: Extension Design1258291 +Node: Old Extension Problems1259435 +Ref: Old Extension Problems-Footnote-11260953 +Node: Extension New Mechanism Goals1261010 +Ref: Extension New Mechanism Goals-Footnote-11264374 +Node: Extension Other Design Decisions1264563 +Node: Extension Future Growth1266676 +Node: Notes summary1267512 +Node: Basic Concepts1268687 +Node: Basic High Level1269368 +Ref: figure-general-flow1269650 +Ref: figure-process-flow1270335 +Ref: Basic High Level-Footnote-11273636 +Node: Basic Data Typing1273821 +Node: Glossary1277149 +Node: Copying1308987 +Node: GNU Free Documentation License1346530 +Node: Index1371650 End Tag Table |