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 c0c44864..472b50f7 100644
--- a/doc/gawk.info
+++ b/doc/gawk.info
@@ -28697,7 +28697,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.
@@ -28720,6 +28720,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
@@ -34478,6 +34518,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)
@@ -35626,41 +35667,41 @@ Ref: VMS Compilation-Footnote-11150091
Node: VMS Dynamic Extensions1150149
Node: VMS Installation Details1151834
Node: VMS Running1154087
-Node: VMS GNV1156928
-Node: VMS Old Gawk1157663
-Node: Bugs1158134
-Node: Other Versions1162331
-Node: Installation summary1168917
-Node: Notes1169975
-Node: Compatibility Mode1170840
-Node: Additions1171622
-Node: Accessing The Source1172547
-Node: Adding Code1173983
-Node: New Ports1180202
-Node: Derived Files1184690
-Ref: Derived Files-Footnote-11190175
-Ref: Derived Files-Footnote-21190210
-Ref: Derived Files-Footnote-31190808
-Node: Future Extensions1190922
-Node: Implementation Limitations1191580
-Node: Extension Design1192763
-Node: Old Extension Problems1193917
-Ref: Old Extension Problems-Footnote-11195435
-Node: Extension New Mechanism Goals1195492
-Ref: Extension New Mechanism Goals-Footnote-11198856
-Node: Extension Other Design Decisions1199045
-Node: Extension Future Growth1201158
-Node: Old Extension Mechanism1201994
-Node: Notes summary1203757
-Node: Basic Concepts1204939
-Node: Basic High Level1205620
-Ref: figure-general-flow1205902
-Ref: figure-process-flow1206587
-Ref: Basic High Level-Footnote-11209888
-Node: Basic Data Typing1210073
-Node: Glossary1213401
-Node: Copying1245347
-Node: GNU Free Documentation License1282886
-Node: Index1308004
+Node: VMS GNV1158366
+Node: VMS Old Gawk1159101
+Node: Bugs1159572
+Node: Other Versions1163769
+Node: Installation summary1170355
+Node: Notes1171413
+Node: Compatibility Mode1172278
+Node: Additions1173060
+Node: Accessing The Source1173985
+Node: Adding Code1175421
+Node: New Ports1181640
+Node: Derived Files1186128
+Ref: Derived Files-Footnote-11191613
+Ref: Derived Files-Footnote-21191648
+Ref: Derived Files-Footnote-31192246
+Node: Future Extensions1192360
+Node: Implementation Limitations1193018
+Node: Extension Design1194201
+Node: Old Extension Problems1195355
+Ref: Old Extension Problems-Footnote-11196873
+Node: Extension New Mechanism Goals1196930
+Ref: Extension New Mechanism Goals-Footnote-11200294
+Node: Extension Other Design Decisions1200483
+Node: Extension Future Growth1202596
+Node: Old Extension Mechanism1203432
+Node: Notes summary1205195
+Node: Basic Concepts1206377
+Node: Basic High Level1207058
+Ref: figure-general-flow1207340
+Ref: figure-process-flow1208025
+Ref: Basic High Level-Footnote-11211326
+Node: Basic Data Typing1211511
+Node: Glossary1214839
+Node: Copying1246785
+Node: GNU Free Documentation License1284324
+Node: Index1309442

End Tag Table