diff options
Diffstat (limited to 'doc')
| -rw-r--r-- | doc/ChangeLog | 7 | ||||
| -rw-r--r-- | doc/gawk.info | 1120 | ||||
| -rw-r--r-- | doc/gawk.texi | 9 | ||||
| -rw-r--r-- | doc/gawktexi.in | 9 |
4 files changed, 588 insertions, 557 deletions
diff --git a/doc/ChangeLog b/doc/ChangeLog index 33930e84..da1ba5ac 100644 --- a/doc/ChangeLog +++ b/doc/ChangeLog @@ -1,3 +1,10 @@ +2019-08-11 Arnold D. Robbins <arnold@skeeve.com> + + * gawktexi.in (Other Arguments): Document the old trick of + using ./count=1 to name a file that looks like a variable + assignment. Thanks to Ed Morton <mortoneccc@comcast.net> + for the suggestion. + 2019-07-23 Arnold D. Robbins <arnold@skeeve.com> * gawk.1: Fix typo, update edition. Thanks to Antonio diff --git a/doc/gawk.info b/doc/gawk.info index 88eae820..9875a0a2 100644 --- a/doc/gawk.info +++ b/doc/gawk.info @@ -2890,6 +2890,12 @@ not a file name: awk -f program.awk file1 count=1 file2 +As a side point, should you really need to have 'awk' process a file +named 'count=1' (or any file whose name looks like a variable +assignment), precede the file name with './', like so: + + awk -f program.awk file1 ./count=1 file2 + All the command-line arguments are made available to your 'awk' program in the 'ARGV' array (*note Built-in Variables::). Command-line options and the program text (if present) are omitted from 'ARGV'. All @@ -34008,11 +34014,11 @@ Index * arctangent: Numeric Functions. (line 12) * ARGC/ARGV variables: Auto-set. (line 15) * ARGC/ARGV variables, command-line arguments: Other Arguments. - (line 15) + (line 21) * ARGC/ARGV variables, how to use: ARGC and ARGV. (line 6) * ARGC/ARGV variables, portability and: Executable Scripts. (line 59) * ARGIND variable: Auto-set. (line 44) -* ARGIND variable, command-line arguments: Other Arguments. (line 15) +* ARGIND variable, command-line arguments: Other Arguments. (line 21) * arguments, command-line: Other Arguments. (line 6) * arguments, command-line <1>: Auto-set. (line 15) * arguments, command-line <2>: ARGC and ARGV. (line 6) @@ -34020,7 +34026,7 @@ Index * arguments, in function calls: Function Calls. (line 18) * arguments, processing: Getopt Function. (line 6) * ARGV array: Options. (line 316) -* ARGV array, indexing into: Other Arguments. (line 15) +* ARGV array, indexing into: Other Arguments. (line 21) * arithmetic operators: Arithmetic Ops. (line 6) * array manipulation in extensions: Array Manipulation. (line 6) * array members: Reference to Elements. @@ -34573,7 +34579,7 @@ Index * dark corner, continue statement: Continue Statement. (line 44) * dark corner, CONVFMT variable: Strings And Numbers. (line 39) * dark corner, empty programs: Command Line. (line 20) -* dark corner, escape sequences: Other Arguments. (line 38) +* dark corner, escape sequences: Other Arguments. (line 44) * dark corner, escape sequences, for metacharacters: Escape Sequences. (line 144) * dark corner, exit statement: Exit Statement. (line 30) @@ -35154,7 +35160,7 @@ Index (line 54) * files, message object, specifying directory of <1>: Programmer i18n. (line 48) -* files, multiple passes over: Other Arguments. (line 56) +* files, multiple passes over: Other Arguments. (line 62) * files, multiple, duplicating output into: Tee Program. (line 6) * files, output, See output files: Close Files And Pipes. (line 6) @@ -35300,7 +35306,7 @@ Index * Garfinkle, Scott: Contributors. (line 35) * gawk program, dynamic profiling: Profiling. (line 179) * gawk version: Auto-set. (line 262) -* gawk, ARGIND variable in: Other Arguments. (line 15) +* gawk, ARGIND variable in: Other Arguments. (line 21) * gawk, awk and: Preface. (line 21) * gawk, awk and <1>: This Manual. (line 14) * gawk, bitwise operations in: Bitwise Functions. (line 40) @@ -35572,7 +35578,7 @@ Index * input files, reading: Reading Files. (line 6) * input files, running awk without: Read Terminal. (line 6) * input files, running awk without <1>: Read Terminal. (line 16) -* input files, variable assignments and: Other Arguments. (line 26) +* input files, variable assignments and: Other Arguments. (line 32) * input pipeline: Getline/Pipe. (line 10) * input record, length of: String Functions. (line 178) * input redirection: Getline/File. (line 6) @@ -36843,7 +36849,7 @@ Index * values, regexp: Strong Regexp Constants. (line 24) * values, string: Basic Data Typing. (line 13) -* variable assignments and input files: Other Arguments. (line 26) +* variable assignments and input files: Other Arguments. (line 32) * variable type: Type Functions. (line 14) * variable typing: Typing and Comparison. (line 9) @@ -36988,554 +36994,554 @@ Node: Options119569 Ref: Options-Footnote-1137023 Ref: Options-Footnote-2137254 Node: Other Arguments137279 -Node: Naming Standard Input140226 -Node: Environment Variables141436 -Node: AWKPATH Variable141994 -Ref: AWKPATH Variable-Footnote-1145406 -Ref: AWKPATH Variable-Footnote-2145440 -Node: AWKLIBPATH Variable145701 -Node: Other Environment Variables147359 -Node: Exit Status151180 -Node: Include Files151857 -Node: Loading Shared Libraries155547 -Node: Obsolete156975 -Node: Undocumented157667 -Node: Invoking Summary157964 -Node: Regexp160805 -Node: Regexp Usage162259 -Node: Escape Sequences164296 -Node: Regexp Operators170528 -Node: Regexp Operator Details171013 -Ref: Regexp Operator Details-Footnote-1177445 -Node: Interval Expressions177592 -Ref: Interval Expressions-Footnote-1179027 -Node: Bracket Expressions179125 -Ref: table-char-classes181601 -Node: Leftmost Longest184927 -Node: Computed Regexps186230 -Node: GNU Regexp Operators189657 -Node: Case-sensitivity193336 -Ref: Case-sensitivity-Footnote-1196202 -Ref: Case-sensitivity-Footnote-2196437 -Node: Regexp Summary196545 -Node: Reading Files198011 -Node: Records200280 -Node: awk split records201355 -Node: gawk split records206630 -Ref: gawk split records-Footnote-1211216 -Node: Fields211253 -Node: Nonconstant Fields213994 -Ref: Nonconstant Fields-Footnote-1216230 -Node: Changing Fields216434 -Node: Field Separators222465 -Node: Default Field Splitting225163 -Node: Regexp Field Splitting226281 -Node: Single Character Fields229634 -Node: Command Line Field Separator230694 -Node: Full Line Fields233912 -Ref: Full Line Fields-Footnote-1235434 -Ref: Full Line Fields-Footnote-2235480 -Node: Field Splitting Summary235581 -Node: Constant Size237655 -Node: Fixed width data238387 -Node: Skipping intervening241854 -Node: Allowing trailing data242652 -Node: Fields with fixed data243689 -Node: Splitting By Content245207 -Ref: Splitting By Content-Footnote-1248857 -Node: Testing field creation249020 -Node: Multiple Line250645 -Node: Getline256922 -Node: Plain Getline259391 -Node: Getline/Variable261964 -Node: Getline/File263115 -Node: Getline/Variable/File264503 -Ref: Getline/Variable/File-Footnote-1266108 -Node: Getline/Pipe266196 -Node: Getline/Variable/Pipe268900 -Node: Getline/Coprocess270035 -Node: Getline/Variable/Coprocess271302 -Node: Getline Notes272044 -Node: Getline Summary274841 -Ref: table-getline-variants275265 -Node: Read Timeout276013 -Ref: Read Timeout-Footnote-1279919 -Node: Retrying Input279977 -Node: Command-line directories281176 -Node: Input Summary282082 -Node: Input Exercises285254 -Node: Printing285688 -Node: Print287522 -Node: Print Examples288979 -Node: Output Separators291759 -Node: OFMT293776 -Node: Printf295132 -Node: Basic Printf295917 -Node: Control Letters297491 -Node: Format Modifiers302655 -Node: Printf Examples308670 -Node: Redirection311156 -Node: Special FD317997 -Ref: Special FD-Footnote-1321165 -Node: Special Files321239 -Node: Other Inherited Files321856 -Node: Special Network322857 -Node: Special Caveats323717 -Node: Close Files And Pipes324666 -Ref: table-close-pipe-return-values331573 -Ref: Close Files And Pipes-Footnote-1332386 -Ref: Close Files And Pipes-Footnote-2332534 -Node: Nonfatal332686 -Node: Output Summary335024 -Node: Output Exercises336246 -Node: Expressions336925 -Node: Values338113 -Node: Constants338791 -Node: Scalar Constants339482 -Ref: Scalar Constants-Footnote-1342006 -Node: Nondecimal-numbers342256 -Node: Regexp Constants345257 -Node: Using Constant Regexps345783 -Node: Standard Regexp Constants346405 -Node: Strong Regexp Constants349593 -Node: Variables352551 -Node: Using Variables353208 -Node: Assignment Options355118 -Node: Conversion357585 -Node: Strings And Numbers358109 -Ref: Strings And Numbers-Footnote-1361172 -Node: Locale influences conversions361281 -Ref: table-locale-affects364039 -Node: All Operators364657 -Node: Arithmetic Ops365286 -Node: Concatenation367792 -Ref: Concatenation-Footnote-1370639 -Node: Assignment Ops370746 -Ref: table-assign-ops375737 -Node: Increment Ops377050 -Node: Truth Values and Conditions380510 -Node: Truth Values381584 -Node: Typing and Comparison382632 -Node: Variable Typing383452 -Ref: Variable Typing-Footnote-1389915 -Ref: Variable Typing-Footnote-2389987 -Node: Comparison Operators390064 -Ref: table-relational-ops390483 -Node: POSIX String Comparison393978 -Ref: POSIX String Comparison-Footnote-1395673 -Ref: POSIX String Comparison-Footnote-2395812 -Node: Boolean Ops395896 -Ref: Boolean Ops-Footnote-1400378 -Node: Conditional Exp400470 -Node: Function Calls402206 -Node: Precedence406083 -Node: Locales409742 -Node: Expressions Summary411374 -Node: Patterns and Actions413947 -Node: Pattern Overview415067 -Node: Regexp Patterns416744 -Node: Expression Patterns417286 -Node: Ranges421067 -Node: BEGIN/END424175 -Node: Using BEGIN/END424936 -Ref: Using BEGIN/END-Footnote-1427672 -Node: I/O And BEGIN/END427778 -Node: BEGINFILE/ENDFILE430092 -Node: Empty433005 -Node: Using Shell Variables433322 -Node: Action Overview435596 -Node: Statements437921 -Node: If Statement439769 -Node: While Statement441264 -Node: Do Statement443292 -Node: For Statement444440 -Node: Switch Statement447611 -Node: Break Statement449997 -Node: Continue Statement452089 -Node: Next Statement453916 -Node: Nextfile Statement456299 -Node: Exit Statement458951 -Node: Built-in Variables461354 -Node: User-modified462487 -Node: Auto-set470254 -Ref: Auto-set-Footnote-1487061 -Ref: Auto-set-Footnote-2487267 -Node: ARGC and ARGV487323 -Node: Pattern Action Summary491536 -Node: Arrays493966 -Node: Array Basics495295 -Node: Array Intro496139 -Ref: figure-array-elements498114 -Ref: Array Intro-Footnote-1500818 -Node: Reference to Elements500946 -Node: Assigning Elements503410 -Node: Array Example503901 -Node: Scanning an Array505660 -Node: Controlling Scanning508682 -Ref: Controlling Scanning-Footnote-1514081 -Node: Numeric Array Subscripts514397 -Node: Uninitialized Subscripts516581 -Node: Delete518200 -Ref: Delete-Footnote-1520952 -Node: Multidimensional521009 -Node: Multiscanning524104 -Node: Arrays of Arrays525695 -Node: Arrays Summary530463 -Node: Functions532556 -Node: Built-in533594 -Node: Calling Built-in534675 -Node: Numeric Functions536671 -Ref: Numeric Functions-Footnote-1540699 -Ref: Numeric Functions-Footnote-2541347 -Ref: Numeric Functions-Footnote-3541395 -Node: String Functions541667 -Ref: String Functions-Footnote-1565525 -Ref: String Functions-Footnote-2565653 -Ref: String Functions-Footnote-3565901 -Node: Gory Details565988 -Ref: table-sub-escapes567779 -Ref: table-sub-proposed569298 -Ref: table-posix-sub570661 -Ref: table-gensub-escapes572202 -Ref: Gory Details-Footnote-1573025 -Node: I/O Functions573179 -Ref: table-system-return-values579647 -Ref: I/O Functions-Footnote-1581727 -Ref: I/O Functions-Footnote-2581875 -Node: Time Functions581995 -Ref: Time Functions-Footnote-1592666 -Ref: Time Functions-Footnote-2592734 -Ref: Time Functions-Footnote-3592892 -Ref: Time Functions-Footnote-4593003 -Ref: Time Functions-Footnote-5593115 -Ref: Time Functions-Footnote-6593342 -Node: Bitwise Functions593608 -Ref: table-bitwise-ops594202 -Ref: Bitwise Functions-Footnote-1600265 -Ref: Bitwise Functions-Footnote-2600438 -Node: Type Functions600629 -Node: I18N Functions603492 -Node: User-defined605143 -Node: Definition Syntax605955 -Ref: Definition Syntax-Footnote-1611642 -Node: Function Example611713 -Ref: Function Example-Footnote-1614635 -Node: Function Calling614657 -Node: Calling A Function615245 -Node: Variable Scope616203 -Node: Pass By Value/Reference619197 -Node: Function Caveats621841 -Ref: Function Caveats-Footnote-1623888 -Node: Return Statement624008 -Node: Dynamic Typing626987 -Node: Indirect Calls627917 -Ref: Indirect Calls-Footnote-1638169 -Node: Functions Summary638297 -Node: Library Functions641002 -Ref: Library Functions-Footnote-1644609 -Ref: Library Functions-Footnote-2644752 -Node: Library Names644923 -Ref: Library Names-Footnote-1648590 -Ref: Library Names-Footnote-2648813 -Node: General Functions648899 -Node: Strtonum Function650002 -Node: Assert Function653024 -Node: Round Function656350 -Node: Cliff Random Function657890 -Node: Ordinal Functions658906 -Ref: Ordinal Functions-Footnote-1661969 -Ref: Ordinal Functions-Footnote-2662221 -Node: Join Function662431 -Ref: Join Function-Footnote-1664201 -Node: Getlocaltime Function664401 -Node: Readfile Function668143 -Node: Shell Quoting670120 -Node: Data File Management671521 -Node: Filetrans Function672153 -Node: Rewind Function676249 -Node: File Checking678158 -Ref: File Checking-Footnote-1679492 -Node: Empty Files679693 -Node: Ignoring Assigns681672 -Node: Getopt Function683222 -Ref: Getopt Function-Footnote-1694691 -Node: Passwd Functions694891 -Ref: Passwd Functions-Footnote-1703730 -Node: Group Functions703818 -Ref: Group Functions-Footnote-1711716 -Node: Walking Arrays711923 -Node: Library Functions Summary714931 -Node: Library Exercises716337 -Node: Sample Programs716802 -Node: Running Examples717572 -Node: Clones718300 -Node: Cut Program719524 -Node: Egrep Program729453 -Ref: Egrep Program-Footnote-1736965 -Node: Id Program737075 -Node: Split Program740755 -Ref: Split Program-Footnote-1744213 -Node: Tee Program744342 -Node: Uniq Program747132 -Node: Wc Program754753 -Ref: Wc Program-Footnote-1759008 -Node: Miscellaneous Programs759102 -Node: Dupword Program760315 -Node: Alarm Program762345 -Node: Translate Program767200 -Ref: Translate Program-Footnote-1771765 -Node: Labels Program772035 -Ref: Labels Program-Footnote-1775386 -Node: Word Sorting775470 -Node: History Sorting779542 -Node: Extract Program781377 -Node: Simple Sed789431 -Node: Igawk Program792505 -Ref: Igawk Program-Footnote-1806836 -Ref: Igawk Program-Footnote-2807038 -Ref: Igawk Program-Footnote-3807160 -Node: Anagram Program807275 -Node: Signature Program810337 -Node: Programs Summary811584 -Node: Programs Exercises812798 -Ref: Programs Exercises-Footnote-1816927 -Node: Advanced Features817018 -Node: Nondecimal Data819008 -Node: Array Sorting820599 -Node: Controlling Array Traversal821299 -Ref: Controlling Array Traversal-Footnote-1829667 -Node: Array Sorting Functions829785 -Ref: Array Sorting Functions-Footnote-1834876 -Node: Two-way I/O835072 -Ref: Two-way I/O-Footnote-1842793 -Ref: Two-way I/O-Footnote-2842980 -Node: TCP/IP Networking843062 -Node: Profiling846180 -Node: Advanced Features Summary855195 -Node: Internationalization857039 -Node: I18N and L10N858519 -Node: Explaining gettext859206 -Ref: Explaining gettext-Footnote-1865098 -Ref: Explaining gettext-Footnote-2865283 -Node: Programmer i18n865448 -Ref: Programmer i18n-Footnote-1870397 -Node: Translator i18n870446 -Node: String Extraction871240 -Ref: String Extraction-Footnote-1872372 -Node: Printf Ordering872458 -Ref: Printf Ordering-Footnote-1875244 -Node: I18N Portability875308 -Ref: I18N Portability-Footnote-1877764 -Node: I18N Example877827 -Ref: I18N Example-Footnote-1881102 -Ref: I18N Example-Footnote-2881175 -Node: Gawk I18N881284 -Node: I18N Summary881933 -Node: Debugger883274 -Node: Debugging884274 -Node: Debugging Concepts884715 -Node: Debugging Terms886524 -Node: Awk Debugging889099 -Ref: Awk Debugging-Footnote-1890044 -Node: Sample Debugging Session890176 -Node: Debugger Invocation890710 -Node: Finding The Bug892096 -Node: List of Debugger Commands898570 -Node: Breakpoint Control899903 -Node: Debugger Execution Control903597 -Node: Viewing And Changing Data906959 -Node: Execution Stack910500 -Node: Debugger Info912137 -Node: Miscellaneous Debugger Commands916208 -Node: Readline Support921270 -Node: Limitations922166 -Node: Debugging Summary924720 -Node: Namespaces925999 -Node: Global Namespace927110 -Node: Qualified Names928508 -Node: Default Namespace929507 -Node: Changing The Namespace930248 -Node: Naming Rules931862 -Node: Internal Name Management933710 -Node: Namespace Example934752 -Node: Namespace And Features937314 -Node: Namespace Summary938749 -Node: Arbitrary Precision Arithmetic940226 -Node: Computer Arithmetic941713 -Ref: table-numeric-ranges945479 -Ref: table-floating-point-ranges945972 -Ref: Computer Arithmetic-Footnote-1946630 -Node: Math Definitions946687 -Ref: table-ieee-formats950003 -Ref: Math Definitions-Footnote-1950606 -Node: MPFR features950711 -Node: FP Math Caution952429 -Ref: FP Math Caution-Footnote-1953501 -Node: Inexactness of computations953870 -Node: Inexact representation954830 -Node: Comparing FP Values956190 -Node: Errors accumulate957431 -Node: Getting Accuracy958864 -Node: Try To Round961574 -Node: Setting precision962473 -Ref: table-predefined-precision-strings963170 -Node: Setting the rounding mode965000 -Ref: table-gawk-rounding-modes965374 -Ref: Setting the rounding mode-Footnote-1969305 -Node: Arbitrary Precision Integers969484 -Ref: Arbitrary Precision Integers-Footnote-1972659 -Node: Checking for MPFR972808 -Node: POSIX Floating Point Problems974282 -Ref: POSIX Floating Point Problems-Footnote-1978567 -Node: Floating point summary978605 -Node: Dynamic Extensions980795 -Node: Extension Intro982348 -Node: Plugin License983614 -Node: Extension Mechanism Outline984411 -Ref: figure-load-extension984850 -Ref: figure-register-new-function986415 -Ref: figure-call-new-function987507 -Node: Extension API Description989569 -Node: Extension API Functions Introduction991211 -Ref: table-api-std-headers993047 -Node: General Data Types996912 -Ref: General Data Types-Footnote-11005273 -Node: Memory Allocation Functions1005572 -Ref: Memory Allocation Functions-Footnote-11009782 -Node: Constructor Functions1009881 -Node: Registration Functions1013467 -Node: Extension Functions1014152 -Node: Exit Callback Functions1019474 -Node: Extension Version String1020724 -Node: Input Parsers1021387 -Node: Output Wrappers1034108 -Node: Two-way processors1038620 -Node: Printing Messages1040885 -Ref: Printing Messages-Footnote-11042056 -Node: Updating ERRNO1042209 -Node: Requesting Values1042948 -Ref: table-value-types-returned1043685 -Node: Accessing Parameters1044621 -Node: Symbol Table Access1045856 -Node: Symbol table by name1046368 -Ref: Symbol table by name-Footnote-11049392 -Node: Symbol table by cookie1049520 -Ref: Symbol table by cookie-Footnote-11053705 -Node: Cached values1053769 -Ref: Cached values-Footnote-11057305 -Node: Array Manipulation1057458 -Ref: Array Manipulation-Footnote-11058549 -Node: Array Data Types1058586 -Ref: Array Data Types-Footnote-11061244 -Node: Array Functions1061336 -Node: Flattening Arrays1065834 -Node: Creating Arrays1072810 -Node: Redirection API1077577 -Node: Extension API Variables1080410 -Node: Extension Versioning1081121 -Ref: gawk-api-version1081550 -Node: Extension GMP/MPFR Versioning1083281 -Node: Extension API Informational Variables1084909 -Node: Extension API Boilerplate1085982 -Node: Changes from API V11089956 -Node: Finding Extensions1091528 -Node: Extension Example1092087 -Node: Internal File Description1092885 -Node: Internal File Ops1096965 -Ref: Internal File Ops-Footnote-11108315 -Node: Using Internal File Ops1108455 -Ref: Using Internal File Ops-Footnote-11110838 -Node: Extension Samples1111112 -Node: Extension Sample File Functions1112641 -Node: Extension Sample Fnmatch1120290 -Node: Extension Sample Fork1121777 -Node: Extension Sample Inplace1122995 -Node: Extension Sample Ord1126620 -Node: Extension Sample Readdir1127456 -Ref: table-readdir-file-types1128345 -Node: Extension Sample Revout1129150 -Node: Extension Sample Rev2way1129739 -Node: Extension Sample Read write array1130479 -Node: Extension Sample Readfile1132421 -Node: Extension Sample Time1133516 -Node: Extension Sample API Tests1134864 -Node: gawkextlib1135356 -Node: Extension summary1138274 -Node: Extension Exercises1141976 -Node: Language History1143218 -Node: V7/SVR3.11144874 -Node: SVR41147026 -Node: POSIX1148460 -Node: BTL1149840 -Node: POSIX/GNU1150569 -Node: Feature History1156347 -Node: Common Extensions1172540 -Node: Ranges and Locales1173823 -Ref: Ranges and Locales-Footnote-11178439 -Ref: Ranges and Locales-Footnote-21178466 -Ref: Ranges and Locales-Footnote-31178701 -Node: Contributors1178922 -Node: History summary1184875 -Node: Installation1186255 -Node: Gawk Distribution1187199 -Node: Getting1187683 -Node: Extracting1188646 -Node: Distribution contents1190284 -Node: Unix Installation1196764 -Node: Quick Installation1197446 -Node: Shell Startup Files1199860 -Node: Additional Configuration Options1200949 -Node: Configuration Philosophy1203264 -Node: Non-Unix Installation1205633 -Node: PC Installation1206093 -Node: PC Binary Installation1206931 -Node: PC Compiling1207366 -Node: PC Using1208483 -Node: Cygwin1212036 -Node: MSYS1213135 -Node: VMS Installation1213636 -Node: VMS Compilation1214427 -Ref: VMS Compilation-Footnote-11215656 -Node: VMS Dynamic Extensions1215714 -Node: VMS Installation Details1217399 -Node: VMS Running1219652 -Node: VMS GNV1223931 -Node: VMS Old Gawk1224666 -Node: Bugs1225137 -Node: Bug address1225800 -Node: Usenet1228782 -Node: Maintainers1229786 -Node: Other Versions1231047 -Node: Installation summary1238135 -Node: Notes1239337 -Node: Compatibility Mode1240131 -Node: Additions1240913 -Node: Accessing The Source1241838 -Node: Adding Code1243275 -Node: New Ports1249494 -Node: Derived Files1253869 -Ref: Derived Files-Footnote-11259529 -Ref: Derived Files-Footnote-21259564 -Ref: Derived Files-Footnote-31260162 -Node: Future Extensions1260276 -Node: Implementation Limitations1260934 -Node: Extension Design1262117 -Node: Old Extension Problems1263261 -Ref: Old Extension Problems-Footnote-11264779 -Node: Extension New Mechanism Goals1264836 -Ref: Extension New Mechanism Goals-Footnote-11268200 -Node: Extension Other Design Decisions1268389 -Node: Extension Future Growth1270502 -Node: Notes summary1271338 -Node: Basic Concepts1272496 -Node: Basic High Level1273177 -Ref: figure-general-flow1273459 -Ref: figure-process-flow1274144 -Ref: Basic High Level-Footnote-11277445 -Node: Basic Data Typing1277630 -Node: Glossary1280958 -Node: Copying1312796 -Node: GNU Free Documentation License1350339 -Node: Index1375459 +Node: Naming Standard Input140460 +Node: Environment Variables141670 +Node: AWKPATH Variable142228 +Ref: AWKPATH Variable-Footnote-1145640 +Ref: AWKPATH Variable-Footnote-2145674 +Node: AWKLIBPATH Variable145935 +Node: Other Environment Variables147593 +Node: Exit Status151414 +Node: Include Files152091 +Node: Loading Shared Libraries155781 +Node: Obsolete157209 +Node: Undocumented157901 +Node: Invoking Summary158198 +Node: Regexp161039 +Node: Regexp Usage162493 +Node: Escape Sequences164530 +Node: Regexp Operators170762 +Node: Regexp Operator Details171247 +Ref: Regexp Operator Details-Footnote-1177679 +Node: Interval Expressions177826 +Ref: Interval Expressions-Footnote-1179261 +Node: Bracket Expressions179359 +Ref: table-char-classes181835 +Node: Leftmost Longest185161 +Node: Computed Regexps186464 +Node: GNU Regexp Operators189891 +Node: Case-sensitivity193570 +Ref: Case-sensitivity-Footnote-1196436 +Ref: Case-sensitivity-Footnote-2196671 +Node: Regexp Summary196779 +Node: Reading Files198245 +Node: Records200514 +Node: awk split records201589 +Node: gawk split records206864 +Ref: gawk split records-Footnote-1211450 +Node: Fields211487 +Node: Nonconstant Fields214228 +Ref: Nonconstant Fields-Footnote-1216464 +Node: Changing Fields216668 +Node: Field Separators222699 +Node: Default Field Splitting225397 +Node: Regexp Field Splitting226515 +Node: Single Character Fields229868 +Node: Command Line Field Separator230928 +Node: Full Line Fields234146 +Ref: Full Line Fields-Footnote-1235668 +Ref: Full Line Fields-Footnote-2235714 +Node: Field Splitting Summary235815 +Node: Constant Size237889 +Node: Fixed width data238621 +Node: Skipping intervening242088 +Node: Allowing trailing data242886 +Node: Fields with fixed data243923 +Node: Splitting By Content245441 +Ref: Splitting By Content-Footnote-1249091 +Node: Testing field creation249254 +Node: Multiple Line250879 +Node: Getline257156 +Node: Plain Getline259625 +Node: Getline/Variable262198 +Node: Getline/File263349 +Node: Getline/Variable/File264737 +Ref: Getline/Variable/File-Footnote-1266342 +Node: Getline/Pipe266430 +Node: Getline/Variable/Pipe269134 +Node: Getline/Coprocess270269 +Node: Getline/Variable/Coprocess271536 +Node: Getline Notes272278 +Node: Getline Summary275075 +Ref: table-getline-variants275499 +Node: Read Timeout276247 +Ref: Read Timeout-Footnote-1280153 +Node: Retrying Input280211 +Node: Command-line directories281410 +Node: Input Summary282316 +Node: Input Exercises285488 +Node: Printing285922 +Node: Print287756 +Node: Print Examples289213 +Node: Output Separators291993 +Node: OFMT294010 +Node: Printf295366 +Node: Basic Printf296151 +Node: Control Letters297725 +Node: Format Modifiers302889 +Node: Printf Examples308904 +Node: Redirection311390 +Node: Special FD318231 +Ref: Special FD-Footnote-1321399 +Node: Special Files321473 +Node: Other Inherited Files322090 +Node: Special Network323091 +Node: Special Caveats323951 +Node: Close Files And Pipes324900 +Ref: table-close-pipe-return-values331807 +Ref: Close Files And Pipes-Footnote-1332620 +Ref: Close Files And Pipes-Footnote-2332768 +Node: Nonfatal332920 +Node: Output Summary335258 +Node: Output Exercises336480 +Node: Expressions337159 +Node: Values338347 +Node: Constants339025 +Node: Scalar Constants339716 +Ref: Scalar Constants-Footnote-1342240 +Node: Nondecimal-numbers342490 +Node: Regexp Constants345491 +Node: Using Constant Regexps346017 +Node: Standard Regexp Constants346639 +Node: Strong Regexp Constants349827 +Node: Variables352785 +Node: Using Variables353442 +Node: Assignment Options355352 +Node: Conversion357819 +Node: Strings And Numbers358343 +Ref: Strings And Numbers-Footnote-1361406 +Node: Locale influences conversions361515 +Ref: table-locale-affects364273 +Node: All Operators364891 +Node: Arithmetic Ops365520 +Node: Concatenation368026 +Ref: Concatenation-Footnote-1370873 +Node: Assignment Ops370980 +Ref: table-assign-ops375971 +Node: Increment Ops377284 +Node: Truth Values and Conditions380744 +Node: Truth Values381818 +Node: Typing and Comparison382866 +Node: Variable Typing383686 +Ref: Variable Typing-Footnote-1390149 +Ref: Variable Typing-Footnote-2390221 +Node: Comparison Operators390298 +Ref: table-relational-ops390717 +Node: POSIX String Comparison394212 +Ref: POSIX String Comparison-Footnote-1395907 +Ref: POSIX String Comparison-Footnote-2396046 +Node: Boolean Ops396130 +Ref: Boolean Ops-Footnote-1400612 +Node: Conditional Exp400704 +Node: Function Calls402440 +Node: Precedence406317 +Node: Locales409976 +Node: Expressions Summary411608 +Node: Patterns and Actions414181 +Node: Pattern Overview415301 +Node: Regexp Patterns416978 +Node: Expression Patterns417520 +Node: Ranges421301 +Node: BEGIN/END424409 +Node: Using BEGIN/END425170 +Ref: Using BEGIN/END-Footnote-1427906 +Node: I/O And BEGIN/END428012 +Node: BEGINFILE/ENDFILE430326 +Node: Empty433239 +Node: Using Shell Variables433556 +Node: Action Overview435830 +Node: Statements438155 +Node: If Statement440003 +Node: While Statement441498 +Node: Do Statement443526 +Node: For Statement444674 +Node: Switch Statement447845 +Node: Break Statement450231 +Node: Continue Statement452323 +Node: Next Statement454150 +Node: Nextfile Statement456533 +Node: Exit Statement459185 +Node: Built-in Variables461588 +Node: User-modified462721 +Node: Auto-set470488 +Ref: Auto-set-Footnote-1487295 +Ref: Auto-set-Footnote-2487501 +Node: ARGC and ARGV487557 +Node: Pattern Action Summary491770 +Node: Arrays494200 +Node: Array Basics495529 +Node: Array Intro496373 +Ref: figure-array-elements498348 +Ref: Array Intro-Footnote-1501052 +Node: Reference to Elements501180 +Node: Assigning Elements503644 +Node: Array Example504135 +Node: Scanning an Array505894 +Node: Controlling Scanning508916 +Ref: Controlling Scanning-Footnote-1514315 +Node: Numeric Array Subscripts514631 +Node: Uninitialized Subscripts516815 +Node: Delete518434 +Ref: Delete-Footnote-1521186 +Node: Multidimensional521243 +Node: Multiscanning524338 +Node: Arrays of Arrays525929 +Node: Arrays Summary530697 +Node: Functions532790 +Node: Built-in533828 +Node: Calling Built-in534909 +Node: Numeric Functions536905 +Ref: Numeric Functions-Footnote-1540933 +Ref: Numeric Functions-Footnote-2541581 +Ref: Numeric Functions-Footnote-3541629 +Node: String Functions541901 +Ref: String Functions-Footnote-1565759 +Ref: String Functions-Footnote-2565887 +Ref: String Functions-Footnote-3566135 +Node: Gory Details566222 +Ref: table-sub-escapes568013 +Ref: table-sub-proposed569532 +Ref: table-posix-sub570895 +Ref: table-gensub-escapes572436 +Ref: Gory Details-Footnote-1573259 +Node: I/O Functions573413 +Ref: table-system-return-values579881 +Ref: I/O Functions-Footnote-1581961 +Ref: I/O Functions-Footnote-2582109 +Node: Time Functions582229 +Ref: Time Functions-Footnote-1592900 +Ref: Time Functions-Footnote-2592968 +Ref: Time Functions-Footnote-3593126 +Ref: Time Functions-Footnote-4593237 +Ref: Time Functions-Footnote-5593349 +Ref: Time Functions-Footnote-6593576 +Node: Bitwise Functions593842 +Ref: table-bitwise-ops594436 +Ref: Bitwise Functions-Footnote-1600499 +Ref: Bitwise Functions-Footnote-2600672 +Node: Type Functions600863 +Node: I18N Functions603726 +Node: User-defined605377 +Node: Definition Syntax606189 +Ref: Definition Syntax-Footnote-1611876 +Node: Function Example611947 +Ref: Function Example-Footnote-1614869 +Node: Function Calling614891 +Node: Calling A Function615479 +Node: Variable Scope616437 +Node: Pass By Value/Reference619431 +Node: Function Caveats622075 +Ref: Function Caveats-Footnote-1624122 +Node: Return Statement624242 +Node: Dynamic Typing627221 +Node: Indirect Calls628151 +Ref: Indirect Calls-Footnote-1638403 +Node: Functions Summary638531 +Node: Library Functions641236 +Ref: Library Functions-Footnote-1644843 +Ref: Library Functions-Footnote-2644986 +Node: Library Names645157 +Ref: Library Names-Footnote-1648824 +Ref: Library Names-Footnote-2649047 +Node: General Functions649133 +Node: Strtonum Function650236 +Node: Assert Function653258 +Node: Round Function656584 +Node: Cliff Random Function658124 +Node: Ordinal Functions659140 +Ref: Ordinal Functions-Footnote-1662203 +Ref: Ordinal Functions-Footnote-2662455 +Node: Join Function662665 +Ref: Join Function-Footnote-1664435 +Node: Getlocaltime Function664635 +Node: Readfile Function668377 +Node: Shell Quoting670354 +Node: Data File Management671755 +Node: Filetrans Function672387 +Node: Rewind Function676483 +Node: File Checking678392 +Ref: File Checking-Footnote-1679726 +Node: Empty Files679927 +Node: Ignoring Assigns681906 +Node: Getopt Function683456 +Ref: Getopt Function-Footnote-1694925 +Node: Passwd Functions695125 +Ref: Passwd Functions-Footnote-1703964 +Node: Group Functions704052 +Ref: Group Functions-Footnote-1711950 +Node: Walking Arrays712157 +Node: Library Functions Summary715165 +Node: Library Exercises716571 +Node: Sample Programs717036 +Node: Running Examples717806 +Node: Clones718534 +Node: Cut Program719758 +Node: Egrep Program729687 +Ref: Egrep Program-Footnote-1737199 +Node: Id Program737309 +Node: Split Program740989 +Ref: Split Program-Footnote-1744447 +Node: Tee Program744576 +Node: Uniq Program747366 +Node: Wc Program754987 +Ref: Wc Program-Footnote-1759242 +Node: Miscellaneous Programs759336 +Node: Dupword Program760549 +Node: Alarm Program762579 +Node: Translate Program767434 +Ref: Translate Program-Footnote-1771999 +Node: Labels Program772269 +Ref: Labels Program-Footnote-1775620 +Node: Word Sorting775704 +Node: History Sorting779776 +Node: Extract Program781611 +Node: Simple Sed789665 +Node: Igawk Program792739 +Ref: Igawk Program-Footnote-1807070 +Ref: Igawk Program-Footnote-2807272 +Ref: Igawk Program-Footnote-3807394 +Node: Anagram Program807509 +Node: Signature Program810571 +Node: Programs Summary811818 +Node: Programs Exercises813032 +Ref: Programs Exercises-Footnote-1817161 +Node: Advanced Features817252 +Node: Nondecimal Data819242 +Node: Array Sorting820833 +Node: Controlling Array Traversal821533 +Ref: Controlling Array Traversal-Footnote-1829901 +Node: Array Sorting Functions830019 +Ref: Array Sorting Functions-Footnote-1835110 +Node: Two-way I/O835306 +Ref: Two-way I/O-Footnote-1843027 +Ref: Two-way I/O-Footnote-2843214 +Node: TCP/IP Networking843296 +Node: Profiling846414 +Node: Advanced Features Summary855429 +Node: Internationalization857273 +Node: I18N and L10N858753 +Node: Explaining gettext859440 +Ref: Explaining gettext-Footnote-1865332 +Ref: Explaining gettext-Footnote-2865517 +Node: Programmer i18n865682 +Ref: Programmer i18n-Footnote-1870631 +Node: Translator i18n870680 +Node: String Extraction871474 +Ref: String Extraction-Footnote-1872606 +Node: Printf Ordering872692 +Ref: Printf Ordering-Footnote-1875478 +Node: I18N Portability875542 +Ref: I18N Portability-Footnote-1877998 +Node: I18N Example878061 +Ref: I18N Example-Footnote-1881336 +Ref: I18N Example-Footnote-2881409 +Node: Gawk I18N881518 +Node: I18N Summary882167 +Node: Debugger883508 +Node: Debugging884508 +Node: Debugging Concepts884949 +Node: Debugging Terms886758 +Node: Awk Debugging889333 +Ref: Awk Debugging-Footnote-1890278 +Node: Sample Debugging Session890410 +Node: Debugger Invocation890944 +Node: Finding The Bug892330 +Node: List of Debugger Commands898804 +Node: Breakpoint Control900137 +Node: Debugger Execution Control903831 +Node: Viewing And Changing Data907193 +Node: Execution Stack910734 +Node: Debugger Info912371 +Node: Miscellaneous Debugger Commands916442 +Node: Readline Support921504 +Node: Limitations922400 +Node: Debugging Summary924954 +Node: Namespaces926233 +Node: Global Namespace927344 +Node: Qualified Names928742 +Node: Default Namespace929741 +Node: Changing The Namespace930482 +Node: Naming Rules932096 +Node: Internal Name Management933944 +Node: Namespace Example934986 +Node: Namespace And Features937548 +Node: Namespace Summary938983 +Node: Arbitrary Precision Arithmetic940460 +Node: Computer Arithmetic941947 +Ref: table-numeric-ranges945713 +Ref: table-floating-point-ranges946206 +Ref: Computer Arithmetic-Footnote-1946864 +Node: Math Definitions946921 +Ref: table-ieee-formats950237 +Ref: Math Definitions-Footnote-1950840 +Node: MPFR features950945 +Node: FP Math Caution952663 +Ref: FP Math Caution-Footnote-1953735 +Node: Inexactness of computations954104 +Node: Inexact representation955064 +Node: Comparing FP Values956424 +Node: Errors accumulate957665 +Node: Getting Accuracy959098 +Node: Try To Round961808 +Node: Setting precision962707 +Ref: table-predefined-precision-strings963404 +Node: Setting the rounding mode965234 +Ref: table-gawk-rounding-modes965608 +Ref: Setting the rounding mode-Footnote-1969539 +Node: Arbitrary Precision Integers969718 +Ref: Arbitrary Precision Integers-Footnote-1972893 +Node: Checking for MPFR973042 +Node: POSIX Floating Point Problems974516 +Ref: POSIX Floating Point Problems-Footnote-1978801 +Node: Floating point summary978839 +Node: Dynamic Extensions981029 +Node: Extension Intro982582 +Node: Plugin License983848 +Node: Extension Mechanism Outline984645 +Ref: figure-load-extension985084 +Ref: figure-register-new-function986649 +Ref: figure-call-new-function987741 +Node: Extension API Description989803 +Node: Extension API Functions Introduction991445 +Ref: table-api-std-headers993281 +Node: General Data Types997146 +Ref: General Data Types-Footnote-11005507 +Node: Memory Allocation Functions1005806 +Ref: Memory Allocation Functions-Footnote-11010016 +Node: Constructor Functions1010115 +Node: Registration Functions1013701 +Node: Extension Functions1014386 +Node: Exit Callback Functions1019708 +Node: Extension Version String1020958 +Node: Input Parsers1021621 +Node: Output Wrappers1034342 +Node: Two-way processors1038854 +Node: Printing Messages1041119 +Ref: Printing Messages-Footnote-11042290 +Node: Updating ERRNO1042443 +Node: Requesting Values1043182 +Ref: table-value-types-returned1043919 +Node: Accessing Parameters1044855 +Node: Symbol Table Access1046090 +Node: Symbol table by name1046602 +Ref: Symbol table by name-Footnote-11049626 +Node: Symbol table by cookie1049754 +Ref: Symbol table by cookie-Footnote-11053939 +Node: Cached values1054003 +Ref: Cached values-Footnote-11057539 +Node: Array Manipulation1057692 +Ref: Array Manipulation-Footnote-11058783 +Node: Array Data Types1058820 +Ref: Array Data Types-Footnote-11061478 +Node: Array Functions1061570 +Node: Flattening Arrays1066068 +Node: Creating Arrays1073044 +Node: Redirection API1077811 +Node: Extension API Variables1080644 +Node: Extension Versioning1081355 +Ref: gawk-api-version1081784 +Node: Extension GMP/MPFR Versioning1083515 +Node: Extension API Informational Variables1085143 +Node: Extension API Boilerplate1086216 +Node: Changes from API V11090190 +Node: Finding Extensions1091762 +Node: Extension Example1092321 +Node: Internal File Description1093119 +Node: Internal File Ops1097199 +Ref: Internal File Ops-Footnote-11108549 +Node: Using Internal File Ops1108689 +Ref: Using Internal File Ops-Footnote-11111072 +Node: Extension Samples1111346 +Node: Extension Sample File Functions1112875 +Node: Extension Sample Fnmatch1120524 +Node: Extension Sample Fork1122011 +Node: Extension Sample Inplace1123229 +Node: Extension Sample Ord1126854 +Node: Extension Sample Readdir1127690 +Ref: table-readdir-file-types1128579 +Node: Extension Sample Revout1129384 +Node: Extension Sample Rev2way1129973 +Node: Extension Sample Read write array1130713 +Node: Extension Sample Readfile1132655 +Node: Extension Sample Time1133750 +Node: Extension Sample API Tests1135098 +Node: gawkextlib1135590 +Node: Extension summary1138508 +Node: Extension Exercises1142210 +Node: Language History1143452 +Node: V7/SVR3.11145108 +Node: SVR41147260 +Node: POSIX1148694 +Node: BTL1150074 +Node: POSIX/GNU1150803 +Node: Feature History1156581 +Node: Common Extensions1172774 +Node: Ranges and Locales1174057 +Ref: Ranges and Locales-Footnote-11178673 +Ref: Ranges and Locales-Footnote-21178700 +Ref: Ranges and Locales-Footnote-31178935 +Node: Contributors1179156 +Node: History summary1185109 +Node: Installation1186489 +Node: Gawk Distribution1187433 +Node: Getting1187917 +Node: Extracting1188880 +Node: Distribution contents1190518 +Node: Unix Installation1196998 +Node: Quick Installation1197680 +Node: Shell Startup Files1200094 +Node: Additional Configuration Options1201183 +Node: Configuration Philosophy1203498 +Node: Non-Unix Installation1205867 +Node: PC Installation1206327 +Node: PC Binary Installation1207165 +Node: PC Compiling1207600 +Node: PC Using1208717 +Node: Cygwin1212270 +Node: MSYS1213369 +Node: VMS Installation1213870 +Node: VMS Compilation1214661 +Ref: VMS Compilation-Footnote-11215890 +Node: VMS Dynamic Extensions1215948 +Node: VMS Installation Details1217633 +Node: VMS Running1219886 +Node: VMS GNV1224165 +Node: VMS Old Gawk1224900 +Node: Bugs1225371 +Node: Bug address1226034 +Node: Usenet1229016 +Node: Maintainers1230020 +Node: Other Versions1231281 +Node: Installation summary1238369 +Node: Notes1239571 +Node: Compatibility Mode1240365 +Node: Additions1241147 +Node: Accessing The Source1242072 +Node: Adding Code1243509 +Node: New Ports1249728 +Node: Derived Files1254103 +Ref: Derived Files-Footnote-11259763 +Ref: Derived Files-Footnote-21259798 +Ref: Derived Files-Footnote-31260396 +Node: Future Extensions1260510 +Node: Implementation Limitations1261168 +Node: Extension Design1262351 +Node: Old Extension Problems1263495 +Ref: Old Extension Problems-Footnote-11265013 +Node: Extension New Mechanism Goals1265070 +Ref: Extension New Mechanism Goals-Footnote-11268434 +Node: Extension Other Design Decisions1268623 +Node: Extension Future Growth1270736 +Node: Notes summary1271572 +Node: Basic Concepts1272730 +Node: Basic High Level1273411 +Ref: figure-general-flow1273693 +Ref: figure-process-flow1274378 +Ref: Basic High Level-Footnote-11277679 +Node: Basic Data Typing1277864 +Node: Glossary1281192 +Node: Copying1313030 +Node: GNU Free Documentation License1350573 +Node: Index1375693 End Tag Table diff --git a/doc/gawk.texi b/doc/gawk.texi index 1d7ee3f4..f27d3018 100644 --- a/doc/gawk.texi +++ b/doc/gawk.texi @@ -4407,6 +4407,15 @@ file at all. (See @ref{Assignment Options}.) In the following example, awk -f program.awk file1 count=1 file2 @end example +@noindent +As a side point, should you really need to have @command{awk} +process a file named @file{count=1} (or any file whose name looks like +a variable assignment), precede the file name with @samp{./}, like so: + +@example +awk -f program.awk file1 ./count=1 file2 +@end example + @cindex @command{gawk}, @code{ARGIND} variable in @cindex @code{ARGIND} variable, command-line arguments @cindex @code{ARGV} array, indexing into diff --git a/doc/gawktexi.in b/doc/gawktexi.in index 44927575..03f58c3c 100644 --- a/doc/gawktexi.in +++ b/doc/gawktexi.in @@ -4317,6 +4317,15 @@ file at all. (See @ref{Assignment Options}.) In the following example, awk -f program.awk file1 count=1 file2 @end example +@noindent +As a side point, should you really need to have @command{awk} +process a file named @file{count=1} (or any file whose name looks like +a variable assignment), precede the file name with @samp{./}, like so: + +@example +awk -f program.awk file1 ./count=1 file2 +@end example + @cindex @command{gawk}, @code{ARGIND} variable in @cindex @code{ARGIND} variable, command-line arguments @cindex @code{ARGV} array, indexing into |