diff options
Diffstat (limited to 'doc')
| -rw-r--r-- | doc/ChangeLog | 4 | ||||
| -rw-r--r-- | doc/gawk.info | 666 | ||||
| -rw-r--r-- | doc/gawk.texi | 25 | ||||
| -rw-r--r-- | doc/gawktexi.in | 25 |
4 files changed, 365 insertions, 355 deletions
diff --git a/doc/ChangeLog b/doc/ChangeLog index afe5841a..2a5fbb2f 100644 --- a/doc/ChangeLog +++ b/doc/ChangeLog @@ -1,3 +1,7 @@ +2016-03-11 Arnold D. Robbins <arnold@skeeve.com> + + * gawktexi.in: Improve system() return values documentation. + 2016-03-07 Arnold D. Robbins <arnold@skeeve.com> * gawktexi.in: Document system() return values. diff --git a/doc/gawk.info b/doc/gawk.info index f18229bc..b091b755 100644 --- a/doc/gawk.info +++ b/doc/gawk.info @@ -12814,18 +12814,21 @@ parameters are enclosed in square brackets ([ ]): fractional floating-point value.(2) POSIX states that 'awk''s 'system()' should return the full 16-bit value. - 'gawk' steers a middle ground. By default, it returns just the - exit status. The '--traditional' option causes 'gawk' to divide - the return vaue by 256, 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 - process. Since exit values are eight bits, where the values range - from 0-255, using 256 + SIG lets you clearly distinguish normal - exit from death-by-signal. - - If some kind of error occurred, 'system()' returns -1. + 'gawk' steers a middle ground. The return values are summarized in + *note Table 9.5: table-system-return-values. + + Situation Return value from 'system()' + -------------------------------------------------------------------------- + '--traditional' C 'system()''s value divided by + 256 + '--posix' C 'system()''s value + Normal exit of command Command's exit status + Death by signal of command 256 + number of murderous signal + Death by signal of command with 512 + number of murderous signal + core dump + Some kind of error -1 + + Table 9.5: Return value from 'system()' Controlling Output Buffering with 'system()' @@ -13207,7 +13210,7 @@ File: gawk.info, Node: Bitwise Functions, Next: Type Functions, Prev: Time Fu two integer numbers. In other words, the operation is performed on each successive pair of bits in the operands. Three common operations are bitwise AND, OR, and XOR. The operations are described in *note Table -9.5: table-bitwise-ops. +9.6: table-bitwise-ops. Bit operator | AND | OR | XOR @@ -13217,7 +13220,7 @@ bitwise AND, OR, and XOR. The operations are described in *note Table 0 | 0 0 | 0 1 | 0 1 1 | 0 1 | 1 1 | 1 0 -Table 9.5: Bitwise operations +Table 9.6: Bitwise operations As you can see, the result of an AND operation is 1 only when _both_ bits are 1. The result of an OR operation is 1 if _either_ bit is 1. @@ -32223,11 +32226,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 164) +* buffering, input/output: I/O Functions. (line 167) * 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 164) +* buffers, flushing <1>: I/O Functions. (line 167) * buffers, operators for: GNU Regexp Operators. (line 51) * bug reports, email address, bug-gawk@gnu.org: Bugs. (line 30) @@ -33751,7 +33754,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 164) +* output, buffering <1>: I/O Functions. (line 167) * output, duplicating into files: Tee Program. (line 6) * output, files, closing: Close Files And Pipes. (line 6) @@ -34247,7 +34250,7 @@ Index (line 14) * sidebar, Changing NR and FNR: Auto-set. (line 311) * sidebar, Controlling Output Buffering with system(): I/O Functions. - (line 162) + (line 165) * sidebar, Escape Sequences for Metacharacters: Escape Sequences. (line 135) * sidebar, FS and IGNORECASE: Field Splitting Summary. @@ -34902,318 +34905,319 @@ Ref: table-posix-sub537317 Ref: table-gensub-escapes538858 Ref: Gory Details-Footnote-1539681 Node: I/O Functions539832 -Ref: I/O Functions-Footnote-1548340 -Ref: I/O Functions-Footnote-2548488 -Node: Time Functions548608 -Ref: Time Functions-Footnote-1559113 -Ref: Time Functions-Footnote-2559181 -Ref: Time Functions-Footnote-3559339 -Ref: Time Functions-Footnote-4559450 -Ref: Time Functions-Footnote-5559562 -Ref: Time Functions-Footnote-6559789 -Node: Bitwise Functions560055 -Ref: table-bitwise-ops560649 -Ref: Bitwise Functions-Footnote-1564987 -Node: Type Functions565160 -Node: I18N Functions566316 -Node: User-defined567967 -Node: Definition Syntax568772 -Ref: Definition Syntax-Footnote-1574459 -Node: Function Example574530 -Ref: Function Example-Footnote-1577452 -Node: Function Caveats577474 -Node: Calling A Function577992 -Node: Variable Scope578950 -Node: Pass By Value/Reference581944 -Node: Return Statement585443 -Node: Dynamic Typing588422 -Node: Indirect Calls589352 -Ref: Indirect Calls-Footnote-1599603 -Node: Functions Summary599731 -Node: Library Functions602436 -Ref: Library Functions-Footnote-1606043 -Ref: Library Functions-Footnote-2606186 -Node: Library Names606357 -Ref: Library Names-Footnote-1609817 -Ref: Library Names-Footnote-2610040 -Node: General Functions610126 -Node: Strtonum Function611229 -Node: Assert Function614251 -Node: Round Function617577 -Node: Cliff Random Function619118 -Node: Ordinal Functions620134 -Ref: Ordinal Functions-Footnote-1623197 -Ref: Ordinal Functions-Footnote-2623449 -Node: Join Function623659 -Ref: Join Function-Footnote-1625429 -Node: Getlocaltime Function625629 -Node: Readfile Function629371 -Node: Shell Quoting631343 -Node: Data File Management632744 -Node: Filetrans Function633376 -Node: Rewind Function637472 -Node: File Checking639377 -Ref: File Checking-Footnote-1640711 -Node: Empty Files640912 -Node: Ignoring Assigns642891 -Node: Getopt Function644441 -Ref: Getopt Function-Footnote-1655910 -Node: Passwd Functions656110 -Ref: Passwd Functions-Footnote-1664949 -Node: Group Functions665037 -Ref: Group Functions-Footnote-1672934 -Node: Walking Arrays673141 -Node: Library Functions Summary676149 -Node: Library Exercises677555 -Node: Sample Programs678020 -Node: Running Examples678790 -Node: Clones679518 -Node: Cut Program680742 -Node: Egrep Program690671 -Ref: Egrep Program-Footnote-1698183 -Node: Id Program698293 -Node: Split Program701973 -Ref: Split Program-Footnote-1705432 -Node: Tee Program705561 -Node: Uniq Program708351 -Node: Wc Program715777 -Ref: Wc Program-Footnote-1720032 -Node: Miscellaneous Programs720126 -Node: Dupword Program721339 -Node: Alarm Program723369 -Node: Translate Program728224 -Ref: Translate Program-Footnote-1732789 -Node: Labels Program733059 -Ref: Labels Program-Footnote-1736410 -Node: Word Sorting736494 -Node: History Sorting740566 -Node: Extract Program742401 -Node: Simple Sed749930 -Node: Igawk Program753004 -Ref: Igawk Program-Footnote-1767335 -Ref: Igawk Program-Footnote-2767537 -Ref: Igawk Program-Footnote-3767659 -Node: Anagram Program767774 -Node: Signature Program770836 -Node: Programs Summary772083 -Node: Programs Exercises773297 -Ref: Programs Exercises-Footnote-1777426 -Node: Advanced Features777517 -Node: Nondecimal Data779507 -Node: Array Sorting781098 -Node: Controlling Array Traversal781798 -Ref: Controlling Array Traversal-Footnote-1790165 -Node: Array Sorting Functions790283 -Ref: Array Sorting Functions-Footnote-1795374 -Node: Two-way I/O795570 -Ref: Two-way I/O-Footnote-1801390 -Ref: Two-way I/O-Footnote-2801577 -Node: TCP/IP Networking801659 -Node: Profiling804777 -Node: Advanced Features Summary812316 -Node: Internationalization814252 -Node: I18N and L10N815732 -Node: Explaining gettext816419 -Ref: Explaining gettext-Footnote-1821442 -Ref: Explaining gettext-Footnote-2821627 -Node: Programmer i18n821792 -Ref: Programmer i18n-Footnote-1826647 -Node: Translator i18n826696 -Node: String Extraction827490 -Ref: String Extraction-Footnote-1828622 -Node: Printf Ordering828708 -Ref: Printf Ordering-Footnote-1831494 -Node: I18N Portability831558 -Ref: I18N Portability-Footnote-1834014 -Node: I18N Example834077 -Ref: I18N Example-Footnote-1836883 -Node: Gawk I18N836956 -Node: I18N Summary837601 -Node: Debugger838942 -Node: Debugging839964 -Node: Debugging Concepts840405 -Node: Debugging Terms842214 -Node: Awk Debugging844789 -Node: Sample Debugging Session845695 -Node: Debugger Invocation846229 -Node: Finding The Bug847615 -Node: List of Debugger Commands854093 -Node: Breakpoint Control855426 -Node: Debugger Execution Control859120 -Node: Viewing And Changing Data862482 -Node: Execution Stack865856 -Node: Debugger Info867493 -Node: Miscellaneous Debugger Commands871564 -Node: Readline Support876652 -Node: Limitations877548 -Node: Debugging Summary879657 -Node: Arbitrary Precision Arithmetic880830 -Node: Computer Arithmetic882246 -Ref: table-numeric-ranges885837 -Ref: Computer Arithmetic-Footnote-1886559 -Node: Math Definitions886616 -Ref: table-ieee-formats889930 -Ref: Math Definitions-Footnote-1890533 -Node: MPFR features890638 -Node: FP Math Caution892355 -Ref: FP Math Caution-Footnote-1893427 -Node: Inexactness of computations893796 -Node: Inexact representation894756 -Node: Comparing FP Values896116 -Node: Errors accumulate897198 -Node: Getting Accuracy898631 -Node: Try To Round901341 -Node: Setting precision902240 -Ref: table-predefined-precision-strings902937 -Node: Setting the rounding mode904767 -Ref: table-gawk-rounding-modes905141 -Ref: Setting the rounding mode-Footnote-1908549 -Node: Arbitrary Precision Integers908728 -Ref: Arbitrary Precision Integers-Footnote-1911712 -Node: POSIX Floating Point Problems911861 -Ref: POSIX Floating Point Problems-Footnote-1915743 -Node: Floating point summary915781 -Node: Dynamic Extensions917971 -Node: Extension Intro919524 -Node: Plugin License920790 -Node: Extension Mechanism Outline921587 -Ref: figure-load-extension922026 -Ref: figure-register-new-function923591 -Ref: figure-call-new-function924683 -Node: Extension API Description926745 -Node: Extension API Functions Introduction928193 -Node: General Data Types933005 -Ref: General Data Types-Footnote-1938960 -Node: Memory Allocation Functions939259 -Ref: Memory Allocation Functions-Footnote-1942104 -Node: Constructor Functions942203 -Node: Registration Functions943948 -Node: Extension Functions944633 -Node: Exit Callback Functions946932 -Node: Extension Version String948182 -Node: Input Parsers948845 -Node: Output Wrappers958730 -Node: Two-way processors963242 -Node: Printing Messages965506 -Ref: Printing Messages-Footnote-1966580 -Node: Updating ERRNO966733 -Node: Requesting Values967472 -Ref: table-value-types-returned968209 -Node: Accessing Parameters969092 -Node: Symbol Table Access970327 -Node: Symbol table by name970839 -Node: Symbol table by cookie972860 -Ref: Symbol table by cookie-Footnote-1977009 -Node: Cached values977073 -Ref: Cached values-Footnote-1980574 -Node: Array Manipulation980665 -Ref: Array Manipulation-Footnote-1981764 -Node: Array Data Types981801 -Ref: Array Data Types-Footnote-1984459 -Node: Array Functions984551 -Node: Flattening Arrays988409 -Node: Creating Arrays995317 -Node: Extension API Variables1000088 -Node: Extension Versioning1000724 -Node: Extension API Informational Variables1002615 -Node: Extension API Boilerplate1003679 -Node: Finding Extensions1007493 -Node: Extension Example1008052 -Node: Internal File Description1008850 -Node: Internal File Ops1012930 -Ref: Internal File Ops-Footnote-11024692 -Node: Using Internal File Ops1024832 -Ref: Using Internal File Ops-Footnote-11027215 -Node: Extension Samples1027489 -Node: Extension Sample File Functions1029018 -Node: Extension Sample Fnmatch1036667 -Node: Extension Sample Fork1038154 -Node: Extension Sample Inplace1039372 -Node: Extension Sample Ord1042582 -Node: Extension Sample Readdir1043418 -Ref: table-readdir-file-types1044307 -Node: Extension Sample Revout1045112 -Node: Extension Sample Rev2way1045701 -Node: Extension Sample Read write array1046441 -Node: Extension Sample Readfile1048383 -Node: Extension Sample Time1049478 -Node: Extension Sample API Tests1050826 -Node: gawkextlib1051318 -Node: Extension summary1053742 -Node: Extension Exercises1057434 -Node: Language History1058931 -Node: V7/SVR3.11060587 -Node: SVR41062739 -Node: POSIX1064173 -Node: BTL1065552 -Node: POSIX/GNU1066281 -Node: Feature History1071802 -Node: Common Extensions1085131 -Node: Ranges and Locales1086414 -Ref: Ranges and Locales-Footnote-11091030 -Ref: Ranges and Locales-Footnote-21091057 -Ref: Ranges and Locales-Footnote-31091292 -Node: Contributors1091513 -Node: History summary1097082 -Node: Installation1098462 -Node: Gawk Distribution1099406 -Node: Getting1099890 -Node: Extracting1100851 -Node: Distribution contents1102489 -Node: Unix Installation1108240 -Node: Quick Installation1108856 -Node: Additional Configuration Options1111283 -Node: Configuration Philosophy1113087 -Node: Non-Unix Installation1115456 -Node: PC Installation1115914 -Node: PC Binary Installation1117234 -Node: PC Compiling1119086 -Ref: PC Compiling-Footnote-11122110 -Node: PC Testing1122219 -Node: PC Using1123399 -Node: Cygwin1127513 -Node: MSYS1128283 -Node: VMS Installation1128784 -Node: VMS Compilation1129575 -Ref: VMS Compilation-Footnote-11130804 -Node: VMS Dynamic Extensions1130862 -Node: VMS Installation Details1132547 -Node: VMS Running1134800 -Node: VMS GNV1139079 -Node: VMS Old Gawk1139814 -Node: Bugs1140285 -Node: Other Versions1144482 -Node: Installation summary1151066 -Node: Notes1152124 -Node: Compatibility Mode1152989 -Node: Additions1153771 -Node: Accessing The Source1154696 -Node: Adding Code1156131 -Node: New Ports1162350 -Node: Derived Files1166838 -Ref: Derived Files-Footnote-11172323 -Ref: Derived Files-Footnote-21172358 -Ref: Derived Files-Footnote-31172956 -Node: Future Extensions1173070 -Node: Implementation Limitations1173728 -Node: Extension Design1174911 -Node: Old Extension Problems1176065 -Ref: Old Extension Problems-Footnote-11177583 -Node: Extension New Mechanism Goals1177640 -Ref: Extension New Mechanism Goals-Footnote-11181004 -Node: Extension Other Design Decisions1181193 -Node: Extension Future Growth1183306 -Node: Old Extension Mechanism1184142 -Node: Notes summary1185905 -Node: Basic Concepts1187087 -Node: Basic High Level1187768 -Ref: figure-general-flow1188050 -Ref: figure-process-flow1188735 -Ref: Basic High Level-Footnote-11192036 -Node: Basic Data Typing1192221 -Node: Glossary1195549 -Node: Copying1227495 -Node: GNU Free Documentation License1265034 -Node: Index1290152 +Ref: table-system-return-values546414 +Ref: I/O Functions-Footnote-1548479 +Ref: I/O Functions-Footnote-2548627 +Node: Time Functions548747 +Ref: Time Functions-Footnote-1559252 +Ref: Time Functions-Footnote-2559320 +Ref: Time Functions-Footnote-3559478 +Ref: Time Functions-Footnote-4559589 +Ref: Time Functions-Footnote-5559701 +Ref: Time Functions-Footnote-6559928 +Node: Bitwise Functions560194 +Ref: table-bitwise-ops560788 +Ref: Bitwise Functions-Footnote-1565126 +Node: Type Functions565299 +Node: I18N Functions566455 +Node: User-defined568106 +Node: Definition Syntax568911 +Ref: Definition Syntax-Footnote-1574598 +Node: Function Example574669 +Ref: Function Example-Footnote-1577591 +Node: Function Caveats577613 +Node: Calling A Function578131 +Node: Variable Scope579089 +Node: Pass By Value/Reference582083 +Node: Return Statement585582 +Node: Dynamic Typing588561 +Node: Indirect Calls589491 +Ref: Indirect Calls-Footnote-1599742 +Node: Functions Summary599870 +Node: Library Functions602575 +Ref: Library Functions-Footnote-1606182 +Ref: Library Functions-Footnote-2606325 +Node: Library Names606496 +Ref: Library Names-Footnote-1609956 +Ref: Library Names-Footnote-2610179 +Node: General Functions610265 +Node: Strtonum Function611368 +Node: Assert Function614390 +Node: Round Function617716 +Node: Cliff Random Function619257 +Node: Ordinal Functions620273 +Ref: Ordinal Functions-Footnote-1623336 +Ref: Ordinal Functions-Footnote-2623588 +Node: Join Function623798 +Ref: Join Function-Footnote-1625568 +Node: Getlocaltime Function625768 +Node: Readfile Function629510 +Node: Shell Quoting631482 +Node: Data File Management632883 +Node: Filetrans Function633515 +Node: Rewind Function637611 +Node: File Checking639516 +Ref: File Checking-Footnote-1640850 +Node: Empty Files641051 +Node: Ignoring Assigns643030 +Node: Getopt Function644580 +Ref: Getopt Function-Footnote-1656049 +Node: Passwd Functions656249 +Ref: Passwd Functions-Footnote-1665088 +Node: Group Functions665176 +Ref: Group Functions-Footnote-1673073 +Node: Walking Arrays673280 +Node: Library Functions Summary676288 +Node: Library Exercises677694 +Node: Sample Programs678159 +Node: Running Examples678929 +Node: Clones679657 +Node: Cut Program680881 +Node: Egrep Program690810 +Ref: Egrep Program-Footnote-1698322 +Node: Id Program698432 +Node: Split Program702112 +Ref: Split Program-Footnote-1705571 +Node: Tee Program705700 +Node: Uniq Program708490 +Node: Wc Program715916 +Ref: Wc Program-Footnote-1720171 +Node: Miscellaneous Programs720265 +Node: Dupword Program721478 +Node: Alarm Program723508 +Node: Translate Program728363 +Ref: Translate Program-Footnote-1732928 +Node: Labels Program733198 +Ref: Labels Program-Footnote-1736549 +Node: Word Sorting736633 +Node: History Sorting740705 +Node: Extract Program742540 +Node: Simple Sed750069 +Node: Igawk Program753143 +Ref: Igawk Program-Footnote-1767474 +Ref: Igawk Program-Footnote-2767676 +Ref: Igawk Program-Footnote-3767798 +Node: Anagram Program767913 +Node: Signature Program770975 +Node: Programs Summary772222 +Node: Programs Exercises773436 +Ref: Programs Exercises-Footnote-1777565 +Node: Advanced Features777656 +Node: Nondecimal Data779646 +Node: Array Sorting781237 +Node: Controlling Array Traversal781937 +Ref: Controlling Array Traversal-Footnote-1790304 +Node: Array Sorting Functions790422 +Ref: Array Sorting Functions-Footnote-1795513 +Node: Two-way I/O795709 +Ref: Two-way I/O-Footnote-1801529 +Ref: Two-way I/O-Footnote-2801716 +Node: TCP/IP Networking801798 +Node: Profiling804916 +Node: Advanced Features Summary812455 +Node: Internationalization814391 +Node: I18N and L10N815871 +Node: Explaining gettext816558 +Ref: Explaining gettext-Footnote-1821581 +Ref: Explaining gettext-Footnote-2821766 +Node: Programmer i18n821931 +Ref: Programmer i18n-Footnote-1826786 +Node: Translator i18n826835 +Node: String Extraction827629 +Ref: String Extraction-Footnote-1828761 +Node: Printf Ordering828847 +Ref: Printf Ordering-Footnote-1831633 +Node: I18N Portability831697 +Ref: I18N Portability-Footnote-1834153 +Node: I18N Example834216 +Ref: I18N Example-Footnote-1837022 +Node: Gawk I18N837095 +Node: I18N Summary837740 +Node: Debugger839081 +Node: Debugging840103 +Node: Debugging Concepts840544 +Node: Debugging Terms842353 +Node: Awk Debugging844928 +Node: Sample Debugging Session845834 +Node: Debugger Invocation846368 +Node: Finding The Bug847754 +Node: List of Debugger Commands854232 +Node: Breakpoint Control855565 +Node: Debugger Execution Control859259 +Node: Viewing And Changing Data862621 +Node: Execution Stack865995 +Node: Debugger Info867632 +Node: Miscellaneous Debugger Commands871703 +Node: Readline Support876791 +Node: Limitations877687 +Node: Debugging Summary879796 +Node: Arbitrary Precision Arithmetic880969 +Node: Computer Arithmetic882385 +Ref: table-numeric-ranges885976 +Ref: Computer Arithmetic-Footnote-1886698 +Node: Math Definitions886755 +Ref: table-ieee-formats890069 +Ref: Math Definitions-Footnote-1890672 +Node: MPFR features890777 +Node: FP Math Caution892494 +Ref: FP Math Caution-Footnote-1893566 +Node: Inexactness of computations893935 +Node: Inexact representation894895 +Node: Comparing FP Values896255 +Node: Errors accumulate897337 +Node: Getting Accuracy898770 +Node: Try To Round901480 +Node: Setting precision902379 +Ref: table-predefined-precision-strings903076 +Node: Setting the rounding mode904906 +Ref: table-gawk-rounding-modes905280 +Ref: Setting the rounding mode-Footnote-1908688 +Node: Arbitrary Precision Integers908867 +Ref: Arbitrary Precision Integers-Footnote-1911851 +Node: POSIX Floating Point Problems912000 +Ref: POSIX Floating Point Problems-Footnote-1915882 +Node: Floating point summary915920 +Node: Dynamic Extensions918110 +Node: Extension Intro919663 +Node: Plugin License920929 +Node: Extension Mechanism Outline921726 +Ref: figure-load-extension922165 +Ref: figure-register-new-function923730 +Ref: figure-call-new-function924822 +Node: Extension API Description926884 +Node: Extension API Functions Introduction928332 +Node: General Data Types933144 +Ref: General Data Types-Footnote-1939099 +Node: Memory Allocation Functions939398 +Ref: Memory Allocation Functions-Footnote-1942243 +Node: Constructor Functions942342 +Node: Registration Functions944087 +Node: Extension Functions944772 +Node: Exit Callback Functions947071 +Node: Extension Version String948321 +Node: Input Parsers948984 +Node: Output Wrappers958869 +Node: Two-way processors963381 +Node: Printing Messages965645 +Ref: Printing Messages-Footnote-1966719 +Node: Updating ERRNO966872 +Node: Requesting Values967611 +Ref: table-value-types-returned968348 +Node: Accessing Parameters969231 +Node: Symbol Table Access970466 +Node: Symbol table by name970978 +Node: Symbol table by cookie972999 +Ref: Symbol table by cookie-Footnote-1977148 +Node: Cached values977212 +Ref: Cached values-Footnote-1980713 +Node: Array Manipulation980804 +Ref: Array Manipulation-Footnote-1981903 +Node: Array Data Types981940 +Ref: Array Data Types-Footnote-1984598 +Node: Array Functions984690 +Node: Flattening Arrays988548 +Node: Creating Arrays995456 +Node: Extension API Variables1000227 +Node: Extension Versioning1000863 +Node: Extension API Informational Variables1002754 +Node: Extension API Boilerplate1003818 +Node: Finding Extensions1007632 +Node: Extension Example1008191 +Node: Internal File Description1008989 +Node: Internal File Ops1013069 +Ref: Internal File Ops-Footnote-11024831 +Node: Using Internal File Ops1024971 +Ref: Using Internal File Ops-Footnote-11027354 +Node: Extension Samples1027628 +Node: Extension Sample File Functions1029157 +Node: Extension Sample Fnmatch1036806 +Node: Extension Sample Fork1038293 +Node: Extension Sample Inplace1039511 +Node: Extension Sample Ord1042721 +Node: Extension Sample Readdir1043557 +Ref: table-readdir-file-types1044446 +Node: Extension Sample Revout1045251 +Node: Extension Sample Rev2way1045840 +Node: Extension Sample Read write array1046580 +Node: Extension Sample Readfile1048522 +Node: Extension Sample Time1049617 +Node: Extension Sample API Tests1050965 +Node: gawkextlib1051457 +Node: Extension summary1053881 +Node: Extension Exercises1057573 +Node: Language History1059070 +Node: V7/SVR3.11060726 +Node: SVR41062878 +Node: POSIX1064312 +Node: BTL1065691 +Node: POSIX/GNU1066420 +Node: Feature History1071941 +Node: Common Extensions1085270 +Node: Ranges and Locales1086553 +Ref: Ranges and Locales-Footnote-11091169 +Ref: Ranges and Locales-Footnote-21091196 +Ref: Ranges and Locales-Footnote-31091431 +Node: Contributors1091652 +Node: History summary1097221 +Node: Installation1098601 +Node: Gawk Distribution1099545 +Node: Getting1100029 +Node: Extracting1100990 +Node: Distribution contents1102628 +Node: Unix Installation1108379 +Node: Quick Installation1108995 +Node: Additional Configuration Options1111422 +Node: Configuration Philosophy1113226 +Node: Non-Unix Installation1115595 +Node: PC Installation1116053 +Node: PC Binary Installation1117373 +Node: PC Compiling1119225 +Ref: PC Compiling-Footnote-11122249 +Node: PC Testing1122358 +Node: PC Using1123538 +Node: Cygwin1127652 +Node: MSYS1128422 +Node: VMS Installation1128923 +Node: VMS Compilation1129714 +Ref: VMS Compilation-Footnote-11130943 +Node: VMS Dynamic Extensions1131001 +Node: VMS Installation Details1132686 +Node: VMS Running1134939 +Node: VMS GNV1139218 +Node: VMS Old Gawk1139953 +Node: Bugs1140424 +Node: Other Versions1144621 +Node: Installation summary1151205 +Node: Notes1152263 +Node: Compatibility Mode1153128 +Node: Additions1153910 +Node: Accessing The Source1154835 +Node: Adding Code1156270 +Node: New Ports1162489 +Node: Derived Files1166977 +Ref: Derived Files-Footnote-11172462 +Ref: Derived Files-Footnote-21172497 +Ref: Derived Files-Footnote-31173095 +Node: Future Extensions1173209 +Node: Implementation Limitations1173867 +Node: Extension Design1175050 +Node: Old Extension Problems1176204 +Ref: Old Extension Problems-Footnote-11177722 +Node: Extension New Mechanism Goals1177779 +Ref: Extension New Mechanism Goals-Footnote-11181143 +Node: Extension Other Design Decisions1181332 +Node: Extension Future Growth1183445 +Node: Old Extension Mechanism1184281 +Node: Notes summary1186044 +Node: Basic Concepts1187226 +Node: Basic High Level1187907 +Ref: figure-general-flow1188189 +Ref: figure-process-flow1188874 +Ref: Basic High Level-Footnote-11192175 +Node: Basic Data Typing1192360 +Node: Glossary1195688 +Node: Copying1227634 +Node: GNU Free Documentation License1265173 +Node: Index1290291 End Tag Table diff --git a/doc/gawk.texi b/doc/gawk.texi index 2c24c8af..8a523389 100644 --- a/doc/gawk.texi +++ b/doc/gawk.texi @@ -18391,19 +18391,20 @@ was probably a mistake.} 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 256, 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 -that killed the process. Since exit values are eight bits, where the -values range from 0--255, using 256 + @var{sig} lets you clearly distinguish -normal exit from death-by-signal. - -If some kind of error occurred, @code{system()} returns @minus{}1. +The return values are summarized in @ref{table-system-return-values}. +@float Table,table-system-return-values +@caption{Return values from @code{system()}} +@multitable @columnfractions .40 .60 +@headitem Situation @tab Return value from @code{system()} +@item @option{--traditional} @tab C @code{system()}'s value divided by 256 +@item @option{--posix} @tab C @code{system()}'s value +@item Normal exit of command @tab Command's exit status +@item Death by signal of command @tab 256 + number of murderous signal +@item Death by signal of command with core dump @tab 512 + number of murderous signal +@item Some kind of error @tab @minus{}1 +@end multitable +@end float @end table @cindex sidebar, Controlling Output Buffering with @code{system()} diff --git a/doc/gawktexi.in b/doc/gawktexi.in index c284f848..84b62a40 100644 --- a/doc/gawktexi.in +++ b/doc/gawktexi.in @@ -17583,19 +17583,20 @@ was probably a mistake.} 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 256, 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 -that killed the process. Since exit values are eight bits, where the -values range from 0--255, using 256 + @var{sig} lets you clearly distinguish -normal exit from death-by-signal. - -If some kind of error occurred, @code{system()} returns @minus{}1. +The return values are summarized in @ref{table-system-return-values}. +@float Table,table-system-return-values +@caption{Return values from @code{system()}} +@multitable @columnfractions .40 .60 +@headitem Situation @tab Return value from @code{system()} +@item @option{--traditional} @tab C @code{system()}'s value divided by 256 +@item @option{--posix} @tab C @code{system()}'s value +@item Normal exit of command @tab Command's exit status +@item Death by signal of command @tab 256 + number of murderous signal +@item Death by signal of command with core dump @tab 512 + number of murderous signal +@item Some kind of error @tab @minus{}1 +@end multitable +@end float @end table @sidebar Controlling Output Buffering with @code{system()} |