From 17cb726be0dea75864a89d31054459c02702786e Mon Sep 17 00:00:00 2001 From: "Arnold D. Robbins" Date: Thu, 27 Mar 2014 22:28:23 +0200 Subject: Add note that lookup of PROCINFO can fail. --- doc/ChangeLog | 5 ++ doc/gawk.info | 217 +++++++++++++++++++++++++++++--------------------------- doc/gawk.texi | 7 ++ doc/gawktexi.in | 7 ++ 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 * 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 -- cgit v1.2.1