diff options
-rw-r--r-- | doc/ChangeLog | 4 | ||||
-rw-r--r-- | doc/gawk.info | 1226 | ||||
-rw-r--r-- | doc/gawk.texi | 60 | ||||
-rw-r--r-- | doc/gawktexi.in | 60 |
4 files changed, 612 insertions, 738 deletions
diff --git a/doc/ChangeLog b/doc/ChangeLog index 13508d8d..7c7fefb8 100644 --- a/doc/ChangeLog +++ b/doc/ChangeLog @@ -1,3 +1,7 @@ +2021-07-15 Arnold D. Robbins <arnold@skeeve.com> + + * gawktexi.in: Remove obsolete bits relating to VMS. + 2021-07-09 Arnold D. Robbins <arnold@skeeve.com> * gawktexi.in: Make @EMAIL usage consistent everywhere. diff --git a/doc/gawk.info b/doc/gawk.info index 55c9bb3f..b1500a78 100644 --- a/doc/gawk.info +++ b/doc/gawk.info @@ -681,8 +681,6 @@ in (a) below. A copy of the license is included in the section entitled VMS. * VMS Running:: How to run 'gawk' under VMS. * VMS GNV:: The VMS GNV Project. -* VMS Old Gawk:: An old version comes with some VMS - systems. * Bugs:: Reporting Problems and Bugs. * Bug definition:: Defining what is and is not a bug. * Bug address:: Where to send reports to. @@ -31106,7 +31104,7 @@ File: gawk.info, Node: VMS Installation, Prev: PC Installation, Up: Non-Unix B.3.2 Compiling and Installing 'gawk' on Vax/VMS and OpenVMS ------------------------------------------------------------ -This node describes how to compile and install 'gawk' under VMS. The +This node describes how to compile and install 'gawk' under OpenVMS. The older designation "VMS" is used throughout to refer to OpenVMS. * Menu: @@ -31117,7 +31115,6 @@ older designation "VMS" is used throughout to refer to OpenVMS. * VMS Installation Details:: How to install 'gawk' under VMS. * VMS Running:: How to run 'gawk' under VMS. * VMS GNV:: The VMS GNV Project. -* VMS Old Gawk:: An old version comes with some VMS systems. File: gawk.info, Node: VMS Compilation, Next: VMS Dynamic Extensions, Up: VMS Installation @@ -31242,7 +31239,7 @@ that can be used to add 'gawk' and 'awk' as DCL commands. $ set command gnv$gnu:[vms_bin]gawk_verb.cld Or the system manager can use 'GNV$GNU:[vms_bin]gawk_verb.cld' to add -the 'gawk' and 'awk' to the system-wide 'DCLTABLES'. +the 'gawk' and 'awk' commands to the system-wide 'DCLTABLES'. The DCL syntax is documented in the 'gawk.hlp' file. @@ -31375,7 +31372,7 @@ ends. $ sort sys$input: sys$output: -File: gawk.info, Node: VMS GNV, Next: VMS Old Gawk, Prev: VMS Running, Up: VMS Installation +File: gawk.info, Node: VMS GNV, Prev: VMS Running, Up: VMS Installation B.3.2.5 The VMS GNV Project ........................... @@ -31393,20 +31390,6 @@ suitable for use with GNV. procedure for building a VMS PCSI kit that is compatible with GNV. -File: gawk.info, Node: VMS Old Gawk, Prev: VMS GNV, Up: VMS Installation - -B.3.2.6 Some VMS Systems Have An Old Version of 'gawk' -...................................................... - -Some versions of VMS have an old version of 'gawk'. To access it, -define a symbol, as follows: - - $ gawk :== $sys$common:[syshlp.examples.tcpip.snmp]gawk.exe - - This is apparently version 2.15.6, which is extremely old. We -recommend compiling and using the current version. - - File: gawk.info, Node: Bugs, Next: Other Versions, Prev: Non-Unix Installation, Up: Installation B.4 Reporting Problems and Bugs @@ -38384,608 +38367,607 @@ Index Tag Table: Node: Top1200 -Node: Foreword345208 -Node: Foreword449650 -Node: Preface51182 -Ref: Preface-Footnote-154041 -Ref: Preface-Footnote-254150 -Ref: Preface-Footnote-354384 -Node: History54526 -Node: Names56878 -Ref: Names-Footnote-157982 -Node: This Manual58129 -Ref: This Manual-Footnote-164768 -Node: Conventions64868 -Node: Manual History67237 -Ref: Manual History-Footnote-170234 -Ref: Manual History-Footnote-270275 -Node: How To Contribute70349 -Node: Acknowledgments71275 -Node: Getting Started76212 -Node: Running gawk78651 -Node: One-shot79841 -Node: Read Terminal81104 -Node: Long83097 -Node: Executable Scripts84610 -Ref: Executable Scripts-Footnote-187243 -Node: Comments87346 -Node: Quoting89830 -Node: DOS Quoting95356 -Node: Sample Data Files97412 -Node: Very Simple100007 -Node: Two Rules106109 -Node: More Complex107994 -Node: Statements/Lines110326 -Ref: Statements/Lines-Footnote-1114810 -Node: Other Features115075 -Node: When116011 -Ref: When-Footnote-1117765 -Node: Intro Summary117830 -Node: Invoking Gawk118714 -Node: Command Line120228 -Node: Options121026 -Ref: Options-Footnote-1138940 -Ref: Options-Footnote-2139171 -Node: Other Arguments139196 -Node: Naming Standard Input143207 -Node: Environment Variables144417 -Node: AWKPATH Variable144975 -Ref: AWKPATH Variable-Footnote-1148387 -Ref: AWKPATH Variable-Footnote-2148421 -Node: AWKLIBPATH Variable148792 -Ref: AWKLIBPATH Variable-Footnote-1150489 -Node: Other Environment Variables150864 -Node: Exit Status154685 -Node: Include Files155362 -Node: Loading Shared Libraries159052 -Node: Obsolete160480 -Node: Undocumented161172 -Node: Invoking Summary161469 -Node: Regexp164310 -Node: Regexp Usage165764 -Node: Escape Sequences167801 -Node: Regexp Operators174042 -Node: Regexp Operator Details174527 -Ref: Regexp Operator Details-Footnote-1181891 -Node: Interval Expressions182038 -Ref: Interval Expressions-Footnote-1183459 -Node: Bracket Expressions183557 -Ref: table-char-classes186033 -Node: Leftmost Longest189359 -Node: Computed Regexps190662 -Node: GNU Regexp Operators194089 -Node: Case-sensitivity197826 -Ref: Case-sensitivity-Footnote-1200692 -Ref: Case-sensitivity-Footnote-2200927 -Node: Regexp Summary201035 -Node: Reading Files202501 -Node: Records204770 -Node: awk split records205845 -Node: gawk split records210545 -Ref: gawk split records-Footnote-1215619 -Node: Fields215656 -Node: Nonconstant Fields218397 -Ref: Nonconstant Fields-Footnote-1220633 -Node: Changing Fields220837 -Node: Field Separators226868 -Node: Default Field Splitting229566 -Node: Regexp Field Splitting230684 -Node: Single Character Fields234361 -Node: Command Line Field Separator235421 -Node: Full Line Fields238639 -Ref: Full Line Fields-Footnote-1240161 -Ref: Full Line Fields-Footnote-2240207 -Node: Field Splitting Summary240308 -Node: Constant Size242382 -Node: Fixed width data243114 -Node: Skipping intervening246581 -Node: Allowing trailing data247379 -Node: Fields with fixed data248416 -Node: Splitting By Content249934 -Ref: Splitting By Content-Footnote-1253717 -Node: More CSV253880 -Node: Testing field creation255472 -Node: Multiple Line257097 -Node: Getline263374 -Node: Plain Getline265843 -Node: Getline/Variable268416 -Node: Getline/File269567 -Node: Getline/Variable/File270955 -Ref: Getline/Variable/File-Footnote-1272560 -Node: Getline/Pipe272648 -Node: Getline/Variable/Pipe275352 -Node: Getline/Coprocess276487 -Node: Getline/Variable/Coprocess277754 -Node: Getline Notes278496 -Node: Getline Summary281293 -Ref: table-getline-variants281717 -Node: Read Timeout282465 -Ref: Read Timeout-Footnote-1286371 -Node: Retrying Input286429 -Node: Command-line directories287628 -Node: Input Summary288534 -Node: Input Exercises291706 -Node: Printing292140 -Node: Print293974 -Node: Print Examples295431 -Node: Output Separators298211 -Node: OFMT300228 -Node: Printf301584 -Node: Basic Printf302369 -Node: Control Letters303943 -Node: Format Modifiers309107 -Node: Printf Examples315122 -Node: Redirection317608 -Node: Special FD324449 -Ref: Special FD-Footnote-1327617 -Node: Special Files327691 -Node: Other Inherited Files328308 -Node: Special Network329309 -Node: Special Caveats330169 -Node: Close Files And Pipes331118 -Ref: table-close-pipe-return-values338025 -Ref: Close Files And Pipes-Footnote-1338838 -Ref: Close Files And Pipes-Footnote-2338986 -Node: Nonfatal339138 -Node: Output Summary341476 -Node: Output Exercises342698 -Node: Expressions343377 -Node: Values344565 -Node: Constants345243 -Node: Scalar Constants345934 -Ref: Scalar Constants-Footnote-1348444 -Node: Nondecimal-numbers348694 -Node: Regexp Constants351695 -Node: Using Constant Regexps352221 -Node: Standard Regexp Constants352843 -Node: Strong Regexp Constants356031 -Node: Variables359043 -Node: Using Variables359700 -Node: Assignment Options361610 -Node: Conversion364081 -Node: Strings And Numbers364605 -Ref: Strings And Numbers-Footnote-1367668 -Node: Locale influences conversions367777 -Ref: table-locale-affects370535 -Node: All Operators371153 -Node: Arithmetic Ops371782 -Node: Concatenation374498 -Ref: Concatenation-Footnote-1377345 -Node: Assignment Ops377452 -Ref: table-assign-ops382443 -Node: Increment Ops383756 -Node: Truth Values and Conditions387216 -Node: Truth Values388290 -Node: Typing and Comparison389338 -Node: Variable Typing390158 -Ref: Variable Typing-Footnote-1396621 -Ref: Variable Typing-Footnote-2396693 -Node: Comparison Operators396770 -Ref: table-relational-ops397189 -Node: POSIX String Comparison400684 -Ref: POSIX String Comparison-Footnote-1402379 -Ref: POSIX String Comparison-Footnote-2402518 -Node: Boolean Ops402602 -Ref: Boolean Ops-Footnote-1407084 -Node: Conditional Exp407176 -Node: Function Calls408912 -Node: Precedence412789 -Node: Locales416448 -Node: Expressions Summary418080 -Node: Patterns and Actions420653 -Node: Pattern Overview421773 -Node: Regexp Patterns423450 -Node: Expression Patterns423992 -Node: Ranges427773 -Node: BEGIN/END430881 -Node: Using BEGIN/END431642 -Ref: Using BEGIN/END-Footnote-1434396 -Node: I/O And BEGIN/END434502 -Node: BEGINFILE/ENDFILE436815 -Node: Empty440046 -Node: Using Shell Variables440363 -Node: Action Overview442637 -Node: Statements444962 -Node: If Statement446810 -Node: While Statement448305 -Node: Do Statement450333 -Node: For Statement451481 -Node: Switch Statement454652 -Node: Break Statement457093 -Node: Continue Statement459185 -Node: Next Statement461012 -Node: Nextfile Statement463395 -Node: Exit Statement466084 -Node: Built-in Variables468487 -Node: User-modified469620 -Node: Auto-set477387 -Ref: Auto-set-Footnote-1494194 -Ref: Auto-set-Footnote-2494400 -Node: ARGC and ARGV494456 -Node: Pattern Action Summary498669 -Node: Arrays501099 -Node: Array Basics502428 -Node: Array Intro503272 -Ref: figure-array-elements505247 -Ref: Array Intro-Footnote-1507951 -Node: Reference to Elements508079 -Node: Assigning Elements510543 -Node: Array Example511034 -Node: Scanning an Array512793 -Node: Controlling Scanning515815 -Ref: Controlling Scanning-Footnote-1522271 -Node: Numeric Array Subscripts522587 -Node: Uninitialized Subscripts524771 -Node: Delete526390 -Ref: Delete-Footnote-1529142 -Node: Multidimensional529199 -Node: Multiscanning532294 -Node: Arrays of Arrays533885 -Node: Arrays Summary538653 -Node: Functions540746 -Node: Built-in541784 -Node: Calling Built-in542865 -Node: Numeric Functions544861 -Ref: Numeric Functions-Footnote-1548889 -Ref: Numeric Functions-Footnote-2549537 -Ref: Numeric Functions-Footnote-3549585 -Node: String Functions549857 -Ref: String Functions-Footnote-1574167 -Ref: String Functions-Footnote-2574295 -Ref: String Functions-Footnote-3574543 -Node: Gory Details574630 -Ref: table-sub-escapes576421 -Ref: table-sub-proposed577940 -Ref: table-posix-sub579303 -Ref: table-gensub-escapes580844 -Ref: Gory Details-Footnote-1581667 -Node: I/O Functions581821 -Ref: table-system-return-values588275 -Ref: I/O Functions-Footnote-1590355 -Ref: I/O Functions-Footnote-2590503 -Node: Time Functions590623 -Ref: Time Functions-Footnote-1601294 -Ref: Time Functions-Footnote-2601362 -Ref: Time Functions-Footnote-3601520 -Ref: Time Functions-Footnote-4601631 -Ref: Time Functions-Footnote-5601743 -Ref: Time Functions-Footnote-6601970 -Node: Bitwise Functions602236 -Ref: table-bitwise-ops602830 -Ref: Bitwise Functions-Footnote-1608893 -Ref: Bitwise Functions-Footnote-2609066 -Node: Type Functions609257 -Node: I18N Functions612120 -Node: User-defined613771 -Node: Definition Syntax614583 -Ref: Definition Syntax-Footnote-1620277 -Node: Function Example620348 -Ref: Function Example-Footnote-1623270 -Node: Function Calling623292 -Node: Calling A Function623880 -Node: Variable Scope624838 -Node: Pass By Value/Reference627832 -Node: Function Caveats630476 -Ref: Function Caveats-Footnote-1632523 -Node: Return Statement632643 -Node: Dynamic Typing635622 -Node: Indirect Calls636552 -Ref: Indirect Calls-Footnote-1646804 -Node: Functions Summary646932 -Node: Library Functions649637 -Ref: Library Functions-Footnote-1653244 -Ref: Library Functions-Footnote-2653387 -Node: Library Names653558 -Ref: Library Names-Footnote-1657225 -Ref: Library Names-Footnote-2657448 -Node: General Functions657534 -Node: Strtonum Function658716 -Node: Assert Function661738 -Node: Round Function665064 -Node: Cliff Random Function666604 -Node: Ordinal Functions667620 -Ref: Ordinal Functions-Footnote-1670683 -Ref: Ordinal Functions-Footnote-2670935 -Node: Join Function671145 -Ref: Join Function-Footnote-1672915 -Node: Getlocaltime Function673115 -Node: Readfile Function676857 -Node: Shell Quoting678834 -Node: Isnumeric Function680262 -Node: Data File Management681650 -Node: Filetrans Function682282 -Node: Rewind Function686378 -Node: File Checking688287 -Ref: File Checking-Footnote-1689621 -Node: Empty Files689822 -Node: Ignoring Assigns691801 -Node: Getopt Function693351 -Ref: Getopt Function-Footnote-1708574 -Node: Passwd Functions708774 -Ref: Passwd Functions-Footnote-1717613 -Node: Group Functions717701 -Ref: Group Functions-Footnote-1725599 -Node: Walking Arrays725806 -Node: Library Functions Summary728814 -Node: Library Exercises730220 -Node: Sample Programs730685 -Node: Running Examples731455 -Node: Clones732183 -Node: Cut Program733407 -Node: Egrep Program743547 -Node: Id Program752548 -Node: Split Program762495 -Ref: Split Program-Footnote-1772388 -Node: Tee Program772561 -Node: Uniq Program775351 -Node: Wc Program782939 -Node: Bytes vs. Characters783326 -Node: Using extensions784874 -Node: wc program785628 -Node: Miscellaneous Programs790493 -Node: Dupword Program791706 -Node: Alarm Program793736 -Node: Translate Program798591 -Ref: Translate Program-Footnote-1803156 -Node: Labels Program803426 -Ref: Labels Program-Footnote-1806777 -Node: Word Sorting806861 -Node: History Sorting810933 -Node: Extract Program813158 -Node: Simple Sed821212 -Node: Igawk Program824286 -Ref: Igawk Program-Footnote-1838617 -Ref: Igawk Program-Footnote-2838819 -Ref: Igawk Program-Footnote-3838941 -Node: Anagram Program839056 -Node: Signature Program842118 -Node: Programs Summary843365 -Node: Programs Exercises844579 -Ref: Programs Exercises-Footnote-1848709 -Node: Advanced Features848795 -Node: Nondecimal Data850862 -Node: Array Sorting852453 -Node: Controlling Array Traversal853153 -Ref: Controlling Array Traversal-Footnote-1861521 -Node: Array Sorting Functions861639 -Ref: Array Sorting Functions-Footnote-1867013 -Node: Two-way I/O867209 -Ref: Two-way I/O-Footnote-1874935 -Ref: Two-way I/O-Footnote-2875122 -Node: TCP/IP Networking875204 -Node: Profiling878322 -Node: Extension Philosophy887631 -Node: Advanced Features Summary889110 -Node: Internationalization891125 -Node: I18N and L10N892799 -Node: Explaining gettext893486 -Ref: Explaining gettext-Footnote-1899378 -Ref: Explaining gettext-Footnote-2899563 -Node: Programmer i18n899728 -Ref: Programmer i18n-Footnote-1904677 -Node: Translator i18n904726 -Node: String Extraction905520 -Ref: String Extraction-Footnote-1906652 -Node: Printf Ordering906738 -Ref: Printf Ordering-Footnote-1909524 -Node: I18N Portability909588 -Ref: I18N Portability-Footnote-1912044 -Node: I18N Example912107 -Ref: I18N Example-Footnote-1915382 -Ref: I18N Example-Footnote-2915455 -Node: Gawk I18N915564 -Node: I18N Summary916213 -Node: Debugger917554 -Node: Debugging918554 -Node: Debugging Concepts918995 -Node: Debugging Terms920804 -Node: Awk Debugging923379 -Ref: Awk Debugging-Footnote-1924324 -Node: Sample Debugging Session924456 -Node: Debugger Invocation924990 -Node: Finding The Bug926376 -Node: List of Debugger Commands932850 -Node: Breakpoint Control934183 -Node: Debugger Execution Control937877 -Node: Viewing And Changing Data941239 -Node: Execution Stack944780 -Node: Debugger Info946417 -Node: Miscellaneous Debugger Commands950488 -Node: Readline Support955550 -Node: Limitations956446 -Node: Debugging Summary959000 -Node: Namespaces960279 -Node: Global Namespace961390 -Node: Qualified Names962788 -Node: Default Namespace963787 -Node: Changing The Namespace964528 -Node: Naming Rules966142 -Node: Internal Name Management967990 -Node: Namespace Example969032 -Node: Namespace And Features971594 -Node: Namespace Summary973029 -Node: Arbitrary Precision Arithmetic974506 -Node: Computer Arithmetic975993 -Ref: table-numeric-ranges979759 -Ref: table-floating-point-ranges980252 -Ref: Computer Arithmetic-Footnote-1980910 -Node: Math Definitions980967 -Ref: table-ieee-formats984283 -Ref: Math Definitions-Footnote-1984886 -Node: MPFR features984991 -Node: FP Math Caution986709 -Ref: FP Math Caution-Footnote-1987781 -Node: Inexactness of computations988150 -Node: Inexact representation989110 -Node: Comparing FP Values990470 -Node: Errors accumulate991711 -Node: Getting Accuracy993144 -Node: Try To Round995854 -Node: Setting precision996753 -Ref: table-predefined-precision-strings997450 -Node: Setting the rounding mode999280 -Ref: table-gawk-rounding-modes999654 -Ref: Setting the rounding mode-Footnote-11003585 -Node: Arbitrary Precision Integers1003764 -Ref: Arbitrary Precision Integers-Footnote-11006939 -Node: Checking for MPFR1007088 -Node: POSIX Floating Point Problems1008562 -Ref: POSIX Floating Point Problems-Footnote-11012847 -Node: Floating point summary1012885 -Node: Dynamic Extensions1015075 -Node: Extension Intro1016628 -Node: Plugin License1017894 -Node: Extension Mechanism Outline1018691 -Ref: figure-load-extension1019130 -Ref: figure-register-new-function1020695 -Ref: figure-call-new-function1021787 -Node: Extension API Description1023849 -Node: Extension API Functions Introduction1025562 -Ref: table-api-std-headers1027398 -Node: General Data Types1031647 -Ref: General Data Types-Footnote-11040277 -Node: Memory Allocation Functions1040576 -Ref: Memory Allocation Functions-Footnote-11045077 -Node: Constructor Functions1045176 -Node: API Ownership of MPFR and GMP Values1048642 -Node: Registration Functions1049955 -Node: Extension Functions1050655 -Node: Exit Callback Functions1055977 -Node: Extension Version String1057227 -Node: Input Parsers1057890 -Node: Output Wrappers1070611 -Node: Two-way processors1075123 -Node: Printing Messages1077388 -Ref: Printing Messages-Footnote-11078559 -Node: Updating ERRNO1078712 -Node: Requesting Values1079451 -Ref: table-value-types-returned1080188 -Node: Accessing Parameters1081124 -Node: Symbol Table Access1082361 -Node: Symbol table by name1082873 -Ref: Symbol table by name-Footnote-11085897 -Node: Symbol table by cookie1086025 -Ref: Symbol table by cookie-Footnote-11090210 -Node: Cached values1090274 -Ref: Cached values-Footnote-11093810 -Node: Array Manipulation1093963 -Ref: Array Manipulation-Footnote-11095054 -Node: Array Data Types1095091 -Ref: Array Data Types-Footnote-11097749 -Node: Array Functions1097841 -Node: Flattening Arrays1102339 -Node: Creating Arrays1109315 -Node: Redirection API1114082 -Node: Extension API Variables1116915 -Node: Extension Versioning1117626 -Ref: gawk-api-version1118055 -Node: Extension GMP/MPFR Versioning1119786 -Node: Extension API Informational Variables1121414 -Node: Extension API Boilerplate1122487 -Node: Changes from API V11126461 -Node: Finding Extensions1128033 -Node: Extension Example1128592 -Node: Internal File Description1129390 -Node: Internal File Ops1133470 -Ref: Internal File Ops-Footnote-11144820 -Node: Using Internal File Ops1144960 -Ref: Using Internal File Ops-Footnote-11147343 -Node: Extension Samples1147617 -Node: Extension Sample File Functions1149146 -Node: Extension Sample Fnmatch1156795 -Node: Extension Sample Fork1158282 -Node: Extension Sample Inplace1159500 -Node: Extension Sample Ord1163126 -Node: Extension Sample Readdir1163962 -Ref: table-readdir-file-types1164851 -Node: Extension Sample Revout1165918 -Node: Extension Sample Rev2way1166507 -Node: Extension Sample Read write array1167247 -Node: Extension Sample Readfile1169189 -Node: Extension Sample Time1170284 -Node: Extension Sample API Tests1172036 -Node: gawkextlib1172528 -Node: Extension summary1175446 -Node: Extension Exercises1179148 -Node: Language History1180390 -Node: V7/SVR3.11182046 -Node: SVR41184198 -Node: POSIX1185632 -Node: BTL1187013 -Node: POSIX/GNU1187742 -Node: Feature History1193520 -Node: Common Extensions1210695 -Node: Ranges and Locales1211978 -Ref: Ranges and Locales-Footnote-11216594 -Ref: Ranges and Locales-Footnote-21216621 -Ref: Ranges and Locales-Footnote-31216856 -Node: Contributors1217079 -Node: History summary1223076 -Node: Installation1224456 -Node: Gawk Distribution1225400 -Node: Getting1225884 -Node: Extracting1226847 -Node: Distribution contents1228485 -Node: Unix Installation1234965 -Node: Quick Installation1235647 -Node: Compiling with MPFR1238128 -Node: Shell Startup Files1238820 -Node: Additional Configuration Options1239909 -Node: Configuration Philosophy1242224 -Node: Non-Unix Installation1244593 -Node: PC Installation1245053 -Node: PC Binary Installation1245891 -Node: PC Compiling1246326 -Node: PC Using1247443 -Node: Cygwin1250996 -Node: MSYS1252220 -Node: VMS Installation1252822 -Node: VMS Compilation1253613 -Ref: VMS Compilation-Footnote-11254842 -Node: VMS Dynamic Extensions1254900 -Node: VMS Installation Details1256585 -Node: VMS Running1258838 -Node: VMS GNV1263117 -Node: VMS Old Gawk1263852 -Node: Bugs1264323 -Node: Bug definition1265203 -Node: Bug address1267707 -Node: Usenet1271095 -Node: Performance bugs1272104 -Node: Asking for help1275025 -Node: Maintainers1276987 -Node: Other Versions1278181 -Node: Installation summary1286033 -Node: Notes1287397 -Node: Compatibility Mode1288191 -Node: Additions1288973 -Node: Accessing The Source1289898 -Node: Adding Code1291335 -Node: New Ports1297554 -Node: Derived Files1301929 -Ref: Derived Files-Footnote-11307589 -Ref: Derived Files-Footnote-21307624 -Ref: Derived Files-Footnote-31308222 -Node: Future Extensions1308336 -Node: Implementation Limitations1308994 -Node: Extension Design1310204 -Node: Old Extension Problems1311348 -Ref: Old Extension Problems-Footnote-11312866 -Node: Extension New Mechanism Goals1312923 -Ref: Extension New Mechanism Goals-Footnote-11316287 -Node: Extension Other Design Decisions1316476 -Node: Extension Future Growth1318589 -Node: Notes summary1319195 -Node: Basic Concepts1320353 -Node: Basic High Level1321034 -Ref: figure-general-flow1321316 -Ref: figure-process-flow1322001 -Ref: Basic High Level-Footnote-11325302 -Node: Basic Data Typing1325487 -Node: Glossary1328815 -Node: Copying1360700 -Node: GNU Free Documentation License1398243 -Node: Index1423363 +Node: Foreword345084 +Node: Foreword449526 +Node: Preface51058 +Ref: Preface-Footnote-153917 +Ref: Preface-Footnote-254026 +Ref: Preface-Footnote-354260 +Node: History54402 +Node: Names56754 +Ref: Names-Footnote-157858 +Node: This Manual58005 +Ref: This Manual-Footnote-164644 +Node: Conventions64744 +Node: Manual History67113 +Ref: Manual History-Footnote-170110 +Ref: Manual History-Footnote-270151 +Node: How To Contribute70225 +Node: Acknowledgments71151 +Node: Getting Started76088 +Node: Running gawk78527 +Node: One-shot79717 +Node: Read Terminal80980 +Node: Long82973 +Node: Executable Scripts84486 +Ref: Executable Scripts-Footnote-187119 +Node: Comments87222 +Node: Quoting89706 +Node: DOS Quoting95232 +Node: Sample Data Files97288 +Node: Very Simple99883 +Node: Two Rules105985 +Node: More Complex107870 +Node: Statements/Lines110202 +Ref: Statements/Lines-Footnote-1114686 +Node: Other Features114951 +Node: When115887 +Ref: When-Footnote-1117641 +Node: Intro Summary117706 +Node: Invoking Gawk118590 +Node: Command Line120104 +Node: Options120902 +Ref: Options-Footnote-1138816 +Ref: Options-Footnote-2139047 +Node: Other Arguments139072 +Node: Naming Standard Input143083 +Node: Environment Variables144293 +Node: AWKPATH Variable144851 +Ref: AWKPATH Variable-Footnote-1148263 +Ref: AWKPATH Variable-Footnote-2148297 +Node: AWKLIBPATH Variable148668 +Ref: AWKLIBPATH Variable-Footnote-1150365 +Node: Other Environment Variables150740 +Node: Exit Status154561 +Node: Include Files155238 +Node: Loading Shared Libraries158928 +Node: Obsolete160356 +Node: Undocumented161048 +Node: Invoking Summary161345 +Node: Regexp164186 +Node: Regexp Usage165640 +Node: Escape Sequences167677 +Node: Regexp Operators173918 +Node: Regexp Operator Details174403 +Ref: Regexp Operator Details-Footnote-1181767 +Node: Interval Expressions181914 +Ref: Interval Expressions-Footnote-1183335 +Node: Bracket Expressions183433 +Ref: table-char-classes185909 +Node: Leftmost Longest189235 +Node: Computed Regexps190538 +Node: GNU Regexp Operators193965 +Node: Case-sensitivity197702 +Ref: Case-sensitivity-Footnote-1200568 +Ref: Case-sensitivity-Footnote-2200803 +Node: Regexp Summary200911 +Node: Reading Files202377 +Node: Records204646 +Node: awk split records205721 +Node: gawk split records210421 +Ref: gawk split records-Footnote-1215495 +Node: Fields215532 +Node: Nonconstant Fields218273 +Ref: Nonconstant Fields-Footnote-1220509 +Node: Changing Fields220713 +Node: Field Separators226744 +Node: Default Field Splitting229442 +Node: Regexp Field Splitting230560 +Node: Single Character Fields234237 +Node: Command Line Field Separator235297 +Node: Full Line Fields238515 +Ref: Full Line Fields-Footnote-1240037 +Ref: Full Line Fields-Footnote-2240083 +Node: Field Splitting Summary240184 +Node: Constant Size242258 +Node: Fixed width data242990 +Node: Skipping intervening246457 +Node: Allowing trailing data247255 +Node: Fields with fixed data248292 +Node: Splitting By Content249810 +Ref: Splitting By Content-Footnote-1253593 +Node: More CSV253756 +Node: Testing field creation255348 +Node: Multiple Line256973 +Node: Getline263250 +Node: Plain Getline265719 +Node: Getline/Variable268292 +Node: Getline/File269443 +Node: Getline/Variable/File270831 +Ref: Getline/Variable/File-Footnote-1272436 +Node: Getline/Pipe272524 +Node: Getline/Variable/Pipe275228 +Node: Getline/Coprocess276363 +Node: Getline/Variable/Coprocess277630 +Node: Getline Notes278372 +Node: Getline Summary281169 +Ref: table-getline-variants281593 +Node: Read Timeout282341 +Ref: Read Timeout-Footnote-1286247 +Node: Retrying Input286305 +Node: Command-line directories287504 +Node: Input Summary288410 +Node: Input Exercises291582 +Node: Printing292016 +Node: Print293850 +Node: Print Examples295307 +Node: Output Separators298087 +Node: OFMT300104 +Node: Printf301460 +Node: Basic Printf302245 +Node: Control Letters303819 +Node: Format Modifiers308983 +Node: Printf Examples314998 +Node: Redirection317484 +Node: Special FD324325 +Ref: Special FD-Footnote-1327493 +Node: Special Files327567 +Node: Other Inherited Files328184 +Node: Special Network329185 +Node: Special Caveats330045 +Node: Close Files And Pipes330994 +Ref: table-close-pipe-return-values337901 +Ref: Close Files And Pipes-Footnote-1338714 +Ref: Close Files And Pipes-Footnote-2338862 +Node: Nonfatal339014 +Node: Output Summary341352 +Node: Output Exercises342574 +Node: Expressions343253 +Node: Values344441 +Node: Constants345119 +Node: Scalar Constants345810 +Ref: Scalar Constants-Footnote-1348320 +Node: Nondecimal-numbers348570 +Node: Regexp Constants351571 +Node: Using Constant Regexps352097 +Node: Standard Regexp Constants352719 +Node: Strong Regexp Constants355907 +Node: Variables358919 +Node: Using Variables359576 +Node: Assignment Options361486 +Node: Conversion363957 +Node: Strings And Numbers364481 +Ref: Strings And Numbers-Footnote-1367544 +Node: Locale influences conversions367653 +Ref: table-locale-affects370411 +Node: All Operators371029 +Node: Arithmetic Ops371658 +Node: Concatenation374374 +Ref: Concatenation-Footnote-1377221 +Node: Assignment Ops377328 +Ref: table-assign-ops382319 +Node: Increment Ops383632 +Node: Truth Values and Conditions387092 +Node: Truth Values388166 +Node: Typing and Comparison389214 +Node: Variable Typing390034 +Ref: Variable Typing-Footnote-1396497 +Ref: Variable Typing-Footnote-2396569 +Node: Comparison Operators396646 +Ref: table-relational-ops397065 +Node: POSIX String Comparison400560 +Ref: POSIX String Comparison-Footnote-1402255 +Ref: POSIX String Comparison-Footnote-2402394 +Node: Boolean Ops402478 +Ref: Boolean Ops-Footnote-1406960 +Node: Conditional Exp407052 +Node: Function Calls408788 +Node: Precedence412665 +Node: Locales416324 +Node: Expressions Summary417956 +Node: Patterns and Actions420529 +Node: Pattern Overview421649 +Node: Regexp Patterns423326 +Node: Expression Patterns423868 +Node: Ranges427649 +Node: BEGIN/END430757 +Node: Using BEGIN/END431518 +Ref: Using BEGIN/END-Footnote-1434272 +Node: I/O And BEGIN/END434378 +Node: BEGINFILE/ENDFILE436691 +Node: Empty439922 +Node: Using Shell Variables440239 +Node: Action Overview442513 +Node: Statements444838 +Node: If Statement446686 +Node: While Statement448181 +Node: Do Statement450209 +Node: For Statement451357 +Node: Switch Statement454528 +Node: Break Statement456969 +Node: Continue Statement459061 +Node: Next Statement460888 +Node: Nextfile Statement463271 +Node: Exit Statement465960 +Node: Built-in Variables468363 +Node: User-modified469496 +Node: Auto-set477263 +Ref: Auto-set-Footnote-1494070 +Ref: Auto-set-Footnote-2494276 +Node: ARGC and ARGV494332 +Node: Pattern Action Summary498545 +Node: Arrays500975 +Node: Array Basics502304 +Node: Array Intro503148 +Ref: figure-array-elements505123 +Ref: Array Intro-Footnote-1507827 +Node: Reference to Elements507955 +Node: Assigning Elements510419 +Node: Array Example510910 +Node: Scanning an Array512669 +Node: Controlling Scanning515691 +Ref: Controlling Scanning-Footnote-1522147 +Node: Numeric Array Subscripts522463 +Node: Uninitialized Subscripts524647 +Node: Delete526266 +Ref: Delete-Footnote-1529018 +Node: Multidimensional529075 +Node: Multiscanning532170 +Node: Arrays of Arrays533761 +Node: Arrays Summary538529 +Node: Functions540622 +Node: Built-in541660 +Node: Calling Built-in542741 +Node: Numeric Functions544737 +Ref: Numeric Functions-Footnote-1548765 +Ref: Numeric Functions-Footnote-2549413 +Ref: Numeric Functions-Footnote-3549461 +Node: String Functions549733 +Ref: String Functions-Footnote-1574043 +Ref: String Functions-Footnote-2574171 +Ref: String Functions-Footnote-3574419 +Node: Gory Details574506 +Ref: table-sub-escapes576297 +Ref: table-sub-proposed577816 +Ref: table-posix-sub579179 +Ref: table-gensub-escapes580720 +Ref: Gory Details-Footnote-1581543 +Node: I/O Functions581697 +Ref: table-system-return-values588151 +Ref: I/O Functions-Footnote-1590231 +Ref: I/O Functions-Footnote-2590379 +Node: Time Functions590499 +Ref: Time Functions-Footnote-1601170 +Ref: Time Functions-Footnote-2601238 +Ref: Time Functions-Footnote-3601396 +Ref: Time Functions-Footnote-4601507 +Ref: Time Functions-Footnote-5601619 +Ref: Time Functions-Footnote-6601846 +Node: Bitwise Functions602112 +Ref: table-bitwise-ops602706 +Ref: Bitwise Functions-Footnote-1608769 +Ref: Bitwise Functions-Footnote-2608942 +Node: Type Functions609133 +Node: I18N Functions611996 +Node: User-defined613647 +Node: Definition Syntax614459 +Ref: Definition Syntax-Footnote-1620153 +Node: Function Example620224 +Ref: Function Example-Footnote-1623146 +Node: Function Calling623168 +Node: Calling A Function623756 +Node: Variable Scope624714 +Node: Pass By Value/Reference627708 +Node: Function Caveats630352 +Ref: Function Caveats-Footnote-1632399 +Node: Return Statement632519 +Node: Dynamic Typing635498 +Node: Indirect Calls636428 +Ref: Indirect Calls-Footnote-1646680 +Node: Functions Summary646808 +Node: Library Functions649513 +Ref: Library Functions-Footnote-1653120 +Ref: Library Functions-Footnote-2653263 +Node: Library Names653434 +Ref: Library Names-Footnote-1657101 +Ref: Library Names-Footnote-2657324 +Node: General Functions657410 +Node: Strtonum Function658592 +Node: Assert Function661614 +Node: Round Function664940 +Node: Cliff Random Function666480 +Node: Ordinal Functions667496 +Ref: Ordinal Functions-Footnote-1670559 +Ref: Ordinal Functions-Footnote-2670811 +Node: Join Function671021 +Ref: Join Function-Footnote-1672791 +Node: Getlocaltime Function672991 +Node: Readfile Function676733 +Node: Shell Quoting678710 +Node: Isnumeric Function680138 +Node: Data File Management681526 +Node: Filetrans Function682158 +Node: Rewind Function686254 +Node: File Checking688163 +Ref: File Checking-Footnote-1689497 +Node: Empty Files689698 +Node: Ignoring Assigns691677 +Node: Getopt Function693227 +Ref: Getopt Function-Footnote-1708450 +Node: Passwd Functions708650 +Ref: Passwd Functions-Footnote-1717489 +Node: Group Functions717577 +Ref: Group Functions-Footnote-1725475 +Node: Walking Arrays725682 +Node: Library Functions Summary728690 +Node: Library Exercises730096 +Node: Sample Programs730561 +Node: Running Examples731331 +Node: Clones732059 +Node: Cut Program733283 +Node: Egrep Program743423 +Node: Id Program752424 +Node: Split Program762371 +Ref: Split Program-Footnote-1772264 +Node: Tee Program772437 +Node: Uniq Program775227 +Node: Wc Program782815 +Node: Bytes vs. Characters783202 +Node: Using extensions784750 +Node: wc program785504 +Node: Miscellaneous Programs790369 +Node: Dupword Program791582 +Node: Alarm Program793612 +Node: Translate Program798467 +Ref: Translate Program-Footnote-1803032 +Node: Labels Program803302 +Ref: Labels Program-Footnote-1806653 +Node: Word Sorting806737 +Node: History Sorting810809 +Node: Extract Program813034 +Node: Simple Sed821088 +Node: Igawk Program824162 +Ref: Igawk Program-Footnote-1838493 +Ref: Igawk Program-Footnote-2838695 +Ref: Igawk Program-Footnote-3838817 +Node: Anagram Program838932 +Node: Signature Program841994 +Node: Programs Summary843241 +Node: Programs Exercises844455 +Ref: Programs Exercises-Footnote-1848585 +Node: Advanced Features848671 +Node: Nondecimal Data850738 +Node: Array Sorting852329 +Node: Controlling Array Traversal853029 +Ref: Controlling Array Traversal-Footnote-1861397 +Node: Array Sorting Functions861515 +Ref: Array Sorting Functions-Footnote-1866889 +Node: Two-way I/O867085 +Ref: Two-way I/O-Footnote-1874811 +Ref: Two-way I/O-Footnote-2874998 +Node: TCP/IP Networking875080 +Node: Profiling878198 +Node: Extension Philosophy887507 +Node: Advanced Features Summary888986 +Node: Internationalization891001 +Node: I18N and L10N892675 +Node: Explaining gettext893362 +Ref: Explaining gettext-Footnote-1899254 +Ref: Explaining gettext-Footnote-2899439 +Node: Programmer i18n899604 +Ref: Programmer i18n-Footnote-1904553 +Node: Translator i18n904602 +Node: String Extraction905396 +Ref: String Extraction-Footnote-1906528 +Node: Printf Ordering906614 +Ref: Printf Ordering-Footnote-1909400 +Node: I18N Portability909464 +Ref: I18N Portability-Footnote-1911920 +Node: I18N Example911983 +Ref: I18N Example-Footnote-1915258 +Ref: I18N Example-Footnote-2915331 +Node: Gawk I18N915440 +Node: I18N Summary916089 +Node: Debugger917430 +Node: Debugging918430 +Node: Debugging Concepts918871 +Node: Debugging Terms920680 +Node: Awk Debugging923255 +Ref: Awk Debugging-Footnote-1924200 +Node: Sample Debugging Session924332 +Node: Debugger Invocation924866 +Node: Finding The Bug926252 +Node: List of Debugger Commands932726 +Node: Breakpoint Control934059 +Node: Debugger Execution Control937753 +Node: Viewing And Changing Data941115 +Node: Execution Stack944656 +Node: Debugger Info946293 +Node: Miscellaneous Debugger Commands950364 +Node: Readline Support955426 +Node: Limitations956322 +Node: Debugging Summary958876 +Node: Namespaces960155 +Node: Global Namespace961266 +Node: Qualified Names962664 +Node: Default Namespace963663 +Node: Changing The Namespace964404 +Node: Naming Rules966018 +Node: Internal Name Management967866 +Node: Namespace Example968908 +Node: Namespace And Features971470 +Node: Namespace Summary972905 +Node: Arbitrary Precision Arithmetic974382 +Node: Computer Arithmetic975869 +Ref: table-numeric-ranges979635 +Ref: table-floating-point-ranges980128 +Ref: Computer Arithmetic-Footnote-1980786 +Node: Math Definitions980843 +Ref: table-ieee-formats984159 +Ref: Math Definitions-Footnote-1984762 +Node: MPFR features984867 +Node: FP Math Caution986585 +Ref: FP Math Caution-Footnote-1987657 +Node: Inexactness of computations988026 +Node: Inexact representation988986 +Node: Comparing FP Values990346 +Node: Errors accumulate991587 +Node: Getting Accuracy993020 +Node: Try To Round995730 +Node: Setting precision996629 +Ref: table-predefined-precision-strings997326 +Node: Setting the rounding mode999156 +Ref: table-gawk-rounding-modes999530 +Ref: Setting the rounding mode-Footnote-11003461 +Node: Arbitrary Precision Integers1003640 +Ref: Arbitrary Precision Integers-Footnote-11006815 +Node: Checking for MPFR1006964 +Node: POSIX Floating Point Problems1008438 +Ref: POSIX Floating Point Problems-Footnote-11012723 +Node: Floating point summary1012761 +Node: Dynamic Extensions1014951 +Node: Extension Intro1016504 +Node: Plugin License1017770 +Node: Extension Mechanism Outline1018567 +Ref: figure-load-extension1019006 +Ref: figure-register-new-function1020571 +Ref: figure-call-new-function1021663 +Node: Extension API Description1023725 +Node: Extension API Functions Introduction1025438 +Ref: table-api-std-headers1027274 +Node: General Data Types1031523 +Ref: General Data Types-Footnote-11040153 +Node: Memory Allocation Functions1040452 +Ref: Memory Allocation Functions-Footnote-11044953 +Node: Constructor Functions1045052 +Node: API Ownership of MPFR and GMP Values1048518 +Node: Registration Functions1049831 +Node: Extension Functions1050531 +Node: Exit Callback Functions1055853 +Node: Extension Version String1057103 +Node: Input Parsers1057766 +Node: Output Wrappers1070487 +Node: Two-way processors1074999 +Node: Printing Messages1077264 +Ref: Printing Messages-Footnote-11078435 +Node: Updating ERRNO1078588 +Node: Requesting Values1079327 +Ref: table-value-types-returned1080064 +Node: Accessing Parameters1081000 +Node: Symbol Table Access1082237 +Node: Symbol table by name1082749 +Ref: Symbol table by name-Footnote-11085773 +Node: Symbol table by cookie1085901 +Ref: Symbol table by cookie-Footnote-11090086 +Node: Cached values1090150 +Ref: Cached values-Footnote-11093686 +Node: Array Manipulation1093839 +Ref: Array Manipulation-Footnote-11094930 +Node: Array Data Types1094967 +Ref: Array Data Types-Footnote-11097625 +Node: Array Functions1097717 +Node: Flattening Arrays1102215 +Node: Creating Arrays1109191 +Node: Redirection API1113958 +Node: Extension API Variables1116791 +Node: Extension Versioning1117502 +Ref: gawk-api-version1117931 +Node: Extension GMP/MPFR Versioning1119662 +Node: Extension API Informational Variables1121290 +Node: Extension API Boilerplate1122363 +Node: Changes from API V11126337 +Node: Finding Extensions1127909 +Node: Extension Example1128468 +Node: Internal File Description1129266 +Node: Internal File Ops1133346 +Ref: Internal File Ops-Footnote-11144696 +Node: Using Internal File Ops1144836 +Ref: Using Internal File Ops-Footnote-11147219 +Node: Extension Samples1147493 +Node: Extension Sample File Functions1149022 +Node: Extension Sample Fnmatch1156671 +Node: Extension Sample Fork1158158 +Node: Extension Sample Inplace1159376 +Node: Extension Sample Ord1163002 +Node: Extension Sample Readdir1163838 +Ref: table-readdir-file-types1164727 +Node: Extension Sample Revout1165794 +Node: Extension Sample Rev2way1166383 +Node: Extension Sample Read write array1167123 +Node: Extension Sample Readfile1169065 +Node: Extension Sample Time1170160 +Node: Extension Sample API Tests1171912 +Node: gawkextlib1172404 +Node: Extension summary1175322 +Node: Extension Exercises1179024 +Node: Language History1180266 +Node: V7/SVR3.11181922 +Node: SVR41184074 +Node: POSIX1185508 +Node: BTL1186889 +Node: POSIX/GNU1187618 +Node: Feature History1193396 +Node: Common Extensions1210571 +Node: Ranges and Locales1211854 +Ref: Ranges and Locales-Footnote-11216470 +Ref: Ranges and Locales-Footnote-21216497 +Ref: Ranges and Locales-Footnote-31216732 +Node: Contributors1216955 +Node: History summary1222952 +Node: Installation1224332 +Node: Gawk Distribution1225276 +Node: Getting1225760 +Node: Extracting1226723 +Node: Distribution contents1228361 +Node: Unix Installation1234841 +Node: Quick Installation1235523 +Node: Compiling with MPFR1238004 +Node: Shell Startup Files1238696 +Node: Additional Configuration Options1239785 +Node: Configuration Philosophy1242100 +Node: Non-Unix Installation1244469 +Node: PC Installation1244929 +Node: PC Binary Installation1245767 +Node: PC Compiling1246202 +Node: PC Using1247319 +Node: Cygwin1250872 +Node: MSYS1252096 +Node: VMS Installation1252698 +Node: VMS Compilation1253417 +Ref: VMS Compilation-Footnote-11254646 +Node: VMS Dynamic Extensions1254704 +Node: VMS Installation Details1256389 +Node: VMS Running1258651 +Node: VMS GNV1262930 +Node: Bugs1263644 +Node: Bug definition1264524 +Node: Bug address1267028 +Node: Usenet1270416 +Node: Performance bugs1271425 +Node: Asking for help1274346 +Node: Maintainers1276308 +Node: Other Versions1277502 +Node: Installation summary1285354 +Node: Notes1286718 +Node: Compatibility Mode1287512 +Node: Additions1288294 +Node: Accessing The Source1289219 +Node: Adding Code1290656 +Node: New Ports1296875 +Node: Derived Files1301250 +Ref: Derived Files-Footnote-11306910 +Ref: Derived Files-Footnote-21306945 +Ref: Derived Files-Footnote-31307543 +Node: Future Extensions1307657 +Node: Implementation Limitations1308315 +Node: Extension Design1309525 +Node: Old Extension Problems1310669 +Ref: Old Extension Problems-Footnote-11312187 +Node: Extension New Mechanism Goals1312244 +Ref: Extension New Mechanism Goals-Footnote-11315608 +Node: Extension Other Design Decisions1315797 +Node: Extension Future Growth1317910 +Node: Notes summary1318516 +Node: Basic Concepts1319674 +Node: Basic High Level1320355 +Ref: figure-general-flow1320637 +Ref: figure-process-flow1321322 +Ref: Basic High Level-Footnote-11324623 +Node: Basic Data Typing1324808 +Node: Glossary1328136 +Node: Copying1360021 +Node: GNU Free Documentation License1397564 +Node: Index1422684 End Tag Table diff --git a/doc/gawk.texi b/doc/gawk.texi index 75e8e315..c3ec64e5 100644 --- a/doc/gawk.texi +++ b/doc/gawk.texi @@ -1054,8 +1054,6 @@ particular records in a file and perform operations upon them. VMS. * VMS Running:: How to run @command{gawk} under VMS. * VMS GNV:: The VMS GNV Project. -* VMS Old Gawk:: An old version comes with some VMS - systems. * Bugs:: Reporting Problems and Bugs. * Bug definition:: Defining what is and is not a bug. * Bug address:: Where to send reports to. @@ -42416,7 +42414,7 @@ recipe works ``out of the box.'' @cindex @command{gawk} @subentry VMS version of @cindex installing @command{gawk} @subentry VMS -This @value{SUBSECTION} describes how to compile and install @command{gawk} under VMS. +This @value{SUBSECTION} describes how to compile and install @command{gawk} under OpenVMS. The older designation ``VMS'' is used throughout to refer to OpenVMS. @menu @@ -42426,7 +42424,6 @@ The older designation ``VMS'' is used throughout to refer to OpenVMS. * VMS Installation Details:: How to install @command{gawk} under VMS. * VMS Running:: How to run @command{gawk} under VMS. * VMS GNV:: The VMS GNV Project. -* VMS Old Gawk:: An old version comes with some VMS systems. @end menu @node VMS Compilation @@ -42568,7 +42565,7 @@ $ @kbd{set command gnv$gnu:[vms_bin]gawk_verb.cld} @end example Or the system manager can use @file{GNV$GNU:[vms_bin]gawk_verb.cld} to -add the @command{gawk} and @command{awk} to the system-wide @samp{DCLTABLES}. +add the @command{gawk} and @command{awk} commands to the system-wide @samp{DCLTABLES}. The DCL syntax is documented in the @file{gawk.hlp} file. @@ -42662,8 +42659,6 @@ VMS reports time values in GMT unless one of the @code{SYS$TIMEZONE_RULE} or @code{TZ} logical names is set. Older versions of VMS, such as VAX/VMS 7.3, do not set these logical names. -@c @cindex directory search -@c @cindex path, search @cindex search paths @cindex search paths @subentry for source files The default search path, when looking for @command{awk} program files specified @@ -42718,7 +42713,6 @@ $ define/user sys$input sys$command: $ sort sys$input: sys$output: @end example - @node VMS GNV @appendixsubsubsec The VMS GNV Project @@ -42734,56 +42728,6 @@ is suitable for use with GNV. The file @file{vms/gawk_build_steps.txt} in the distribution documents the procedure for building a VMS PCSI kit that is compatible with GNV. -@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 - -Ignore the instructions above, although @file{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, @file{configure} and -@file{vms/posix-cc.sh}, are executable; use @samp{chmod +x} on them if -necessary. Then execute the following two commands: - -@example -psx> @kbd{CC=vms/posix-cc.sh configure} -psx> @kbd{make CC=c89 gawk} -@end example - -@noindent -The first command constructs files @file{config.h} and @file{Makefile} out -of templates, using a script to make the C compiler fit @command{configure}'s -expectations. The second command compiles and links @command{gawk} using -the C compiler directly; ignore any warnings from @command{make} about being -unable to redefine @code{CC}. @command{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, @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} - -@c Thanks to "gerard labadie" <gerard.labadie@gmail.com> - -Some versions of VMS have an old version of @command{gawk}. To access it, -define a symbol, as follows: - -@example -$ @kbd{gawk :== $sys$common:[syshlp.examples.tcpip.snmp]gawk.exe} -@end example - -This is apparently @value{PVERSION} 2.15.6, which is extremely old. We -recommend compiling and using the current version. - @node Bugs @appendixsec Reporting Problems and Bugs @cindex archaeologists diff --git a/doc/gawktexi.in b/doc/gawktexi.in index a795f0dc..1584d3f4 100644 --- a/doc/gawktexi.in +++ b/doc/gawktexi.in @@ -1049,8 +1049,6 @@ particular records in a file and perform operations upon them. VMS. * VMS Running:: How to run @command{gawk} under VMS. * VMS GNV:: The VMS GNV Project. -* VMS Old Gawk:: An old version comes with some VMS - systems. * Bugs:: Reporting Problems and Bugs. * Bug definition:: Defining what is and is not a bug. * Bug address:: Where to send reports to. @@ -41259,7 +41257,7 @@ recipe works ``out of the box.'' @cindex @command{gawk} @subentry VMS version of @cindex installing @command{gawk} @subentry VMS -This @value{SUBSECTION} describes how to compile and install @command{gawk} under VMS. +This @value{SUBSECTION} describes how to compile and install @command{gawk} under OpenVMS. The older designation ``VMS'' is used throughout to refer to OpenVMS. @menu @@ -41269,7 +41267,6 @@ The older designation ``VMS'' is used throughout to refer to OpenVMS. * VMS Installation Details:: How to install @command{gawk} under VMS. * VMS Running:: How to run @command{gawk} under VMS. * VMS GNV:: The VMS GNV Project. -* VMS Old Gawk:: An old version comes with some VMS systems. @end menu @node VMS Compilation @@ -41411,7 +41408,7 @@ $ @kbd{set command gnv$gnu:[vms_bin]gawk_verb.cld} @end example Or the system manager can use @file{GNV$GNU:[vms_bin]gawk_verb.cld} to -add the @command{gawk} and @command{awk} to the system-wide @samp{DCLTABLES}. +add the @command{gawk} and @command{awk} commands to the system-wide @samp{DCLTABLES}. The DCL syntax is documented in the @file{gawk.hlp} file. @@ -41505,8 +41502,6 @@ VMS reports time values in GMT unless one of the @code{SYS$TIMEZONE_RULE} or @code{TZ} logical names is set. Older versions of VMS, such as VAX/VMS 7.3, do not set these logical names. -@c @cindex directory search -@c @cindex path, search @cindex search paths @cindex search paths @subentry for source files The default search path, when looking for @command{awk} program files specified @@ -41561,7 +41556,6 @@ $ define/user sys$input sys$command: $ sort sys$input: sys$output: @end example - @node VMS GNV @appendixsubsubsec The VMS GNV Project @@ -41577,56 +41571,6 @@ is suitable for use with GNV. The file @file{vms/gawk_build_steps.txt} in the distribution documents the procedure for building a VMS PCSI kit that is compatible with GNV. -@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 - -Ignore the instructions above, although @file{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, @file{configure} and -@file{vms/posix-cc.sh}, are executable; use @samp{chmod +x} on them if -necessary. Then execute the following two commands: - -@example -psx> @kbd{CC=vms/posix-cc.sh configure} -psx> @kbd{make CC=c89 gawk} -@end example - -@noindent -The first command constructs files @file{config.h} and @file{Makefile} out -of templates, using a script to make the C compiler fit @command{configure}'s -expectations. The second command compiles and links @command{gawk} using -the C compiler directly; ignore any warnings from @command{make} about being -unable to redefine @code{CC}. @command{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, @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} - -@c Thanks to "gerard labadie" <gerard.labadie@gmail.com> - -Some versions of VMS have an old version of @command{gawk}. To access it, -define a symbol, as follows: - -@example -$ @kbd{gawk :== $sys$common:[syshlp.examples.tcpip.snmp]gawk.exe} -@end example - -This is apparently @value{PVERSION} 2.15.6, which is extremely old. We -recommend compiling and using the current version. - @node Bugs @appendixsec Reporting Problems and Bugs @cindex archaeologists |