Add note that lookup of PROCINFO can fail.

4 files changed, 130 insertions, 106 deletions

diff --git a/doc/ChangeLog b/doc/ChangeLog
index 84750e4a..c8781f4e 100644
--- a/doc/ChangeLog
+++ b/doc/ChangeLog
@@ -4,6 +4,11 @@
 	functions are indexed the way I want in TeX and the way Eli
 	wants in Info.
 
+	Unrelated:
+
+	* gawktexi.in: Add a note in extension chapter that lookup of
+	PROCINFO can fail.
+
 2014-03-27         Eli Zaretskii             <eliz@gnu.org>
 
 	* gawktexi.in: First round of massive indexing improvements.
diff --git a/doc/gawk.info b/doc/gawk.info
index 033a804e..ea2a718f 100644
--- a/doc/gawk.info
+++ b/doc/gawk.info
@@ -22812,6 +22812,11 @@ termed a "symbol table".
 However, with the exception of the `PROCINFO' array, an extension
 cannot change any of those variables.
 
+     NOTE: It is possible for the lookup of `PROCINFO' to fail. This
+     happens if the `awk' program being run does not reference
+     `PROCINFO'; in this case `gawk' doesn't bother to create the array
+     and populate it.
+
 
 File: gawk.info,  Node: Symbol table by cookie,  Next: Cached values,  Prev: Symbol table by name,  Up: Symbol Table Access
 
