Update doc with caution about namespaces.

4 files changed, 210 insertions, 186 deletions

diff --git a/doc/ChangeLog b/doc/ChangeLog
index d285f880..66a0b546 100644
--- a/doc/ChangeLog
+++ b/doc/ChangeLog
@@ -1,3 +1,8 @@
+2019-01-25         Arnold D. Robbins     <arnold@skeeve.com>
+
+	* gawktexi.in (Namespaces): Add a cautionary note that the feature
+	is new and may still have dark corners and/or bugs.
+
 2019-01-18         Arnold D. Robbins     <arnold@skeeve.com>
 
 	* gawktexi.in: Finish up indexing changes.
diff --git a/doc/gawk.info b/doc/gawk.info
index 75cd6cbf..4168fc6f 100644
--- a/doc/gawk.info
+++ b/doc/gawk.info
@@ -22734,6 +22734,11 @@ File: gawk.info,  Node: Namespaces,  Next: Arbitrary Precision Arithmetic,  Prev
 
 This major node describes a feature that is specific to 'gawk'.
 
+     CAUTION: This feature described in this chapter is new.  It is
+     entirely possible, and even likely, that there are dark corners (if
+     not bugs) still lurking within the implementation.  If you find any
+     such, please report them (*Note Bugs::).
+
 * Menu:
 
 * Global Namespace::            The global namespace in standard 'awk'.
@@ -37168,191 +37173,191 @@ Node: Readline Support916693
 Node: Limitations917589
 Node: Debugging Summary919698
 Node: Namespaces920977
