More doc updates.

6 files changed, 568 insertions, 528 deletions

diff --git a/README_d/ChangeLog b/README_d/ChangeLog
index 534f409b..4cc3f727 100644
--- a/README_d/ChangeLog
+++ b/README_d/ChangeLog
@@ -1,3 +1,7 @@
+2018-01-25         Arnold D. Robbins     <arnold@skeeve.com>
+
+	* README.macosx: Updated.
+
 2017-11-15         Arnold D. Robbins     <arnold@skeeve.com>
 
 	* README.mpfr: Make separate sections for different ports and
diff --git a/README_d/README.macosx b/README_d/README.macosx
index de9305de..cdeceecc 100644
--- a/README_d/README.macosx
+++ b/README_d/README.macosx
@@ -1,3 +1,10 @@
+Thu Jan 25 20:07:56 IST 2018
+============================
+
+You may need to explicitly tell configure where to find the GNU gettext
+header file and library with --with-libintl-prefix=...'. Otherwise,
+the nlstringtest test will fail.
+
 Fri Dec 23 13:42:58 IST 2016
 ============================
 
diff --git a/doc/ChangeLog b/doc/ChangeLog
index b8ba26a6..581b3d0d 100644
--- a/doc/ChangeLog
+++ b/doc/ChangeLog
@@ -1,5 +1,11 @@
 2018-01-25         Arnold D. Robbins     <arnold@skeeve.com>
 
+	* gawktexi.in (AWKLIBPATH Variable): Add note that changing
+	ENVIRON["AWKLIBPATH"] won't affect the running program. Thanks to
+	Neil R. Ormos <ormos-gnulists17@ormos.org> for the suggestion.
+
+2018-01-25         Arnold D. Robbins     <arnold@skeeve.com>
+
 	* gawktexi.in (gawkextlib): Update discussion of gawkextlib.
 	Add not about json extension, and just present the list as
 	describing some of the extensions, since there are now too
diff --git a/doc/gawk.info b/doc/gawk.info
index ded680ee..b2726536 100644
--- a/doc/gawk.info
+++ b/doc/gawk.info
@@ -3050,6 +3050,13 @@ to manipulate the 'AWKLIBPATH' variable.
 'ENVIRON["AWKLIBPATH"]'.  This provides access to the actual search path
 value from within an 'awk' program.
 
+   Although you can change 'ENVIRON["AWKLIBPATH"]' within your 'awk'
+program, this has no effect on the running program's behavior.  This
+makes sense: the 'AWKLIBPATH' environment variable is used to find any
+requested extensions, and they are loaded before the program starts to
+run.  Once your program is running, all the extensions have been found,
+and 'gawk' no longer needs to use 'AWKLIBPATH'.
+
 
 File: gawk.info,  Node: Other Environment Variables,  Prev: AWKLIBPATH Variable,  Up: Environment Variables
 
@@ -36034,533 +36041,533 @@ Node: AWKPATH Variable139943
 Ref: AWKPATH Variable-Footnote-1143355
 Ref: AWKPATH Variable-Footnote-2143389
 Node: AWKLIBPATH Variable143650