@@ -33498,111 +33503,111 @@ Node: Updating `ERRNO'919058
 Node: Accessing Parameters919797
 Node: Symbol Table Access921027
 Node: Symbol table by name921541
-Node: Symbol table by cookie923290
-Ref: Symbol table by cookie-Footnote-1927422
-Node: Cached values927485
-Ref: Cached values-Footnote-1930975
-Node: Array Manipulation931066
-Ref: Array Manipulation-Footnote-1932164
-Node: Array Data Types932203
-Ref: Array Data Types-Footnote-1934906
-Node: Array Functions934998
-Node: Flattening Arrays938834
-Node: Creating Arrays945686
-Node: Extension API Variables950411
-Node: Extension Versioning951047
-Node: Extension API Informational Variables952948
-Node: Extension API Boilerplate954034
-Node: Finding Extensions957838
-Node: Extension Example958398
-Node: Internal File Description959128
-Node: Internal File Ops963219
-Ref: Internal File Ops-Footnote-1974728
-Node: Using Internal File Ops974868
-Ref: Using Internal File Ops-Footnote-1977221
-Node: Extension Samples977487
-Node: Extension Sample File Functions979011
-Node: Extension Sample Fnmatch987496
-Node: Extension Sample Fork989265
-Node: Extension Sample Inplace990478
-Node: Extension Sample Ord992256
-Node: Extension Sample Readdir993092
-Node: Extension Sample Revout994624
-Node: Extension Sample Rev2way995217
-Node: Extension Sample Read write array995907
-Node: Extension Sample Readfile997790
-Node: Extension Sample API Tests998608
-Node: Extension Sample Time999133
-Node: gawkextlib1000497
-Node: Language History1003278
-Node: V7/SVR3.11004871
-Node: SVR41007191
-Node: POSIX1008633
-Node: BTL1010019
-Node: POSIX/GNU1010753
-Node: Feature History1016352
-Node: Common Extensions1029328
-Node: Ranges and Locales1030640
-Ref: Ranges and Locales-Footnote-11035257
-Ref: Ranges and Locales-Footnote-21035284
-Ref: Ranges and Locales-Footnote-31035518
-Node: Contributors1035739
-Node: Installation1041120
-Node: Gawk Distribution1042014
-Node: Getting1042498
-Node: Extracting1043324
-Node: Distribution contents1045016
-Node: Unix Installation1050721
-Node: Quick Installation1051338
-Node: Additional Configuration Options1053784
-Node: Configuration Philosophy1055520
-Node: Non-Unix Installation1057874
-Node: PC Installation1058332
-Node: PC Binary Installation1059631
-Node: PC Compiling1061479
-Node: PC Testing1064423
-Node: PC Using1065599
-Node: Cygwin1069767
-Node: MSYS1070576
-Node: VMS Installation1071090
-Node: VMS Compilation1071854
-Ref: VMS Compilation-Footnote-11073106
-Node: VMS Dynamic Extensions1073164
-Node: VMS Installation Details1074537
-Node: VMS Running1076788
-Node: VMS GNV1079622
-Node: VMS Old Gawk1080345
-Node: Bugs1080815
-Node: Other Versions1084733
-Node: Notes1090817
-Node: Compatibility Mode1091617
-Node: Additions1092400
-Node: Accessing The Source1093327
-Node: Adding Code1094767
-Node: New Ports1100812
-Node: Derived Files1104947
-Ref: Derived Files-Footnote-11110268
-Ref: Derived Files-Footnote-21110302
-Ref: Derived Files-Footnote-31110902
-Node: Future Extensions1111000
-Node: Implementation Limitations1111583
-Node: Extension Design1112835
-Node: Old Extension Problems1113989
-Ref: Old Extension Problems-Footnote-11115497
-Node: Extension New Mechanism Goals1115554
-Ref: Extension New Mechanism Goals-Footnote-11118919
-Node: Extension Other Design Decisions1119105
-Node: Extension Future Growth1121211
-Node: Old Extension Mechanism1122047
-Node: Basic Concepts1123787
-Node: Basic High Level1124468
-Ref: figure-general-flow1124739
-Ref: figure-process-flow1125338
-Ref: Basic High Level-Footnote-11128567
-Node: Basic Data Typing1128752
-Node: Glossary1132107
-Node: Copying1157336
-Node: GNU Free Documentation License1194893
-Node: Index1220030
+Node: Symbol table by cookie923517
+Ref: Symbol table by cookie-Footnote-1927649
+Node: Cached values927712
+Ref: Cached values-Footnote-1931202
+Node: Array Manipulation931293
+Ref: Array Manipulation-Footnote-1932391
+Node: Array Data Types932430
+Ref: Array Data Types-Footnote-1935133
+Node: Array Functions935225
+Node: Flattening Arrays939061
+Node: Creating Arrays945913
+Node: Extension API Variables950638
+Node: Extension Versioning951274
+Node: Extension API Informational Variables953175
+Node: Extension API Boilerplate954261
+Node: Finding Extensions958065
+Node: Extension Example958625
+Node: Internal File Description959355
+Node: Internal File Ops963446
+Ref: Internal File Ops-Footnote-1974955
+Node: Using Internal File Ops975095
+Ref: Using Internal File Ops-Footnote-1977448
+Node: Extension Samples977714
+Node: Extension Sample File Functions979238
+Node: Extension Sample Fnmatch987723
+Node: Extension Sample Fork989492
+Node: Extension Sample Inplace990705
+Node: Extension Sample Ord992483
+Node: Extension Sample Readdir993319
+Node: Extension Sample Revout994851
+Node: Extension Sample Rev2way995444
+Node: Extension Sample Read write array996134
+Node: Extension Sample Readfile998017
+Node: Extension Sample API Tests998835
+Node: Extension Sample Time999360
+Node: gawkextlib1000724
+Node: Language History1003505
+Node: V7/SVR3.11005098
+Node: SVR41007418
+Node: POSIX1008860
+Node: BTL1010246
+Node: POSIX/GNU1010980
+Node: Feature History1016579
+Node: Common Extensions1029555
+Node: Ranges and Locales1030867
+Ref: Ranges and Locales-Footnote-11035484
+Ref: Ranges and Locales-Footnote-21035511
+Ref: Ranges and Locales-Footnote-31035745
+Node: Contributors1035966
+Node: Installation1041347
+Node: Gawk Distribution1042241
+Node: Getting1042725
+Node: Extracting1043551
+Node: Distribution contents1045243
+Node: Unix Installation1050948
+Node: Quick Installation1051565
+Node: Additional Configuration Options1054011
+Node: Configuration Philosophy1055747
+Node: Non-Unix Installation1058101
+Node: PC Installation1058559
+Node: PC Binary Installation1059858
+Node: PC Compiling1061706
+Node: PC Testing1064650
+Node: PC Using1065826
+Node: Cygwin1069994
+Node: MSYS1070803
+Node: VMS Installation1071317
+Node: VMS Compilation1072081
+Ref: VMS Compilation-Footnote-11073333
+Node: VMS Dynamic Extensions1073391
+Node: VMS Installation Details1074764
+Node: VMS Running1077015
+Node: VMS GNV1079849
+Node: VMS Old Gawk1080572
+Node: Bugs1081042
+Node: Other Versions1084960
+Node: Notes1091044
+Node: Compatibility Mode1091844
+Node: Additions1092627
+Node: Accessing The Source1093554
+Node: Adding Code1094994
+Node: New Ports1101039
+Node: Derived Files1105174
+Ref: Derived Files-Footnote-11110495
+Ref: Derived Files-Footnote-21110529
+Ref: Derived Files-Footnote-31111129
+Node: Future Extensions1111227
+Node: Implementation Limitations1111810
+Node: Extension Design1113062
+Node: Old Extension Problems1114216
+Ref: Old Extension Problems-Footnote-11115724
+Node: Extension New Mechanism Goals1115781
+Ref: Extension New Mechanism Goals-Footnote-11119146
+Node: Extension Other Design Decisions1119332
+Node: Extension Future Growth1121438
+Node: Old Extension Mechanism1122274
+Node: Basic Concepts1124014
+Node: Basic High Level1124695
+Ref: figure-general-flow1124966
+Ref: figure-process-flow1125565
+Ref: Basic High Level-Footnote-11128794
+Node: Basic Data Typing1128979
+Node: Glossary1132334
+Node: Copying1157563
+Node: GNU Free Documentation License1195120
+Node: Index1220257
 
 End Tag Table
diff --git a/doc/gawk.texi b/doc/gawk.texi
index f3c54551..6c41c99a 100644
--- a/doc/gawk.texi
+++ b/doc/gawk.texi
@@ -30923,6 +30923,13 @@ An extension can look up the value of @command{gawk}'s special variables.
 However, with the exception of the @code{PROCINFO} array, an extension
 cannot change any of those variables.
 
+@quotation NOTE
+It is possible for the lookup of @code{PROCINFO} to fail. This happens if
+the @command{awk} program being run does not reference @code{PROCINFO};
+in this case @command{gawk} doesn't bother to create the array and
+populate it.
+@end quotation
+
 @node Symbol table by cookie
 @subsubsection Variable Access and Update by Cookie
 
diff --git a/doc/gawktexi.in b/doc/gawktexi.in
index 7ca73834..db949be2 100644
--- a/doc/gawktexi.in
+++ b/doc/gawktexi.in
@@ -30064,6 +30064,13 @@ An extension can look up the value of @command{gawk}'s special variables.
 However, with the exception of the @code{PROCINFO} array, an extension
 cannot change any of those variables.
 
+@quotation NOTE
+It is possible for the lookup of @code{PROCINFO} to fail. This happens if
+the @command{awk} program being run does not reference @code{PROCINFO};
+in this case @command{gawk} doesn't bother to create the array and
+populate it.
+@end quotation
+
 @node Symbol table by cookie
 @subsubsection Variable Access and Update by Cookie