aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorArnold D. Robbins <arnold@skeeve.com>2020-11-16 14:36:03 +0200
committerArnold D. Robbins <arnold@skeeve.com>2020-11-16 14:36:03 +0200
commitc190cc7b72f9a0eea27b3455e011c2244d8d337a (patch)
tree2d1e73422d90a092b8393c16d10efeead7618529
parent7d76cb815e02b1ef7bfa640975395935fccb71f8 (diff)
parentd04f08bb8474e44417e739c7a03fb9690a9e22d8 (diff)
downloadegawk-c190cc7b72f9a0eea27b3455e011c2244d8d337a.tar.gz
egawk-c190cc7b72f9a0eea27b3455e011c2244d8d337a.tar.bz2
egawk-c190cc7b72f9a0eea27b3455e011c2244d8d337a.zip
Merge branch 'gawk-5.1-stable'
-rw-r--r--doc/ChangeLog1
-rw-r--r--doc/gawk.info780
-rw-r--r--doc/gawk.texi5
-rw-r--r--doc/gawktexi.in5
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