diff options
Diffstat (limited to 'doc')
| -rw-r--r-- | doc/gawk.info | 157 | ||||
| -rw-r--r-- | doc/gawk.texi | 8 | ||||
| -rw-r--r-- | doc/gawktexi.in | 8 |
3 files changed, 96 insertions, 77 deletions
diff --git a/doc/gawk.info b/doc/gawk.info index ea2a718f..6bff2719 100644 --- a/doc/gawk.info +++ b/doc/gawk.info @@ -24830,7 +24830,8 @@ File: gawk.info, Node: Extension Sample Readfile, Next: Extension Sample API T 16.7.10 Reading An Entire File ------------------------------ -The `readfile' extension adds a single function named `readfile()': +The `readfile' extension adds a single function named `readfile()', and +an input parser: `@load "readfile"' This is how you load the extension. @@ -24840,6 +24841,12 @@ The `readfile' extension adds a single function named `readfile()': a string containing the entire contents of the requested file. Upon error, the function returns the empty string and sets `ERRNO'. +`BEGIN { PROCINFO["readfile"] = 1 }' + In addition, the extension adds an input parser that is activated + if `PROCINFO["readfile"]' exists. When activated, each input file + is returned in its entirety as `$0'. `RT' is set to the null + string. + Here is an example: @load "readfile" @@ -32421,7 +32428,7 @@ Index * readdir extension: Extension Sample Readdir. (line 9) * readfile() extension function: Extension Sample Readfile. - (line 11) + (line 12) * readfile() user-defined function: Readfile Function. (line 30) * reading input files: Reading Files. (line 6) * recipe for a programming language: History. (line 6) @@ -33536,78 +33543,78 @@ 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 +Node: Extension Sample API Tests999117 +Node: Extension Sample Time999642 +Node: gawkextlib1001006 +Node: Language History1003787 +Node: V7/SVR3.11005380 +Node: SVR41007700 +Node: POSIX1009142 +Node: BTL1010528 +Node: POSIX/GNU1011262 +Node: Feature History1016861 +Node: Common Extensions1029837 +Node: Ranges and Locales1031149 +Ref: Ranges and Locales-Footnote-11035766 +Ref: Ranges and Locales-Footnote-21035793 +Ref: Ranges and Locales-Footnote-31036027 +Node: Contributors1036248 +Node: Installation1041629 +Node: Gawk Distribution1042523 +Node: Getting1043007 +Node: Extracting1043833 +Node: Distribution contents1045525 +Node: Unix Installation1051230 +Node: Quick Installation1051847 +Node: Additional Configuration Options1054293 +Node: Configuration Philosophy1056029 +Node: Non-Unix Installation1058383 +Node: PC Installation1058841 +Node: PC Binary Installation1060140 +Node: PC Compiling1061988 +Node: PC Testing1064932 +Node: PC Using1066108 +Node: Cygwin1070276 +Node: MSYS1071085 +Node: VMS Installation1071599 +Node: VMS Compilation1072363 +Ref: VMS Compilation-Footnote-11073615 +Node: VMS Dynamic Extensions1073673 +Node: VMS Installation Details1075046 +Node: VMS Running1077297 +Node: VMS GNV1080131 +Node: VMS Old Gawk1080854 +Node: Bugs1081324 +Node: Other Versions1085242 +Node: Notes1091326 +Node: Compatibility Mode1092126 +Node: Additions1092909 +Node: Accessing The Source1093836 +Node: Adding Code1095276 +Node: New Ports1101321 +Node: Derived Files1105456 +Ref: Derived Files-Footnote-11110777 +Ref: Derived Files-Footnote-21110811 +Ref: Derived Files-Footnote-31111411 +Node: Future Extensions1111509 +Node: Implementation Limitations1112092 +Node: Extension Design1113344 +Node: Old Extension Problems1114498 +Ref: Old Extension Problems-Footnote-11116006 +Node: Extension New Mechanism Goals1116063 +Ref: Extension New Mechanism Goals-Footnote-11119428 +Node: Extension Other Design Decisions1119614 +Node: Extension Future Growth1121720 +Node: Old Extension Mechanism1122556 +Node: Basic Concepts1124296 +Node: Basic High Level1124977 +Ref: figure-general-flow1125248 +Ref: figure-process-flow1125847 +Ref: Basic High Level-Footnote-11129076 +Node: Basic Data Typing1129261 +Node: Glossary1132616 +Node: Copying1157845 +Node: GNU Free Documentation License1195402 +Node: Index1220539 End Tag Table diff --git a/doc/gawk.texi b/doc/gawk.texi index 6c41c99a..139af5f7 100644 --- a/doc/gawk.texi +++ b/doc/gawk.texi @@ -33173,7 +33173,7 @@ ret = reada("arraydump.bin", array) @subsection Reading An Entire File The @code{readfile} extension adds a single function -named @code{readfile()}: +named @code{readfile()}, and an input parser: @table @code @item @@load "readfile" @@ -33184,6 +33184,12 @@ This is how you load the extension. The argument is the name of the file to read. The return value is a string containing the entire contents of the requested file. Upon error, the function returns the empty string and sets @code{ERRNO}. + +@item BEGIN @{ PROCINFO["readfile"] = 1 @} +In addition, the extension adds an input parser that is activated if +@code{PROCINFO["readfile"]} exists. +When activated, each input file is returned in its entirety as @code{$0}. +@code{RT} is set to the null string. @end table Here is an example: diff --git a/doc/gawktexi.in b/doc/gawktexi.in index db949be2..dfdf3434 100644 --- a/doc/gawktexi.in +++ b/doc/gawktexi.in @@ -32314,7 +32314,7 @@ ret = reada("arraydump.bin", array) @subsection Reading An Entire File The @code{readfile} extension adds a single function -named @code{readfile()}: +named @code{readfile()}, and an input parser: @table @code @item @@load "readfile" @@ -32325,6 +32325,12 @@ This is how you load the extension. The argument is the name of the file to read. The return value is a string containing the entire contents of the requested file. Upon error, the function returns the empty string and sets @code{ERRNO}. + +@item BEGIN @{ PROCINFO["readfile"] = 1 @} +In addition, the extension adds an input parser that is activated if +@code{PROCINFO["readfile"]} exists. +When activated, each input file is returned in its entirety as @code{$0}. +@code{RT} is set to the null string. @end table Here is an example: |