-Node: Global Namespace921795
-Node: Qualified Names923193
-Node: Default Namespace924192
-Node: Changing The Namespace924933
-Node: Naming Rules926547
-Node: Internal Name Management928395
-Node: Namespace Example929437
-Node: Namespace And Features931999
-Node: Namespace Summary933434
-Node: Arbitrary Precision Arithmetic934911
-Node: Computer Arithmetic936398
-Ref: table-numeric-ranges940164
-Ref: table-floating-point-ranges940657
-Ref: Computer Arithmetic-Footnote-1941315
-Node: Math Definitions941372
-Ref: table-ieee-formats944688
-Ref: Math Definitions-Footnote-1945291
-Node: MPFR features945396
-Node: FP Math Caution947114
-Ref: FP Math Caution-Footnote-1948186
-Node: Inexactness of computations948555
-Node: Inexact representation949515
-Node: Comparing FP Values950875
-Node: Errors accumulate952116
-Node: Getting Accuracy953549
-Node: Try To Round956259
-Node: Setting precision957158
-Ref: table-predefined-precision-strings957855
-Node: Setting the rounding mode959685
-Ref: table-gawk-rounding-modes960059
-Ref: Setting the rounding mode-Footnote-1963990
-Node: Arbitrary Precision Integers964169
-Ref: Arbitrary Precision Integers-Footnote-1967344
-Node: Checking for MPFR967493
-Node: POSIX Floating Point Problems968967
-Ref: POSIX Floating Point Problems-Footnote-1973252
-Node: Floating point summary973290
-Node: Dynamic Extensions975480
-Node: Extension Intro977033
-Node: Plugin License978299
-Node: Extension Mechanism Outline979096
-Ref: figure-load-extension979535
-Ref: figure-register-new-function981100
-Ref: figure-call-new-function982192
-Node: Extension API Description984254
-Node: Extension API Functions Introduction985896
-Ref: table-api-std-headers987732
-Node: General Data Types991597
-Ref: General Data Types-Footnote-1999958
-Node: Memory Allocation Functions1000257
-Ref: Memory Allocation Functions-Footnote-11004467
-Node: Constructor Functions1004566
-Node: Registration Functions1008152
-Node: Extension Functions1008837
-Node: Exit Callback Functions1014159
-Node: Extension Version String1015409
-Node: Input Parsers1016072
-Node: Output Wrappers1028793
-Node: Two-way processors1033305
-Node: Printing Messages1035570
-Ref: Printing Messages-Footnote-11036741
-Node: Updating ERRNO1036894
-Node: Requesting Values1037633
-Ref: table-value-types-returned1038370
-Node: Accessing Parameters1039306
-Node: Symbol Table Access1040541
-Node: Symbol table by name1041053
-Ref: Symbol table by name-Footnote-11044077
-Node: Symbol table by cookie1044205
-Ref: Symbol table by cookie-Footnote-11048390
-Node: Cached values1048454
-Ref: Cached values-Footnote-11051990
-Node: Array Manipulation1052143
-Ref: Array Manipulation-Footnote-11053234
-Node: Array Data Types1053271
-Ref: Array Data Types-Footnote-11055929
-Node: Array Functions1056021
-Node: Flattening Arrays1060519
-Node: Creating Arrays1067495
-Node: Redirection API1072262
-Node: Extension API Variables1075095
-Node: Extension Versioning1075806
-Ref: gawk-api-version1076235
-Node: Extension GMP/MPFR Versioning1077966
-Node: Extension API Informational Variables1079594
-Node: Extension API Boilerplate1080667
-Node: Changes from API V11084641
-Node: Finding Extensions1086213
-Node: Extension Example1086772
-Node: Internal File Description1087570
-Node: Internal File Ops1091650
-Ref: Internal File Ops-Footnote-11103000
-Node: Using Internal File Ops1103140
-Ref: Using Internal File Ops-Footnote-11105523
-Node: Extension Samples1105797
-Node: Extension Sample File Functions1107326
-Node: Extension Sample Fnmatch1114975
-Node: Extension Sample Fork1116462
-Node: Extension Sample Inplace1117680
-Node: Extension Sample Ord1120984
-Node: Extension Sample Readdir1121820
-Ref: table-readdir-file-types1122709
-Node: Extension Sample Revout1123514
-Node: Extension Sample Rev2way1124103
-Node: Extension Sample Read write array1124843
-Node: Extension Sample Readfile1126785
-Node: Extension Sample Time1127880
-Node: Extension Sample API Tests1129228
-Node: gawkextlib1129720
-Node: Extension summary1132638
-Node: Extension Exercises1136340
-Node: Language History1137582
-Node: V7/SVR3.11139238
-Node: SVR41141390
-Node: POSIX1142824
-Node: BTL1144204
-Node: POSIX/GNU1144933
-Node: Feature History1150711
-Node: Common Extensions1166757
-Node: Ranges and Locales1168040
-Ref: Ranges and Locales-Footnote-11172656
-Ref: Ranges and Locales-Footnote-21172683
-Ref: Ranges and Locales-Footnote-31172918
-Node: Contributors1173139
-Node: History summary1179084
-Node: Installation1180464
-Node: Gawk Distribution1181408
-Node: Getting1181892
-Node: Extracting1182855
-Node: Distribution contents1184493
-Node: Unix Installation1190973
-Node: Quick Installation1191655
-Node: Shell Startup Files1194069
-Node: Additional Configuration Options1195158
-Node: Configuration Philosophy1197323
-Node: Non-Unix Installation1199692
-Node: PC Installation1200152
-Node: PC Binary Installation1200990
-Node: PC Compiling1201425
-Node: PC Using1202542
-Node: Cygwin1206095
-Node: MSYS1207194
-Node: VMS Installation1207695
-Node: VMS Compilation1208486
-Ref: VMS Compilation-Footnote-11209715
-Node: VMS Dynamic Extensions1209773
-Node: VMS Installation Details1211458
-Node: VMS Running1213711
-Node: VMS GNV1217990
-Node: VMS Old Gawk1218725
-Node: Bugs1219196
-Node: Bug address1219859
-Node: Usenet1222841
-Node: Maintainers1223845
-Node: Other Versions1225106
-Node: Installation summary1232020
-Node: Notes1233222
-Node: Compatibility Mode1234016
-Node: Additions1234798
-Node: Accessing The Source1235723
-Node: Adding Code1237160
-Node: New Ports1243379
-Node: Derived Files1247867
-Ref: Derived Files-Footnote-11253513
-Ref: Derived Files-Footnote-21253548
-Ref: Derived Files-Footnote-31254146
-Node: Future Extensions1254260
-Node: Implementation Limitations1254918
-Node: Extension Design1256101
-Node: Old Extension Problems1257245
-Ref: Old Extension Problems-Footnote-11258763
-Node: Extension New Mechanism Goals1258820
-Ref: Extension New Mechanism Goals-Footnote-11262184
-Node: Extension Other Design Decisions1262373
-Node: Extension Future Growth1264486
-Node: Notes summary1265322
-Node: Basic Concepts1266497
-Node: Basic High Level1267178
-Ref: figure-general-flow1267460
-Ref: figure-process-flow1268145
-Ref: Basic High Level-Footnote-11271446
-Node: Basic Data Typing1271631
-Node: Glossary1274959
-Node: Copying1306797
-Node: GNU Free Documentation License1344340
-Node: Index1369460
+Node: Global Namespace922056
+Node: Qualified Names923454
+Node: Default Namespace924453
+Node: Changing The Namespace925194
+Node: Naming Rules926808
+Node: Internal Name Management928656
+Node: Namespace Example929698
+Node: Namespace And Features932260
+Node: Namespace Summary933695
+Node: Arbitrary Precision Arithmetic935172
+Node: Computer Arithmetic936659
+Ref: table-numeric-ranges940425
+Ref: table-floating-point-ranges940918
+Ref: Computer Arithmetic-Footnote-1941576
+Node: Math Definitions941633
+Ref: table-ieee-formats944949
+Ref: Math Definitions-Footnote-1945552
+Node: MPFR features945657
+Node: FP Math Caution947375
+Ref: FP Math Caution-Footnote-1948447
+Node: Inexactness of computations948816
+Node: Inexact representation949776
+Node: Comparing FP Values951136
+Node: Errors accumulate952377
+Node: Getting Accuracy953810
+Node: Try To Round956520
+Node: Setting precision957419
+Ref: table-predefined-precision-strings958116
+Node: Setting the rounding mode959946
+Ref: table-gawk-rounding-modes960320
+Ref: Setting the rounding mode-Footnote-1964251
+Node: Arbitrary Precision Integers964430
+Ref: Arbitrary Precision Integers-Footnote-1967605
+Node: Checking for MPFR967754
+Node: POSIX Floating Point Problems969228
+Ref: POSIX Floating Point Problems-Footnote-1973513
+Node: Floating point summary973551
+Node: Dynamic Extensions975741
+Node: Extension Intro977294
+Node: Plugin License978560
+Node: Extension Mechanism Outline979357
+Ref: figure-load-extension979796
+Ref: figure-register-new-function981361
+Ref: figure-call-new-function982453
+Node: Extension API Description984515
+Node: Extension API Functions Introduction986157
+Ref: table-api-std-headers987993
+Node: General Data Types991858
+Ref: General Data Types-Footnote-11000219
+Node: Memory Allocation Functions1000518
+Ref: Memory Allocation Functions-Footnote-11004728
+Node: Constructor Functions1004827
+Node: Registration Functions1008413
+Node: Extension Functions1009098
+Node: Exit Callback Functions1014420
+Node: Extension Version String1015670
+Node: Input Parsers1016333
+Node: Output Wrappers1029054
+Node: Two-way processors1033566
+Node: Printing Messages1035831
+Ref: Printing Messages-Footnote-11037002
+Node: Updating ERRNO1037155
+Node: Requesting Values1037894
+Ref: table-value-types-returned1038631
+Node: Accessing Parameters1039567
+Node: Symbol Table Access1040802
+Node: Symbol table by name1041314
+Ref: Symbol table by name-Footnote-11044338
+Node: Symbol table by cookie1044466
+Ref: Symbol table by cookie-Footnote-11048651
+Node: Cached values1048715
+Ref: Cached values-Footnote-11052251
+Node: Array Manipulation1052404
+Ref: Array Manipulation-Footnote-11053495
+Node: Array Data Types1053532
+Ref: Array Data Types-Footnote-11056190
+Node: Array Functions1056282
+Node: Flattening Arrays1060780
+Node: Creating Arrays1067756
+Node: Redirection API1072523
+Node: Extension API Variables1075356
+Node: Extension Versioning1076067
+Ref: gawk-api-version1076496
+Node: Extension GMP/MPFR Versioning1078227
+Node: Extension API Informational Variables1079855
+Node: Extension API Boilerplate1080928
+Node: Changes from API V11084902
+Node: Finding Extensions1086474
+Node: Extension Example1087033
+Node: Internal File Description1087831
+Node: Internal File Ops1091911
+Ref: Internal File Ops-Footnote-11103261
+Node: Using Internal File Ops1103401
+Ref: Using Internal File Ops-Footnote-11105784
+Node: Extension Samples1106058
+Node: Extension Sample File Functions1107587
+Node: Extension Sample Fnmatch1115236
+Node: Extension Sample Fork1116723
+Node: Extension Sample Inplace1117941
+Node: Extension Sample Ord1121245
+Node: Extension Sample Readdir1122081
+Ref: table-readdir-file-types1122970
+Node: Extension Sample Revout1123775
+Node: Extension Sample Rev2way1124364
+Node: Extension Sample Read write array1125104
+Node: Extension Sample Readfile1127046
+Node: Extension Sample Time1128141
+Node: Extension Sample API Tests1129489
+Node: gawkextlib1129981
+Node: Extension summary1132899
+Node: Extension Exercises1136601
+Node: Language History1137843
+Node: V7/SVR3.11139499
+Node: SVR41141651
+Node: POSIX1143085
+Node: BTL1144465
+Node: POSIX/GNU1145194
+Node: Feature History1150972
+Node: Common Extensions1167018
+Node: Ranges and Locales1168301
+Ref: Ranges and Locales-Footnote-11172917
+Ref: Ranges and Locales-Footnote-21172944
+Ref: Ranges and Locales-Footnote-31173179
+Node: Contributors1173400
+Node: History summary1179345
+Node: Installation1180725
+Node: Gawk Distribution1181669
+Node: Getting1182153
+Node: Extracting1183116
+Node: Distribution contents1184754
+Node: Unix Installation1191234
+Node: Quick Installation1191916
+Node: Shell Startup Files1194330
+Node: Additional Configuration Options1195419
+Node: Configuration Philosophy1197584
+Node: Non-Unix Installation1199953
+Node: PC Installation1200413
+Node: PC Binary Installation1201251
+Node: PC Compiling1201686
+Node: PC Using1202803
+Node: Cygwin1206356
+Node: MSYS1207455
+Node: VMS Installation1207956
+Node: VMS Compilation1208747
+Ref: VMS Compilation-Footnote-11209976
+Node: VMS Dynamic Extensions1210034
+Node: VMS Installation Details1211719
+Node: VMS Running1213972
+Node: VMS GNV1218251
+Node: VMS Old Gawk1218986
+Node: Bugs1219457
+Node: Bug address1220120
+Node: Usenet1223102
+Node: Maintainers1224106
+Node: Other Versions1225367
+Node: Installation summary1232281
+Node: Notes1233483
+Node: Compatibility Mode1234277
+Node: Additions1235059
+Node: Accessing The Source1235984
+Node: Adding Code1237421
+Node: New Ports1243640
+Node: Derived Files1248128
+Ref: Derived Files-Footnote-11253774
+Ref: Derived Files-Footnote-21253809
+Ref: Derived Files-Footnote-31254407
+Node: Future Extensions1254521
+Node: Implementation Limitations1255179
+Node: Extension Design1256362
+Node: Old Extension Problems1257506
+Ref: Old Extension Problems-Footnote-11259024
+Node: Extension New Mechanism Goals1259081
+Ref: Extension New Mechanism Goals-Footnote-11262445
+Node: Extension Other Design Decisions1262634
+Node: Extension Future Growth1264747
+Node: Notes summary1265583
+Node: Basic Concepts1266758
+Node: Basic High Level1267439
+Ref: figure-general-flow1267721
+Ref: figure-process-flow1268406
+Ref: Basic High Level-Footnote-11271707
+Node: Basic Data Typing1271892
+Node: Glossary1275220
+Node: Copying1307058
+Node: GNU Free Documentation License1344601
+Node: Index1369721
 
 End Tag Table
