aboutsummaryrefslogtreecommitdiffstats
path: root/doc/gawk.info
diff options
context:
space:
mode:
Diffstat (limited to 'doc/gawk.info')
-rw-r--r--doc/gawk.info115
1 files changed, 78 insertions, 37 deletions
diff --git a/doc/gawk.info b/doc/gawk.info
index 0da0b079..59c1c69e 100644
--- a/doc/gawk.info
+++ b/doc/gawk.info
@@ -28154,7 +28154,7 @@ by 3 bits to make room for the severity codes.
To extract the actual 'gawk' exit code from the VMS status, use:
- unix_status = (vms_status .and. &x7f8) / 8
+ unix_status = (vms_status .and. %x7f8) / 8
A C program that uses 'exec()' to call 'gawk' will get the original
Unix-style exit value.
@@ -28177,6 +28177,46 @@ of 'AWKPATH' is a comma-separated list of directory specifications.
When defining it, the value should be quoted so that it retains a single
translation and not a multitranslation 'RMS' searchlist.
+ This restriction also applies to running 'gawk' under GNV, as
+redirection is always to a DCL command.
+
+ If you are redirecting data to a VMS command or utility, the current
+implementation requires that setting up a VMS foreign command that runs
+a command file before invoking 'gawk'. (This restriction may be removed
+in a future release of 'gawk' on VMS.)
+
+ Without this command file, the input data will also appear prepended
+to the output data.
+
+ This also allows simulating POSIX commands that are not found on VMS
+or the use of GNV utilities.
+
+ The example below is for 'gawk' redirecting data to the VMS 'sort'
+command.
+
+ $ sort = "@device:[dir]vms_gawk_sort.com"
+
+ The command file needs to be of the format in the example below.
+
+ The first line inhibits the passed input data from also showing up in
+the output. It must be in the format in the example.
+
+ The next line creates a foreign command that overrides the outer
+foreign command which prevents an infinite recursion of command files.
+
+ The next to the last command redirects 'sys$input' to be
+'sys$command', in order to pick up the data that is being redirected to
+the command.
+
+ The last line runs the actual command. It must be the last command
+as the data redirected from 'gawk' will be read when the command file
+ends.
+
+ $!'f$verify(0,0)'
+ $ sort := sort
+ $ define/user sys$input sys$command:
+ $ sort sys$input: sys$output:
+

File: gawk.info, Node: VMS GNV, Next: VMS Old Gawk, Prev: VMS Running, Up: VMS Installation
@@ -33930,6 +33970,7 @@ Index
* redirect gawk output, in debugger: Debugger Info. (line 73)
* redirection of input: Getline/File. (line 6)
* redirection of output: Redirection. (line 6)
+* redirection on VMS: VMS Running. (line 64)
* reference counting, sorting arrays: Array Sorting Functions.
(line 77)
* regexp: Regexp. (line 6)
@@ -35071,41 +35112,41 @@ Ref: VMS Compilation-Footnote-11128266
Node: VMS Dynamic Extensions1128324
Node: VMS Installation Details1130009
Node: VMS Running1132262
-Node: VMS GNV1135103
-Node: VMS Old Gawk1135838
-Node: Bugs1136309
-Node: Other Versions1140506
-Node: Installation summary1147092
-Node: Notes1148150
-Node: Compatibility Mode1149015
-Node: Additions1149797
-Node: Accessing The Source1150722
-Node: Adding Code1152158
-Node: New Ports1158377
-Node: Derived Files1162865
-Ref: Derived Files-Footnote-11168350
-Ref: Derived Files-Footnote-21168385
-Ref: Derived Files-Footnote-31168983
-Node: Future Extensions1169097
-Node: Implementation Limitations1169755
-Node: Extension Design1170938
-Node: Old Extension Problems1172092
-Ref: Old Extension Problems-Footnote-11173610
-Node: Extension New Mechanism Goals1173667
-Ref: Extension New Mechanism Goals-Footnote-11177031
-Node: Extension Other Design Decisions1177220
-Node: Extension Future Growth1179333
-Node: Old Extension Mechanism1180169
-Node: Notes summary1181932
-Node: Basic Concepts1183114
-Node: Basic High Level1183795
-Ref: figure-general-flow1184077
-Ref: figure-process-flow1184762
-Ref: Basic High Level-Footnote-11188063
-Node: Basic Data Typing1188248
-Node: Glossary1191576
-Node: Copying1223522
-Node: GNU Free Documentation License1261061
-Node: Index1286179
+Node: VMS GNV1136541
+Node: VMS Old Gawk1137276
+Node: Bugs1137747
+Node: Other Versions1141944
+Node: Installation summary1148530
+Node: Notes1149588
+Node: Compatibility Mode1150453
+Node: Additions1151235
+Node: Accessing The Source1152160
+Node: Adding Code1153596
+Node: New Ports1159815
+Node: Derived Files1164303
+Ref: Derived Files-Footnote-11169788
+Ref: Derived Files-Footnote-21169823
+Ref: Derived Files-Footnote-31170421
+Node: Future Extensions1170535
+Node: Implementation Limitations1171193
+Node: Extension Design1172376
+Node: Old Extension Problems1173530
+Ref: Old Extension Problems-Footnote-11175048
+Node: Extension New Mechanism Goals1175105
+Ref: Extension New Mechanism Goals-Footnote-11178469
+Node: Extension Other Design Decisions1178658
+Node: Extension Future Growth1180771
+Node: Old Extension Mechanism1181607
+Node: Notes summary1183370
+Node: Basic Concepts1184552
+Node: Basic High Level1185233
+Ref: figure-general-flow1185515
+Ref: figure-process-flow1186200
+Ref: Basic High Level-Footnote-11189501
+Node: Basic Data Typing1189686
+Node: Glossary1193014
+Node: Copying1224960
+Node: GNU Free Documentation License1262499
+Node: Index1287617

End Tag Table