-Node: Other Environment Variables144907
-Node: Exit Status148728
-Node: Include Files149405
-Node: Loading Shared Libraries152930
-Node: Obsolete154358
-Node: Undocumented155050
-Node: Invoking Summary155347
-Node: Regexp157007
-Node: Regexp Usage158461
-Node: Escape Sequences160498
-Node: Regexp Operators166730
-Ref: Regexp Operators-Footnote-1174146
-Ref: Regexp Operators-Footnote-2174293
-Node: Bracket Expressions174391
-Ref: table-char-classes176867
-Node: Leftmost Longest180004
-Node: Computed Regexps181307
-Node: GNU Regexp Operators184734
-Node: Case-sensitivity188413
-Ref: Case-sensitivity-Footnote-1191300
-Ref: Case-sensitivity-Footnote-2191535
-Node: Regexp Summary191643
-Node: Reading Files193109
-Node: Records195378
-Node: awk split records196111
-Node: gawk split records201042
-Ref: gawk split records-Footnote-1205582
-Node: Fields205619
-Node: Nonconstant Fields208360
-Ref: Nonconstant Fields-Footnote-1210596
-Node: Changing Fields210800
-Node: Field Separators216728
-Node: Default Field Splitting219426
-Node: Regexp Field Splitting220544
-Node: Single Character Fields223897
-Node: Command Line Field Separator224957
-Node: Full Line Fields228175
-Ref: Full Line Fields-Footnote-1229697
-Ref: Full Line Fields-Footnote-2229743
-Node: Field Splitting Summary229844
-Node: Constant Size231918
-Node: Fixed width data232650
-Node: Skipping intervening236117
-Node: Allowing trailing data236915
-Node: Fields with fixed data237952
-Node: Splitting By Content239470
-Ref: Splitting By Content-Footnote-1243120
-Node: Testing field creation243283
-Node: Multiple Line244908
-Ref: Multiple Line-Footnote-1250792
-Node: Getline250971
-Node: Plain Getline253440
-Node: Getline/Variable256081
-Node: Getline/File257232
-Node: Getline/Variable/File258620
-Ref: Getline/Variable/File-Footnote-1260225
-Node: Getline/Pipe260313
-Node: Getline/Variable/Pipe263020
-Node: Getline/Coprocess264155
-Node: Getline/Variable/Coprocess265422
-Node: Getline Notes266164
-Node: Getline Summary268961
-Ref: table-getline-variants269385
-Node: Read Timeout270133
-Ref: Read Timeout-Footnote-1274039
-Node: Retrying Input274097
-Node: Command-line directories275296
-Node: Input Summary276202
-Node: Input Exercises279374
-Node: Printing280102
-Node: Print281936
-Node: Print Examples283393
-Node: Output Separators286173
-Node: OFMT288190
-Node: Printf289546
-Node: Basic Printf290331
-Node: Control Letters291905
-Node: Format Modifiers295901
-Node: Printf Examples301916
-Node: Redirection304402
-Node: Special FD311243
-Ref: Special FD-Footnote-1314411
-Node: Special Files314485
-Node: Other Inherited Files315102
-Node: Special Network316103
-Node: Special Caveats316963
-Node: Close Files And Pipes317912
-Ref: table-close-pipe-return-values324819
-Ref: Close Files And Pipes-Footnote-1325632
-Ref: Close Files And Pipes-Footnote-2325780
-Node: Nonfatal325932
-Node: Output Summary328270
-Node: Output Exercises329492
-Node: Expressions330171
-Node: Values331359
-Node: Constants332037
-Node: Scalar Constants332728
-Ref: Scalar Constants-Footnote-1333592
-Node: Nondecimal-numbers333842
-Node: Regexp Constants336843
-Node: Using Constant Regexps337369
-Node: Standard Regexp Constants337991
-Node: Strong Regexp Constants341179
-Node: Variables344137
-Node: Using Variables344794
-Node: Assignment Options346704
-Node: Conversion348577
-Node: Strings And Numbers349101
-Ref: Strings And Numbers-Footnote-1352164
-Node: Locale influences conversions352273
-Ref: table-locale-affects355031
-Node: All Operators355649
-Node: Arithmetic Ops356278
-Node: Concatenation358784
-Ref: Concatenation-Footnote-1361631
-Node: Assignment Ops361738
-Ref: table-assign-ops366729
-Node: Increment Ops368042
-Node: Truth Values and Conditions371502
-Node: Truth Values372576
-Node: Typing and Comparison373624
-Node: Variable Typing374444
-Ref: Variable Typing-Footnote-1380907
-Ref: Variable Typing-Footnote-2380979
-Node: Comparison Operators381056
-Ref: table-relational-ops381475
-Node: POSIX String Comparison384970
-Ref: POSIX String Comparison-Footnote-1386665
-Ref: POSIX String Comparison-Footnote-2386804
-Node: Boolean Ops386888
-Ref: Boolean Ops-Footnote-1391370
-Node: Conditional Exp391462
-Node: Function Calls393198
-Node: Precedence397075
-Node: Locales400734
-Node: Expressions Summary402366
-Node: Patterns and Actions404939
-Node: Pattern Overview406059
-Node: Regexp Patterns407736
-Node: Expression Patterns408278
-Node: Ranges412059
-Node: BEGIN/END415167
-Node: Using BEGIN/END415928
-Ref: Using BEGIN/END-Footnote-1418664
-Node: I/O And BEGIN/END418770
-Node: BEGINFILE/ENDFILE421084
-Node: Empty423997
-Node: Using Shell Variables424314
-Node: Action Overview426588
-Node: Statements428913
-Node: If Statement430761
-Node: While Statement432256
-Node: Do Statement434284
-Node: For Statement435432
-Node: Switch Statement438603
-Node: Break Statement440989
-Node: Continue Statement443081
-Node: Next Statement444908
-Node: Nextfile Statement447291
-Node: Exit Statement449943
-Node: Built-in Variables452346
-Node: User-modified453479
-Node: Auto-set461246
-Ref: Auto-set-Footnote-1477579
-Ref: Auto-set-Footnote-2477785
-Node: ARGC and ARGV477841
-Node: Pattern Action Summary482054
-Node: Arrays484484
-Node: Array Basics485813
-Node: Array Intro486657
-Ref: figure-array-elements488632
-Ref: Array Intro-Footnote-1491336
-Node: Reference to Elements491464
-Node: Assigning Elements493928
-Node: Array Example494419
-Node: Scanning an Array496178
-Node: Controlling Scanning499200
-Ref: Controlling Scanning-Footnote-1504599
-Node: Numeric Array Subscripts504915
-Node: Uninitialized Subscripts507099
-Node: Delete508718
-Ref: Delete-Footnote-1511470
-Node: Multidimensional511527
-Node: Multiscanning514622
-Node: Arrays of Arrays516213
-Node: Arrays Summary520980
-Node: Functions523073
-Node: Built-in524111
-Node: Calling Built-in525192
-Node: Numeric Functions527188
-Ref: Numeric Functions-Footnote-1531216
-Ref: Numeric Functions-Footnote-2531573
-Ref: Numeric Functions-Footnote-3531621
-Node: String Functions531893
-Ref: String Functions-Footnote-1555551
-Ref: String Functions-Footnote-2555679
-Ref: String Functions-Footnote-3555927
-Node: Gory Details556014
-Ref: table-sub-escapes557805
-Ref: table-sub-proposed559324
-Ref: table-posix-sub560687
-Ref: table-gensub-escapes562228
-Ref: Gory Details-Footnote-1563051
-Node: I/O Functions563205
-Ref: table-system-return-values569673
-Ref: I/O Functions-Footnote-1571653
-Ref: I/O Functions-Footnote-2571801
-Node: Time Functions571921
-Ref: Time Functions-Footnote-1582592
-Ref: Time Functions-Footnote-2582660
-Ref: Time Functions-Footnote-3582818
-Ref: Time Functions-Footnote-4582929
-Ref: Time Functions-Footnote-5583041
-Ref: Time Functions-Footnote-6583268
-Node: Bitwise Functions583534
-Ref: table-bitwise-ops584128
-Ref: Bitwise Functions-Footnote-1590173
-Ref: Bitwise Functions-Footnote-2590346
-Node: Type Functions590537
-Node: I18N Functions593288
-Node: User-defined594939
-Node: Definition Syntax595744
-Ref: Definition Syntax-Footnote-1601431
-Node: Function Example601502
-Ref: Function Example-Footnote-1604424
-Node: Function Caveats604446
-Node: Calling A Function604964
-Node: Variable Scope605922
-Node: Pass By Value/Reference608916
-Node: Return Statement612415
-Node: Dynamic Typing615394
-Node: Indirect Calls616324
-Ref: Indirect Calls-Footnote-1626576
-Node: Functions Summary626704
-Node: Library Functions629409
-Ref: Library Functions-Footnote-1633016
-Ref: Library Functions-Footnote-2633159
-Node: Library Names633330
-Ref: Library Names-Footnote-1636790
-Ref: Library Names-Footnote-2637013
-Node: General Functions637099
-Node: Strtonum Function638202
-Node: Assert Function641224
-Node: Round Function644550
-Node: Cliff Random Function646090
-Node: Ordinal Functions647106
-Ref: Ordinal Functions-Footnote-1650169
-Ref: Ordinal Functions-Footnote-2650421
-Node: Join Function650631
-Ref: Join Function-Footnote-1652401
-Node: Getlocaltime Function652601
-Node: Readfile Function656343
-Node: Shell Quoting658320
-Node: Data File Management659721
-Node: Filetrans Function660353
-Node: Rewind Function664449
-Node: File Checking666359
-Ref: File Checking-Footnote-1667693
-Node: Empty Files667894
-Node: Ignoring Assigns669873
-Node: Getopt Function671423
-Ref: Getopt Function-Footnote-1682892
-Node: Passwd Functions683092
-Ref: Passwd Functions-Footnote-1691931
-Node: Group Functions692019
-Ref: Group Functions-Footnote-1699917
-Node: Walking Arrays700124
-Node: Library Functions Summary703132
-Node: Library Exercises704538
-Node: Sample Programs705003
-Node: Running Examples705773
-Node: Clones706501
-Node: Cut Program707725
-Node: Egrep Program717654
-Ref: Egrep Program-Footnote-1725166
-Node: Id Program725276
-Node: Split Program728956
-Ref: Split Program-Footnote-1732414
-Node: Tee Program732543
-Node: Uniq Program735333
-Node: Wc Program742759
-Ref: Wc Program-Footnote-1747014
-Node: Miscellaneous Programs747108
-Node: Dupword Program748321
-Node: Alarm Program750351
-Node: Translate Program755206
-Ref: Translate Program-Footnote-1759771
-Node: Labels Program760041
-Ref: Labels Program-Footnote-1763392
-Node: Word Sorting763476
-Node: History Sorting767548
-Node: Extract Program769383
-Node: Simple Sed776913
-Node: Igawk Program779987
-Ref: Igawk Program-Footnote-1794318
-Ref: Igawk Program-Footnote-2794520
-Ref: Igawk Program-Footnote-3794642
-Node: Anagram Program794757
-Node: Signature Program797819
-Node: Programs Summary799066
-Node: Programs Exercises800280
-Ref: Programs Exercises-Footnote-1804409
-Node: Advanced Features804500
-Node: Nondecimal Data806490
-Node: Array Sorting808081
-Node: Controlling Array Traversal808781
-Ref: Controlling Array Traversal-Footnote-1817149
-Node: Array Sorting Functions817267
-Ref: Array Sorting Functions-Footnote-1822358
-Node: Two-way I/O822554
-Ref: Two-way I/O-Footnote-1829106
-Ref: Two-way I/O-Footnote-2829293
-Node: TCP/IP Networking829375
-Node: Profiling832493
-Ref: Profiling-Footnote-1841165
-Node: Advanced Features Summary841488
-Node: Internationalization843332
-Node: I18N and L10N844812
-Node: Explaining gettext845499
-Ref: Explaining gettext-Footnote-1851391
-Ref: Explaining gettext-Footnote-2851576
-Node: Programmer i18n851741
-Ref: Programmer i18n-Footnote-1856690
-Node: Translator i18n856739
-Node: String Extraction857533
-Ref: String Extraction-Footnote-1858665
-Node: Printf Ordering858751
-Ref: Printf Ordering-Footnote-1861537
-Node: I18N Portability861601
-Ref: I18N Portability-Footnote-1864057
-Node: I18N Example864120
-Ref: I18N Example-Footnote-1866926
-Node: Gawk I18N866999
-Node: I18N Summary867644
-Node: Debugger868985
-Node: Debugging870008
-Node: Debugging Concepts870449
-Node: Debugging Terms872258
-Node: Awk Debugging874833
-Node: Sample Debugging Session875739
-Node: Debugger Invocation876273
-Node: Finding The Bug877659
-Node: List of Debugger Commands884137
-Node: Breakpoint Control885470
-Node: Debugger Execution Control889164
-Node: Viewing And Changing Data892526
-Node: Execution Stack895900
-Node: Debugger Info897537
-Node: Miscellaneous Debugger Commands901608
-Node: Readline Support906670
-Node: Limitations907566
-Node: Debugging Summary909675
-Node: Arbitrary Precision Arithmetic910954
-Node: Computer Arithmetic912439
-Ref: table-numeric-ranges916205
-Ref: table-floating-point-ranges916698
-Ref: Computer Arithmetic-Footnote-1917356
-Node: Math Definitions917413
-Ref: table-ieee-formats920729
-Ref: Math Definitions-Footnote-1921332
-Node: MPFR features921437
-Node: FP Math Caution923155
-Ref: FP Math Caution-Footnote-1924227
-Node: Inexactness of computations924596
-Node: Inexact representation925556
-Node: Comparing FP Values926916
-Node: Errors accumulate927998
-Node: Getting Accuracy929431
-Node: Try To Round932141
-Node: Setting precision933040
-Ref: table-predefined-precision-strings933737
-Node: Setting the rounding mode935567
-Ref: table-gawk-rounding-modes935941
-Ref: Setting the rounding mode-Footnote-1939872
-Node: Arbitrary Precision Integers940051
-Ref: Arbitrary Precision Integers-Footnote-1943226
-Node: Checking for MPFR943375
-Node: POSIX Floating Point Problems944849
-Ref: POSIX Floating Point Problems-Footnote-1948720
-Node: Floating point summary948758
-Node: Dynamic Extensions950948
-Node: Extension Intro952501
-Node: Plugin License953767
-Node: Extension Mechanism Outline954564
-Ref: figure-load-extension955003
-Ref: figure-register-new-function956568
-Ref: figure-call-new-function957660
-Node: Extension API Description959722
-Node: Extension API Functions Introduction961364
-Node: General Data Types966904
-Ref: General Data Types-Footnote-1975265
-Node: Memory Allocation Functions975564
-Ref: Memory Allocation Functions-Footnote-1979774
-Node: Constructor Functions979873
-Node: Registration Functions983459
-Node: Extension Functions984144
-Node: Exit Callback Functions989359
-Node: Extension Version String990609
-Node: Input Parsers991272
-Node: Output Wrappers1003993
-Node: Two-way processors1008505
-Node: Printing Messages1010770
-Ref: Printing Messages-Footnote-11011941
-Node: Updating ERRNO1012094
-Node: Requesting Values1012833
-Ref: table-value-types-returned1013570
-Node: Accessing Parameters1014506
-Node: Symbol Table Access1015741
-Node: Symbol table by name1016253
-Node: Symbol table by cookie1018042
-Ref: Symbol table by cookie-Footnote-11022227
-Node: Cached values1022291
-Ref: Cached values-Footnote-11025827
-Node: Array Manipulation1025980
-Ref: Array Manipulation-Footnote-11027071
-Node: Array Data Types1027108
-Ref: Array Data Types-Footnote-11029766
-Node: Array Functions1029858
-Node: Flattening Arrays1034356
-Node: Creating Arrays1041332
-Node: Redirection API1046099
-Node: Extension API Variables1048932
-Node: Extension Versioning1049643
-Ref: gawk-api-version1050072
-Node: Extension GMP/MPFR Versioning1051803
-Node: Extension API Informational Variables1053431
-Node: Extension API Boilerplate1054504
-Node: Changes from API V11058478
-Node: Finding Extensions1060050
-Node: Extension Example1060609
-Node: Internal File Description1061407
-Node: Internal File Ops1065487
-Ref: Internal File Ops-Footnote-11076837
-Node: Using Internal File Ops1076977
-Ref: Using Internal File Ops-Footnote-11079360
-Node: Extension Samples1079634
-Node: Extension Sample File Functions1081163
-Node: Extension Sample Fnmatch1088812
-Node: Extension Sample Fork1090299
-Node: Extension Sample Inplace1091517
-Node: Extension Sample Ord1094734
-Node: Extension Sample Readdir1095570
-Ref: table-readdir-file-types1096459
-Node: Extension Sample Revout1097264
-Node: Extension Sample Rev2way1097853
-Node: Extension Sample Read write array1098593
-Node: Extension Sample Readfile1100535
-Node: Extension Sample Time1101630
-Node: Extension Sample API Tests1102978
-Node: gawkextlib1103470
-Node: Extension summary1106388
-Node: Extension Exercises1110090
-Node: Language History1111588
-Node: V7/SVR3.11113244
-Node: SVR41115396
-Node: POSIX1116830
-Node: BTL1118210
-Node: POSIX/GNU1118939
-Node: Feature History1124717
-Node: Common Extensions1140576
-Node: Ranges and Locales1141859
-Ref: Ranges and Locales-Footnote-11146475
-Ref: Ranges and Locales-Footnote-21146502
-Ref: Ranges and Locales-Footnote-31146737
-Node: Contributors1146958
-Node: History summary1152903
-Node: Installation1154283
-Node: Gawk Distribution1155227
-Node: Getting1155711
-Node: Extracting1156674
-Node: Distribution contents1158312
-Node: Unix Installation1164792
-Node: Quick Installation1165474
-Node: Shell Startup Files1167888
-Node: Additional Configuration Options1168977
-Node: Configuration Philosophy1171270
-Node: Non-Unix Installation1173639
-Node: PC Installation1174099
-Node: PC Binary Installation1174937
-Node: PC Compiling1175372
-Node: PC Using1176489
-Node: Cygwin1179534
-Node: MSYS1180304
-Node: VMS Installation1180805
-Node: VMS Compilation1181596
-Ref: VMS Compilation-Footnote-11182825
-Node: VMS Dynamic Extensions1182883
-Node: VMS Installation Details1184568
-Node: VMS Running1186821
-Node: VMS GNV1191100
-Node: VMS Old Gawk1191835
-Node: Bugs1192306
-Node: Bug address1192969
-Node: Usenet1195761
-Node: Maintainers1196538
-Node: Other Versions1197799
-Node: Installation summary1204561
-Node: Notes1205763
-Node: Compatibility Mode1206628
-Node: Additions1207410
-Node: Accessing The Source1208335
-Node: Adding Code1209772
-Node: New Ports1215991
-Node: Derived Files1220479
-Ref: Derived Files-Footnote-11226125
-Ref: Derived Files-Footnote-21226160
-Ref: Derived Files-Footnote-31226758
-Node: Future Extensions1226872
-Node: Implementation Limitations1227530
-Node: Extension Design1228713
-Node: Old Extension Problems1229867
-Ref: Old Extension Problems-Footnote-11231385
-Node: Extension New Mechanism Goals1231442
-Ref: Extension New Mechanism Goals-Footnote-11234806
-Node: Extension Other Design Decisions1234995
-Node: Extension Future Growth1237108
-Node: Old Extension Mechanism1237944
-Node: Notes summary1239707
-Node: Basic Concepts1240889
-Node: Basic High Level1241570
-Ref: figure-general-flow1241852
-Ref: figure-process-flow1242537
-Ref: Basic High Level-Footnote-11245838
-Node: Basic Data Typing1246023
-Node: Glossary1249351
-Node: Copying1281189
-Node: GNU Free Documentation License1318732
-Node: Index1343852
+Node: Other Environment Variables145308
+Node: Exit Status149129
+Node: Include Files149806
+Node: Loading Shared Libraries153331
+Node: Obsolete154759
+Node: Undocumented155451
+Node: Invoking Summary155748
+Node: Regexp157408
+Node: Regexp Usage158862
+Node: Escape Sequences160899
+Node: Regexp Operators167131
+Ref: Regexp Operators-Footnote-1174547
+Ref: Regexp Operators-Footnote-2174694
+Node: Bracket Expressions174792
+Ref: table-char-classes177268
+Node: Leftmost Longest180405
+Node: Computed Regexps181708
+Node: GNU Regexp Operators185135
+Node: Case-sensitivity188814
+Ref: Case-sensitivity-Footnote-1191701
+Ref: Case-sensitivity-Footnote-2191936
+Node: Regexp Summary192044
+Node: Reading Files193510
+Node: Records195779
+Node: awk split records196512
+Node: gawk split records201443
+Ref: gawk split records-Footnote-1205983
+Node: Fields206020
+Node: Nonconstant Fields208761
+Ref: Nonconstant Fields-Footnote-1210997
+Node: Changing Fields211201
+Node: Field Separators217129
+Node: Default Field Splitting219827
+Node: Regexp Field Splitting220945
+Node: Single Character Fields224298
+Node: Command Line Field Separator225358
+Node: Full Line Fields228576
+Ref: Full Line Fields-Footnote-1230098
+Ref: Full Line Fields-Footnote-2230144
+Node: Field Splitting Summary230245
+Node: Constant Size232319
+Node: Fixed width data233051
+Node: Skipping intervening236518
+Node: Allowing trailing data237316
+Node: Fields with fixed data238353
+Node: Splitting By Content239871
+Ref: Splitting By Content-Footnote-1243521
+Node: Testing field creation243684
+Node: Multiple Line245309
+Ref: Multiple Line-Footnote-1251193
+Node: Getline251372
+Node: Plain Getline253841
+Node: Getline/Variable256482
+Node: Getline/File257633
+Node: Getline/Variable/File259021
+Ref: Getline/Variable/File-Footnote-1260626
+Node: Getline/Pipe260714
+Node: Getline/Variable/Pipe263421
+Node: Getline/Coprocess264556
+Node: Getline/Variable/Coprocess265823
+Node: Getline Notes266565
+Node: Getline Summary269362
+Ref: table-getline-variants269786
+Node: Read Timeout270534
+Ref: Read Timeout-Footnote-1274440
+Node: Retrying Input274498
+Node: Command-line directories275697
+Node: Input Summary276603
+Node: Input Exercises279775
+Node: Printing280503
+Node: Print282337
+Node: Print Examples283794
+Node: Output Separators286574
+Node: OFMT288591
+Node: Printf289947
+Node: Basic Printf290732
+Node: Control Letters292306
+Node: Format Modifiers296302
+Node: Printf Examples302317
+Node: Redirection304803
+Node: Special FD311644
+Ref: Special FD-Footnote-1314812
+Node: Special Files314886
+Node: Other Inherited Files315503
+Node: Special Network316504
+Node: Special Caveats317364
+Node: Close Files And Pipes318313
+Ref: table-close-pipe-return-values325220
+Ref: Close Files And Pipes-Footnote-1326033
+Ref: Close Files And Pipes-Footnote-2326181
+Node: Nonfatal326333
+Node: Output Summary328671
+Node: Output Exercises329893
+Node: Expressions330572
+Node: Values331760
+Node: Constants332438
+Node: Scalar Constants333129
+Ref: Scalar Constants-Footnote-1333993
+Node: Nondecimal-numbers334243
+Node: Regexp Constants337244
+Node: Using Constant Regexps337770
+Node: Standard Regexp Constants338392
+Node: Strong Regexp Constants341580
+Node: Variables344538
+Node: Using Variables345195
+Node: Assignment Options347105
+Node: Conversion348978
+Node: Strings And Numbers349502
+Ref: Strings And Numbers-Footnote-1352565
+Node: Locale influences conversions352674
+Ref: table-locale-affects355432
+Node: All Operators356050
+Node: Arithmetic Ops356679
+Node: Concatenation359185
+Ref: Concatenation-Footnote-1362032
+Node: Assignment Ops362139
+Ref: table-assign-ops367130
+Node: Increment Ops368443
+Node: Truth Values and Conditions371903
+Node: Truth Values372977
+Node: Typing and Comparison374025
+Node: Variable Typing374845
+Ref: Variable Typing-Footnote-1381308
+Ref: Variable Typing-Footnote-2381380
+Node: Comparison Operators381457
+Ref: table-relational-ops381876
+Node: POSIX String Comparison385371
+Ref: POSIX String Comparison-Footnote-1387066
+Ref: POSIX String Comparison-Footnote-2387205
+Node: Boolean Ops387289
+Ref: Boolean Ops-Footnote-1391771
+Node: Conditional Exp391863
+Node: Function Calls393599
+Node: Precedence397476
+Node: Locales401135
+Node: Expressions Summary402767
+Node: Patterns and Actions405340
+Node: Pattern Overview406460
+Node: Regexp Patterns408137
+Node: Expression Patterns408679
+Node: Ranges412460
+Node: BEGIN/END415568
+Node: Using BEGIN/END416329
+Ref: Using BEGIN/END-Footnote-1419065
+Node: I/O And BEGIN/END419171
+Node: BEGINFILE/ENDFILE421485
+Node: Empty424398
+Node: Using Shell Variables424715
+Node: Action Overview426989
+Node: Statements429314
+Node: If Statement431162
+Node: While Statement432657
+Node: Do Statement434685
+Node: For Statement435833
+Node: Switch Statement439004
+Node: Break Statement441390
+Node: Continue Statement443482
+Node: Next Statement445309
+Node: Nextfile Statement447692
+Node: Exit Statement450344
+Node: Built-in Variables452747
+Node: User-modified453880
+Node: Auto-set461647
+Ref: Auto-set-Footnote-1477980
+Ref: Auto-set-Footnote-2478186
+Node: ARGC and ARGV478242
+Node: Pattern Action Summary482455
+Node: Arrays484885
+Node: Array Basics486214
+Node: Array Intro487058
+Ref: figure-array-elements489033
+Ref: Array Intro-Footnote-1491737
+Node: Reference to Elements491865
+Node: Assigning Elements494329
+Node: Array Example494820
+Node: Scanning an Array496579
+Node: Controlling Scanning499601
+Ref: Controlling Scanning-Footnote-1505000
+Node: Numeric Array Subscripts505316
+Node: Uninitialized Subscripts507500
+Node: Delete509119
+Ref: Delete-Footnote-1511871
+Node: Multidimensional511928
+Node: Multiscanning515023
+Node: Arrays of Arrays516614
+Node: Arrays Summary521381
+Node: Functions523474
+Node: Built-in524512
+Node: Calling Built-in525593
+Node: Numeric Functions527589
+Ref: Numeric Functions-Footnote-1531617
+Ref: Numeric Functions-Footnote-2531974
+Ref: Numeric Functions-Footnote-3532022
+Node: String Functions532294
+Ref: String Functions-Footnote-1555952
+Ref: String Functions-Footnote-2556080
+Ref: String Functions-Footnote-3556328
+Node: Gory Details556415
+Ref: table-sub-escapes558206
+Ref: table-sub-proposed559725
+Ref: table-posix-sub561088
+Ref: table-gensub-escapes562629
+Ref: Gory Details-Footnote-1563452
+Node: I/O Functions563606
+Ref: table-system-return-values570074
+Ref: I/O Functions-Footnote-1572054
+Ref: I/O Functions-Footnote-2572202
+Node: Time Functions572322
+Ref: Time Functions-Footnote-1582993
+Ref: Time Functions-Footnote-2583061
+Ref: Time Functions-Footnote-3583219
+Ref: Time Functions-Footnote-4583330
+Ref: Time Functions-Footnote-5583442
+Ref: Time Functions-Footnote-6583669
+Node: Bitwise Functions583935
+Ref: table-bitwise-ops584529
+Ref: Bitwise Functions-Footnote-1590574
+Ref: Bitwise Functions-Footnote-2590747
+Node: Type Functions590938
+Node: I18N Functions593689
+Node: User-defined595340
+Node: Definition Syntax596145
+Ref: Definition Syntax-Footnote-1601832
+Node: Function Example601903
+Ref: Function Example-Footnote-1604825
+Node: Function Caveats604847
+Node: Calling A Function605365
+Node: Variable Scope606323
+Node: Pass By Value/Reference609317
+Node: Return Statement612816
+Node: Dynamic Typing615795
+Node: Indirect Calls616725
+Ref: Indirect Calls-Footnote-1626977
+Node: Functions Summary627105
+Node: Library Functions629810
+Ref: Library Functions-Footnote-1633417
+Ref: Library Functions-Footnote-2633560
+Node: Library Names633731
+Ref: Library Names-Footnote-1637191
+Ref: Library Names-Footnote-2637414
+Node: General Functions637500
+Node: Strtonum Function638603
+Node: Assert Function641625
+Node: Round Function644951
+Node: Cliff Random Function646491
+Node: Ordinal Functions647507
+Ref: Ordinal Functions-Footnote-1650570
+Ref: Ordinal Functions-Footnote-2650822
+Node: Join Function651032
+Ref: Join Function-Footnote-1652802
+Node: Getlocaltime Function653002
+Node: Readfile Function656744
+Node: Shell Quoting658721
+Node: Data File Management660122
+Node: Filetrans Function660754
+Node: Rewind Function664850
+Node: File Checking666760
+Ref: File Checking-Footnote-1668094
+Node: Empty Files668295
+Node: Ignoring Assigns670274
+Node: Getopt Function671824
+Ref: Getopt Function-Footnote-1683293
+Node: Passwd Functions683493
+Ref: Passwd Functions-Footnote-1692332
+Node: Group Functions692420
+Ref: Group Functions-Footnote-1700318
+Node: Walking Arrays700525
+Node: Library Functions Summary703533
+Node: Library Exercises704939
+Node: Sample Programs705404
+Node: Running Examples706174
+Node: Clones706902
+Node: Cut Program708126
+Node: Egrep Program718055
+Ref: Egrep Program-Footnote-1725567
+Node: Id Program725677
+Node: Split Program729357
+Ref: Split Program-Footnote-1732815
+Node: Tee Program732944
+Node: Uniq Program735734
+Node: Wc Program743160
+Ref: Wc Program-Footnote-1747415
+Node: Miscellaneous Programs747509
+Node: Dupword Program748722
+Node: Alarm Program750752
+Node: Translate Program755607
+Ref: Translate Program-Footnote-1760172
+Node: Labels Program760442
+Ref: Labels Program-Footnote-1763793
+Node: Word Sorting763877
+Node: History Sorting767949
+Node: Extract Program769784
+Node: Simple Sed777314
+Node: Igawk Program780388
+Ref: Igawk Program-Footnote-1794719
+Ref: Igawk Program-Footnote-2794921
+Ref: Igawk Program-Footnote-3795043
+Node: Anagram Program795158
+Node: Signature Program798220
+Node: Programs Summary799467
+Node: Programs Exercises800681
+Ref: Programs Exercises-Footnote-1804810
+Node: Advanced Features804901
+Node: Nondecimal Data806891
+Node: Array Sorting808482
+Node: Controlling Array Traversal809182
+Ref: Controlling Array Traversal-Footnote-1817550
+Node: Array Sorting Functions817668
+Ref: Array Sorting Functions-Footnote-1822759
+Node: Two-way I/O822955
+Ref: Two-way I/O-Footnote-1829507
+Ref: Two-way I/O-Footnote-2829694
+Node: TCP/IP Networking829776
+Node: Profiling832894
+Ref: Profiling-Footnote-1841566
+Node: Advanced Features Summary841889
+Node: Internationalization843733
+Node: I18N and L10N845213
+Node: Explaining gettext845900
+Ref: Explaining gettext-Footnote-1851792
+Ref: Explaining gettext-Footnote-2851977
+Node: Programmer i18n852142
+Ref: Programmer i18n-Footnote-1857091
+Node: Translator i18n857140
+Node: String Extraction857934
+Ref: String Extraction-Footnote-1859066
+Node: Printf Ordering859152
+Ref: Printf Ordering-Footnote-1861938
+Node: I18N Portability862002
+Ref: I18N Portability-Footnote-1864458
+Node: I18N Example864521
+Ref: I18N Example-Footnote-1867327
+Node: Gawk I18N867400
+Node: I18N Summary868045
+Node: Debugger869386
+Node: Debugging870409
+Node: Debugging Concepts870850
+Node: Debugging Terms872659
+Node: Awk Debugging875234
+Node: Sample Debugging Session876140
+Node: Debugger Invocation876674
+Node: Finding The Bug878060
+Node: List of Debugger Commands884538
+Node: Breakpoint Control885871
+Node: Debugger Execution Control889565
+Node: Viewing And Changing Data892927
+Node: Execution Stack896301
+Node: Debugger Info897938
+Node: Miscellaneous Debugger Commands902009
+Node: Readline Support907071
+Node: Limitations907967
+Node: Debugging Summary910076
+Node: Arbitrary Precision Arithmetic911355
+Node: Computer Arithmetic912840
+Ref: table-numeric-ranges916606
+Ref: table-floating-point-ranges917099
+Ref: Computer Arithmetic-Footnote-1917757
+Node: Math Definitions917814
+Ref: table-ieee-formats921130
+Ref: Math Definitions-Footnote-1921733
+Node: MPFR features921838
+Node: FP Math Caution923556
+Ref: FP Math Caution-Footnote-1924628
+Node: Inexactness of computations924997
+Node: Inexact representation925957
+Node: Comparing FP Values927317
+Node: Errors accumulate928399
+Node: Getting Accuracy929832
+Node: Try To Round932542
+Node: Setting precision933441
+Ref: table-predefined-precision-strings934138
+Node: Setting the rounding mode935968
+Ref: table-gawk-rounding-modes936342
+Ref: Setting the rounding mode-Footnote-1940273
+Node: Arbitrary Precision Integers940452
+Ref: Arbitrary Precision Integers-Footnote-1943627
+Node: Checking for MPFR943776
+Node: POSIX Floating Point Problems945250
+Ref: POSIX Floating Point Problems-Footnote-1949121
+Node: Floating point summary949159
+Node: Dynamic Extensions951349
+Node: Extension Intro952902
+Node: Plugin License954168
+Node: Extension Mechanism Outline954965
+Ref: figure-load-extension955404
+Ref: figure-register-new-function956969
+Ref: figure-call-new-function958061
+Node: Extension API Description960123
+Node: Extension API Functions Introduction961765
+Node: General Data Types967305
+Ref: General Data Types-Footnote-1975666
+Node: Memory Allocation Functions975965
+Ref: Memory Allocation Functions-Footnote-1980175
+Node: Constructor Functions980274
+Node: Registration Functions983860
+Node: Extension Functions984545
+Node: Exit Callback Functions989760
+Node: Extension Version String991010
+Node: Input Parsers991673
+Node: Output Wrappers1004394
+Node: Two-way processors1008906
+Node: Printing Messages1011171
+Ref: Printing Messages-Footnote-11012342
+Node: Updating ERRNO1012495
+Node: Requesting Values1013234
+Ref: table-value-types-returned1013971
+Node: Accessing Parameters1014907
+Node: Symbol Table Access1016142
+Node: Symbol table by name1016654
+Node: Symbol table by cookie1018443
+Ref: Symbol table by cookie-Footnote-11022628
+Node: Cached values1022692
+Ref: Cached values-Footnote-11026228
+Node: Array Manipulation1026381
+Ref: Array Manipulation-Footnote-11027472
+Node: Array Data Types1027509
+Ref: Array Data Types-Footnote-11030167
+Node: Array Functions1030259
+Node: Flattening Arrays1034757
+Node: Creating Arrays1041733
+Node: Redirection API1046500
+Node: Extension API Variables1049333
+Node: Extension Versioning1050044
+Ref: gawk-api-version1050473
+Node: Extension GMP/MPFR Versioning1052204
+Node: Extension API Informational Variables1053832
+Node: Extension API Boilerplate1054905
+Node: Changes from API V11058879
+Node: Finding Extensions1060451
+Node: Extension Example1061010
+Node: Internal File Description1061808
+Node: Internal File Ops1065888
+Ref: Internal File Ops-Footnote-11077238
+Node: Using Internal File Ops1077378
+Ref: Using Internal File Ops-Footnote-11079761
+Node: Extension Samples1080035
+Node: Extension Sample File Functions1081564
+Node: Extension Sample Fnmatch1089213
+Node: Extension Sample Fork1090700
+Node: Extension Sample Inplace1091918
+Node: Extension Sample Ord1095135
+Node: Extension Sample Readdir1095971
+Ref: table-readdir-file-types1096860
+Node: Extension Sample Revout1097665
+Node: Extension Sample Rev2way1098254
+Node: Extension Sample Read write array1098994
+Node: Extension Sample Readfile1100936
+Node: Extension Sample Time1102031
+Node: Extension Sample API Tests1103379
+Node: gawkextlib1103871
+Node: Extension summary1106789
+Node: Extension Exercises1110491
+Node: Language History1111989
+Node: V7/SVR3.11113645
+Node: SVR41115797
+Node: POSIX1117231
+Node: BTL1118611
+Node: POSIX/GNU1119340
+Node: Feature History1125118
+Node: Common Extensions1140977
+Node: Ranges and Locales1142260
+Ref: Ranges and Locales-Footnote-11146876
+Ref: Ranges and Locales-Footnote-21146903
+Ref: Ranges and Locales-Footnote-31147138
+Node: Contributors1147359
+Node: History summary1153304
+Node: Installation1154684
+Node: Gawk Distribution1155628
+Node: Getting1156112
+Node: Extracting1157075
+Node: Distribution contents1158713
+Node: Unix Installation1165193
+Node: Quick Installation1165875
+Node: Shell Startup Files1168289
+Node: Additional Configuration Options1169378
+Node: Configuration Philosophy1171671
+Node: Non-Unix Installation1174040
+Node: PC Installation1174500
+Node: PC Binary Installation1175338
+Node: PC Compiling1175773
+Node: PC Using1176890
+Node: Cygwin1179935
+Node: MSYS1180705
+Node: VMS Installation1181206
+Node: VMS Compilation1181997
+Ref: VMS Compilation-Footnote-11183226
+Node: VMS Dynamic Extensions1183284
+Node: VMS Installation Details1184969
+Node: VMS Running1187222
+Node: VMS GNV1191501
+Node: VMS Old Gawk1192236
+Node: Bugs1192707
+Node: Bug address1193370
+Node: Usenet1196162
+Node: Maintainers1196939
+Node: Other Versions1198200
+Node: Installation summary1204962
+Node: Notes1206164
+Node: Compatibility Mode1207029
+Node: Additions1207811
+Node: Accessing The Source1208736
+Node: Adding Code1210173
+Node: New Ports1216392
+Node: Derived Files1220880
+Ref: Derived Files-Footnote-11226526
+Ref: Derived Files-Footnote-21226561
+Ref: Derived Files-Footnote-31227159
+Node: Future Extensions1227273
+Node: Implementation Limitations1227931
+Node: Extension Design1229114
+Node: Old Extension Problems1230268
+Ref: Old Extension Problems-Footnote-11231786
+Node: Extension New Mechanism Goals1231843
+Ref: Extension New Mechanism Goals-Footnote-11235207
+Node: Extension Other Design Decisions1235396
+Node: Extension Future Growth1237509
+Node: Old Extension Mechanism1238345
+Node: Notes summary1240108
+Node: Basic Concepts1241290
+Node: Basic High Level1241971
+Ref: figure-general-flow1242253
+Ref: figure-process-flow1242938
+Ref: Basic High Level-Footnote-11246239
+Node: Basic Data Typing1246424
+Node: Glossary1249752
+Node: Copying1281590
+Node: GNU Free Documentation License1319133
+Node: Index1344253
 
 End Tag Table
