diff options
| -rw-r--r-- | doc/ChangeLog | 6 | ||||
| -rw-r--r-- | doc/gawk.info | 115 | ||||
| -rw-r--r-- | doc/gawk.texi | 58 | ||||
| -rw-r--r-- | doc/gawktexi.in | 25 | ||||
| -rw-r--r-- | vms/ChangeLog | 15 |
5 files changed, 156 insertions, 63 deletions
diff --git a/doc/ChangeLog b/doc/ChangeLog index a57b0013..7acbea48 100644 --- a/doc/ChangeLog +++ b/doc/ChangeLog @@ -1,7 +1,11 @@ +2016-02-03 Arnold D. Robbins <arnold@skeeve.com> + + * gawktexi.in (VMS Running): Improve the Texinfo usage. + 2016-01-31 John E. Malmberg <wb8tyw@qsl.net> * gawktexi.in (VMS Running): Add instructions on how to redirect - gawk data to a VMS command. + gawk data to a VMS command. 2016-01-18 Arnold D. Robbins <arnold@skeeve.com> 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 diff --git a/doc/gawk.texi b/doc/gawk.texi index f8c3a859..146a3761 100644 --- a/doc/gawk.texi +++ b/doc/gawk.texi @@ -38079,8 +38079,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 @@ -38098,15 +38098,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 @@ -38127,6 +38127,52 @@ 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. +@cindex redirection on VMS + +This restriction also applies to running @command{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 @command{gawk}. +(This restriction may be removed in a future release of @command{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 @command{gawk} redirecting data to the VMS +@command{sort} command. + +@example +$ sort = "@@device:[dir]vms_gawk_sort.com" +@end 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 @code{sys$input} to be +@code{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 @command{gawk} will be read when the command file ends. + +@example +$!'f$verify(0,0)' +$ sort := sort +$ define/user sys$input sys$command: +$ sort sys$input: sys$output: +@end example + + @node VMS GNV @appendixsubsubsec The VMS GNV Project @@ -42058,7 +42104,7 @@ Consistency issues: awk '{ ... }' - + Do show it when showing command-line arguments, data files, etc, even if there is no output shown. diff --git a/doc/gawktexi.in b/doc/gawktexi.in index aedfe17b..fd2f2825 100644 --- a/doc/gawktexi.in +++ b/doc/gawktexi.in @@ -37218,27 +37218,27 @@ 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. -@cindex redirection +@cindex redirection on VMS -This restriction also applies to running gawk under GNV, as redirection -is always to a DCL command. +This restriction also applies to running @command{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. +a command file before invoking @command{gawk}. +(This restriction may be removed in a future release of @command{gawk} on VMS.) -With out this command file, the input data will also appear pre-pended +Without this command file, the input data will also appear prepended 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. +The example below is for @command{gawk} redirecting data to the VMS +@command{sort} command. @example -$ sort = "@device:[dir]vms_gawk_sort.com" +$ sort = "@@device:[dir]vms_gawk_sort.com" @end example The command file needs to be of the format in the example below. @@ -37249,11 +37249,12 @@ 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 next to the last command redirects @code{sys$input} to be +@code{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. +redirected from @command{gawk} will be read when the command file ends. @example $!'f$verify(0,0)' diff --git a/vms/ChangeLog b/vms/ChangeLog index 3a16319a..203dd9ae 100644 --- a/vms/ChangeLog +++ b/vms/ChangeLog @@ -5,18 +5,19 @@ * vmstest.com: updates Reorganize test lists to make them easier to read and update. - (vms_debug) New command to switch to debug_gawk - New/fixed tests: - (basic) badassign1,dfamb1,exit2,nfloop,badbuild, + (vms_debug): New command to switch to debug_gawk + + New/fixed tests: + (basic): badassign1,dfamb1,exit2,nfloop,badbuild, callparam,exitval2,exitval3,inpref,paramasfunc1, paramasfunc2,regexpbrack,sortglos,rebrackloc aryprm9,nulinsrc,rstest4,rstest5 - (ext) id,profile4,profile5,crlf,dbugeval,fpat4,genpot, + (ext): id,profile4,profile5,crlf,dbugeval,fpat4,genpot, indirectbuiltin,printfbad4,printhuge,profile0, profile6,profile7,regnul1,regnul2,rsgetline, rsglstdin,mbstr2,profile8,watchpoint1,rsstart3 - (locale) backbigs1,backsmalls1,backsmalls2,mbprintf4 - (shlib) inplace2,testext,lc_num1,mbprintf1, + (locale): backbigs1,backsmalls1,backsmalls2,mbprintf4 + (shlib): inplace2,testext,lc_num1,mbprintf1, mbprintf2,mbprintf3,mbprintf4,mbfw1,ordchr2 * vms.h, vms_args.c, vms_cli.c, vms_fwrite.c, vms_misc.c, vms_popen.c: @@ -41,7 +42,7 @@ * generate_config_vms_h_gawk.com: Supress compiler message about comparing an unsigned value to a negative number - in w.missing_d/strftime.c. + in missing_d/strftime.c. * descrip.mms: Temporary comment out the use of bison or yacc until current ports are known to be available for VMS. * build_gawk_pcsi_desc.com: Remove extra copy of a file being |