diff options
author | Arnold D. Robbins <arnold@skeeve.com> | 2021-07-15 07:34:13 +0300 |
---|---|---|
committer | Arnold D. Robbins <arnold@skeeve.com> | 2021-07-15 07:34:13 +0300 |
commit | d67e86cb0869244fe4124d23def7be08fa6ab4ce (patch) | |
tree | cbfb7aa96bdfcd58ff10e0c7b2f13b82d80e653f /doc/gawk.info | |
parent | 257b436d7aa1622c24e974ec11956133908acfea (diff) | |
parent | 41b120c7a932b6bb9eccb24b03475a74ca1303ca (diff) | |
download | egawk-d67e86cb0869244fe4124d23def7be08fa6ab4ce.tar.gz egawk-d67e86cb0869244fe4124d23def7be08fa6ab4ce.tar.bz2 egawk-d67e86cb0869244fe4124d23def7be08fa6ab4ce.zip |
Merge branch 'gawk-5.1-stable'
Diffstat (limited to 'doc/gawk.info')
-rw-r--r-- | doc/gawk.info | 1232 |
1 files changed, 607 insertions, 625 deletions
diff --git a/doc/gawk.info b/doc/gawk.info index 1a5e6bfd..cc34390f 100644 --- a/doc/gawk.info +++ b/doc/gawk.info @@ -685,8 +685,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. @@ -31231,7 +31229,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: @@ -31242,7 +31240,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 @@ -31367,7 +31364,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. @@ -31500,7 +31497,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 ........................... @@ -31518,20 +31515,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 @@ -38511,611 +38494,610 @@ Index Tag Table: Node: Top1200 -Node: Foreword345479 -Node: Foreword449921 -Node: Preface51453 -Ref: Preface-Footnote-154312 -Ref: Preface-Footnote-254421 -Ref: Preface-Footnote-354655 -Node: History54797 -Node: Names57149 -Ref: Names-Footnote-158253 -Node: This Manual58400 -Ref: This Manual-Footnote-165039 -Node: Conventions65139 -Node: Manual History67508 -Ref: Manual History-Footnote-170505 -Ref: Manual History-Footnote-270546 -Node: How To Contribute70620 -Node: Acknowledgments71546 -Node: Getting Started76483 -Node: Running gawk78922 -Node: One-shot80112 -Node: Read Terminal81375 -Node: Long83368 -Node: Executable Scripts84881 -Ref: Executable Scripts-Footnote-187514 -Node: Comments87617 -Node: Quoting90101 -Node: DOS Quoting95627 -Node: Sample Data Files97683 -Node: Very Simple100278 -Node: Two Rules106380 -Node: More Complex108265 -Node: Statements/Lines110597 -Ref: Statements/Lines-Footnote-1115081 -Node: Other Features115346 -Node: When116282 -Ref: When-Footnote-1118036 -Node: Intro Summary118101 -Node: Invoking Gawk118985 -Node: Command Line120499 -Node: Options121297 -Ref: Options-Footnote-1139211 -Ref: Options-Footnote-2139442 -Node: Other Arguments139467 -Node: Naming Standard Input143478 -Node: Environment Variables144688 -Node: AWKPATH Variable145246 -Ref: AWKPATH Variable-Footnote-1148658 -Ref: AWKPATH Variable-Footnote-2148692 -Node: AWKLIBPATH Variable149063 -Ref: AWKLIBPATH Variable-Footnote-1150760 -Node: Other Environment Variables151135 -Node: Exit Status155087 -Node: Include Files155764 -Node: Loading Shared Libraries159454 -Node: Obsolete160882 -Node: Undocumented161574 -Node: Invoking Summary161871 -Node: Regexp164712 -Node: Regexp Usage166166 -Node: Escape Sequences168203 -Node: Regexp Operators174444 -Node: Regexp Operator Details174929 -Ref: Regexp Operator Details-Footnote-1182293 -Node: Interval Expressions182440 -Ref: Interval Expressions-Footnote-1183861 -Node: Bracket Expressions183959 -Ref: table-char-classes186435 -Node: Leftmost Longest189761 -Node: Computed Regexps191064 -Node: GNU Regexp Operators194491 -Node: Case-sensitivity198228 -Ref: Case-sensitivity-Footnote-1201094 -Ref: Case-sensitivity-Footnote-2201329 -Node: Regexp Summary201437 -Node: Reading Files202903 -Node: Records205172 -Node: awk split records206247 -Node: gawk split records210947 -Ref: gawk split records-Footnote-1216021 -Node: Fields216058 -Node: Nonconstant Fields218799 -Ref: Nonconstant Fields-Footnote-1221035 -Node: Changing Fields221239 -Node: Field Separators227270 -Node: Default Field Splitting229968 -Node: Regexp Field Splitting231086 -Node: Single Character Fields234763 -Node: Command Line Field Separator235823 -Node: Full Line Fields239041 -Ref: Full Line Fields-Footnote-1240563 -Ref: Full Line Fields-Footnote-2240609 -Node: Field Splitting Summary240710 -Node: Constant Size242784 -Node: Fixed width data243516 -Node: Skipping intervening246983 -Node: Allowing trailing data247781 -Node: Fields with fixed data248818 -Node: Splitting By Content250336 -Ref: Splitting By Content-Footnote-1254119 -Node: More CSV254282 -Node: Testing field creation255874 -Node: Multiple Line257499 -Node: Getline263776 -Node: Plain Getline266245 -Node: Getline/Variable268818 -Node: Getline/File269969 -Node: Getline/Variable/File271357 -Ref: Getline/Variable/File-Footnote-1272962 -Node: Getline/Pipe273050 -Node: Getline/Variable/Pipe275754 -Node: Getline/Coprocess276889 -Node: Getline/Variable/Coprocess278156 -Node: Getline Notes278898 -Node: Getline Summary281695 -Ref: table-getline-variants282119 -Node: Read Timeout282867 -Ref: Read Timeout-Footnote-1286773 -Node: Retrying Input286831 -Node: Command-line directories288030 -Node: Input Summary288936 -Node: Input Exercises292108 -Node: Printing292542 -Node: Print294376 -Node: Print Examples295833 -Node: Output Separators298613 -Node: OFMT300630 -Node: Printf301986 -Node: Basic Printf302771 -Node: Control Letters304345 -Node: Format Modifiers309507 -Node: Printf Examples315522 -Node: Redirection318008 -Node: Special FD324849 -Ref: Special FD-Footnote-1328017 -Node: Special Files328091 -Node: Other Inherited Files328708 -Node: Special Network329709 -Node: Special Caveats330569 -Node: Close Files And Pipes331518 -Ref: table-close-pipe-return-values338425 -Ref: Close Files And Pipes-Footnote-1339238 -Ref: Close Files And Pipes-Footnote-2339386 -Node: Nonfatal339538 -Node: Output Summary341876 -Node: Output Exercises343098 -Node: Expressions343777 -Node: Values344965 -Node: Constants345643 -Node: Scalar Constants346334 -Ref: Scalar Constants-Footnote-1348844 -Node: Nondecimal-numbers349094 -Node: Regexp Constants352095 -Node: Using Constant Regexps352621 -Node: Standard Regexp Constants353243 -Node: Strong Regexp Constants356431 -Node: Variables359443 -Node: Using Variables360100 -Node: Assignment Options362010 -Node: Conversion364481 -Node: Strings And Numbers365005 -Ref: Strings And Numbers-Footnote-1368068 -Node: Locale influences conversions368177 -Ref: table-locale-affects370935 -Node: All Operators371553 -Node: Arithmetic Ops372182 -Node: Concatenation374898 -Ref: Concatenation-Footnote-1377745 -Node: Assignment Ops377852 -Ref: table-assign-ops382843 -Node: Increment Ops384156 -Node: Truth Values and Conditions387616 -Node: Truth Values388690 -Node: Typing and Comparison389738 -Node: Variable Typing390558 -Ref: Variable Typing-Footnote-1397021 -Ref: Variable Typing-Footnote-2397093 -Node: Comparison Operators397170 -Ref: table-relational-ops397589 -Node: POSIX String Comparison401084 -Ref: POSIX String Comparison-Footnote-1402779 -Ref: POSIX String Comparison-Footnote-2402918 -Node: Boolean Ops403002 -Ref: Boolean Ops-Footnote-1407484 -Node: Conditional Exp407576 -Node: Function Calls409312 -Node: Precedence413189 -Node: Locales416848 -Node: Expressions Summary418480 -Node: Patterns and Actions421053 -Node: Pattern Overview422173 -Node: Regexp Patterns423850 -Node: Expression Patterns424392 -Node: Ranges428173 -Node: BEGIN/END431281 -Node: Using BEGIN/END432042 -Ref: Using BEGIN/END-Footnote-1434796 -Node: I/O And BEGIN/END434902 -Node: BEGINFILE/ENDFILE437215 -Node: Empty440446 -Node: Using Shell Variables440763 -Node: Action Overview443037 -Node: Statements445362 -Node: If Statement447210 -Node: While Statement448705 -Node: Do Statement450733 -Node: For Statement451881 -Node: Switch Statement455052 -Node: Break Statement457493 -Node: Continue Statement459585 -Node: Next Statement461412 -Node: Nextfile Statement463795 -Node: Exit Statement466484 -Node: Built-in Variables468887 -Node: User-modified470020 -Node: Auto-set477787 -Ref: Auto-set-Footnote-1494594 -Ref: Auto-set-Footnote-2494800 -Node: ARGC and ARGV494856 -Node: Pattern Action Summary499069 -Node: Arrays501499 -Node: Array Basics502828 -Node: Array Intro503672 -Ref: figure-array-elements505647 -Ref: Array Intro-Footnote-1508351 -Node: Reference to Elements508479 -Node: Assigning Elements510943 -Node: Array Example511434 -Node: Scanning an Array513193 -Node: Controlling Scanning516215 -Ref: Controlling Scanning-Footnote-1522671 -Node: Numeric Array Subscripts522987 -Node: Uninitialized Subscripts525171 -Node: Delete526790 -Ref: Delete-Footnote-1529542 -Node: Multidimensional529599 -Node: Multiscanning532694 -Node: Arrays of Arrays534285 -Node: Arrays Summary539053 -Node: Functions541146 -Node: Built-in542184 -Node: Calling Built-in543337 -Node: Boolean Functions545333 -Node: Numeric Functions545887 -Ref: Numeric Functions-Footnote-1549914 -Ref: Numeric Functions-Footnote-2550562 -Ref: Numeric Functions-Footnote-3550610 -Node: String Functions550882 -Ref: String Functions-Footnote-1575192 -Ref: String Functions-Footnote-2575320 -Ref: String Functions-Footnote-3575568 -Node: Gory Details575655 -Ref: table-sub-escapes577446 -Ref: table-sub-proposed578965 -Ref: table-posix-sub580328 -Ref: table-gensub-escapes581869 -Ref: Gory Details-Footnote-1582692 -Node: I/O Functions582846 -Ref: table-system-return-values589300 -Ref: I/O Functions-Footnote-1591380 -Ref: I/O Functions-Footnote-2591528 -Node: Time Functions591648 -Ref: Time Functions-Footnote-1602319 -Ref: Time Functions-Footnote-2602387 -Ref: Time Functions-Footnote-3602545 -Ref: Time Functions-Footnote-4602656 -Ref: Time Functions-Footnote-5602768 -Ref: Time Functions-Footnote-6602995 -Node: Bitwise Functions603261 -Ref: table-bitwise-ops603855 -Ref: Bitwise Functions-Footnote-1609918 -Ref: Bitwise Functions-Footnote-2610091 -Node: Type Functions610282 -Node: I18N Functions613236 -Node: User-defined614887 -Node: Definition Syntax615699 -Ref: Definition Syntax-Footnote-1621393 -Node: Function Example621464 -Ref: Function Example-Footnote-1624386 -Node: Function Calling624408 -Node: Calling A Function624996 -Node: Variable Scope625954 -Node: Pass By Value/Reference628948 -Node: Function Caveats631592 -Ref: Function Caveats-Footnote-1633639 -Node: Return Statement633759 -Node: Dynamic Typing636738 -Node: Indirect Calls637668 -Ref: Indirect Calls-Footnote-1647923 -Node: Functions Summary648051 -Node: Library Functions650756 -Ref: Library Functions-Footnote-1654363 -Ref: Library Functions-Footnote-2654506 -Node: Library Names654677 -Ref: Library Names-Footnote-1658344 -Ref: Library Names-Footnote-2658567 -Node: General Functions658653 -Node: Strtonum Function659835 -Node: Assert Function662857 -Node: Round Function666183 -Node: Cliff Random Function667723 -Node: Ordinal Functions668739 -Ref: Ordinal Functions-Footnote-1671802 -Ref: Ordinal Functions-Footnote-2672054 -Node: Join Function672264 -Ref: Join Function-Footnote-1674034 -Node: Getlocaltime Function674234 -Node: Readfile Function677976 -Node: Shell Quoting679953 -Node: Isnumeric Function681381 -Node: Data File Management682769 -Node: Filetrans Function683401 -Node: Rewind Function687497 -Node: File Checking689406 -Ref: File Checking-Footnote-1690740 -Node: Empty Files690941 -Node: Ignoring Assigns692920 -Node: Getopt Function694470 -Ref: Getopt Function-Footnote-1709693 -Node: Passwd Functions709893 -Ref: Passwd Functions-Footnote-1718732 -Node: Group Functions718820 -Ref: Group Functions-Footnote-1726718 -Node: Walking Arrays726925 -Node: Library Functions Summary729933 -Node: Library Exercises731339 -Node: Sample Programs731804 -Node: Running Examples732574 -Node: Clones733302 -Node: Cut Program734526 -Node: Egrep Program744666 -Node: Id Program753667 -Node: Split Program763614 -Ref: Split Program-Footnote-1773507 -Node: Tee Program773680 -Node: Uniq Program776470 -Node: Wc Program784058 -Node: Bytes vs. Characters784445 -Node: Using extensions785993 -Node: wc program786747 -Node: Miscellaneous Programs791612 -Node: Dupword Program792825 -Node: Alarm Program794855 -Node: Translate Program799710 -Ref: Translate Program-Footnote-1804275 -Node: Labels Program804545 -Ref: Labels Program-Footnote-1807896 -Node: Word Sorting807980 -Node: History Sorting812052 -Node: Extract Program814277 -Node: Simple Sed822331 -Node: Igawk Program825405 -Ref: Igawk Program-Footnote-1839736 -Ref: Igawk Program-Footnote-2839938 -Ref: Igawk Program-Footnote-3840060 -Node: Anagram Program840175 -Node: Signature Program843237 -Node: Programs Summary844484 -Node: Programs Exercises845698 -Ref: Programs Exercises-Footnote-1849828 -Node: Advanced Features849914 -Node: Nondecimal Data852045 -Node: Boolean Typed Values853643 -Node: Array Sorting855524 -Node: Controlling Array Traversal856229 -Ref: Controlling Array Traversal-Footnote-1864597 -Node: Array Sorting Functions864715 -Ref: Array Sorting Functions-Footnote-1870089 -Node: Two-way I/O870285 -Ref: Two-way I/O-Footnote-1878011 -Ref: Two-way I/O-Footnote-2878198 -Node: TCP/IP Networking878280 -Node: Profiling881398 -Node: Extension Philosophy890707 -Node: Advanced Features Summary892186 -Node: Internationalization894201 -Node: I18N and L10N895875 -Node: Explaining gettext896562 -Ref: Explaining gettext-Footnote-1902454 -Ref: Explaining gettext-Footnote-2902639 -Node: Programmer i18n902804 -Ref: Programmer i18n-Footnote-1907753 -Node: Translator i18n907802 -Node: String Extraction908596 -Ref: String Extraction-Footnote-1909728 -Node: Printf Ordering909814 -Ref: Printf Ordering-Footnote-1912600 -Node: I18N Portability912664 -Ref: I18N Portability-Footnote-1915120 -Node: I18N Example915183 -Ref: I18N Example-Footnote-1918458 -Ref: I18N Example-Footnote-2918531 -Node: Gawk I18N918640 -Node: I18N Summary919289 -Node: Debugger920630 -Node: Debugging921630 -Node: Debugging Concepts922071 -Node: Debugging Terms923880 -Node: Awk Debugging926455 -Ref: Awk Debugging-Footnote-1927400 -Node: Sample Debugging Session927532 -Node: Debugger Invocation928066 -Node: Finding The Bug929452 -Node: List of Debugger Commands935926 -Node: Breakpoint Control937259 -Node: Debugger Execution Control940953 -Node: Viewing And Changing Data944315 -Node: Execution Stack947856 -Node: Debugger Info949493 -Node: Miscellaneous Debugger Commands953564 -Node: Readline Support958626 -Node: Limitations959522 -Node: Debugging Summary962076 -Node: Namespaces963355 -Node: Global Namespace964466 -Node: Qualified Names965864 -Node: Default Namespace966863 -Node: Changing The Namespace967604 -Node: Naming Rules969218 -Node: Internal Name Management971066 -Node: Namespace Example972108 -Node: Namespace And Features974670 -Node: Namespace Summary976105 -Node: Arbitrary Precision Arithmetic977582 -Node: Computer Arithmetic979069 -Ref: table-numeric-ranges982835 -Ref: table-floating-point-ranges983328 -Ref: Computer Arithmetic-Footnote-1983986 -Node: Math Definitions984043 -Ref: table-ieee-formats987019 -Node: MPFR features987586 -Node: FP Math Caution989304 -Ref: FP Math Caution-Footnote-1990376 -Node: Inexactness of computations990745 -Node: Inexact representation991776 -Node: Comparing FP Values993136 -Node: Errors accumulate994377 -Node: Strange values995833 -Ref: Strange values-Footnote-1998421 -Node: Getting Accuracy998526 -Node: Try To Round1001236 -Node: Setting precision1002135 -Ref: table-predefined-precision-strings1002832 -Node: Setting the rounding mode1004662 -Ref: table-gawk-rounding-modes1005036 -Ref: Setting the rounding mode-Footnote-11008967 -Node: Arbitrary Precision Integers1009146 -Ref: Arbitrary Precision Integers-Footnote-11012321 -Node: Checking for MPFR1012470 -Node: POSIX Floating Point Problems1013944 -Ref: POSIX Floating Point Problems-Footnote-11018229 -Node: Floating point summary1018267 -Node: Dynamic Extensions1020457 -Node: Extension Intro1022010 -Node: Plugin License1023276 -Node: Extension Mechanism Outline1024073 -Ref: figure-load-extension1024512 -Ref: figure-register-new-function1026077 -Ref: figure-call-new-function1027169 -Node: Extension API Description1029231 -Node: Extension API Functions Introduction1030944 -Ref: table-api-std-headers1032780 -Node: General Data Types1037029 -Ref: General Data Types-Footnote-11045735 -Node: Memory Allocation Functions1046034 -Ref: Memory Allocation Functions-Footnote-11050535 -Node: Constructor Functions1050634 -Node: API Ownership of MPFR and GMP Values1054287 -Node: Registration Functions1055600 -Node: Extension Functions1056300 -Node: Exit Callback Functions1061622 -Node: Extension Version String1062872 -Node: Input Parsers1063535 -Node: Output Wrappers1076256 -Node: Two-way processors1080768 -Node: Printing Messages1083033 -Ref: Printing Messages-Footnote-11084204 -Node: Updating ERRNO1084357 -Node: Requesting Values1085096 -Ref: table-value-types-returned1085833 -Node: Accessing Parameters1086941 -Node: Symbol Table Access1088178 -Node: Symbol table by name1088690 -Ref: Symbol table by name-Footnote-11091714 -Node: Symbol table by cookie1091842 -Ref: Symbol table by cookie-Footnote-11096027 -Node: Cached values1096091 -Ref: Cached values-Footnote-11099627 -Node: Array Manipulation1099780 -Ref: Array Manipulation-Footnote-11100871 -Node: Array Data Types1100908 -Ref: Array Data Types-Footnote-11103566 -Node: Array Functions1103658 -Node: Flattening Arrays1108156 -Node: Creating Arrays1115132 -Node: Redirection API1119899 -Node: Extension API Variables1122732 -Node: Extension Versioning1123443 -Ref: gawk-api-version1123872 -Node: Extension GMP/MPFR Versioning1125603 -Node: Extension API Informational Variables1127231 -Node: Extension API Boilerplate1128304 -Node: Changes from API V11132278 -Node: Finding Extensions1133850 -Node: Extension Example1134409 -Node: Internal File Description1135207 -Node: Internal File Ops1139287 -Ref: Internal File Ops-Footnote-11150637 -Node: Using Internal File Ops1150777 -Ref: Using Internal File Ops-Footnote-11153160 -Node: Extension Samples1153434 -Node: Extension Sample File Functions1154963 -Node: Extension Sample Fnmatch1162612 -Node: Extension Sample Fork1164099 -Node: Extension Sample Inplace1165317 -Node: Extension Sample Ord1168943 -Node: Extension Sample Readdir1169779 -Ref: table-readdir-file-types1170668 -Node: Extension Sample Revout1171735 -Node: Extension Sample Rev2way1172324 -Node: Extension Sample Read write array1173064 -Node: Extension Sample Readfile1175006 -Node: Extension Sample Time1176101 -Node: Extension Sample API Tests1177853 -Node: gawkextlib1178345 -Node: Extension summary1181263 -Node: Extension Exercises1184965 -Node: Language History1186207 -Node: V7/SVR3.11187863 -Node: SVR41190015 -Node: POSIX1191449 -Node: BTL1192830 -Node: POSIX/GNU1193559 -Node: Feature History1199337 -Node: Common Extensions1216512 -Node: Ranges and Locales1217795 -Ref: Ranges and Locales-Footnote-11222411 -Ref: Ranges and Locales-Footnote-21222438 -Ref: Ranges and Locales-Footnote-31222673 -Node: Contributors1222896 -Node: History summary1228893 -Node: Installation1230273 -Node: Gawk Distribution1231217 -Node: Getting1231701 -Node: Extracting1232664 -Node: Distribution contents1234302 -Node: Unix Installation1240782 -Node: Quick Installation1241464 -Node: Compiling with MPFR1243945 -Node: Shell Startup Files1244637 -Node: Additional Configuration Options1245726 -Node: Configuration Philosophy1248041 -Node: Non-Unix Installation1250410 -Node: PC Installation1250870 -Node: PC Binary Installation1251708 -Node: PC Compiling1252143 -Node: PC Using1253260 -Node: Cygwin1256813 -Node: MSYS1258037 -Node: VMS Installation1258639 -Node: VMS Compilation1259430 -Ref: VMS Compilation-Footnote-11260659 -Node: VMS Dynamic Extensions1260717 -Node: VMS Installation Details1262402 -Node: VMS Running1264655 -Node: VMS GNV1268934 -Node: VMS Old Gawk1269669 -Node: Bugs1270140 -Node: Bug definition1271020 -Node: Bug address1273524 -Node: Usenet1276912 -Node: Performance bugs1277921 -Node: Asking for help1280842 -Node: Maintainers1282804 -Node: Other Versions1283998 -Node: Installation summary1291850 -Node: Notes1293214 -Node: Compatibility Mode1294008 -Node: Additions1294790 -Node: Accessing The Source1295715 -Node: Adding Code1297152 -Node: New Ports1303371 -Node: Derived Files1307746 -Ref: Derived Files-Footnote-11313406 -Ref: Derived Files-Footnote-21313441 -Ref: Derived Files-Footnote-31314039 -Node: Future Extensions1314153 -Node: Implementation Limitations1314811 -Node: Extension Design1316021 -Node: Old Extension Problems1317165 -Ref: Old Extension Problems-Footnote-11318683 -Node: Extension New Mechanism Goals1318740 -Ref: Extension New Mechanism Goals-Footnote-11322104 -Node: Extension Other Design Decisions1322293 -Node: Extension Future Growth1324406 -Node: Notes summary1325012 -Node: Basic Concepts1326170 -Node: Basic High Level1326851 -Ref: figure-general-flow1327133 -Ref: figure-process-flow1327818 -Ref: Basic High Level-Footnote-11331119 -Node: Basic Data Typing1331304 -Node: Glossary1334632 -Node: Copying1366519 -Node: GNU Free Documentation License1404062 -Node: Index1429182 +Node: Foreword345355 +Node: Foreword449797 +Node: Preface51329 +Ref: Preface-Footnote-154188 +Ref: Preface-Footnote-254297 +Ref: Preface-Footnote-354531 +Node: History54673 +Node: Names57025 +Ref: Names-Footnote-158129 +Node: This Manual58276 +Ref: This Manual-Footnote-164915 +Node: Conventions65015 +Node: Manual History67384 +Ref: Manual History-Footnote-170381 +Ref: Manual History-Footnote-270422 +Node: How To Contribute70496 +Node: Acknowledgments71422 +Node: Getting Started76359 +Node: Running gawk78798 +Node: One-shot79988 +Node: Read Terminal81251 +Node: Long83244 +Node: Executable Scripts84757 +Ref: Executable Scripts-Footnote-187390 +Node: Comments87493 +Node: Quoting89977 +Node: DOS Quoting95503 +Node: Sample Data Files97559 +Node: Very Simple100154 +Node: Two Rules106256 +Node: More Complex108141 +Node: Statements/Lines110473 +Ref: Statements/Lines-Footnote-1114957 +Node: Other Features115222 +Node: When116158 +Ref: When-Footnote-1117912 +Node: Intro Summary117977 +Node: Invoking Gawk118861 +Node: Command Line120375 +Node: Options121173 +Ref: Options-Footnote-1139087 +Ref: Options-Footnote-2139318 +Node: Other Arguments139343 +Node: Naming Standard Input143354 +Node: Environment Variables144564 +Node: AWKPATH Variable145122 +Ref: AWKPATH Variable-Footnote-1148534 +Ref: AWKPATH Variable-Footnote-2148568 +Node: AWKLIBPATH Variable148939 +Ref: AWKLIBPATH Variable-Footnote-1150636 +Node: Other Environment Variables151011 +Node: Exit Status154963 +Node: Include Files155640 +Node: Loading Shared Libraries159330 +Node: Obsolete160758 +Node: Undocumented161450 +Node: Invoking Summary161747 +Node: Regexp164588 +Node: Regexp Usage166042 +Node: Escape Sequences168079 +Node: Regexp Operators174320 +Node: Regexp Operator Details174805 +Ref: Regexp Operator Details-Footnote-1182169 +Node: Interval Expressions182316 +Ref: Interval Expressions-Footnote-1183737 +Node: Bracket Expressions183835 +Ref: table-char-classes186311 +Node: Leftmost Longest189637 +Node: Computed Regexps190940 +Node: GNU Regexp Operators194367 +Node: Case-sensitivity198104 +Ref: Case-sensitivity-Footnote-1200970 +Ref: Case-sensitivity-Footnote-2201205 +Node: Regexp Summary201313 +Node: Reading Files202779 +Node: Records205048 +Node: awk split records206123 +Node: gawk split records210823 +Ref: gawk split records-Footnote-1215897 +Node: Fields215934 +Node: Nonconstant Fields218675 +Ref: Nonconstant Fields-Footnote-1220911 +Node: Changing Fields221115 +Node: Field Separators227146 +Node: Default Field Splitting229844 +Node: Regexp Field Splitting230962 +Node: Single Character Fields234639 +Node: Command Line Field Separator235699 +Node: Full Line Fields238917 +Ref: Full Line Fields-Footnote-1240439 +Ref: Full Line Fields-Footnote-2240485 +Node: Field Splitting Summary240586 +Node: Constant Size242660 +Node: Fixed width data243392 +Node: Skipping intervening246859 +Node: Allowing trailing data247657 +Node: Fields with fixed data248694 +Node: Splitting By Content250212 +Ref: Splitting By Content-Footnote-1253995 +Node: More CSV254158 +Node: Testing field creation255750 +Node: Multiple Line257375 +Node: Getline263652 +Node: Plain Getline266121 +Node: Getline/Variable268694 +Node: Getline/File269845 +Node: Getline/Variable/File271233 +Ref: Getline/Variable/File-Footnote-1272838 +Node: Getline/Pipe272926 +Node: Getline/Variable/Pipe275630 +Node: Getline/Coprocess276765 +Node: Getline/Variable/Coprocess278032 +Node: Getline Notes278774 +Node: Getline Summary281571 +Ref: table-getline-variants281995 +Node: Read Timeout282743 +Ref: Read Timeout-Footnote-1286649 +Node: Retrying Input286707 +Node: Command-line directories287906 +Node: Input Summary288812 +Node: Input Exercises291984 +Node: Printing292418 +Node: Print294252 +Node: Print Examples295709 +Node: Output Separators298489 +Node: OFMT300506 +Node: Printf301862 +Node: Basic Printf302647 +Node: Control Letters304221 +Node: Format Modifiers309383 +Node: Printf Examples315398 +Node: Redirection317884 +Node: Special FD324725 +Ref: Special FD-Footnote-1327893 +Node: Special Files327967 +Node: Other Inherited Files328584 +Node: Special Network329585 +Node: Special Caveats330445 +Node: Close Files And Pipes331394 +Ref: table-close-pipe-return-values338301 +Ref: Close Files And Pipes-Footnote-1339114 +Ref: Close Files And Pipes-Footnote-2339262 +Node: Nonfatal339414 +Node: Output Summary341752 +Node: Output Exercises342974 +Node: Expressions343653 +Node: Values344841 +Node: Constants345519 +Node: Scalar Constants346210 +Ref: Scalar Constants-Footnote-1348720 +Node: Nondecimal-numbers348970 +Node: Regexp Constants351971 +Node: Using Constant Regexps352497 +Node: Standard Regexp Constants353119 +Node: Strong Regexp Constants356307 +Node: Variables359319 +Node: Using Variables359976 +Node: Assignment Options361886 +Node: Conversion364357 +Node: Strings And Numbers364881 +Ref: Strings And Numbers-Footnote-1367944 +Node: Locale influences conversions368053 +Ref: table-locale-affects370811 +Node: All Operators371429 +Node: Arithmetic Ops372058 +Node: Concatenation374774 +Ref: Concatenation-Footnote-1377621 +Node: Assignment Ops377728 +Ref: table-assign-ops382719 +Node: Increment Ops384032 +Node: Truth Values and Conditions387492 +Node: Truth Values388566 +Node: Typing and Comparison389614 +Node: Variable Typing390434 +Ref: Variable Typing-Footnote-1396897 +Ref: Variable Typing-Footnote-2396969 +Node: Comparison Operators397046 +Ref: table-relational-ops397465 +Node: POSIX String Comparison400960 +Ref: POSIX String Comparison-Footnote-1402655 +Ref: POSIX String Comparison-Footnote-2402794 +Node: Boolean Ops402878 +Ref: Boolean Ops-Footnote-1407360 +Node: Conditional Exp407452 +Node: Function Calls409188 +Node: Precedence413065 +Node: Locales416724 +Node: Expressions Summary418356 +Node: Patterns and Actions420929 +Node: Pattern Overview422049 +Node: Regexp Patterns423726 +Node: Expression Patterns424268 +Node: Ranges428049 +Node: BEGIN/END431157 +Node: Using BEGIN/END431918 +Ref: Using BEGIN/END-Footnote-1434672 +Node: I/O And BEGIN/END434778 +Node: BEGINFILE/ENDFILE437091 +Node: Empty440322 +Node: Using Shell Variables440639 +Node: Action Overview442913 +Node: Statements445238 +Node: If Statement447086 +Node: While Statement448581 +Node: Do Statement450609 +Node: For Statement451757 +Node: Switch Statement454928 +Node: Break Statement457369 +Node: Continue Statement459461 +Node: Next Statement461288 +Node: Nextfile Statement463671 +Node: Exit Statement466360 +Node: Built-in Variables468763 +Node: User-modified469896 +Node: Auto-set477663 +Ref: Auto-set-Footnote-1494470 +Ref: Auto-set-Footnote-2494676 +Node: ARGC and ARGV494732 +Node: Pattern Action Summary498945 +Node: Arrays501375 +Node: Array Basics502704 +Node: Array Intro503548 +Ref: figure-array-elements505523 +Ref: Array Intro-Footnote-1508227 +Node: Reference to Elements508355 +Node: Assigning Elements510819 +Node: Array Example511310 +Node: Scanning an Array513069 +Node: Controlling Scanning516091 +Ref: Controlling Scanning-Footnote-1522547 +Node: Numeric Array Subscripts522863 +Node: Uninitialized Subscripts525047 +Node: Delete526666 +Ref: Delete-Footnote-1529418 +Node: Multidimensional529475 +Node: Multiscanning532570 +Node: Arrays of Arrays534161 +Node: Arrays Summary538929 +Node: Functions541022 +Node: Built-in542060 +Node: Calling Built-in543213 +Node: Boolean Functions545209 +Node: Numeric Functions545763 +Ref: Numeric Functions-Footnote-1549790 +Ref: Numeric Functions-Footnote-2550438 +Ref: Numeric Functions-Footnote-3550486 +Node: String Functions550758 +Ref: String Functions-Footnote-1575068 +Ref: String Functions-Footnote-2575196 +Ref: String Functions-Footnote-3575444 +Node: Gory Details575531 +Ref: table-sub-escapes577322 +Ref: table-sub-proposed578841 +Ref: table-posix-sub580204 +Ref: table-gensub-escapes581745 +Ref: Gory Details-Footnote-1582568 +Node: I/O Functions582722 +Ref: table-system-return-values589176 +Ref: I/O Functions-Footnote-1591256 +Ref: I/O Functions-Footnote-2591404 +Node: Time Functions591524 +Ref: Time Functions-Footnote-1602195 +Ref: Time Functions-Footnote-2602263 +Ref: Time Functions-Footnote-3602421 +Ref: Time Functions-Footnote-4602532 +Ref: Time Functions-Footnote-5602644 +Ref: Time Functions-Footnote-6602871 +Node: Bitwise Functions603137 +Ref: table-bitwise-ops603731 +Ref: Bitwise Functions-Footnote-1609794 +Ref: Bitwise Functions-Footnote-2609967 +Node: Type Functions610158 +Node: I18N Functions613112 +Node: User-defined614763 +Node: Definition Syntax615575 +Ref: Definition Syntax-Footnote-1621269 +Node: Function Example621340 +Ref: Function Example-Footnote-1624262 +Node: Function Calling624284 +Node: Calling A Function624872 +Node: Variable Scope625830 +Node: Pass By Value/Reference628824 +Node: Function Caveats631468 +Ref: Function Caveats-Footnote-1633515 +Node: Return Statement633635 +Node: Dynamic Typing636614 +Node: Indirect Calls637544 +Ref: Indirect Calls-Footnote-1647799 +Node: Functions Summary647927 +Node: Library Functions650632 +Ref: Library Functions-Footnote-1654239 +Ref: Library Functions-Footnote-2654382 +Node: Library Names654553 +Ref: Library Names-Footnote-1658220 +Ref: Library Names-Footnote-2658443 +Node: General Functions658529 +Node: Strtonum Function659711 +Node: Assert Function662733 +Node: Round Function666059 +Node: Cliff Random Function667599 +Node: Ordinal Functions668615 +Ref: Ordinal Functions-Footnote-1671678 +Ref: Ordinal Functions-Footnote-2671930 +Node: Join Function672140 +Ref: Join Function-Footnote-1673910 +Node: Getlocaltime Function674110 +Node: Readfile Function677852 +Node: Shell Quoting679829 +Node: Isnumeric Function681257 +Node: Data File Management682645 +Node: Filetrans Function683277 +Node: Rewind Function687373 +Node: File Checking689282 +Ref: File Checking-Footnote-1690616 +Node: Empty Files690817 +Node: Ignoring Assigns692796 +Node: Getopt Function694346 +Ref: Getopt Function-Footnote-1709569 +Node: Passwd Functions709769 +Ref: Passwd Functions-Footnote-1718608 +Node: Group Functions718696 +Ref: Group Functions-Footnote-1726594 +Node: Walking Arrays726801 +Node: Library Functions Summary729809 +Node: Library Exercises731215 +Node: Sample Programs731680 +Node: Running Examples732450 +Node: Clones733178 +Node: Cut Program734402 +Node: Egrep Program744542 +Node: Id Program753543 +Node: Split Program763490 +Ref: Split Program-Footnote-1773383 +Node: Tee Program773556 +Node: Uniq Program776346 +Node: Wc Program783934 +Node: Bytes vs. Characters784321 +Node: Using extensions785869 +Node: wc program786623 +Node: Miscellaneous Programs791488 +Node: Dupword Program792701 +Node: Alarm Program794731 +Node: Translate Program799586 +Ref: Translate Program-Footnote-1804151 +Node: Labels Program804421 +Ref: Labels Program-Footnote-1807772 +Node: Word Sorting807856 +Node: History Sorting811928 +Node: Extract Program814153 +Node: Simple Sed822207 +Node: Igawk Program825281 +Ref: Igawk Program-Footnote-1839612 +Ref: Igawk Program-Footnote-2839814 +Ref: Igawk Program-Footnote-3839936 +Node: Anagram Program840051 +Node: Signature Program843113 +Node: Programs Summary844360 +Node: Programs Exercises845574 +Ref: Programs Exercises-Footnote-1849704 +Node: Advanced Features849790 +Node: Nondecimal Data851921 +Node: Boolean Typed Values853519 +Node: Array Sorting855400 +Node: Controlling Array Traversal856105 +Ref: Controlling Array Traversal-Footnote-1864473 +Node: Array Sorting Functions864591 +Ref: Array Sorting Functions-Footnote-1869965 +Node: Two-way I/O870161 +Ref: Two-way I/O-Footnote-1877887 +Ref: Two-way I/O-Footnote-2878074 +Node: TCP/IP Networking878156 +Node: Profiling881274 +Node: Extension Philosophy890583 +Node: Advanced Features Summary892062 +Node: Internationalization894077 +Node: I18N and L10N895751 +Node: Explaining gettext896438 +Ref: Explaining gettext-Footnote-1902330 +Ref: Explaining gettext-Footnote-2902515 +Node: Programmer i18n902680 +Ref: Programmer i18n-Footnote-1907629 +Node: Translator i18n907678 +Node: String Extraction908472 +Ref: String Extraction-Footnote-1909604 +Node: Printf Ordering909690 +Ref: Printf Ordering-Footnote-1912476 +Node: I18N Portability912540 +Ref: I18N Portability-Footnote-1914996 +Node: I18N Example915059 +Ref: I18N Example-Footnote-1918334 +Ref: I18N Example-Footnote-2918407 +Node: Gawk I18N918516 +Node: I18N Summary919165 +Node: Debugger920506 +Node: Debugging921506 +Node: Debugging Concepts921947 +Node: Debugging Terms923756 +Node: Awk Debugging926331 +Ref: Awk Debugging-Footnote-1927276 +Node: Sample Debugging Session927408 +Node: Debugger Invocation927942 +Node: Finding The Bug929328 +Node: List of Debugger Commands935802 +Node: Breakpoint Control937135 +Node: Debugger Execution Control940829 +Node: Viewing And Changing Data944191 +Node: Execution Stack947732 +Node: Debugger Info949369 +Node: Miscellaneous Debugger Commands953440 +Node: Readline Support958502 +Node: Limitations959398 +Node: Debugging Summary961952 +Node: Namespaces963231 +Node: Global Namespace964342 +Node: Qualified Names965740 +Node: Default Namespace966739 +Node: Changing The Namespace967480 +Node: Naming Rules969094 +Node: Internal Name Management970942 +Node: Namespace Example971984 +Node: Namespace And Features974546 +Node: Namespace Summary975981 +Node: Arbitrary Precision Arithmetic977458 +Node: Computer Arithmetic978945 +Ref: table-numeric-ranges982711 +Ref: table-floating-point-ranges983204 +Ref: Computer Arithmetic-Footnote-1983862 +Node: Math Definitions983919 +Ref: table-ieee-formats986895 +Node: MPFR features987462 +Node: FP Math Caution989180 +Ref: FP Math Caution-Footnote-1990252 +Node: Inexactness of computations990621 +Node: Inexact representation991652 +Node: Comparing FP Values993012 +Node: Errors accumulate994253 +Node: Strange values995709 +Ref: Strange values-Footnote-1998297 +Node: Getting Accuracy998402 +Node: Try To Round1001112 +Node: Setting precision1002011 +Ref: table-predefined-precision-strings1002708 +Node: Setting the rounding mode1004538 +Ref: table-gawk-rounding-modes1004912 +Ref: Setting the rounding mode-Footnote-11008843 +Node: Arbitrary Precision Integers1009022 +Ref: Arbitrary Precision Integers-Footnote-11012197 +Node: Checking for MPFR1012346 +Node: POSIX Floating Point Problems1013820 +Ref: POSIX Floating Point Problems-Footnote-11018105 +Node: Floating point summary1018143 +Node: Dynamic Extensions1020333 +Node: Extension Intro1021886 +Node: Plugin License1023152 +Node: Extension Mechanism Outline1023949 +Ref: figure-load-extension1024388 +Ref: figure-register-new-function1025953 +Ref: figure-call-new-function1027045 +Node: Extension API Description1029107 +Node: Extension API Functions Introduction1030820 +Ref: table-api-std-headers1032656 +Node: General Data Types1036905 +Ref: General Data Types-Footnote-11045611 +Node: Memory Allocation Functions1045910 +Ref: Memory Allocation Functions-Footnote-11050411 +Node: Constructor Functions1050510 +Node: API Ownership of MPFR and GMP Values1054163 +Node: Registration Functions1055476 +Node: Extension Functions1056176 +Node: Exit Callback Functions1061498 +Node: Extension Version String1062748 +Node: Input Parsers1063411 +Node: Output Wrappers1076132 +Node: Two-way processors1080644 +Node: Printing Messages1082909 +Ref: Printing Messages-Footnote-11084080 +Node: Updating ERRNO1084233 +Node: Requesting Values1084972 +Ref: table-value-types-returned1085709 +Node: Accessing Parameters1086817 +Node: Symbol Table Access1088054 +Node: Symbol table by name1088566 +Ref: Symbol table by name-Footnote-11091590 +Node: Symbol table by cookie1091718 +Ref: Symbol table by cookie-Footnote-11095903 +Node: Cached values1095967 +Ref: Cached values-Footnote-11099503 +Node: Array Manipulation1099656 +Ref: Array Manipulation-Footnote-11100747 +Node: Array Data Types1100784 +Ref: Array Data Types-Footnote-11103442 +Node: Array Functions1103534 +Node: Flattening Arrays1108032 +Node: Creating Arrays1115008 +Node: Redirection API1119775 +Node: Extension API Variables1122608 +Node: Extension Versioning1123319 +Ref: gawk-api-version1123748 +Node: Extension GMP/MPFR Versioning1125479 +Node: Extension API Informational Variables1127107 +Node: Extension API Boilerplate1128180 +Node: Changes from API V11132154 +Node: Finding Extensions1133726 +Node: Extension Example1134285 +Node: Internal File Description1135083 +Node: Internal File Ops1139163 +Ref: Internal File Ops-Footnote-11150513 +Node: Using Internal File Ops1150653 +Ref: Using Internal File Ops-Footnote-11153036 +Node: Extension Samples1153310 +Node: Extension Sample File Functions1154839 +Node: Extension Sample Fnmatch1162488 +Node: Extension Sample Fork1163975 +Node: Extension Sample Inplace1165193 +Node: Extension Sample Ord1168819 +Node: Extension Sample Readdir1169655 +Ref: table-readdir-file-types1170544 +Node: Extension Sample Revout1171611 +Node: Extension Sample Rev2way1172200 +Node: Extension Sample Read write array1172940 +Node: Extension Sample Readfile1174882 +Node: Extension Sample Time1175977 +Node: Extension Sample API Tests1177729 +Node: gawkextlib1178221 +Node: Extension summary1181139 +Node: Extension Exercises1184841 +Node: Language History1186083 +Node: V7/SVR3.11187739 +Node: SVR41189891 +Node: POSIX1191325 +Node: BTL1192706 +Node: POSIX/GNU1193435 +Node: Feature History1199213 +Node: Common Extensions1216388 +Node: Ranges and Locales1217671 +Ref: Ranges and Locales-Footnote-11222287 +Ref: Ranges and Locales-Footnote-21222314 +Ref: Ranges and Locales-Footnote-31222549 +Node: Contributors1222772 +Node: History summary1228769 +Node: Installation1230149 +Node: Gawk Distribution1231093 +Node: Getting1231577 +Node: Extracting1232540 +Node: Distribution contents1234178 +Node: Unix Installation1240658 +Node: Quick Installation1241340 +Node: Compiling with MPFR1243821 +Node: Shell Startup Files1244513 +Node: Additional Configuration Options1245602 +Node: Configuration Philosophy1247917 +Node: Non-Unix Installation1250286 +Node: PC Installation1250746 +Node: PC Binary Installation1251584 +Node: PC Compiling1252019 +Node: PC Using1253136 +Node: Cygwin1256689 +Node: MSYS1257913 +Node: VMS Installation1258515 +Node: VMS Compilation1259234 +Ref: VMS Compilation-Footnote-11260463 +Node: VMS Dynamic Extensions1260521 +Node: VMS Installation Details1262206 +Node: VMS Running1264468 +Node: VMS GNV1268747 +Node: Bugs1269461 +Node: Bug definition1270341 +Node: Bug address1272845 +Node: Usenet1276233 +Node: Performance bugs1277242 +Node: Asking for help1280163 +Node: Maintainers1282125 +Node: Other Versions1283319 +Node: Installation summary1291171 +Node: Notes1292535 +Node: Compatibility Mode1293329 +Node: Additions1294111 +Node: Accessing The Source1295036 +Node: Adding Code1296473 +Node: New Ports1302692 +Node: Derived Files1307067 +Ref: Derived Files-Footnote-11312727 +Ref: Derived Files-Footnote-21312762 +Ref: Derived Files-Footnote-31313360 +Node: Future Extensions1313474 +Node: Implementation Limitations1314132 +Node: Extension Design1315342 +Node: Old Extension Problems1316486 +Ref: Old Extension Problems-Footnote-11318004 +Node: Extension New Mechanism Goals1318061 +Ref: Extension New Mechanism Goals-Footnote-11321425 +Node: Extension Other Design Decisions1321614 +Node: Extension Future Growth1323727 +Node: Notes summary1324333 +Node: Basic Concepts1325491 +Node: Basic High Level1326172 +Ref: figure-general-flow1326454 +Ref: figure-process-flow1327139 +Ref: Basic High Level-Footnote-11330440 +Node: Basic Data Typing1330625 +Node: Glossary1333953 +Node: Copying1365840 +Node: GNU Free Documentation License1403383 +Node: Index1428503 End Tag Table |