diff options
Diffstat (limited to 'doc')
| -rw-r--r-- | doc/gawk.info | 650 | ||||
| -rw-r--r-- | doc/gawk.texi | 20 | ||||
| -rw-r--r-- | doc/gawktexi.in | 20 |
3 files changed, 348 insertions, 342 deletions
diff --git a/doc/gawk.info b/doc/gawk.info index 3820a05a..0a56ebd6 100644 --- a/doc/gawk.info +++ b/doc/gawk.info @@ -12805,17 +12805,19 @@ parameters are enclosed in square brackets ([ ]): On POSIX systems, a command's exit status is a 16-bit number. The exit value passed to the C 'exit()' function is held in the high-order eight bits. The low-order bits indicate if the process - was killed by a signal (bit 7) and if so, the signal number (bits - 0-6). + was killed by a signal (bit 7) and if so, the guilty signal number + (bits 0-6). Traditionally, 'awk''s 'system()' function has simply returned the - exit status value and ignored death-by-signal. POSIX states that - 'awk''s 'system()' should return the full 16-bit value. + exit status value divided by 256. In the normal case this gives + the exit status but in the case of death-by-signal it yields a + fractional floating-point value. POSIX states that 'awk''s + 'system()' should return the full 16-bit value. - 'gawk' steers a middle ground. With '--posix', it returns the full - 16-bit value. By default, it returns just the exit status. The - '--traditional' option forces 'gawk' to ignore death-by-signal, in - which case 'system()' returns zero. + 'gawk' steers a middle ground. By default, it returns just the + exit status. The '--traditional' option causes 'gawk' to divide + the return vaue by 356, just as Brian Kernighan's 'awk' does. With + '--posix', it returns the full 16-bit value. If the process was killed by a signal, 'gawk''s 'system()' returns 256 + SIG, where SIG is the number of the signal that killed the @@ -32218,11 +32220,11 @@ Index * Buening, Andreas: Acknowledgments. (line 60) * Buening, Andreas <1>: Contributors. (line 93) * Buening, Andreas <2>: Bugs. (line 73) -* buffering, input/output: I/O Functions. (line 162) +* buffering, input/output: I/O Functions. (line 164) * buffering, input/output <1>: Two-way I/O. (line 53) * buffering, interactive vs. noninteractive: I/O Functions. (line 76) * buffers, flushing: I/O Functions. (line 32) -* buffers, flushing <1>: I/O Functions. (line 162) +* buffers, flushing <1>: I/O Functions. (line 164) * buffers, operators for: GNU Regexp Operators. (line 51) * bug reports, email address, bug-gawk@gnu.org: Bugs. (line 30) @@ -33746,7 +33748,7 @@ Index * output redirection: Redirection. (line 6) * output wrapper: Output Wrappers. (line 6) * output, buffering: I/O Functions. (line 32) -* output, buffering <1>: I/O Functions. (line 162) +* output, buffering <1>: I/O Functions. (line 164) * output, duplicating into files: Tee Program. (line 6) * output, files, closing: Close Files And Pipes. (line 6) @@ -34242,7 +34244,7 @@ Index (line 14) * sidebar, Changing NR and FNR: Auto-set. (line 311) * sidebar, Controlling Output Buffering with system(): I/O Functions. - (line 160) + (line 162) * sidebar, Escape Sequences for Metacharacters: Escape Sequences. (line 135) * sidebar, FS and IGNORECASE: Field Splitting Summary. @@ -34897,317 +34899,317 @@ Ref: table-posix-sub537317 Ref: table-gensub-escapes538858 Ref: Gory Details-Footnote-1539681 Node: I/O Functions539832 -Ref: I/O Functions-Footnote-1548200 -Node: Time Functions548348 -Ref: Time Functions-Footnote-1558853 -Ref: Time Functions-Footnote-2558921 -Ref: Time Functions-Footnote-3559079 -Ref: Time Functions-Footnote-4559190 -Ref: Time Functions-Footnote-5559302 -Ref: Time Functions-Footnote-6559529 -Node: Bitwise Functions559795 -Ref: table-bitwise-ops560389 -Ref: Bitwise Functions-Footnote-1564727 -Node: Type Functions564900 -Node: I18N Functions566056 -Node: User-defined567707 -Node: Definition Syntax568512 -Ref: Definition Syntax-Footnote-1574199 -Node: Function Example574270 -Ref: Function Example-Footnote-1577192 -Node: Function Caveats577214 -Node: Calling A Function577732 -Node: Variable Scope578690 -Node: Pass By Value/Reference581684 -Node: Return Statement585183 -Node: Dynamic Typing588162 -Node: Indirect Calls589092 -Ref: Indirect Calls-Footnote-1599343 -Node: Functions Summary599471 -Node: Library Functions602176 -Ref: Library Functions-Footnote-1605783 -Ref: Library Functions-Footnote-2605926 -Node: Library Names606097 -Ref: Library Names-Footnote-1609557 -Ref: Library Names-Footnote-2609780 -Node: General Functions609866 -Node: Strtonum Function610969 -Node: Assert Function613991 -Node: Round Function617317 -Node: Cliff Random Function618858 -Node: Ordinal Functions619874 -Ref: Ordinal Functions-Footnote-1622937 -Ref: Ordinal Functions-Footnote-2623189 -Node: Join Function623399 -Ref: Join Function-Footnote-1625169 -Node: Getlocaltime Function625369 -Node: Readfile Function629111 -Node: Shell Quoting631083 -Node: Data File Management632484 -Node: Filetrans Function633116 -Node: Rewind Function637212 -Node: File Checking639117 -Ref: File Checking-Footnote-1640451 -Node: Empty Files640652 -Node: Ignoring Assigns642631 -Node: Getopt Function644181 -Ref: Getopt Function-Footnote-1655650 -Node: Passwd Functions655850 -Ref: Passwd Functions-Footnote-1664689 -Node: Group Functions664777 -Ref: Group Functions-Footnote-1672674 -Node: Walking Arrays672881 -Node: Library Functions Summary675889 -Node: Library Exercises677295 -Node: Sample Programs677760 -Node: Running Examples678530 -Node: Clones679258 -Node: Cut Program680482 -Node: Egrep Program690411 -Ref: Egrep Program-Footnote-1697923 -Node: Id Program698033 -Node: Split Program701713 -Ref: Split Program-Footnote-1705172 -Node: Tee Program705301 -Node: Uniq Program708091 -Node: Wc Program715517 -Ref: Wc Program-Footnote-1719772 -Node: Miscellaneous Programs719866 -Node: Dupword Program721079 -Node: Alarm Program723109 -Node: Translate Program727964 -Ref: Translate Program-Footnote-1732529 -Node: Labels Program732799 -Ref: Labels Program-Footnote-1736150 -Node: Word Sorting736234 -Node: History Sorting740306 -Node: Extract Program742141 -Node: Simple Sed749670 -Node: Igawk Program752744 -Ref: Igawk Program-Footnote-1767075 -Ref: Igawk Program-Footnote-2767277 -Ref: Igawk Program-Footnote-3767399 -Node: Anagram Program767514 -Node: Signature Program770576 -Node: Programs Summary771823 -Node: Programs Exercises773037 -Ref: Programs Exercises-Footnote-1777166 -Node: Advanced Features777257 -Node: Nondecimal Data779247 -Node: Array Sorting780838 -Node: Controlling Array Traversal781538 -Ref: Controlling Array Traversal-Footnote-1789905 -Node: Array Sorting Functions790023 -Ref: Array Sorting Functions-Footnote-1795114 -Node: Two-way I/O795310 -Ref: Two-way I/O-Footnote-1801130 -Ref: Two-way I/O-Footnote-2801317 -Node: TCP/IP Networking801399 -Node: Profiling804517 -Node: Advanced Features Summary812056 -Node: Internationalization813992 -Node: I18N and L10N815472 -Node: Explaining gettext816159 -Ref: Explaining gettext-Footnote-1821182 -Ref: Explaining gettext-Footnote-2821367 -Node: Programmer i18n821532 -Ref: Programmer i18n-Footnote-1826387 -Node: Translator i18n826436 -Node: String Extraction827230 -Ref: String Extraction-Footnote-1828362 -Node: Printf Ordering828448 -Ref: Printf Ordering-Footnote-1831234 -Node: I18N Portability831298 -Ref: I18N Portability-Footnote-1833754 -Node: I18N Example833817 -Ref: I18N Example-Footnote-1836623 -Node: Gawk I18N836696 -Node: I18N Summary837341 -Node: Debugger838682 -Node: Debugging839704 -Node: Debugging Concepts840145 -Node: Debugging Terms841954 -Node: Awk Debugging844529 -Node: Sample Debugging Session845435 -Node: Debugger Invocation845969 -Node: Finding The Bug847355 -Node: List of Debugger Commands853833 -Node: Breakpoint Control855166 -Node: Debugger Execution Control858860 -Node: Viewing And Changing Data862222 -Node: Execution Stack865596 -Node: Debugger Info867233 -Node: Miscellaneous Debugger Commands871304 -Node: Readline Support876392 -Node: Limitations877288 -Node: Debugging Summary879397 -Node: Arbitrary Precision Arithmetic880570 -Node: Computer Arithmetic881986 -Ref: table-numeric-ranges885577 -Ref: Computer Arithmetic-Footnote-1886299 -Node: Math Definitions886356 -Ref: table-ieee-formats889670 -Ref: Math Definitions-Footnote-1890273 -Node: MPFR features890378 -Node: FP Math Caution892095 -Ref: FP Math Caution-Footnote-1893167 -Node: Inexactness of computations893536 -Node: Inexact representation894496 -Node: Comparing FP Values895856 -Node: Errors accumulate896938 -Node: Getting Accuracy898371 -Node: Try To Round901081 -Node: Setting precision901980 -Ref: table-predefined-precision-strings902677 -Node: Setting the rounding mode904507 -Ref: table-gawk-rounding-modes904881 -Ref: Setting the rounding mode-Footnote-1908289 -Node: Arbitrary Precision Integers908468 -Ref: Arbitrary Precision Integers-Footnote-1911452 -Node: POSIX Floating Point Problems911601 -Ref: POSIX Floating Point Problems-Footnote-1915483 -Node: Floating point summary915521 -Node: Dynamic Extensions917711 -Node: Extension Intro919264 -Node: Plugin License920530 -Node: Extension Mechanism Outline921327 -Ref: figure-load-extension921766 -Ref: figure-register-new-function923331 -Ref: figure-call-new-function924423 -Node: Extension API Description926485 -Node: Extension API Functions Introduction927933 -Node: General Data Types932745 -Ref: General Data Types-Footnote-1938700 -Node: Memory Allocation Functions938999 -Ref: Memory Allocation Functions-Footnote-1941844 -Node: Constructor Functions941943 -Node: Registration Functions943688 -Node: Extension Functions944373 -Node: Exit Callback Functions946672 -Node: Extension Version String947922 -Node: Input Parsers948585 -Node: Output Wrappers958470 -Node: Two-way processors962982 -Node: Printing Messages965246 -Ref: Printing Messages-Footnote-1966320 -Node: Updating ERRNO966473 -Node: Requesting Values967212 -Ref: table-value-types-returned967949 -Node: Accessing Parameters968832 -Node: Symbol Table Access970067 -Node: Symbol table by name970579 -Node: Symbol table by cookie972600 -Ref: Symbol table by cookie-Footnote-1976749 -Node: Cached values976813 -Ref: Cached values-Footnote-1980314 -Node: Array Manipulation980405 -Ref: Array Manipulation-Footnote-1981504 -Node: Array Data Types981541 -Ref: Array Data Types-Footnote-1984199 -Node: Array Functions984291 -Node: Flattening Arrays988149 -Node: Creating Arrays995057 -Node: Extension API Variables999828 -Node: Extension Versioning1000464 -Node: Extension API Informational Variables1002355 -Node: Extension API Boilerplate1003419 -Node: Finding Extensions1007233 -Node: Extension Example1007792 -Node: Internal File Description1008590 -Node: Internal File Ops1012670 -Ref: Internal File Ops-Footnote-11024432 -Node: Using Internal File Ops1024572 -Ref: Using Internal File Ops-Footnote-11026955 -Node: Extension Samples1027229 -Node: Extension Sample File Functions1028758 -Node: Extension Sample Fnmatch1036407 -Node: Extension Sample Fork1037894 -Node: Extension Sample Inplace1039112 -Node: Extension Sample Ord1042322 -Node: Extension Sample Readdir1043158 -Ref: table-readdir-file-types1044047 -Node: Extension Sample Revout1044852 -Node: Extension Sample Rev2way1045441 -Node: Extension Sample Read write array1046181 -Node: Extension Sample Readfile1048123 -Node: Extension Sample Time1049218 -Node: Extension Sample API Tests1050566 -Node: gawkextlib1051058 -Node: Extension summary1053482 -Node: Extension Exercises1057174 -Node: Language History1058671 -Node: V7/SVR3.11060327 -Node: SVR41062479 -Node: POSIX1063913 -Node: BTL1065292 -Node: POSIX/GNU1066021 -Node: Feature History1071542 -Node: Common Extensions1084871 -Node: Ranges and Locales1086154 -Ref: Ranges and Locales-Footnote-11090770 -Ref: Ranges and Locales-Footnote-21090797 -Ref: Ranges and Locales-Footnote-31091032 -Node: Contributors1091253 -Node: History summary1096822 -Node: Installation1098202 -Node: Gawk Distribution1099146 -Node: Getting1099630 -Node: Extracting1100591 -Node: Distribution contents1102229 -Node: Unix Installation1107980 -Node: Quick Installation1108596 -Node: Additional Configuration Options1111023 -Node: Configuration Philosophy1112827 -Node: Non-Unix Installation1115196 -Node: PC Installation1115654 -Node: PC Binary Installation1116974 -Node: PC Compiling1118826 -Ref: PC Compiling-Footnote-11121850 -Node: PC Testing1121959 -Node: PC Using1123139 -Node: Cygwin1127253 -Node: MSYS1128023 -Node: VMS Installation1128524 -Node: VMS Compilation1129315 -Ref: VMS Compilation-Footnote-11130544 -Node: VMS Dynamic Extensions1130602 -Node: VMS Installation Details1132287 -Node: VMS Running1134540 -Node: VMS GNV1138819 -Node: VMS Old Gawk1139554 -Node: Bugs1140025 -Node: Other Versions1144222 -Node: Installation summary1150806 -Node: Notes1151864 -Node: Compatibility Mode1152729 -Node: Additions1153511 -Node: Accessing The Source1154436 -Node: Adding Code1155871 -Node: New Ports1162090 -Node: Derived Files1166578 -Ref: Derived Files-Footnote-11172063 -Ref: Derived Files-Footnote-21172098 -Ref: Derived Files-Footnote-31172696 -Node: Future Extensions1172810 -Node: Implementation Limitations1173468 -Node: Extension Design1174651 -Node: Old Extension Problems1175805 -Ref: Old Extension Problems-Footnote-11177323 -Node: Extension New Mechanism Goals1177380 -Ref: Extension New Mechanism Goals-Footnote-11180744 -Node: Extension Other Design Decisions1180933 -Node: Extension Future Growth1183046 -Node: Old Extension Mechanism1183882 -Node: Notes summary1185645 -Node: Basic Concepts1186827 -Node: Basic High Level1187508 -Ref: figure-general-flow1187790 -Ref: figure-process-flow1188475 -Ref: Basic High Level-Footnote-11191776 -Node: Basic Data Typing1191961 -Node: Glossary1195289 -Node: Copying1227235 -Node: GNU Free Documentation License1264774 -Node: Index1289892 +Ref: I/O Functions-Footnote-1548337 +Node: Time Functions548485 +Ref: Time Functions-Footnote-1558990 +Ref: Time Functions-Footnote-2559058 +Ref: Time Functions-Footnote-3559216 +Ref: Time Functions-Footnote-4559327 +Ref: Time Functions-Footnote-5559439 +Ref: Time Functions-Footnote-6559666 +Node: Bitwise Functions559932 +Ref: table-bitwise-ops560526 +Ref: Bitwise Functions-Footnote-1564864 +Node: Type Functions565037 +Node: I18N Functions566193 +Node: User-defined567844 +Node: Definition Syntax568649 +Ref: Definition Syntax-Footnote-1574336 +Node: Function Example574407 +Ref: Function Example-Footnote-1577329 +Node: Function Caveats577351 +Node: Calling A Function577869 +Node: Variable Scope578827 +Node: Pass By Value/Reference581821 +Node: Return Statement585320 +Node: Dynamic Typing588299 +Node: Indirect Calls589229 +Ref: Indirect Calls-Footnote-1599480 +Node: Functions Summary599608 +Node: Library Functions602313 +Ref: Library Functions-Footnote-1605920 +Ref: Library Functions-Footnote-2606063 +Node: Library Names606234 +Ref: Library Names-Footnote-1609694 +Ref: Library Names-Footnote-2609917 +Node: General Functions610003 +Node: Strtonum Function611106 +Node: Assert Function614128 +Node: Round Function617454 +Node: Cliff Random Function618995 +Node: Ordinal Functions620011 +Ref: Ordinal Functions-Footnote-1623074 +Ref: Ordinal Functions-Footnote-2623326 +Node: Join Function623536 +Ref: Join Function-Footnote-1625306 +Node: Getlocaltime Function625506 +Node: Readfile Function629248 +Node: Shell Quoting631220 +Node: Data File Management632621 +Node: Filetrans Function633253 +Node: Rewind Function637349 +Node: File Checking639254 +Ref: File Checking-Footnote-1640588 +Node: Empty Files640789 +Node: Ignoring Assigns642768 +Node: Getopt Function644318 +Ref: Getopt Function-Footnote-1655787 +Node: Passwd Functions655987 +Ref: Passwd Functions-Footnote-1664826 +Node: Group Functions664914 +Ref: Group Functions-Footnote-1672811 +Node: Walking Arrays673018 +Node: Library Functions Summary676026 +Node: Library Exercises677432 +Node: Sample Programs677897 +Node: Running Examples678667 +Node: Clones679395 +Node: Cut Program680619 +Node: Egrep Program690548 +Ref: Egrep Program-Footnote-1698060 +Node: Id Program698170 +Node: Split Program701850 +Ref: Split Program-Footnote-1705309 +Node: Tee Program705438 +Node: Uniq Program708228 +Node: Wc Program715654 +Ref: Wc Program-Footnote-1719909 +Node: Miscellaneous Programs720003 +Node: Dupword Program721216 +Node: Alarm Program723246 +Node: Translate Program728101 +Ref: Translate Program-Footnote-1732666 +Node: Labels Program732936 +Ref: Labels Program-Footnote-1736287 +Node: Word Sorting736371 +Node: History Sorting740443 +Node: Extract Program742278 +Node: Simple Sed749807 +Node: Igawk Program752881 +Ref: Igawk Program-Footnote-1767212 +Ref: Igawk Program-Footnote-2767414 +Ref: Igawk Program-Footnote-3767536 +Node: Anagram Program767651 +Node: Signature Program770713 +Node: Programs Summary771960 +Node: Programs Exercises773174 +Ref: Programs Exercises-Footnote-1777303 +Node: Advanced Features777394 +Node: Nondecimal Data779384 +Node: Array Sorting780975 +Node: Controlling Array Traversal781675 +Ref: Controlling Array Traversal-Footnote-1790042 +Node: Array Sorting Functions790160 +Ref: Array Sorting Functions-Footnote-1795251 +Node: Two-way I/O795447 +Ref: Two-way I/O-Footnote-1801267 +Ref: Two-way I/O-Footnote-2801454 +Node: TCP/IP Networking801536 +Node: Profiling804654 +Node: Advanced Features Summary812193 +Node: Internationalization814129 +Node: I18N and L10N815609 +Node: Explaining gettext816296 +Ref: Explaining gettext-Footnote-1821319 +Ref: Explaining gettext-Footnote-2821504 +Node: Programmer i18n821669 +Ref: Programmer i18n-Footnote-1826524 +Node: Translator i18n826573 +Node: String Extraction827367 +Ref: String Extraction-Footnote-1828499 +Node: Printf Ordering828585 +Ref: Printf Ordering-Footnote-1831371 +Node: I18N Portability831435 +Ref: I18N Portability-Footnote-1833891 +Node: I18N Example833954 +Ref: I18N Example-Footnote-1836760 +Node: Gawk I18N836833 +Node: I18N Summary837478 +Node: Debugger838819 +Node: Debugging839841 +Node: Debugging Concepts840282 +Node: Debugging Terms842091 +Node: Awk Debugging844666 +Node: Sample Debugging Session845572 +Node: Debugger Invocation846106 +Node: Finding The Bug847492 +Node: List of Debugger Commands853970 +Node: Breakpoint Control855303 +Node: Debugger Execution Control858997 +Node: Viewing And Changing Data862359 +Node: Execution Stack865733 +Node: Debugger Info867370 +Node: Miscellaneous Debugger Commands871441 +Node: Readline Support876529 +Node: Limitations877425 +Node: Debugging Summary879534 +Node: Arbitrary Precision Arithmetic880707 +Node: Computer Arithmetic882123 +Ref: table-numeric-ranges885714 +Ref: Computer Arithmetic-Footnote-1886436 +Node: Math Definitions886493 +Ref: table-ieee-formats889807 +Ref: Math Definitions-Footnote-1890410 +Node: MPFR features890515 +Node: FP Math Caution892232 +Ref: FP Math Caution-Footnote-1893304 +Node: Inexactness of computations893673 +Node: Inexact representation894633 +Node: Comparing FP Values895993 +Node: Errors accumulate897075 +Node: Getting Accuracy898508 +Node: Try To Round901218 +Node: Setting precision902117 +Ref: table-predefined-precision-strings902814 +Node: Setting the rounding mode904644 +Ref: table-gawk-rounding-modes905018 +Ref: Setting the rounding mode-Footnote-1908426 +Node: Arbitrary Precision Integers908605 +Ref: Arbitrary Precision Integers-Footnote-1911589 +Node: POSIX Floating Point Problems911738 +Ref: POSIX Floating Point Problems-Footnote-1915620 +Node: Floating point summary915658 +Node: Dynamic Extensions917848 +Node: Extension Intro919401 +Node: Plugin License920667 +Node: Extension Mechanism Outline921464 +Ref: figure-load-extension921903 +Ref: figure-register-new-function923468 +Ref: figure-call-new-function924560 +Node: Extension API Description926622 +Node: Extension API Functions Introduction928070 +Node: General Data Types932882 +Ref: General Data Types-Footnote-1938837 +Node: Memory Allocation Functions939136 +Ref: Memory Allocation Functions-Footnote-1941981 +Node: Constructor Functions942080 +Node: Registration Functions943825 +Node: Extension Functions944510 +Node: Exit Callback Functions946809 +Node: Extension Version String948059 +Node: Input Parsers948722 +Node: Output Wrappers958607 +Node: Two-way processors963119 +Node: Printing Messages965383 +Ref: Printing Messages-Footnote-1966457 +Node: Updating ERRNO966610 +Node: Requesting Values967349 +Ref: table-value-types-returned968086 +Node: Accessing Parameters968969 +Node: Symbol Table Access970204 +Node: Symbol table by name970716 +Node: Symbol table by cookie972737 +Ref: Symbol table by cookie-Footnote-1976886 +Node: Cached values976950 +Ref: Cached values-Footnote-1980451 +Node: Array Manipulation980542 +Ref: Array Manipulation-Footnote-1981641 +Node: Array Data Types981678 +Ref: Array Data Types-Footnote-1984336 +Node: Array Functions984428 +Node: Flattening Arrays988286 +Node: Creating Arrays995194 +Node: Extension API Variables999965 +Node: Extension Versioning1000601 +Node: Extension API Informational Variables1002492 +Node: Extension API Boilerplate1003556 +Node: Finding Extensions1007370 +Node: Extension Example1007929 +Node: Internal File Description1008727 +Node: Internal File Ops1012807 +Ref: Internal File Ops-Footnote-11024569 +Node: Using Internal File Ops1024709 +Ref: Using Internal File Ops-Footnote-11027092 +Node: Extension Samples1027366 +Node: Extension Sample File Functions1028895 +Node: Extension Sample Fnmatch1036544 +Node: Extension Sample Fork1038031 +Node: Extension Sample Inplace1039249 +Node: Extension Sample Ord1042459 +Node: Extension Sample Readdir1043295 +Ref: table-readdir-file-types1044184 +Node: Extension Sample Revout1044989 +Node: Extension Sample Rev2way1045578 +Node: Extension Sample Read write array1046318 +Node: Extension Sample Readfile1048260 +Node: Extension Sample Time1049355 +Node: Extension Sample API Tests1050703 +Node: gawkextlib1051195 +Node: Extension summary1053619 +Node: Extension Exercises1057311 +Node: Language History1058808 +Node: V7/SVR3.11060464 +Node: SVR41062616 +Node: POSIX1064050 +Node: BTL1065429 +Node: POSIX/GNU1066158 +Node: Feature History1071679 +Node: Common Extensions1085008 +Node: Ranges and Locales1086291 +Ref: Ranges and Locales-Footnote-11090907 +Ref: Ranges and Locales-Footnote-21090934 +Ref: Ranges and Locales-Footnote-31091169 +Node: Contributors1091390 +Node: History summary1096959 +Node: Installation1098339 +Node: Gawk Distribution1099283 +Node: Getting1099767 +Node: Extracting1100728 +Node: Distribution contents1102366 +Node: Unix Installation1108117 +Node: Quick Installation1108733 +Node: Additional Configuration Options1111160 +Node: Configuration Philosophy1112964 +Node: Non-Unix Installation1115333 +Node: PC Installation1115791 +Node: PC Binary Installation1117111 +Node: PC Compiling1118963 +Ref: PC Compiling-Footnote-11121987 +Node: PC Testing1122096 +Node: PC Using1123276 +Node: Cygwin1127390 +Node: MSYS1128160 +Node: VMS Installation1128661 +Node: VMS Compilation1129452 +Ref: VMS Compilation-Footnote-11130681 +Node: VMS Dynamic Extensions1130739 +Node: VMS Installation Details1132424 +Node: VMS Running1134677 +Node: VMS GNV1138956 +Node: VMS Old Gawk1139691 +Node: Bugs1140162 +Node: Other Versions1144359 +Node: Installation summary1150943 +Node: Notes1152001 +Node: Compatibility Mode1152866 +Node: Additions1153648 +Node: Accessing The Source1154573 +Node: Adding Code1156008 +Node: New Ports1162227 +Node: Derived Files1166715 +Ref: Derived Files-Footnote-11172200 +Ref: Derived Files-Footnote-21172235 +Ref: Derived Files-Footnote-31172833 +Node: Future Extensions1172947 +Node: Implementation Limitations1173605 +Node: Extension Design1174788 +Node: Old Extension Problems1175942 +Ref: Old Extension Problems-Footnote-11177460 +Node: Extension New Mechanism Goals1177517 +Ref: Extension New Mechanism Goals-Footnote-11180881 +Node: Extension Other Design Decisions1181070 +Node: Extension Future Growth1183183 +Node: Old Extension Mechanism1184019 +Node: Notes summary1185782 +Node: Basic Concepts1186964 +Node: Basic High Level1187645 +Ref: figure-general-flow1187927 +Ref: figure-process-flow1188612 +Ref: Basic High Level-Footnote-11191913 +Node: Basic Data Typing1192098 +Node: Glossary1195426 +Node: Copying1227372 +Node: GNU Free Documentation License1264911 +Node: Index1290029 End Tag Table diff --git a/doc/gawk.texi b/doc/gawk.texi index cfb40b6a..30826891 100644 --- a/doc/gawk.texi +++ b/doc/gawk.texi @@ -18380,17 +18380,19 @@ When @option{--sandbox} is specified, the @code{system()} function is disabled On POSIX systems, a command's exit status is a 16-bit number. The exit value passed to the C @code{exit()} function is held in the high-order eight bits. The low-order bits indicate if the process was killed by a -signal (bit 7) and if so, the signal number (bits 0--6). +signal (bit 7) and if so, the guilty signal number (bits 0--6). Traditionally, @command{awk}'s @code{system()} function has simply -returned the exit status value and ignored death-by-signal. POSIX -states that @command{awk}'s @code{system()} should return the full -16-bit value. - -@command{gawk} steers a middle ground. With @option{--posix}, it returns -the full 16-bit value. By default, it returns just the exit status. The -@option{--traditional} option forces @command{gawk} to ignore -death-by-signal, in which case @code{system()} returns zero. +returned the exit status value divided by 256. In the normal case this +gives the exit status but in the case of death-by-signal it yields +a fractional floating-point value. POSIX states that @command{awk}'s +@code{system()} should return the full 16-bit value. + +@command{gawk} steers a middle ground. +By default, it returns just the exit status. The +@option{--traditional} option causes @command{gawk} to divide +the return vaue by 356, just as Brian Kernighan's @command{awk} does. +With @option{--posix}, it returns the full 16-bit value. If the process was killed by a signal, @command{gawk}'s @code{system()} returns 256 + @var{sig}, where @var{sig} is the number of the signal diff --git a/doc/gawktexi.in b/doc/gawktexi.in index 4b0af55b..3831d6ef 100644 --- a/doc/gawktexi.in +++ b/doc/gawktexi.in @@ -17572,17 +17572,19 @@ When @option{--sandbox} is specified, the @code{system()} function is disabled On POSIX systems, a command's exit status is a 16-bit number. The exit value passed to the C @code{exit()} function is held in the high-order eight bits. The low-order bits indicate if the process was killed by a -signal (bit 7) and if so, the signal number (bits 0--6). +signal (bit 7) and if so, the guilty signal number (bits 0--6). Traditionally, @command{awk}'s @code{system()} function has simply -returned the exit status value and ignored death-by-signal. POSIX -states that @command{awk}'s @code{system()} should return the full -16-bit value. - -@command{gawk} steers a middle ground. With @option{--posix}, it returns -the full 16-bit value. By default, it returns just the exit status. The -@option{--traditional} option forces @command{gawk} to ignore -death-by-signal, in which case @code{system()} returns zero. +returned the exit status value divided by 256. In the normal case this +gives the exit status but in the case of death-by-signal it yields +a fractional floating-point value. POSIX states that @command{awk}'s +@code{system()} should return the full 16-bit value. + +@command{gawk} steers a middle ground. +By default, it returns just the exit status. The +@option{--traditional} option causes @command{gawk} to divide +the return vaue by 356, just as Brian Kernighan's @command{awk} does. +With @option{--posix}, it returns the full 16-bit value. If the process was killed by a signal, @command{gawk}'s @code{system()} returns 256 + @var{sig}, where @var{sig} is the number of the signal |