[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[gawk-diffs] [SCM] gawk branch, gawk-4.1-stable, updated. gawk-4.1.0-808
From: |
John Malmberg |
Subject: |
[gawk-diffs] [SCM] gawk branch, gawk-4.1-stable, updated. gawk-4.1.0-808-gb6a18e6 |
Date: |
Wed, 03 Feb 2016 02:31:22 +0000 |
This is an automated email from the git hooks/post-receive script. It was
generated because a ref change was pushed to the repository containing
the project "gawk".
The branch, gawk-4.1-stable has been updated
via b6a18e65dfdd0581d3e5b6c4b33503bfe51033db (commit)
from 4a3b33c24dd8d3bcc2776f4403c846beb2de350b (commit)
Those revisions listed above that are new to this repository have
not appeared on any other notification email; so we list those
revisions in full, below.
- Log -----------------------------------------------------------------
http://git.sv.gnu.org/cgit/gawk.git/commit/?id=b6a18e65dfdd0581d3e5b6c4b33503bfe51033db
commit b6a18e65dfdd0581d3e5b6c4b33503bfe51033db
Author: John Malmberg <address@hidden>
Date: Tue Feb 2 20:28:54 2016 -0600
VMS redirection documentation update
diff --git a/doc/ChangeLog b/doc/ChangeLog
index 9ce040b..a57b001 100644
--- a/doc/ChangeLog
+++ b/doc/ChangeLog
@@ -1,3 +1,8 @@
+2016-01-31 John E. Malmberg <address@hidden>
+
+ * gawktexi.in (VMS Running): Add instructions on how to redirect
+ gawk data to a VMS command.
+
2016-01-18 Arnold D. Robbins <address@hidden>
* gawktexi.in (Bracket Expressions): Document that '[', '.' and
diff --git a/doc/gawktexi.in b/doc/gawktexi.in
index 8d721c2..aedfe17 100644
--- a/doc/gawktexi.in
+++ b/doc/gawktexi.in
@@ -37170,8 +37170,8 @@ to the original shell-style interface (see the help
entry for details).
One side effect of dual command-line parsing is that if there is only a
single parameter (as in the quoted string program), the command
becomes ambiguous. To work around this, the normally optional @option{--}
-flag is required to force Unix-style parsing rather than @code{DCL} parsing.
If any
-other dash-type options (or multiple parameters such as @value{DF}s to
+flag is required to force Unix-style parsing rather than @code{DCL} parsing.
+If any other dash-type options (or multiple parameters such as @value{DF}s to
process) are present, there is no ambiguity and @option{--} can be omitted.
@cindex exit status, of VMS
@@ -37189,15 +37189,15 @@ added to the number shifted over by 3 bits to make
room for the severity codes.
To extract the actual @command{gawk} exit code from the VMS status, use:
@example
-unix_status = (vms_status .and. &x7f8) / 8
+unix_status = (vms_status .and. %x7f8) / 8
@end example
@noindent
A C program that uses @code{exec()} to call @command{gawk} will get the
original
Unix-style exit value.
-Older versions of @command{gawk} for VMS treated a Unix exit code 0 as 1, a
failure
-as 2, a fatal error as 4, and passed all the other numbers through.
+Older versions of @command{gawk} for VMS treated a Unix exit code 0 as 1,
+a failure as 2, a fatal error as 4, and passed all the other numbers through.
This violated the VMS exit status coding requirements.
@cindex floating-point, VAX/VMS
@@ -37218,6 +37218,51 @@ of @env{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 @code{RMS} searchlist.
address@hidden redirection
+
+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.
+
+With out this command file, the input data will also appear pre-pended
+to the output data.
+
+This restriction may be removed in a future release of gawk on VMS.
+
+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.
+
address@hidden
+$ sort = "@device:[dir]vms_gawk_sort.com"
address@hidden example
+
+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.
+
address@hidden
+$!'f$verify(0,0)'
+$ sort := sort
+$ define/user sys$input sys$command:
+$ sort sys$input: sys$output:
address@hidden example
+
+
@node VMS GNV
@appendixsubsubsec The VMS GNV Project
@@ -41149,7 +41194,7 @@ Consistency issues:
awk '{
...
}'
-
+
Do show it when showing command-line arguments, data files, etc, even
if there is no output shown.
-----------------------------------------------------------------------
Summary of changes:
doc/ChangeLog | 5 ++++
doc/gawktexi.in | 57 +++++++++++++++++++++++++++++++++++++++++++++++++-----
2 files changed, 56 insertions(+), 6 deletions(-)
hooks/post-receive
--
gawk
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- [gawk-diffs] [SCM] gawk branch, gawk-4.1-stable, updated. gawk-4.1.0-808-gb6a18e6,
John Malmberg <=