diff --git a/doc/gawk.texi b/doc/gawk.texi
index ae6673cd..9b4d392e 100644
--- a/doc/gawk.texi
+++ b/doc/gawk.texi
@@ -4594,6 +4594,14 @@ manipulate the @env{AWKLIBPATH} variable.
 @code{ENVIRON["AWKLIBPATH"]}. This provides access to the actual search
 path value from within an @command{awk} program.
 
+Although you can change @code{ENVIRON["AWKLIBPATH"]} within your
+@command{awk} program, this has no effect on the running program's
+behavior.  This makes sense: the @env{AWKLIBPATH} environment variable
+is used to find any requested extensions, and they are loaded before
+the program starts to run.  Once your program is running, all the
+extensions have been found, and @command{gawk} no longer needs to use
+@env{AWKLIBPATH}.
+
 @node Other Environment Variables
 @subsection Other Environment Variables
 
diff --git a/doc/gawktexi.in b/doc/gawktexi.in
index 2db05902..ce7d62ca 100644
--- a/doc/gawktexi.in
+++ b/doc/gawktexi.in
@@ -4504,6 +4504,14 @@ manipulate the @env{AWKLIBPATH} variable.
 @code{ENVIRON["AWKLIBPATH"]}. This provides access to the actual search
 path value from within an @command{awk} program.
 
+Although you can change @code{ENVIRON["AWKLIBPATH"]} within your
+@command{awk} program, this has no effect on the running program's
+behavior.  This makes sense: the @env{AWKLIBPATH} environment variable
+is used to find any requested extensions, and they are loaded before
+the program starts to run.  Once your program is running, all the
+extensions have been found, and @command{gawk} no longer needs to use
+@env{AWKLIBPATH}.
+
 @node Other Environment Variables
 @subsection Other Environment Variables