diff options
author | Arnold D. Robbins <arnold@skeeve.com> | 2020-11-16 14:36:03 +0200 |
---|---|---|
committer | Arnold D. Robbins <arnold@skeeve.com> | 2020-11-16 14:36:03 +0200 |
commit | c190cc7b72f9a0eea27b3455e011c2244d8d337a (patch) | |
tree | 2d1e73422d90a092b8393c16d10efeead7618529 | |
parent | 7d76cb815e02b1ef7bfa640975395935fccb71f8 (diff) | |
parent | d04f08bb8474e44417e739c7a03fb9690a9e22d8 (diff) | |
download | egawk-c190cc7b72f9a0eea27b3455e011c2244d8d337a.tar.gz egawk-c190cc7b72f9a0eea27b3455e011c2244d8d337a.tar.bz2 egawk-c190cc7b72f9a0eea27b3455e011c2244d8d337a.zip |
Merge branch 'gawk-5.1-stable'
-rw-r--r-- | doc/ChangeLog | 1 | ||||
-rw-r--r-- | doc/gawk.info | 780 | ||||
-rw-r--r-- | doc/gawk.texi | 5 | ||||
-rw-r--r-- | doc/gawktexi.in | 5 |
4 files changed, 397 insertions, 394 deletions
diff --git a/doc/ChangeLog b/doc/ChangeLog index 8d00228d..af355722 100644 --- a/doc/ChangeLog +++ b/doc/ChangeLog @@ -2,6 +2,7 @@ * gawktexi.in (Nextfile Statement): Clarify what happens in a BEGINFILE rule. + * gawktexi.in: Additional small fixes. 2020-11-15 Arnold D. Robbins <arnold@skeeve.com> diff --git a/doc/gawk.info b/doc/gawk.info index 5b0e5dfc..bf4400fa 100644 --- a/doc/gawk.info +++ b/doc/gawk.info @@ -10803,10 +10803,10 @@ an 'END' rule, 'ARGIND' is incremented, and any 'BEGINFILE' rules are executed. ('ARGIND' hasn't been introduced yet. *Note Built-in Variables::.) - With 'gawk', 'nextfile' is useful inside a 'BEGINFILE' rule to skip -over a file that would otherwise cause 'gawk' to exit with a fatal -error. In this case, 'ENDFILE' rules are not executed. *Note -BEGINFILE/ENDFILE::. + There is an additional, special, use case with 'gawk'. 'nextfile' is +useful inside a 'BEGINFILE' rule to skip over a file that would +otherwise cause 'gawk' to exit with a fatal error. In this special +case, 'ENDFILE' rules are not executed. *Note BEGINFILE/ENDFILE::. Although it might seem that 'close(FILENAME)' would accomplish the same as 'nextfile', this isn't true. 'close()' is reserved for closing @@ -38192,392 +38192,392 @@ Node: Break Statement455132 Node: Continue Statement457224 Node: Next Statement459051 Node: Nextfile Statement461434 -Node: Exit Statement464072 -Node: Built-in Variables466475 -Node: User-modified467608 -Node: Auto-set475375 -Ref: Auto-set-Footnote-1492182 -Ref: Auto-set-Footnote-2492388 -Node: ARGC and ARGV492444 -Node: Pattern Action Summary496657 -Node: Arrays499087 -Node: Array Basics500416 -Node: Array Intro501260 -Ref: figure-array-elements503235 -Ref: Array Intro-Footnote-1505939 -Node: Reference to Elements506067 -Node: Assigning Elements508531 -Node: Array Example509022 -Node: Scanning an Array510781 -Node: Controlling Scanning513803 -Ref: Controlling Scanning-Footnote-1520259 -Node: Numeric Array Subscripts520575 -Node: Uninitialized Subscripts522759 -Node: Delete524378 -Ref: Delete-Footnote-1527130 -Node: Multidimensional527187 -Node: Multiscanning530282 -Node: Arrays of Arrays531873 -Node: Arrays Summary536641 -Node: Functions538734 -Node: Built-in539772 -Node: Calling Built-in540853 -Node: Numeric Functions542849 -Ref: Numeric Functions-Footnote-1546875 -Ref: Numeric Functions-Footnote-2547523 -Ref: Numeric Functions-Footnote-3547571 -Node: String Functions547843 -Ref: String Functions-Footnote-1571984 -Ref: String Functions-Footnote-2572112 -Ref: String Functions-Footnote-3572360 -Node: Gory Details572447 -Ref: table-sub-escapes574238 -Ref: table-sub-proposed575757 -Ref: table-posix-sub577120 -Ref: table-gensub-escapes578661 -Ref: Gory Details-Footnote-1579484 -Node: I/O Functions579638 -Ref: table-system-return-values586092 -Ref: I/O Functions-Footnote-1588172 -Ref: I/O Functions-Footnote-2588320 -Node: Time Functions588440 -Ref: Time Functions-Footnote-1599111 -Ref: Time Functions-Footnote-2599179 -Ref: Time Functions-Footnote-3599337 -Ref: Time Functions-Footnote-4599448 -Ref: Time Functions-Footnote-5599560 -Ref: Time Functions-Footnote-6599787 -Node: Bitwise Functions600053 -Ref: table-bitwise-ops600647 -Ref: Bitwise Functions-Footnote-1606710 -Ref: Bitwise Functions-Footnote-2606883 -Node: Type Functions607074 -Node: I18N Functions609937 -Node: User-defined611588 -Node: Definition Syntax612400 -Ref: Definition Syntax-Footnote-1618094 -Node: Function Example618165 -Ref: Function Example-Footnote-1621087 -Node: Function Calling621109 -Node: Calling A Function621697 -Node: Variable Scope622655 -Node: Pass By Value/Reference625649 -Node: Function Caveats628293 -Ref: Function Caveats-Footnote-1630340 -Node: Return Statement630460 -Node: Dynamic Typing633439 -Node: Indirect Calls634369 -Ref: Indirect Calls-Footnote-1644621 -Node: Functions Summary644749 -Node: Library Functions647454 -Ref: Library Functions-Footnote-1651061 -Ref: Library Functions-Footnote-2651204 -Node: Library Names651375 -Ref: Library Names-Footnote-1655042 -Ref: Library Names-Footnote-2655265 -Node: General Functions655351 -Node: Strtonum Function656454 -Node: Assert Function659476 -Node: Round Function662802 -Node: Cliff Random Function664342 -Node: Ordinal Functions665358 -Ref: Ordinal Functions-Footnote-1668421 -Ref: Ordinal Functions-Footnote-2668673 -Node: Join Function668883 -Ref: Join Function-Footnote-1670653 -Node: Getlocaltime Function670853 -Node: Readfile Function674595 -Node: Shell Quoting676572 -Node: Data File Management677973 -Node: Filetrans Function678605 -Node: Rewind Function682701 -Node: File Checking684610 -Ref: File Checking-Footnote-1685944 -Node: Empty Files686145 -Node: Ignoring Assigns688124 -Node: Getopt Function689674 -Ref: Getopt Function-Footnote-1704885 -Node: Passwd Functions705085 -Ref: Passwd Functions-Footnote-1713924 -Node: Group Functions714012 -Ref: Group Functions-Footnote-1721910 -Node: Walking Arrays722117 -Node: Library Functions Summary725125 -Node: Library Exercises726531 -Node: Sample Programs726996 -Node: Running Examples727766 -Node: Clones728494 -Node: Cut Program729718 -Node: Egrep Program739647 -Node: Id Program748658 -Node: Split Program758605 -Ref: Split Program-Footnote-1768379 -Node: Tee Program768552 -Node: Uniq Program771342 -Node: Wc Program778906 -Node: Bytes vs. Characters779303 -Node: Using extensions780851 -Node: wc program781609 -Node: Miscellaneous Programs786474 -Node: Dupword Program787687 -Node: Alarm Program789717 -Node: Translate Program794572 -Ref: Translate Program-Footnote-1799137 -Node: Labels Program799407 -Ref: Labels Program-Footnote-1802758 -Node: Word Sorting802842 -Node: History Sorting806914 -Node: Extract Program809139 -Node: Simple Sed817193 -Node: Igawk Program820267 -Ref: Igawk Program-Footnote-1834598 -Ref: Igawk Program-Footnote-2834800 -Ref: Igawk Program-Footnote-3834922 -Node: Anagram Program835037 -Node: Signature Program838099 -Node: Programs Summary839346 -Node: Programs Exercises840560 -Ref: Programs Exercises-Footnote-1844690 -Node: Advanced Features844776 -Node: Nondecimal Data846766 -Node: Array Sorting848357 -Node: Controlling Array Traversal849057 -Ref: Controlling Array Traversal-Footnote-1857425 -Node: Array Sorting Functions857543 -Ref: Array Sorting Functions-Footnote-1862634 -Node: Two-way I/O862830 -Ref: Two-way I/O-Footnote-1870551 -Ref: Two-way I/O-Footnote-2870738 -Node: TCP/IP Networking870820 -Node: Profiling873938 -Node: Advanced Features Summary883252 -Node: Internationalization885096 -Node: I18N and L10N886576 -Node: Explaining gettext887263 -Ref: Explaining gettext-Footnote-1893155 -Ref: Explaining gettext-Footnote-2893340 -Node: Programmer i18n893505 -Ref: Programmer i18n-Footnote-1898454 -Node: Translator i18n898503 -Node: String Extraction899297 -Ref: String Extraction-Footnote-1900429 -Node: Printf Ordering900515 -Ref: Printf Ordering-Footnote-1903301 -Node: I18N Portability903365 -Ref: I18N Portability-Footnote-1905821 -Node: I18N Example905884 -Ref: I18N Example-Footnote-1909159 -Ref: I18N Example-Footnote-2909232 -Node: Gawk I18N909341 -Node: I18N Summary909990 -Node: Debugger911331 -Node: Debugging912331 -Node: Debugging Concepts912772 -Node: Debugging Terms914581 -Node: Awk Debugging917156 -Ref: Awk Debugging-Footnote-1918101 -Node: Sample Debugging Session918233 -Node: Debugger Invocation918767 -Node: Finding The Bug920153 -Node: List of Debugger Commands926627 -Node: Breakpoint Control927960 -Node: Debugger Execution Control931654 -Node: Viewing And Changing Data935016 -Node: Execution Stack938557 -Node: Debugger Info940194 -Node: Miscellaneous Debugger Commands944265 -Node: Readline Support949327 -Node: Limitations950223 -Node: Debugging Summary952777 -Node: Namespaces954056 -Node: Global Namespace955167 -Node: Qualified Names956565 -Node: Default Namespace957564 -Node: Changing The Namespace958305 -Node: Naming Rules959919 -Node: Internal Name Management961767 -Node: Namespace Example962809 -Node: Namespace And Features965371 -Node: Namespace Summary966806 -Node: Arbitrary Precision Arithmetic968283 -Node: Computer Arithmetic969770 -Ref: table-numeric-ranges973536 -Ref: table-floating-point-ranges974029 -Ref: Computer Arithmetic-Footnote-1974687 -Node: Math Definitions974744 -Ref: table-ieee-formats977720 -Node: MPFR features978287 -Node: FP Math Caution980005 -Ref: FP Math Caution-Footnote-1981077 -Node: Inexactness of computations981446 -Node: Inexact representation982477 -Node: Comparing FP Values983837 -Node: Errors accumulate985078 -Node: Strange values986534 -Ref: Strange values-Footnote-1989097 -Node: Getting Accuracy989202 -Node: Try To Round991912 -Node: Setting precision992811 -Ref: table-predefined-precision-strings993508 -Node: Setting the rounding mode995338 -Ref: table-gawk-rounding-modes995712 -Ref: Setting the rounding mode-Footnote-1999643 -Node: Arbitrary Precision Integers999822 -Ref: Arbitrary Precision Integers-Footnote-11002997 -Node: Checking for MPFR1003146 -Node: POSIX Floating Point Problems1004620 -Ref: POSIX Floating Point Problems-Footnote-11008905 -Node: Floating point summary1008943 -Node: Dynamic Extensions1011133 -Node: Extension Intro1012686 -Node: Plugin License1013952 -Node: Extension Mechanism Outline1014749 -Ref: figure-load-extension1015188 -Ref: figure-register-new-function1016753 -Ref: figure-call-new-function1017845 -Node: Extension API Description1019907 -Node: Extension API Functions Introduction1021620 -Ref: table-api-std-headers1023456 -Node: General Data Types1027705 -Ref: General Data Types-Footnote-11036335 -Node: Memory Allocation Functions1036634 -Ref: Memory Allocation Functions-Footnote-11041135 -Node: Constructor Functions1041234 -Node: API Ownership of MPFR and GMP Values1044700 -Node: Registration Functions1046013 -Node: Extension Functions1046713 -Node: Exit Callback Functions1052035 -Node: Extension Version String1053285 -Node: Input Parsers1053948 -Node: Output Wrappers1066669 -Node: Two-way processors1071181 -Node: Printing Messages1073446 -Ref: Printing Messages-Footnote-11074617 -Node: Updating ERRNO1074770 -Node: Requesting Values1075509 -Ref: table-value-types-returned1076246 -Node: Accessing Parameters1077182 -Node: Symbol Table Access1078419 -Node: Symbol table by name1078931 -Ref: Symbol table by name-Footnote-11081955 -Node: Symbol table by cookie1082083 -Ref: Symbol table by cookie-Footnote-11086268 -Node: Cached values1086332 -Ref: Cached values-Footnote-11089868 -Node: Array Manipulation1090021 -Ref: Array Manipulation-Footnote-11091112 -Node: Array Data Types1091149 -Ref: Array Data Types-Footnote-11093807 -Node: Array Functions1093899 -Node: Flattening Arrays1098397 -Node: Creating Arrays1105373 -Node: Redirection API1110140 -Node: Extension API Variables1112973 -Node: Extension Versioning1113684 -Ref: gawk-api-version1114113 -Node: Extension GMP/MPFR Versioning1115844 -Node: Extension API Informational Variables1117472 -Node: Extension API Boilerplate1118545 -Node: Changes from API V11122519 -Node: Finding Extensions1124091 -Node: Extension Example1124650 -Node: Internal File Description1125448 -Node: Internal File Ops1129528 -Ref: Internal File Ops-Footnote-11140878 -Node: Using Internal File Ops1141018 -Ref: Using Internal File Ops-Footnote-11143401 -Node: Extension Samples1143675 -Node: Extension Sample File Functions1145204 -Node: Extension Sample Fnmatch1152853 -Node: Extension Sample Fork1154340 -Node: Extension Sample Inplace1155558 -Node: Extension Sample Ord1159184 -Node: Extension Sample Readdir1160020 -Ref: table-readdir-file-types1160909 -Node: Extension Sample Revout1161976 -Node: Extension Sample Rev2way1162565 -Node: Extension Sample Read write array1163305 -Node: Extension Sample Readfile1165247 -Node: Extension Sample Time1166342 -Node: Extension Sample API Tests1168094 -Node: gawkextlib1168586 -Node: Extension summary1171504 -Node: Extension Exercises1175206 -Node: Language History1176448 -Node: V7/SVR3.11178104 -Node: SVR41180256 -Node: POSIX1181690 -Node: BTL1183071 -Node: POSIX/GNU1183800 -Node: Feature History1189578 -Node: Common Extensions1205897 -Node: Ranges and Locales1207180 -Ref: Ranges and Locales-Footnote-11211796 -Ref: Ranges and Locales-Footnote-21211823 -Ref: Ranges and Locales-Footnote-31212058 -Node: Contributors1212281 -Node: History summary1218278 -Node: Installation1219658 -Node: Gawk Distribution1220602 -Node: Getting1221086 -Node: Extracting1222049 -Node: Distribution contents1223687 -Node: Unix Installation1230167 -Node: Quick Installation1230849 -Node: Shell Startup Files1233263 -Node: Additional Configuration Options1234352 -Node: Configuration Philosophy1236667 -Node: Non-Unix Installation1239036 -Node: PC Installation1239496 -Node: PC Binary Installation1240334 -Node: PC Compiling1240769 -Node: PC Using1241886 -Node: Cygwin1245439 -Node: MSYS1246663 -Node: VMS Installation1247265 -Node: VMS Compilation1248056 -Ref: VMS Compilation-Footnote-11249285 -Node: VMS Dynamic Extensions1249343 -Node: VMS Installation Details1251028 -Node: VMS Running1253281 -Node: VMS GNV1257560 -Node: VMS Old Gawk1258295 -Node: Bugs1258766 -Node: Bug address1259429 -Node: Usenet1262411 -Node: Maintainers1263415 -Node: Other Versions1264600 -Node: Installation summary1271688 -Node: Notes1272897 -Node: Compatibility Mode1273691 -Node: Additions1274473 -Node: Accessing The Source1275398 -Node: Adding Code1276835 -Node: New Ports1283054 -Node: Derived Files1287429 -Ref: Derived Files-Footnote-11293089 -Ref: Derived Files-Footnote-21293124 -Ref: Derived Files-Footnote-31293722 -Node: Future Extensions1293836 -Node: Implementation Limitations1294494 -Node: Extension Design1295704 -Node: Old Extension Problems1296848 -Ref: Old Extension Problems-Footnote-11298366 -Node: Extension New Mechanism Goals1298423 -Ref: Extension New Mechanism Goals-Footnote-11301787 -Node: Extension Other Design Decisions1301976 -Node: Extension Future Growth1304089 -Node: Notes summary1304695 -Node: Basic Concepts1305853 -Node: Basic High Level1306534 -Ref: figure-general-flow1306816 -Ref: figure-process-flow1307501 -Ref: Basic High Level-Footnote-11310802 -Node: Basic Data Typing1310987 -Node: Glossary1314315 -Node: Copying1346200 -Node: GNU Free Documentation License1383743 -Node: Index1408863 +Node: Exit Statement464123 +Node: Built-in Variables466526 +Node: User-modified467659 +Node: Auto-set475426 +Ref: Auto-set-Footnote-1492233 +Ref: Auto-set-Footnote-2492439 +Node: ARGC and ARGV492495 +Node: Pattern Action Summary496708 +Node: Arrays499138 +Node: Array Basics500467 +Node: Array Intro501311 +Ref: figure-array-elements503286 +Ref: Array Intro-Footnote-1505990 +Node: Reference to Elements506118 +Node: Assigning Elements508582 +Node: Array Example509073 +Node: Scanning an Array510832 +Node: Controlling Scanning513854 +Ref: Controlling Scanning-Footnote-1520310 +Node: Numeric Array Subscripts520626 +Node: Uninitialized Subscripts522810 +Node: Delete524429 +Ref: Delete-Footnote-1527181 +Node: Multidimensional527238 +Node: Multiscanning530333 +Node: Arrays of Arrays531924 +Node: Arrays Summary536692 +Node: Functions538785 +Node: Built-in539823 +Node: Calling Built-in540904 +Node: Numeric Functions542900 +Ref: Numeric Functions-Footnote-1546926 +Ref: Numeric Functions-Footnote-2547574 +Ref: Numeric Functions-Footnote-3547622 +Node: String Functions547894 +Ref: String Functions-Footnote-1572035 +Ref: String Functions-Footnote-2572163 +Ref: String Functions-Footnote-3572411 +Node: Gory Details572498 +Ref: table-sub-escapes574289 +Ref: table-sub-proposed575808 +Ref: table-posix-sub577171 +Ref: table-gensub-escapes578712 +Ref: Gory Details-Footnote-1579535 +Node: I/O Functions579689 +Ref: table-system-return-values586143 +Ref: I/O Functions-Footnote-1588223 +Ref: I/O Functions-Footnote-2588371 +Node: Time Functions588491 +Ref: Time Functions-Footnote-1599162 +Ref: Time Functions-Footnote-2599230 +Ref: Time Functions-Footnote-3599388 +Ref: Time Functions-Footnote-4599499 +Ref: Time Functions-Footnote-5599611 +Ref: Time Functions-Footnote-6599838 +Node: Bitwise Functions600104 +Ref: table-bitwise-ops600698 +Ref: Bitwise Functions-Footnote-1606761 +Ref: Bitwise Functions-Footnote-2606934 +Node: Type Functions607125 +Node: I18N Functions609988 +Node: User-defined611639 +Node: Definition Syntax612451 +Ref: Definition Syntax-Footnote-1618145 +Node: Function Example618216 +Ref: Function Example-Footnote-1621138 +Node: Function Calling621160 +Node: Calling A Function621748 +Node: Variable Scope622706 +Node: Pass By Value/Reference625700 +Node: Function Caveats628344 +Ref: Function Caveats-Footnote-1630391 +Node: Return Statement630511 +Node: Dynamic Typing633490 +Node: Indirect Calls634420 +Ref: Indirect Calls-Footnote-1644672 +Node: Functions Summary644800 +Node: Library Functions647505 +Ref: Library Functions-Footnote-1651112 +Ref: Library Functions-Footnote-2651255 +Node: Library Names651426 +Ref: Library Names-Footnote-1655093 +Ref: Library Names-Footnote-2655316 +Node: General Functions655402 +Node: Strtonum Function656505 +Node: Assert Function659527 +Node: Round Function662853 +Node: Cliff Random Function664393 +Node: Ordinal Functions665409 +Ref: Ordinal Functions-Footnote-1668472 +Ref: Ordinal Functions-Footnote-2668724 +Node: Join Function668934 +Ref: Join Function-Footnote-1670704 +Node: Getlocaltime Function670904 +Node: Readfile Function674646 +Node: Shell Quoting676623 +Node: Data File Management678024 +Node: Filetrans Function678656 +Node: Rewind Function682752 +Node: File Checking684661 +Ref: File Checking-Footnote-1685995 +Node: Empty Files686196 +Node: Ignoring Assigns688175 +Node: Getopt Function689725 +Ref: Getopt Function-Footnote-1704936 +Node: Passwd Functions705136 +Ref: Passwd Functions-Footnote-1713975 +Node: Group Functions714063 +Ref: Group Functions-Footnote-1721961 +Node: Walking Arrays722168 +Node: Library Functions Summary725176 +Node: Library Exercises726582 +Node: Sample Programs727047 +Node: Running Examples727817 +Node: Clones728545 +Node: Cut Program729769 +Node: Egrep Program739698 +Node: Id Program748709 +Node: Split Program758656 +Ref: Split Program-Footnote-1768430 +Node: Tee Program768603 +Node: Uniq Program771393 +Node: Wc Program778957 +Node: Bytes vs. Characters779354 +Node: Using extensions780902 +Node: wc program781660 +Node: Miscellaneous Programs786525 +Node: Dupword Program787738 +Node: Alarm Program789768 +Node: Translate Program794623 +Ref: Translate Program-Footnote-1799188 +Node: Labels Program799458 +Ref: Labels Program-Footnote-1802809 +Node: Word Sorting802893 +Node: History Sorting806965 +Node: Extract Program809190 +Node: Simple Sed817244 +Node: Igawk Program820318 +Ref: Igawk Program-Footnote-1834649 +Ref: Igawk Program-Footnote-2834851 +Ref: Igawk Program-Footnote-3834973 +Node: Anagram Program835088 +Node: Signature Program838150 +Node: Programs Summary839397 +Node: Programs Exercises840611 +Ref: Programs Exercises-Footnote-1844741 +Node: Advanced Features844827 +Node: Nondecimal Data846817 +Node: Array Sorting848408 +Node: Controlling Array Traversal849108 +Ref: Controlling Array Traversal-Footnote-1857476 +Node: Array Sorting Functions857594 +Ref: Array Sorting Functions-Footnote-1862685 +Node: Two-way I/O862881 +Ref: Two-way I/O-Footnote-1870602 +Ref: Two-way I/O-Footnote-2870789 +Node: TCP/IP Networking870871 +Node: Profiling873989 +Node: Advanced Features Summary883303 +Node: Internationalization885147 +Node: I18N and L10N886627 +Node: Explaining gettext887314 +Ref: Explaining gettext-Footnote-1893206 +Ref: Explaining gettext-Footnote-2893391 +Node: Programmer i18n893556 +Ref: Programmer i18n-Footnote-1898505 +Node: Translator i18n898554 +Node: String Extraction899348 +Ref: String Extraction-Footnote-1900480 +Node: Printf Ordering900566 +Ref: Printf Ordering-Footnote-1903352 +Node: I18N Portability903416 +Ref: I18N Portability-Footnote-1905872 +Node: I18N Example905935 +Ref: I18N Example-Footnote-1909210 +Ref: I18N Example-Footnote-2909283 +Node: Gawk I18N909392 +Node: I18N Summary910041 +Node: Debugger911382 +Node: Debugging912382 +Node: Debugging Concepts912823 +Node: Debugging Terms914632 +Node: Awk Debugging917207 +Ref: Awk Debugging-Footnote-1918152 +Node: Sample Debugging Session918284 +Node: Debugger Invocation918818 +Node: Finding The Bug920204 +Node: List of Debugger Commands926678 +Node: Breakpoint Control928011 +Node: Debugger Execution Control931705 +Node: Viewing And Changing Data935067 +Node: Execution Stack938608 +Node: Debugger Info940245 +Node: Miscellaneous Debugger Commands944316 +Node: Readline Support949378 +Node: Limitations950274 +Node: Debugging Summary952828 +Node: Namespaces954107 +Node: Global Namespace955218 +Node: Qualified Names956616 +Node: Default Namespace957615 +Node: Changing The Namespace958356 +Node: Naming Rules959970 +Node: Internal Name Management961818 +Node: Namespace Example962860 +Node: Namespace And Features965422 +Node: Namespace Summary966857 +Node: Arbitrary Precision Arithmetic968334 +Node: Computer Arithmetic969821 +Ref: table-numeric-ranges973587 +Ref: table-floating-point-ranges974080 +Ref: Computer Arithmetic-Footnote-1974738 +Node: Math Definitions974795 +Ref: table-ieee-formats977771 +Node: MPFR features978338 +Node: FP Math Caution980056 +Ref: FP Math Caution-Footnote-1981128 +Node: Inexactness of computations981497 +Node: Inexact representation982528 +Node: Comparing FP Values983888 +Node: Errors accumulate985129 +Node: Strange values986585 +Ref: Strange values-Footnote-1989148 +Node: Getting Accuracy989253 +Node: Try To Round991963 +Node: Setting precision992862 +Ref: table-predefined-precision-strings993559 +Node: Setting the rounding mode995389 +Ref: table-gawk-rounding-modes995763 +Ref: Setting the rounding mode-Footnote-1999694 +Node: Arbitrary Precision Integers999873 +Ref: Arbitrary Precision Integers-Footnote-11003048 +Node: Checking for MPFR1003197 +Node: POSIX Floating Point Problems1004671 +Ref: POSIX Floating Point Problems-Footnote-11008956 +Node: Floating point summary1008994 +Node: Dynamic Extensions1011184 +Node: Extension Intro1012737 +Node: Plugin License1014003 +Node: Extension Mechanism Outline1014800 +Ref: figure-load-extension1015239 +Ref: figure-register-new-function1016804 +Ref: figure-call-new-function1017896 +Node: Extension API Description1019958 +Node: Extension API Functions Introduction1021671 +Ref: table-api-std-headers1023507 +Node: General Data Types1027756 +Ref: General Data Types-Footnote-11036386 +Node: Memory Allocation Functions1036685 +Ref: Memory Allocation Functions-Footnote-11041186 +Node: Constructor Functions1041285 +Node: API Ownership of MPFR and GMP Values1044751 +Node: Registration Functions1046064 +Node: Extension Functions1046764 +Node: Exit Callback Functions1052086 +Node: Extension Version String1053336 +Node: Input Parsers1053999 +Node: Output Wrappers1066720 +Node: Two-way processors1071232 +Node: Printing Messages1073497 +Ref: Printing Messages-Footnote-11074668 +Node: Updating ERRNO1074821 +Node: Requesting Values1075560 +Ref: table-value-types-returned1076297 +Node: Accessing Parameters1077233 +Node: Symbol Table Access1078470 +Node: Symbol table by name1078982 +Ref: Symbol table by name-Footnote-11082006 +Node: Symbol table by cookie1082134 +Ref: Symbol table by cookie-Footnote-11086319 +Node: Cached values1086383 +Ref: Cached values-Footnote-11089919 +Node: Array Manipulation1090072 +Ref: Array Manipulation-Footnote-11091163 +Node: Array Data Types1091200 +Ref: Array Data Types-Footnote-11093858 +Node: Array Functions1093950 +Node: Flattening Arrays1098448 +Node: Creating Arrays1105424 +Node: Redirection API1110191 +Node: Extension API Variables1113024 +Node: Extension Versioning1113735 +Ref: gawk-api-version1114164 +Node: Extension GMP/MPFR Versioning1115895 +Node: Extension API Informational Variables1117523 +Node: Extension API Boilerplate1118596 +Node: Changes from API V11122570 +Node: Finding Extensions1124142 +Node: Extension Example1124701 +Node: Internal File Description1125499 +Node: Internal File Ops1129579 +Ref: Internal File Ops-Footnote-11140929 +Node: Using Internal File Ops1141069 +Ref: Using Internal File Ops-Footnote-11143452 +Node: Extension Samples1143726 +Node: Extension Sample File Functions1145255 +Node: Extension Sample Fnmatch1152904 +Node: Extension Sample Fork1154391 +Node: Extension Sample Inplace1155609 +Node: Extension Sample Ord1159235 +Node: Extension Sample Readdir1160071 +Ref: table-readdir-file-types1160960 +Node: Extension Sample Revout1162027 +Node: Extension Sample Rev2way1162616 +Node: Extension Sample Read write array1163356 +Node: Extension Sample Readfile1165298 +Node: Extension Sample Time1166393 +Node: Extension Sample API Tests1168145 +Node: gawkextlib1168637 +Node: Extension summary1171555 +Node: Extension Exercises1175257 +Node: Language History1176499 +Node: V7/SVR3.11178155 +Node: SVR41180307 +Node: POSIX1181741 +Node: BTL1183122 +Node: POSIX/GNU1183851 +Node: Feature History1189629 +Node: Common Extensions1205948 +Node: Ranges and Locales1207231 +Ref: Ranges and Locales-Footnote-11211847 +Ref: Ranges and Locales-Footnote-21211874 +Ref: Ranges and Locales-Footnote-31212109 +Node: Contributors1212332 +Node: History summary1218329 +Node: Installation1219709 +Node: Gawk Distribution1220653 +Node: Getting1221137 +Node: Extracting1222100 +Node: Distribution contents1223738 +Node: Unix Installation1230218 +Node: Quick Installation1230900 +Node: Shell Startup Files1233314 +Node: Additional Configuration Options1234403 +Node: Configuration Philosophy1236718 +Node: Non-Unix Installation1239087 +Node: PC Installation1239547 +Node: PC Binary Installation1240385 +Node: PC Compiling1240820 +Node: PC Using1241937 +Node: Cygwin1245490 +Node: MSYS1246714 +Node: VMS Installation1247316 +Node: VMS Compilation1248107 +Ref: VMS Compilation-Footnote-11249336 +Node: VMS Dynamic Extensions1249394 +Node: VMS Installation Details1251079 +Node: VMS Running1253332 +Node: VMS GNV1257611 +Node: VMS Old Gawk1258346 +Node: Bugs1258817 +Node: Bug address1259480 +Node: Usenet1262462 +Node: Maintainers1263466 +Node: Other Versions1264651 +Node: Installation summary1271739 +Node: Notes1272948 +Node: Compatibility Mode1273742 +Node: Additions1274524 +Node: Accessing The Source1275449 +Node: Adding Code1276886 +Node: New Ports1283105 +Node: Derived Files1287480 +Ref: Derived Files-Footnote-11293140 +Ref: Derived Files-Footnote-21293175 +Ref: Derived Files-Footnote-31293773 +Node: Future Extensions1293887 +Node: Implementation Limitations1294545 +Node: Extension Design1295755 +Node: Old Extension Problems1296899 +Ref: Old Extension Problems-Footnote-11298417 +Node: Extension New Mechanism Goals1298474 +Ref: Extension New Mechanism Goals-Footnote-11301838 +Node: Extension Other Design Decisions1302027 +Node: Extension Future Growth1304140 +Node: Notes summary1304746 +Node: Basic Concepts1305904 +Node: Basic High Level1306585 +Ref: figure-general-flow1306867 +Ref: figure-process-flow1307552 +Ref: Basic High Level-Footnote-11310853 +Node: Basic Data Typing1311038 +Node: Glossary1314366 +Node: Copying1346251 +Node: GNU Free Documentation License1383794 +Node: Index1408914 End Tag Table diff --git a/doc/gawk.texi b/doc/gawk.texi index 5d593fde..7943365f 100644 --- a/doc/gawk.texi +++ b/doc/gawk.texi @@ -15513,9 +15513,10 @@ not currently in an @code{END} rule, @code{ARGIND} is incremented, and any @code{BEGINFILE} rules are executed. (@code{ARGIND} hasn't been introduced yet. @xref{Built-in Variables}.) -With @command{gawk}, @code{nextfile} is useful inside a @code{BEGINFILE} +There is an additional, special, use case +with @command{gawk}. @code{nextfile} is useful inside a @code{BEGINFILE} rule to skip over a file that would otherwise cause @command{gawk} -to exit with a fatal error. In this case, @code{ENDFILE} rules are not +to exit with a fatal error. In this special case, @code{ENDFILE} rules are not executed. @xref{BEGINFILE/ENDFILE}. Although it might seem that @samp{close(FILENAME)} would accomplish diff --git a/doc/gawktexi.in b/doc/gawktexi.in index 2c2b12ec..04e16468 100644 --- a/doc/gawktexi.in +++ b/doc/gawktexi.in @@ -14784,9 +14784,10 @@ not currently in an @code{END} rule, @code{ARGIND} is incremented, and any @code{BEGINFILE} rules are executed. (@code{ARGIND} hasn't been introduced yet. @xref{Built-in Variables}.) -With @command{gawk}, @code{nextfile} is useful inside a @code{BEGINFILE} +There is an additional, special, use case +with @command{gawk}. @code{nextfile} is useful inside a @code{BEGINFILE} rule to skip over a file that would otherwise cause @command{gawk} -to exit with a fatal error. In this case, @code{ENDFILE} rules are not +to exit with a fatal error. In this special case, @code{ENDFILE} rules are not executed. @xref{BEGINFILE/ENDFILE}. Although it might seem that @samp{close(FILENAME)} would accomplish |