diff options
| -rw-r--r-- | ChangeLog | 2 | ||||
| -rw-r--r-- | doc/ChangeLog | 4 | ||||
| -rw-r--r-- | doc/gawk.info | 886 | ||||
| -rw-r--r-- | doc/gawk.texi | 50 |
4 files changed, 445 insertions, 497 deletions
@@ -4,7 +4,7 @@ Thu Feb 10 21:31:36 2011 Andreas Buening <andreas.buening@nexgo.de> don't have multiple groups. * protos.h: Move decls for many standard functions here if they aren't in the header files (OS/2) and bracket inside - #ifndef STD_HEADERS. + #ifndef STDC_HEADERS. * io.c (devopen): Remove decl of strtoul. * field.c (set_FIELDWIDTHS): Same. * awk.h: Always include protos.h. diff --git a/doc/ChangeLog b/doc/ChangeLog index 12a4de21..756808b3 100644 --- a/doc/ChangeLog +++ b/doc/ChangeLog @@ -1,3 +1,7 @@ +Thu Feb 10 21:48:18 2011 Pat Rankin <rankin@pactechdata.com> + + * gawk.texi: Update VMS section. + Thu Feb 10 21:31:36 2011 Andreas Buening <andreas.buening@nexgo.de> * gawk.texi: Update OS/2 information. diff --git a/doc/gawk.info b/doc/gawk.info index 51f91d5d..ccb9ac31 100644 --- a/doc/gawk.info +++ b/doc/gawk.info @@ -468,7 +468,6 @@ texts being (a) (see below), and with the Back-Cover Texts being (b) * VMS Compilation:: How to compile `gawk' under VMS. * VMS Installation Details:: How to install `gawk' under VMS. * VMS Running:: How to run `gawk' under VMS. -* VMS POSIX:: Alternate instructions for VMS POSIX. * VMS Old Gawk:: An old version comes with some VMS systems. * Bugs:: Reporting Problems and Bugs. * Other Versions:: Other freely available `awk' @@ -20530,12 +20529,13 @@ B.3.2 How to Compile and Install `gawk' on VMS This node describes how to compile and install `gawk' under VMS. + The older designation "VMS" is used throughout to refer to OpenVMS. + * Menu: * VMS Compilation:: How to compile `gawk' under VMS. * VMS Installation Details:: How to install `gawk' under VMS. * VMS Running:: How to run `gawk' under VMS. -* VMS POSIX:: Alternate instructions for VMS POSIX. * VMS Old Gawk:: An old version comes with some VMS systems. @@ -20555,33 +20555,19 @@ or: $ MMS/DESCRIPTION=[.VMS]DESCRIP.MMS GAWK - Depending upon which C compiler you are using, follow one of the sets -of instructions in this table: - -VAX C V3.x - Use either `vmsbuild.com' or `descrip.mms' as is. These use - `CC/OPTIMIZE=NOLINE', which is essential for Version 3.0. + Older versions of `gawk' could be built with VAX C or GNU C on +VAX/VMS, as well as with DEC C, but that is no longer suported. DEC C +(also briefly known as "Compaq C" and now known as "HP C," but referred +to here as "DEC C") is required. Both `VMSBUILD.COM' and `DESCRIP.MMS' +contain some obsolete support for the older compilers but are set up to +use DEC C by default. -VAX C V2.x - You must have Version 2.3 or 2.4; older ones won't work. Edit - either `vmsbuild.com' or `descrip.mms' according to the comments - in them. For `vmsbuild.com', this just entails removing two `!' - delimiters. Also edit `config.h' (which is a copy of file - `[.config]vms-conf.h') and comment out or delete the two lines - `#define __STDC__ 0' and `#define VAXC_BUILTINS' near the end. + `gawk' has been tested under Alpha/VMS 7.3-1 using Compaq C V6.4, +and on Alpha/VMS 7.3, Alpha/VMS 7.3-2, and IA64/VMS 8.3.(1) -GNU C - Edit `vmsbuild.com' or `descrip.mms'; the changes are different - from those for VAX C V2.x but equally straightforward. No changes - to `config.h' are needed. - -DEC C - Edit `vmsbuild.com' or `descrip.mms' according to their comments. - No changes to `config.h' are needed. + ---------- Footnotes ---------- - `gawk' has been tested under VAX/VMS 5.5-1 using VAX C V3.2, and GNU -C 1.40 and 2.3. It should work without modifications for VMS V4.6 and -up. + (1) The IA64 architecture is also known as "Itanium." File: gawk.info, Node: VMS Installation Details, Next: VMS Running, Prev: VMS Compilation, Up: VMS Installation @@ -20620,11 +20606,11 @@ current directory first, then in the directory specified by the translation of `AWK_LIBRARY' if the file is not found. If, after searching in both directories, the file still is not found, `gawk' appends the suffix `.awk' to the filename and retries the file search. -If `AWK_LIBRARY' is not defined, that portion of the file search fails -benignly. +If `AWK_LIBRARY' has no definition, a default value of `SYS$LIBRARY:' +is used for it. -File: gawk.info, Node: VMS Running, Next: VMS POSIX, Prev: VMS Installation Details, Up: VMS Installation +File: gawk.info, Node: VMS Running, Next: VMS Old Gawk, Prev: VMS Installation Details, Up: VMS Installation B.3.2.3 Running `gawk' on VMS ............................. @@ -20659,39 +20645,9 @@ When defining it, the value should be quoted so that it retains a single translation and not a multitranslation `RMS' searchlist. -File: gawk.info, Node: VMS POSIX, Next: VMS Old Gawk, Prev: VMS Running, Up: VMS Installation - -B.3.2.4 Building and Using `gawk' on VMS POSIX -.............................................. - -Ignore the instructions above, although `vms/gawk.hlp' should still be -made available in a help library. The source tree should be unpacked -into a container file subsystem rather than into the ordinary VMS -filesystem. Make sure that the two scripts, `configure' and -`vms/posix-cc.sh', are executable; use `chmod +x' on them if necessary. -Then execute the following two commands: - - psx> CC=vms/posix-cc.sh configure - psx> make CC=c89 gawk - -The first command constructs files `config.h' and `Makefile' out of -templates, using a script to make the C compiler fit `configure''s -expectations. The second command compiles and links `gawk' using the C -compiler directly; ignore any warnings from `make' about being unable -to redefine `CC'. `configure' takes a very long time to execute, but -at least it provides incremental feedback as it runs. - - This has been tested with VAX/VMS V6.2, VMS POSIX V2.0, and DEC C -V5.2. - - Once built, `gawk' works like any other shell utility. Unlike the -normal VMS port of `gawk', no special command-line manipulation is -needed in the VMS POSIX environment. - - -File: gawk.info, Node: VMS Old Gawk, Prev: VMS POSIX, Up: VMS Installation +File: gawk.info, Node: VMS Old Gawk, Prev: VMS Running, Up: VMS Installation -B.3.2.5 Some VMS Systems Have An Old Version of `gawk' +B.3.2.4 Some VMS Systems Have An Old Version of `gawk' ...................................................... Some versions of VMS have an old version of `gawk'. To access it, @@ -27081,409 +27037,409 @@ Index Tag Table: Node: Top1340 -Node: Foreword30171 -Node: Preface34499 -Ref: Preface-Footnote-137451 -Ref: Preface-Footnote-237557 -Node: History37789 -Node: Names40023 -Ref: Names-Footnote-141500 -Node: This Manual41572 -Ref: This Manual-Footnote-146470 -Node: Conventions46570 -Node: Manual History48686 -Ref: Manual History-Footnote-151864 -Ref: Manual History-Footnote-251905 -Node: How To Contribute51979 -Node: Acknowledgments53123 -Node: Getting Started57371 -Node: Running gawk59750 -Node: One-shot60936 -Node: Read Terminal62161 -Ref: Read Terminal-Footnote-163811 -Ref: Read Terminal-Footnote-264085 -Node: Long64256 -Node: Executable Scripts65632 -Ref: Executable Scripts-Footnote-167493 -Ref: Executable Scripts-Footnote-267595 -Node: Comments68046 -Node: Quoting70513 -Node: DOS Quoting75130 -Node: Sample Data Files75805 -Node: Very Simple78837 -Node: Two Rules83434 -Node: More Complex85581 -Ref: More Complex-Footnote-188511 -Node: Statements/Lines88591 -Ref: Statements/Lines-Footnote-193053 -Node: Other Features93318 -Node: When94187 -Node: Invoking Gawk96330 -Node: Command Line97715 -Node: Options98498 -Ref: Options-Footnote-1111552 -Node: Other Arguments111577 -Node: Naming Standard Input114240 -Node: Environment Variables115204 -Node: AWKPATH Variable115648 -Ref: AWKPATH Variable-Footnote-1118385 -Node: Other Environment Variables118645 -Node: Exit Status120993 -Node: Include Files121668 -Node: Obsolete125059 -Node: Undocumented125745 -Node: Regexp125986 -Node: Regexp Usage127438 -Node: Escape Sequences129464 -Node: Regexp Operators135207 -Ref: Regexp Operators-Footnote-1142379 -Ref: Regexp Operators-Footnote-2142526 -Node: Character Lists142624 -Ref: table-char-classes144399 -Node: GNU Regexp Operators147039 -Node: Case-sensitivity150758 -Ref: Case-sensitivity-Footnote-1153713 -Ref: Case-sensitivity-Footnote-2153948 -Node: Leftmost Longest154056 -Node: Computed Regexps155257 -Node: Locales158674 -Node: Reading Files162216 -Node: Records164157 -Ref: Records-Footnote-1172836 -Node: Fields172873 -Ref: Fields-Footnote-1175905 -Node: Nonconstant Fields175991 -Node: Changing Fields178193 -Node: Field Separators183483 -Node: Default Field Splitting186112 -Node: Regexp Field Splitting187229 -Node: Single Character Fields190587 -Node: Command Line Field Separator191646 -Node: Field Splitting Summary195085 -Ref: Field Splitting Summary-Footnote-1198271 -Node: Constant Size198372 -Node: Splitting By Content202934 -Ref: Splitting By Content-Footnote-1206660 -Node: Multiple Line206700 -Ref: Multiple Line-Footnote-1212547 -Node: Getline212726 -Node: Plain Getline214954 -Node: Getline/Variable217043 -Node: Getline/File218184 -Node: Getline/Variable/File219506 -Ref: Getline/Variable/File-Footnote-1221105 -Node: Getline/Pipe221192 -Node: Getline/Variable/Pipe223740 -Node: Getline/Coprocess224847 -Node: Getline/Variable/Coprocess226090 -Node: Getline Notes226804 -Node: Getline Summary228746 -Ref: table-getline-variants229030 -Node: Command line directories229935 -Node: Printing230560 -Node: Print232191 -Node: Print Examples233528 -Node: Output Separators236312 -Node: OFMT238071 -Node: Printf239429 -Node: Basic Printf240335 -Node: Control Letters241872 -Node: Format Modifiers245684 -Node: Printf Examples251695 -Node: Redirection254410 -Node: Special Files261388 -Node: Special FD261921 -Ref: Special FD-Footnote-1265532 -Node: Special Network265606 -Node: Special Caveats266461 -Node: Close Files And Pipes267255 -Ref: Close Files And Pipes-Footnote-1274199 -Ref: Close Files And Pipes-Footnote-2274347 -Node: Expressions274497 -Node: Values275566 -Node: Constants276242 -Node: Scalar Constants276922 -Ref: Scalar Constants-Footnote-1277781 -Node: Nondecimal-numbers277963 -Node: Regexp Constants281022 -Node: Using Constant Regexps281497 -Node: Variables284502 -Node: Using Variables285157 -Node: Assignment Options286884 -Node: Conversion288765 -Ref: table-locale-affects294139 -Ref: Conversion-Footnote-1294763 -Node: All Operators294872 -Node: Arithmetic Ops295502 -Node: Concatenation298008 -Ref: Concatenation-Footnote-1300801 -Node: Assignment Ops300920 -Ref: table-assign-ops305908 -Node: Increment Ops307316 -Node: Truth Values and Conditions310794 -Node: Truth Values311877 -Node: Typing and Comparison312925 -Node: Variable Typing313714 -Ref: Variable Typing-Footnote-1317611 -Node: Comparison Operators317733 -Ref: table-relational-ops318143 -Node: POSIX String Comparison321692 -Ref: POSIX String Comparison-Footnote-1322649 -Node: Boolean Ops322787 -Ref: Boolean Ops-Footnote-1326865 -Node: Conditional Exp326956 -Node: Function Calls328688 -Node: Precedence332278 -Node: Patterns and Actions335931 -Node: Pattern Overview336985 -Node: Regexp Patterns338651 -Node: Expression Patterns339194 -Node: Ranges342768 -Node: BEGIN/END345734 -Node: Using BEGIN/END346484 -Ref: Using BEGIN/END-Footnote-1349215 -Node: I/O And BEGIN/END349329 -Node: Empty351598 -Node: BEGINFILE/ENDFILE351932 -Node: Using Shell Variables354757 -Node: Action Overview357036 -Node: Statements359393 -Node: If Statement361252 -Node: While Statement362751 -Node: Do Statement364795 -Node: For Statement365951 -Node: Switch Statement369103 -Node: Break Statement371200 -Node: Continue Statement373176 -Node: Next Statement374877 -Node: Nextfile Statement377259 -Node: Exit Statement379784 -Node: Built-in Variables382115 -Node: User-modified383210 -Ref: User-modified-Footnote-1391211 -Node: Auto-set391273 -Ref: Auto-set-Footnote-1400537 -Node: ARGC and ARGV400742 -Node: Arrays404501 -Node: Array Basics406072 -Node: Array Intro406783 -Node: Reference to Elements411101 -Node: Assigning Elements413371 -Node: Array Example413862 -Node: Scanning an Array415594 -Node: Delete419042 -Ref: Delete-Footnote-1421473 -Node: Numeric Array Subscripts421530 -Node: Uninitialized Subscripts423713 -Node: Multi-dimensional425341 -Node: Multi-scanning428432 -Node: Array Sorting430016 -Ref: Array Sorting-Footnote-1433214 -Node: Arrays of Arrays433408 -Node: Functions437946 -Node: Built-in438768 -Node: Calling Built-in439846 -Node: Numeric Functions441822 -Ref: Numeric Functions-Footnote-1445579 -Ref: Numeric Functions-Footnote-2445915 -Ref: Numeric Functions-Footnote-3445963 -Node: String Functions446232 -Ref: String Functions-Footnote-1468038 -Ref: String Functions-Footnote-2468167 -Ref: String Functions-Footnote-3468415 -Node: Gory Details468502 -Ref: table-sub-escapes470159 -Ref: table-posix-sub471473 -Ref: table-gensub-escapes472373 -Node: I/O Functions473544 -Ref: I/O Functions-Footnote-1480239 -Node: Time Functions480386 -Ref: Time Functions-Footnote-1491253 -Ref: Time Functions-Footnote-2491321 -Ref: Time Functions-Footnote-3491479 -Ref: Time Functions-Footnote-4491590 -Ref: Time Functions-Footnote-5491702 -Ref: Time Functions-Footnote-6491929 -Node: Bitwise Functions492195 -Ref: table-bitwise-ops492753 -Ref: Bitwise Functions-Footnote-1496913 -Node: Type Functions497097 -Node: I18N Functions497535 -Node: User-defined499162 -Node: Definition Syntax499966 -Ref: Definition Syntax-Footnote-1504603 -Node: Function Example504672 -Node: Function Caveats507266 -Node: Calling A Function507687 -Node: Variable Scope508802 -Node: Pass By Value/Reference510730 -Node: Return Statement514170 -Node: Dynamic Typing517112 -Node: Indirect Calls517849 -Node: Internationalization527534 -Node: I18N and L10N528962 -Node: Explaining gettext529648 -Ref: Explaining gettext-Footnote-1534710 -Ref: Explaining gettext-Footnote-2534893 -Node: Programmer i18n535058 -Node: Translator i18n539349 -Node: String Extraction540142 -Ref: String Extraction-Footnote-1541103 -Node: Printf Ordering541189 -Ref: Printf Ordering-Footnote-1543973 -Node: I18N Portability544037 -Ref: I18N Portability-Footnote-1546486 -Node: I18N Example546549 -Ref: I18N Example-Footnote-1549184 -Node: Gawk I18N549256 -Node: Advanced Features549873 -Node: Nondecimal Data551192 -Node: Two-way I/O552773 -Ref: Two-way I/O-Footnote-1558187 -Node: TCP/IP Networking558264 -Node: Profiling561107 -Node: Library Functions568507 -Ref: Library Functions-Footnote-1571546 -Node: Library Names571717 -Ref: Library Names-Footnote-1575188 -Ref: Library Names-Footnote-2575408 -Node: General Functions575494 -Node: Nextfile Function576557 -Node: Strtonum Function580938 -Node: Assert Function583889 -Node: Round Function587215 -Node: Cliff Random Function588756 -Node: Ordinal Functions589772 -Ref: Ordinal Functions-Footnote-1592842 -Ref: Ordinal Functions-Footnote-2593094 -Node: Join Function593310 -Ref: Join Function-Footnote-1595081 -Node: Gettimeofday Function595281 -Node: Data File Management598996 -Node: Filetrans Function599628 -Node: Rewind Function603865 -Node: File Checking605318 -Node: Empty Files606412 -Node: Ignoring Assigns608642 -Node: Getopt Function610195 -Ref: Getopt Function-Footnote-1621520 -Node: Passwd Functions621723 -Ref: Passwd Functions-Footnote-1630711 -Node: Group Functions630799 -Node: Walking Arrays638902 -Node: Sample Programs640468 -Node: Running Examples641133 -Node: Clones641861 -Node: Cut Program642984 -Node: Egrep Program652825 -Ref: Egrep Program-Footnote-1660596 -Node: Id Program660706 -Node: Split Program664322 -Ref: Split Program-Footnote-1667841 -Node: Tee Program667969 -Node: Uniq Program670772 -Node: Wc Program678195 -Ref: Wc Program-Footnote-1682459 -Node: Miscellaneous Programs682659 -Node: Dupword Program683847 -Node: Alarm Program685878 -Node: Translate Program690600 -Ref: Translate Program-Footnote-1694979 -Ref: Translate Program-Footnote-2695207 -Node: Labels Program695341 -Ref: Labels Program-Footnote-1698712 -Node: Word Sorting698796 -Node: History Sorting703141 -Node: Extract Program704979 -Ref: Extract Program-Footnote-1712460 -Node: Simple Sed712588 -Node: Igawk Program715650 -Ref: Igawk Program-Footnote-1730682 -Ref: Igawk Program-Footnote-2730883 -Node: Anagram Program731021 -Node: Signature Program734119 -Node: Debugger735222 -Node: Debugging736133 -Node: Debugging Concepts736447 -Node: Debugging Terms738303 -Node: Awk Debugging740848 -Node: Sample dgawk session741740 -Node: dgawk invocation742232 -Node: Finding The Bug743414 -Node: List of Debugger Commands749898 -Node: Breakpoint Control751209 -Node: Dgawk Execution Control754685 -Node: Viewing And Changing Data758036 -Node: Dgawk Stack761345 -Node: Dgawk Info762805 -Node: Miscellaneous Dgawk Commands766753 -Node: Readline Support772181 -Node: Dgawk Limitations773008 -Node: Language History775147 -Node: V7/SVR3.1776579 -Node: SVR4778874 -Node: POSIX780316 -Node: BTL781314 -Node: POSIX/GNU782048 -Node: Common Extensions787234 -Node: Contributors788367 -Node: Installation792402 -Node: Gawk Distribution793296 -Node: Getting793780 -Node: Extracting794606 -Node: Distribution contents796284 -Node: Unix Installation801302 -Node: Quick Installation801919 -Node: Additional Configuration Options803881 -Node: Configuration Philosophy805358 -Node: Non-Unix Installation807700 -Node: PC Installation808158 -Node: PC Binary Installation809457 -Node: PC Compiling811305 -Node: PC Testing814249 -Node: PC Using815425 -Node: Cygwin819610 -Node: MSYS820607 -Node: VMS Installation821121 -Node: VMS Compilation821725 -Node: VMS Installation Details823302 -Node: VMS Running824932 -Node: VMS POSIX826529 -Node: VMS Old Gawk827827 -Node: Bugs828299 -Node: Other Versions832164 -Node: Notes837443 -Node: Compatibility Mode838135 -Node: Additions838918 -Node: Accessing The Source839730 -Node: Adding Code841153 -Node: New Ports846701 -Node: Dynamic Extensions850814 -Node: Internals852190 -Node: Plugin License861306 -Node: Sample Library861940 -Node: Internal File Description862626 -Node: Internal File Ops866333 -Ref: Internal File Ops-Footnote-1871101 -Node: Using Internal File Ops871249 -Node: Future Extensions873626 -Node: Basic Concepts876130 -Node: Basic High Level876887 -Ref: Basic High Level-Footnote-1880922 -Node: Basic Data Typing881107 -Node: Floating Point Issues885632 -Node: String Conversion Precision886715 -Ref: String Conversion Precision-Footnote-1888409 -Node: Unexpected Results888518 -Node: POSIX Floating Point Problems890344 -Ref: POSIX Floating Point Problems-Footnote-1894040 -Node: Glossary894078 -Node: Copying918177 -Node: GNU Free Documentation License955734 -Node: next-edition980878 -Node: unresolved981230 -Node: revision981730 -Node: consistency982153 -Node: Index985652 +Node: Foreword30098 +Node: Preface34426 +Ref: Preface-Footnote-137378 +Ref: Preface-Footnote-237484 +Node: History37716 +Node: Names39950 +Ref: Names-Footnote-141427 +Node: This Manual41499 +Ref: This Manual-Footnote-146397 +Node: Conventions46497 +Node: Manual History48613 +Ref: Manual History-Footnote-151791 +Ref: Manual History-Footnote-251832 +Node: How To Contribute51906 +Node: Acknowledgments53050 +Node: Getting Started57298 +Node: Running gawk59677 +Node: One-shot60863 +Node: Read Terminal62088 +Ref: Read Terminal-Footnote-163738 +Ref: Read Terminal-Footnote-264012 +Node: Long64183 +Node: Executable Scripts65559 +Ref: Executable Scripts-Footnote-167420 +Ref: Executable Scripts-Footnote-267522 +Node: Comments67973 +Node: Quoting70440 +Node: DOS Quoting75057 +Node: Sample Data Files75732 +Node: Very Simple78764 +Node: Two Rules83361 +Node: More Complex85508 +Ref: More Complex-Footnote-188438 +Node: Statements/Lines88518 +Ref: Statements/Lines-Footnote-192980 +Node: Other Features93245 +Node: When94114 +Node: Invoking Gawk96257 +Node: Command Line97642 +Node: Options98425 +Ref: Options-Footnote-1111479 +Node: Other Arguments111504 +Node: Naming Standard Input114167 +Node: Environment Variables115131 +Node: AWKPATH Variable115575 +Ref: AWKPATH Variable-Footnote-1118312 +Node: Other Environment Variables118572 +Node: Exit Status120920 +Node: Include Files121595 +Node: Obsolete124986 +Node: Undocumented125672 +Node: Regexp125913 +Node: Regexp Usage127365 +Node: Escape Sequences129391 +Node: Regexp Operators135134 +Ref: Regexp Operators-Footnote-1142306 +Ref: Regexp Operators-Footnote-2142453 +Node: Character Lists142551 +Ref: table-char-classes144326 +Node: GNU Regexp Operators146966 +Node: Case-sensitivity150685 +Ref: Case-sensitivity-Footnote-1153640 +Ref: Case-sensitivity-Footnote-2153875 +Node: Leftmost Longest153983 +Node: Computed Regexps155184 +Node: Locales158601 +Node: Reading Files162143 +Node: Records164084 +Ref: Records-Footnote-1172763 +Node: Fields172800 +Ref: Fields-Footnote-1175832 +Node: Nonconstant Fields175918 +Node: Changing Fields178120 +Node: Field Separators183410 +Node: Default Field Splitting186039 +Node: Regexp Field Splitting187156 +Node: Single Character Fields190514 +Node: Command Line Field Separator191573 +Node: Field Splitting Summary195012 +Ref: Field Splitting Summary-Footnote-1198198 +Node: Constant Size198299 +Node: Splitting By Content202861 +Ref: Splitting By Content-Footnote-1206587 +Node: Multiple Line206627 +Ref: Multiple Line-Footnote-1212474 +Node: Getline212653 +Node: Plain Getline214881 +Node: Getline/Variable216970 +Node: Getline/File218111 +Node: Getline/Variable/File219433 +Ref: Getline/Variable/File-Footnote-1221032 +Node: Getline/Pipe221119 +Node: Getline/Variable/Pipe223667 +Node: Getline/Coprocess224774 +Node: Getline/Variable/Coprocess226017 +Node: Getline Notes226731 +Node: Getline Summary228673 +Ref: table-getline-variants228957 +Node: Command line directories229862 +Node: Printing230487 +Node: Print232118 +Node: Print Examples233455 +Node: Output Separators236239 +Node: OFMT237998 +Node: Printf239356 +Node: Basic Printf240262 +Node: Control Letters241799 +Node: Format Modifiers245611 +Node: Printf Examples251622 +Node: Redirection254337 +Node: Special Files261315 +Node: Special FD261848 +Ref: Special FD-Footnote-1265459 +Node: Special Network265533 +Node: Special Caveats266388 +Node: Close Files And Pipes267182 +Ref: Close Files And Pipes-Footnote-1274126 +Ref: Close Files And Pipes-Footnote-2274274 +Node: Expressions274424 +Node: Values275493 +Node: Constants276169 +Node: Scalar Constants276849 +Ref: Scalar Constants-Footnote-1277708 +Node: Nondecimal-numbers277890 +Node: Regexp Constants280949 +Node: Using Constant Regexps281424 +Node: Variables284429 +Node: Using Variables285084 +Node: Assignment Options286811 +Node: Conversion288692 +Ref: table-locale-affects294066 +Ref: Conversion-Footnote-1294690 +Node: All Operators294799 +Node: Arithmetic Ops295429 +Node: Concatenation297935 +Ref: Concatenation-Footnote-1300728 +Node: Assignment Ops300847 +Ref: table-assign-ops305835 +Node: Increment Ops307243 +Node: Truth Values and Conditions310721 +Node: Truth Values311804 +Node: Typing and Comparison312852 +Node: Variable Typing313641 +Ref: Variable Typing-Footnote-1317538 +Node: Comparison Operators317660 +Ref: table-relational-ops318070 +Node: POSIX String Comparison321619 +Ref: POSIX String Comparison-Footnote-1322576 +Node: Boolean Ops322714 +Ref: Boolean Ops-Footnote-1326792 +Node: Conditional Exp326883 +Node: Function Calls328615 +Node: Precedence332205 +Node: Patterns and Actions335858 +Node: Pattern Overview336912 +Node: Regexp Patterns338578 +Node: Expression Patterns339121 +Node: Ranges342695 +Node: BEGIN/END345661 +Node: Using BEGIN/END346411 +Ref: Using BEGIN/END-Footnote-1349142 +Node: I/O And BEGIN/END349256 +Node: Empty351525 +Node: BEGINFILE/ENDFILE351859 +Node: Using Shell Variables354684 +Node: Action Overview356963 +Node: Statements359320 +Node: If Statement361179 +Node: While Statement362678 +Node: Do Statement364722 +Node: For Statement365878 +Node: Switch Statement369030 +Node: Break Statement371127 +Node: Continue Statement373103 +Node: Next Statement374804 +Node: Nextfile Statement377186 +Node: Exit Statement379711 +Node: Built-in Variables382042 +Node: User-modified383137 +Ref: User-modified-Footnote-1391138 +Node: Auto-set391200 +Ref: Auto-set-Footnote-1400464 +Node: ARGC and ARGV400669 +Node: Arrays404428 +Node: Array Basics405999 +Node: Array Intro406710 +Node: Reference to Elements411028 +Node: Assigning Elements413298 +Node: Array Example413789 +Node: Scanning an Array415521 +Node: Delete418969 +Ref: Delete-Footnote-1421400 +Node: Numeric Array Subscripts421457 +Node: Uninitialized Subscripts423640 +Node: Multi-dimensional425268 +Node: Multi-scanning428359 +Node: Array Sorting429943 +Ref: Array Sorting-Footnote-1433141 +Node: Arrays of Arrays433335 +Node: Functions437873 +Node: Built-in438695 +Node: Calling Built-in439773 +Node: Numeric Functions441749 +Ref: Numeric Functions-Footnote-1445506 +Ref: Numeric Functions-Footnote-2445842 +Ref: Numeric Functions-Footnote-3445890 +Node: String Functions446159 +Ref: String Functions-Footnote-1467965 +Ref: String Functions-Footnote-2468094 +Ref: String Functions-Footnote-3468342 +Node: Gory Details468429 +Ref: table-sub-escapes470086 +Ref: table-posix-sub471400 +Ref: table-gensub-escapes472300 +Node: I/O Functions473471 +Ref: I/O Functions-Footnote-1480166 +Node: Time Functions480313 +Ref: Time Functions-Footnote-1491180 +Ref: Time Functions-Footnote-2491248 +Ref: Time Functions-Footnote-3491406 +Ref: Time Functions-Footnote-4491517 +Ref: Time Functions-Footnote-5491629 +Ref: Time Functions-Footnote-6491856 +Node: Bitwise Functions492122 +Ref: table-bitwise-ops492680 +Ref: Bitwise Functions-Footnote-1496840 +Node: Type Functions497024 +Node: I18N Functions497462 +Node: User-defined499089 +Node: Definition Syntax499893 +Ref: Definition Syntax-Footnote-1504530 +Node: Function Example504599 +Node: Function Caveats507193 +Node: Calling A Function507614 +Node: Variable Scope508729 +Node: Pass By Value/Reference510657 +Node: Return Statement514097 +Node: Dynamic Typing517039 +Node: Indirect Calls517776 +Node: Internationalization527461 +Node: I18N and L10N528889 +Node: Explaining gettext529575 +Ref: Explaining gettext-Footnote-1534637 +Ref: Explaining gettext-Footnote-2534820 +Node: Programmer i18n534985 +Node: Translator i18n539276 +Node: String Extraction540069 +Ref: String Extraction-Footnote-1541030 +Node: Printf Ordering541116 +Ref: Printf Ordering-Footnote-1543900 +Node: I18N Portability543964 +Ref: I18N Portability-Footnote-1546413 +Node: I18N Example546476 +Ref: I18N Example-Footnote-1549111 +Node: Gawk I18N549183 +Node: Advanced Features549800 +Node: Nondecimal Data551119 +Node: Two-way I/O552700 +Ref: Two-way I/O-Footnote-1558114 +Node: TCP/IP Networking558191 +Node: Profiling561034 +Node: Library Functions568434 +Ref: Library Functions-Footnote-1571473 +Node: Library Names571644 +Ref: Library Names-Footnote-1575115 +Ref: Library Names-Footnote-2575335 +Node: General Functions575421 +Node: Nextfile Function576484 +Node: Strtonum Function580865 +Node: Assert Function583816 +Node: Round Function587142 +Node: Cliff Random Function588683 +Node: Ordinal Functions589699 +Ref: Ordinal Functions-Footnote-1592769 +Ref: Ordinal Functions-Footnote-2593021 +Node: Join Function593237 +Ref: Join Function-Footnote-1595008 +Node: Gettimeofday Function595208 +Node: Data File Management598923 +Node: Filetrans Function599555 +Node: Rewind Function603792 +Node: File Checking605245 +Node: Empty Files606339 +Node: Ignoring Assigns608569 +Node: Getopt Function610122 +Ref: Getopt Function-Footnote-1621447 +Node: Passwd Functions621650 +Ref: Passwd Functions-Footnote-1630638 +Node: Group Functions630726 +Node: Walking Arrays638829 +Node: Sample Programs640395 +Node: Running Examples641060 +Node: Clones641788 +Node: Cut Program642911 +Node: Egrep Program652752 +Ref: Egrep Program-Footnote-1660523 +Node: Id Program660633 +Node: Split Program664249 +Ref: Split Program-Footnote-1667768 +Node: Tee Program667896 +Node: Uniq Program670699 +Node: Wc Program678122 +Ref: Wc Program-Footnote-1682386 +Node: Miscellaneous Programs682586 +Node: Dupword Program683774 +Node: Alarm Program685805 +Node: Translate Program690527 +Ref: Translate Program-Footnote-1694906 +Ref: Translate Program-Footnote-2695134 +Node: Labels Program695268 +Ref: Labels Program-Footnote-1698639 +Node: Word Sorting698723 +Node: History Sorting703068 +Node: Extract Program704906 +Ref: Extract Program-Footnote-1712387 +Node: Simple Sed712515 +Node: Igawk Program715577 +Ref: Igawk Program-Footnote-1730609 +Ref: Igawk Program-Footnote-2730810 +Node: Anagram Program730948 +Node: Signature Program734046 +Node: Debugger735149 +Node: Debugging736060 +Node: Debugging Concepts736374 +Node: Debugging Terms738230 +Node: Awk Debugging740775 +Node: Sample dgawk session741667 +Node: dgawk invocation742159 +Node: Finding The Bug743341 +Node: List of Debugger Commands749825 +Node: Breakpoint Control751136 +Node: Dgawk Execution Control754612 +Node: Viewing And Changing Data757963 +Node: Dgawk Stack761272 +Node: Dgawk Info762732 +Node: Miscellaneous Dgawk Commands766680 +Node: Readline Support772108 +Node: Dgawk Limitations772935 +Node: Language History775074 +Node: V7/SVR3.1776506 +Node: SVR4778801 +Node: POSIX780243 +Node: BTL781241 +Node: POSIX/GNU781975 +Node: Common Extensions787161 +Node: Contributors788294 +Node: Installation792329 +Node: Gawk Distribution793223 +Node: Getting793707 +Node: Extracting794533 +Node: Distribution contents796211 +Node: Unix Installation801229 +Node: Quick Installation801846 +Node: Additional Configuration Options803808 +Node: Configuration Philosophy805285 +Node: Non-Unix Installation807627 +Node: PC Installation808085 +Node: PC Binary Installation809384 +Node: PC Compiling811232 +Node: PC Testing814176 +Node: PC Using815352 +Node: Cygwin819537 +Node: MSYS820534 +Node: VMS Installation821048 +Node: VMS Compilation821654 +Ref: VMS Compilation-Footnote-1822660 +Node: VMS Installation Details822718 +Node: VMS Running824353 +Node: VMS Old Gawk825953 +Node: Bugs826427 +Node: Other Versions830292 +Node: Notes835571 +Node: Compatibility Mode836263 +Node: Additions837046 +Node: Accessing The Source837858 +Node: Adding Code839281 +Node: New Ports844829 +Node: Dynamic Extensions848942 +Node: Internals850318 +Node: Plugin License859434 +Node: Sample Library860068 +Node: Internal File Description860754 +Node: Internal File Ops864461 +Ref: Internal File Ops-Footnote-1869229 +Node: Using Internal File Ops869377 +Node: Future Extensions871754 +Node: Basic Concepts874258 +Node: Basic High Level875015 +Ref: Basic High Level-Footnote-1879050 +Node: Basic Data Typing879235 +Node: Floating Point Issues883760 +Node: String Conversion Precision884843 +Ref: String Conversion Precision-Footnote-1886537 +Node: Unexpected Results886646 +Node: POSIX Floating Point Problems888472 +Ref: POSIX Floating Point Problems-Footnote-1892168 +Node: Glossary892206 +Node: Copying916305 +Node: GNU Free Documentation License953862 +Node: next-edition979006 +Node: unresolved979358 +Node: revision979858 +Node: consistency980281 +Node: Index983780 End Tag Table diff --git a/doc/gawk.texi b/doc/gawk.texi index 4b8fc19a..26fa523d 100644 --- a/doc/gawk.texi +++ b/doc/gawk.texi @@ -665,7 +665,6 @@ particular records in a file and perform operations upon them. * VMS Compilation:: How to compile @command{gawk} under VMS. * VMS Installation Details:: How to install @command{gawk} under VMS. * VMS Running:: How to run @command{gawk} under VMS. -* VMS POSIX:: Alternate instructions for VMS POSIX. * VMS Old Gawk:: An old version comes with some VMS systems. * Bugs:: Reporting Problems and Bugs. * Other Versions:: Other freely available @command{awk} @@ -27600,11 +27599,12 @@ translation of @code{"\r\n"}, since it won't. Caveat Emptor! @cindex installation, VMS This @value{SUBSECTION} describes how to compile and install @command{gawk} under VMS. +The older designation ``VMS'' is used throughout to refer to OpenVMS. + @menu * VMS Compilation:: How to compile @command{gawk} under VMS. * VMS Installation Details:: How to install @command{gawk} under VMS. * VMS Running:: How to run @command{gawk} under VMS. -* VMS POSIX:: Alternate instructions for VMS POSIX. * VMS Old Gawk:: An old version comes with some VMS systems. @end menu @@ -27628,34 +27628,16 @@ or: $ @kbd{MMS/DESCRIPTION=[.VMS]DESCRIP.MMS GAWK} @end example -Depending upon which C compiler you are using, follow one of the sets -of instructions in this table: - -@table @asis -@item VAX C V3.x -Use either @file{vmsbuild.com} or @file{descrip.mms} as is. These use -@code{CC/OPTIMIZE=NOLINE}, which is essential for Version 3.0. - -@item VAX C V2.x -You must have Version 2.3 or 2.4; older ones won't work. Edit either -@file{vmsbuild.com} or @file{descrip.mms} according to the comments in them. -For @file{vmsbuild.com}, this just entails removing two @samp{!} delimiters. -Also edit @file{config.h} (which is a copy of file @file{[.config]vms-conf.h}) -and comment out or delete the two lines @samp{#define __STDC__ 0} and -@samp{#define VAXC_BUILTINS} near the end. - -@item GNU C -Edit @file{vmsbuild.com} or @file{descrip.mms}; the changes are different -from those for VAX C V2.x but equally straightforward. No changes to -@file{config.h} are needed. - -@item DEC C -Edit @file{vmsbuild.com} or @file{descrip.mms} according to their comments. -No changes to @file{config.h} are needed. -@end table +Older versions of @command{gawk} could be built with VAX C or +GNU C on VAX/VMS, as well as with DEC C, but that is no longer +suported. DEC C (also briefly known as ``Compaq C'' and now known +as ``HP C,'' but referred to here as ``DEC C'') is required. Both +@code{VMSBUILD.COM} and @code{DESCRIP.MMS} contain some obsolete support +for the older compilers but are set up to use DEC C by default. -@command{gawk} has been tested under VAX/VMS 5.5-1 using VAX C V3.2, and -GNU C 1.40 and 2.3. It should work without modifications for VMS V4.6 and up. +@command{gawk} has been tested under Alpha/VMS 7.3-1 using Compaq C V6.4, +and on Alpha/VMS 7.3, Alpha/VMS 7.3-2, and IA64/VMS 8.3.@footnote{The IA64 +architecture is also known as ``Itanium.''} @node VMS Installation Details @appendixsubsubsec Installing @command{gawk} on VMS @@ -27702,8 +27684,8 @@ looks in the current directory first, then in the directory specified by the translation of @samp{AWK_LIBRARY} if the file is not found. If, after searching in both directories, the file still is not found, @command{gawk} appends the suffix @samp{.awk} to the filename and retries -the file search. If @samp{AWK_LIBRARY} is not defined, that -portion of the file search fails benignly. +the file search. If @samp{AWK_LIBRARY} has no definition, a default value +of @samp{SYS$LIBRARY:} is used for it. @node VMS Running @appendixsubsubsec Running @command{gawk} on VMS @@ -27744,6 +27726,11 @@ 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. +@ignore +@c The VMS POSIX product, also known as POSIX for OpenVMS, is long defunct +@c and building gawk for it has not been tested in many years, but these +@c old instructions might still work if anyone is still using it. + @node VMS POSIX @appendixsubsubsec Building and Using @command{gawk} on VMS POSIX @@ -27772,6 +27759,7 @@ This has been tested with VAX/VMS V6.2, VMS POSIX V2.0, and DEC C V5.2. Once built, @command{gawk} works like any other shell utility. Unlike the normal VMS port of @command{gawk}, no special command-line manipulation is needed in the VMS POSIX environment. +@end ignore @node VMS Old Gawk @appendixsubsubsec Some VMS Systems Have An Old Version of @command{gawk} |