diff --git a/doc/gawk.texi b/doc/gawk.texi
index cae7c399..e56ee61e 100644
--- a/doc/gawk.texi
+++ b/doc/gawk.texi
@@ -31737,6 +31737,13 @@ program being debugged, but occasionally it can.
 
 This @value{CHAPTER} describes a feature that is specific to @command{gawk}.
 
+@quotation CAUTION
+This feature described in this chapter is new.  It is entirely
+possible, and even likely, that there are dark corners (if not bugs)
+still lurking within the implementation. If you find any such,
+please report them (@xref{Bugs}).
+@end quotation
+
 @menu
 * Global Namespace::            The global namespace in standard @command{awk}.
 * Qualified Names::             How to qualify names with a namespace.
diff --git a/doc/gawktexi.in b/doc/gawktexi.in
index ddbe8df5..1b194efe 100644
--- a/doc/gawktexi.in
+++ b/doc/gawktexi.in
@@ -30749,6 +30749,13 @@ program being debugged, but occasionally it can.
 
 This @value{CHAPTER} describes a feature that is specific to @command{gawk}.
 
+@quotation CAUTION
+This feature described in this chapter is new.  It is entirely
+possible, and even likely, that there are dark corners (if not bugs)
+still lurking within the implementation. If you find any such,
+please report them (@xref{Bugs}).
+@end quotation
+
 @menu
 * Global Namespace::            The global namespace in standard @command{awk}.
 * Qualified Names::             How to qualify names with a namespace.