diff options
Diffstat (limited to 'doc')
| -rw-r--r-- | doc/ChangeLog | 6 | ||||
| -rw-r--r-- | doc/awkcard.in | 4 | ||||
| -rw-r--r-- | doc/gawk.1 | 6 | ||||
| -rw-r--r-- | doc/gawk.info | 959 | ||||
| -rw-r--r-- | doc/gawk.texi | 38 |
5 files changed, 523 insertions, 490 deletions
diff --git a/doc/ChangeLog b/doc/ChangeLog index f89f1603..42dc28ac 100644 --- a/doc/ChangeLog +++ b/doc/ChangeLog @@ -1,3 +1,9 @@ +Thu May 19 16:57:28 2011 Arnold D. Robbins <arnold@skeeve.com> + + * gawk.texi, gawk.1, awkcard.in: Revised to reflect the reality + that -d and -p don't allow a space before the file name. + Thanks to Pat Rankin. + Mon May 16 16:40:50 2011 Arnold D. Robbins <arnold@skeeve.com> * gawk.texi: Remove last vestiges of old PROCINFO sorting diff --git a/doc/awkcard.in b/doc/awkcard.in index 57d0c028..1c4d1910 100644 --- a/doc/awkcard.in +++ b/doc/awkcard.in @@ -246,7 +246,7 @@ Disable \*(GK-specific extensions. .TI "\*(FC\-C\*(FR, \*(FC\-\^\-copyright\*(FR Print the short version of the GNU copyright information on \*(FCstdout\*(FR. -.TI "\*(FC\-d \*(FIfile\*(FR, \*(FC\-\^\-dump-variables\*(FR[\*(FC=\*(FIfile\*(FR] +.TI "\*(FC\-d\*(FR[\*(FIfile\*(FR], \*(FC\-\^\-dump-variables\*(FR[\*(FC=\*(FIfile\*(FR] Print a sorted list of global variables, their types and final values to \*(FIfile\*(FR. @@ -284,7 +284,7 @@ Recognize octal and hexadecimal values in input data. Force use of the locale's decimal point character when parsing input data. .TI "\*(FC\-O\*(FR, \*(FC\-\^\-optimize\*(FR Enable some internal optimizations. -.TI "\*(FC\-p \*(FR[\*(FC\*(FIfile\*(FR], \*(FC\-\^\-profile\*(FR[\*(FC=\*(FIfile\*(FR] +.TI "\*(FC\-p\*(FR[\*(FC\*(FIfile\*(FR], \*(FC\-\^\-profile\*(FR[\*(FC=\*(FIfile\*(FR] Send profiling data to \*(FIfile\*(FR (default: \*(FCawkprof.out\*(FR). With \*(GK, @@ -14,7 +14,7 @@ . if \w'\(rq' .ds rq "\(rq . \} .\} -.TH GAWK 1 "May 5 2011" "Free Software Foundation" "Utility Commands" +.TH GAWK 1 "May 19 2011" "Free Software Foundation" "Utility Commands" .SH NAME gawk \- pattern scanning and processing language .SH SYNOPSIS @@ -247,7 +247,7 @@ Print the short version of the \*(GN copyright information message on the standard output and exit successfully. .TP .PD 0 -\fB\-d \fR[\fIfile\fR] +\fB\-d\fR[\fIfile\fR] .TP .PD \fB\-\^\-dump-variables\fR[\fB=\fIfile\fR] @@ -397,7 +397,7 @@ Currently, this includes just simple constant-folding. The maintainer hopes to add additional optimizations over time. .TP .PD 0 -\fB\-p \fR[\fIprof_file\fR] +\fB\-p\fR[\fIprof_file\fR] .TP .PD \fB\-\^\-profile\fR[\fB=\fIprof_file\fR] diff --git a/doc/gawk.info b/doc/gawk.info index 4a166838..b3c5bd29 100644 --- a/doc/gawk.info +++ b/doc/gawk.info @@ -1,5 +1,4 @@ -This is /home/arnold/Gnu/gawk/gawk.git/doc/gawk.info, produced by -makeinfo version 4.13 from /home/arnold/Gnu/gawk/gawk.git/doc/gawk.texi. +This is gawk.info, produced by makeinfo version 4.13 from gawk.texi. INFO-DIR-SECTION Text creation and manipulation START-INFO-DIR-ENTRY @@ -2238,11 +2237,12 @@ The following list describes options mandated by the POSIX standard: Print the short version of the General Public License and then exit. -`-d [FILE]' +`-d[FILE]' `--dump-variables[=FILE]' Print a sorted list of global variables, their types, and final values to FILE. If no FILE is provided, print this list to the - file named `awkvars.out' in the current directory. + file named `awkvars.out' in the current directory. No space is + allowed between the `-d' and FILE, if FILE is supplied. Having a list of all global variables is a good way to look for typographical errors in your programs. You would also use this @@ -2333,12 +2333,13 @@ The following list describes options mandated by the POSIX standard: folding. The `gawk' maintainer hopes to add more optimizations over time. -`-p [FILE]' +`-p[FILE]' `--profile[=FILE]' Enable profiling of `awk' programs (*note Profiling::). By default, profiles are created in a file named `awkprof.out'. The optional FILE argument allows you to specify a different file name - for the profile file. + for the profile file. No space is allowed between the `-p' and + FILE, if FILE is supplied. When run with `gawk', the profile is just a "pretty printed" version of the program. When run with `pgawk', the profile @@ -9597,7 +9598,7 @@ and then remove, command-line options: for (i = 1; i < ARGC; i++) { if (ARGV[i] == "-v") verbose = 1 - else if (ARGV[i] == "-d") + else if (ARGV[i] == "-q") debug = 1 else if (ARGV[i] ~ /^-./) { e = sprintf("%s: unrecognized option -- %c", @@ -9613,7 +9614,7 @@ and then remove, command-line options: options with `--' and then supply the `awk' program's options, in the following manner: - awk -f myprog -- -v -d file1 file2 ... + awk -f myprog -- -v -q file1 file2 ... This is not necessary in `gawk'. Unless `--posix' has been specified, `gawk' silently puts any unrecognized options into `ARGV' @@ -9621,9 +9622,9 @@ for the `awk' program to deal with. As soon as it sees an unknown option, `gawk' stops looking for other options that it might otherwise recognize. The previous example with `gawk' would be: - gawk -f myprog -d -v file1 file2 ... + gawk -f myprog -q -v file1 file2 ... -Because `-d' is not a valid `gawk' option, it and the following `-v' +Because `-q' is not a valid `gawk' option, it and the following `-v' are passed on to the `awk' program. (*Note Getopt Function::, for an `awk' library function that parses command-line options.) @@ -24592,7 +24593,7 @@ Index * --assign option: Options. (line 32) * --c option: Options. (line 78) * --characters-as-bytes option: Options. (line 68) -* --command option: Options. (line 229) +* --command option: Options. (line 231) * --copyright option: Options. (line 85) * --disable-lint configuration option: Additional Configuration Options. (line 9) @@ -24600,63 +24601,63 @@ Index (line 24) * --dump-variables option <1>: Library Names. (line 45) * --dump-variables option: Options. (line 90) -* --exec option: Options. (line 112) +* --exec option: Options. (line 113) * --field-separator option: Options. (line 21) * --file option: Options. (line 25) * --gen-pot option <1>: String Extraction. (line 6) -* --gen-pot option: Options. (line 134) -* --help option: Options. (line 141) -* --L option: Options. (line 243) -* --lint option <1>: Options. (line 146) +* --gen-pot option: Options. (line 135) +* --help option: Options. (line 142) +* --L option: Options. (line 245) +* --lint option <1>: Options. (line 147) * --lint option: Command Line. (line 20) -* --lint-old option: Options. (line 243) +* --lint-old option: Options. (line 245) * --non-decimal-data option <1>: Nondecimal Data. (line 6) -* --non-decimal-data option: Options. (line 165) +* --non-decimal-data option: Options. (line 166) * --non-decimal-data option, strtonum() function and: Nondecimal Data. (line 36) -* --optimize option: Options. (line 178) -* --posix option: Options. (line 197) -* --posix option, --traditional option and: Options. (line 216) +* --optimize option: Options. (line 179) +* --posix option: Options. (line 199) +* --posix option, --traditional option and: Options. (line 218) * --profile option <1>: Profiling. (line 15) -* --profile option: Options. (line 185) -* --re-interval option: Options. (line 222) -* --sandbox option: Options. (line 234) +* --profile option: Options. (line 186) +* --re-interval option: Options. (line 224) +* --sandbox option: Options. (line 236) * --sandbox option, disabling system() function: I/O Functions. (line 85) * --sandbox option, input redirection with getline: Getline. (line 19) * --sandbox option, output redirection with print, printf: Redirection. (line 6) -* --source option: Options. (line 104) +* --source option: Options. (line 105) * --traditional option: Options. (line 78) -* --traditional option, --posix option and: Options. (line 216) -* --use-lc-numeric option: Options. (line 173) -* --version option: Options. (line 248) +* --traditional option, --posix option and: Options. (line 218) +* --use-lc-numeric option: Options. (line 174) +* --version option: Options. (line 250) * --with-whiny-user-strftime configuration option: Additional Configuration Options. (line 29) * -b option: Options. (line 68) * -C option: Options. (line 85) * -d option: Options. (line 90) -* -E option: Options. (line 112) -* -e option: Options. (line 104) +* -E option: Options. (line 113) +* -e option: Options. (line 105) * -F option: Command Line Field Separator. (line 6) * -f option: Options. (line 25) * -F option: Options. (line 21) * -f option: Long. (line 12) -* -F option, -Ft sets FS to TAB: Options. (line 256) -* -f option, on command line: Options. (line 261) -* -g option: Options. (line 134) -* -h option: Options. (line 141) -* -l option: Options. (line 146) -* -N option: Options. (line 173) -* -n option: Options. (line 165) -* -O option: Options. (line 178) -* -P option: Options. (line 197) -* -p option: Options. (line 185) -* -R option: Options. (line 229) -* -r option: Options. (line 222) -* -S option: Options. (line 234) -* -V option: Options. (line 248) +* -F option, -Ft sets FS to TAB: Options. (line 258) +* -f option, on command line: Options. (line 263) +* -g option: Options. (line 135) +* -h option: Options. (line 142) +* -l option: Options. (line 147) +* -N option: Options. (line 174) +* -n option: Options. (line 166) +* -O option: Options. (line 179) +* -P option: Options. (line 199) +* -p option: Options. (line 186) +* -R option: Options. (line 231) +* -r option: Options. (line 224) +* -S option: Options. (line 236) +* -V option: Options. (line 250) * -v option: Options. (line 32) * -v option, variables, assigning: Assignment Options. (line 12) * -W option: Options. (line 46) @@ -24928,7 +24929,7 @@ Index * awk programs, location of: Options. (line 25) * awk programs, one-line examples: Very Simple. (line 45) * awk programs, profiling: Profiling. (line 6) -* awk programs, profiling, enabling: Options. (line 185) +* awk programs, profiling, enabling: Options. (line 186) * awk programs, running <1>: Long. (line 6) * awk programs, running: Running gawk. (line 6) * awk programs, running, from shell scripts: One-shot. (line 22) @@ -25137,7 +25138,7 @@ Index * case sensitivity, regexps and <1>: User-modified. (line 82) * case sensitivity, regexps and: Case-sensitivity. (line 6) * case sensitivity, string comparisons and: User-modified. (line 82) -* CGI, awk scripts for: Options. (line 112) +* CGI, awk scripts for: Options. (line 113) * character lists, See bracket expressions: Regexp Operators. (line 55) * character sets (machine character encodings) <1>: Glossary. (line 141) * character sets (machine character encodings): Ordinal Functions. @@ -25268,7 +25269,7 @@ Index * cos() function: Numeric Functions. (line 14) * counting: Wc Program. (line 6) * csh utility: Statements/Lines. (line 44) -* csh utility, POSIXLY_CORRECT environment variable: Options. (line 300) +* csh utility, POSIXLY_CORRECT environment variable: Options. (line 302) * csh utility, |& operator, comparison with: Two-way I/O. (line 44) * ctime() user-defined function: Function Example. (line 72) * currency symbols, localization: Explaining gettext. (line 103) @@ -25436,7 +25437,7 @@ Index * debugger commands, watch: Viewing And Changing Data. (line 67) * debugging gawk, bug reports: Bugs. (line 9) -* decimal point character, locale specific: Options. (line 213) +* decimal point character, locale specific: Options. (line 215) * decrement operators: Increment Ops. (line 35) * default keyword: Switch Statement. (line 6) * Deifik, Scott <1>: Bugs. (line 70) @@ -25760,7 +25761,7 @@ Index * files, portable object template: Explaining gettext. (line 30) * files, portable object, converting to message object files: I18N Example. (line 62) -* files, portable object, generating: Options. (line 134) +* files, portable object, generating: Options. (line 135) * files, processing, ARGIND variable and: Auto-set. (line 47) * files, reading: Rewind Function. (line 6) * files, reading, multiline records: Multiple Line. (line 6) @@ -25816,7 +25817,7 @@ Index * FS variable, --field-separator option and: Options. (line 21) * FS variable, as null string: Single Character Fields. (line 20) -* FS variable, as TAB character: Options. (line 209) +* FS variable, as TAB character: Options. (line 211) * FS variable, changing value of: Field Separators. (line 34) * FS variable, running awk programs and: Cut Program. (line 68) * FS variable, setting from command line: Command Line Field Separator. @@ -25901,7 +25902,7 @@ Index (line 139) * gawk, ERRNO variable in: Getline. (line 19) * gawk, escape sequences: Escape Sequences. (line 125) -* gawk, extensions, disabling: Options. (line 197) +* gawk, extensions, disabling: Options. (line 199) * gawk, features, adding: Adding Code. (line 6) * gawk, features, advanced: Advanced Features. (line 6) * gawk, fflush() function in: I/O Functions. (line 44) @@ -25965,7 +25966,7 @@ Index * gawk, TEXTDOMAIN variable in: User-modified. (line 153) * gawk, timestamps: Time Functions. (line 6) * gawk, uses for: Preface. (line 35) -* gawk, versions of, information about, printing: Options. (line 248) +* gawk, versions of, information about, printing: Options. (line 250) * gawk, VMS version of: VMS Installation. (line 6) * gawk, word-boundary operator: GNU Regexp Operators. (line 63) @@ -26026,7 +26027,7 @@ Index * GNU Lesser General Public License: Glossary. (line 397) * GNU long options <1>: Options. (line 6) * GNU long options: Command Line. (line 13) -* GNU long options, printing list of: Options. (line 141) +* GNU long options, printing list of: Options. (line 142) * GNU Project <1>: Glossary. (line 319) * GNU Project: Manual History. (line 11) * GNU/Linux <1>: Glossary. (line 611) @@ -26057,7 +26058,7 @@ Index * help debugger command: Miscellaneous Dgawk Commands. (line 68) * hexadecimal numbers: Nondecimal-numbers. (line 6) -* hexadecimal values, enabling interpretation of: Options. (line 165) +* hexadecimal values, enabling interpretation of: Options. (line 166) * histsort.awk program: History Sorting. (line 25) * Hughes, Phil: Acknowledgments. (line 43) * HUP signal: Profiling. (line 204) @@ -26278,9 +26279,9 @@ Index * lint checking, array subscripts: Uninitialized Subscripts. (line 43) * lint checking, empty programs: Command Line. (line 16) -* lint checking, issuing warnings: Options. (line 146) +* lint checking, issuing warnings: Options. (line 147) * lint checking, POSIXLY_CORRECT environment variable: Options. - (line 287) + (line 289) * lint checking, undefined functions: Pass By Value/Reference. (line 88) * LINT variable: User-modified. (line 98) @@ -26291,7 +26292,7 @@ Index (line 74) * local variables: Variable Scope. (line 6) * locale categories: Explaining gettext. (line 80) -* locale decimal point character: Options. (line 213) +* locale decimal point character: Options. (line 215) * locale, definition of: Locales. (line 6) * localization: I18N and L10N. (line 6) * localization, See internationalization, localization: I18N and L10N. @@ -26359,7 +26360,7 @@ Index * networks, programming: TCP/IP Networking. (line 6) * networks, support for: Special Network. (line 6) * newlines <1>: Boolean Ops. (line 67) -* newlines <2>: Options. (line 203) +* newlines <2>: Options. (line 205) * newlines: Statements/Lines. (line 6) * newlines, as field separators: Default Field Splitting. (line 6) @@ -26439,7 +26440,7 @@ Index * oawk utility: Names. (line 17) * obsolete features: Obsolete. (line 6) * octal numbers: Nondecimal-numbers. (line 6) -* octal values, enabling interpretation of: Options. (line 165) +* octal values, enabling interpretation of: Options. (line 166) * OFMT variable <1>: User-modified. (line 115) * OFMT variable <2>: Conversion. (line 55) * OFMT variable: OFMT. (line 15) @@ -26492,7 +26493,7 @@ Index * options, deprecated: Obsolete. (line 6) * options, long <1>: Options. (line 6) * options, long: Command Line. (line 13) -* options, printing list of: Options. (line 141) +* options, printing list of: Options. (line 142) * OR bitwise operation: Bitwise Functions. (line 6) * or Boolean-logic operator: Boolean Ops. (line 6) * or() function (gawk): Bitwise Functions. (line 48) @@ -26587,13 +26588,13 @@ Index * portability, NF variable, decrementing: Changing Fields. (line 115) * portability, operators: Increment Ops. (line 61) * portability, operators, not in POSIX awk: Precedence. (line 98) -* portability, POSIXLY_CORRECT environment variable: Options. (line 305) +* portability, POSIXLY_CORRECT environment variable: Options. (line 307) * portability, substr() function: String Functions. (line 512) * portable object files <1>: Translator i18n. (line 6) * portable object files: Explaining gettext. (line 36) * portable object files, converting to message object files: I18N Example. (line 62) -* portable object files, generating: Options. (line 134) +* portable object files, generating: Options. (line 135) * portable object template files: Explaining gettext. (line 30) * porting gawk: New Ports. (line 6) * positional specifiers, printf statement <1>: Printf Ordering. @@ -26636,11 +26637,11 @@ Index * POSIX awk, regular expressions and: Regexp Operators. (line 157) * POSIX awk, timestamps and: Time Functions. (line 6) * POSIX awk, | I/O operator and: Getline/Pipe. (line 52) -* POSIX mode: Options. (line 197) +* POSIX mode: Options. (line 199) * POSIX, awk and: Preface. (line 22) * POSIX, gawk extensions not included in: POSIX/GNU. (line 6) * POSIX, programs, implementing in awk: Clones. (line 6) -* POSIXLY_CORRECT environment variable: Options. (line 287) +* POSIXLY_CORRECT environment variable: Options. (line 289) * precedence <1>: Precedence. (line 6) * precedence: Increment Ops. (line 61) * precedence, regexp operators: Regexp Operators. (line 152) @@ -26674,7 +26675,7 @@ Index * printf statement, sprintf() function and: Round Function. (line 6) * printf statement, syntax of: Basic Printf. (line 6) * printing: Printing. (line 6) -* printing, list of options: Options. (line 141) +* printing, list of options: Options. (line 142) * printing, mailing labels: Labels Program. (line 6) * printing, unduplicated lines of text: Uniq Program. (line 6) * printing, user information: Id Program. (line 6) @@ -26797,7 +26798,7 @@ Index (line 59) * regular expressions, gawk, command-line options: GNU Regexp Operators. (line 70) -* regular expressions, interval expressions and: Options. (line 222) +* regular expressions, interval expressions and: Options. (line 224) * regular expressions, leftmost longest match: Leftmost Longest. (line 6) * regular expressions, operators <1>: Regexp Operators. (line 6) @@ -26871,7 +26872,7 @@ Index * rvalues/lvalues: Assignment Ops. (line 32) * s debugger command (alias for step): Dgawk Execution Control. (line 68) -* sandbox mode: Options. (line 234) +* sandbox mode: Options. (line 236) * scalar values: Basic Data Typing. (line 13) * Schorr, Andrew: Acknowledgments. (line 60) * Schreiber, Bert: Acknowledgments. (line 38) @@ -26967,7 +26968,7 @@ Index * source code, jawk: Other Versions. (line 96) * source code, libmawk: Other Versions. (line 104) * source code, mawk: Other Versions. (line 35) -* source code, mixing: Options. (line 104) +* source code, mixing: Options. (line 105) * source code, pawk: Other Versions. (line 69) * source code, QSE Awk: Other Versions. (line 108) * source code, QuikTrim Awk: Other Versions. (line 112) @@ -27106,7 +27107,7 @@ Index * trace debugger command: Miscellaneous Dgawk Commands. (line 110) * translate.awk program: Translate Program. (line 55) -* troubleshooting, --non-decimal-data option: Options. (line 165) +* troubleshooting, --non-decimal-data option: Options. (line 166) * troubleshooting, == operator: Comparison Operators. (line 37) * troubleshooting, awk uses FS not IFS: Field Separators. (line 29) @@ -27138,7 +27139,7 @@ Index * troubleshooting, substr() function: String Functions. (line 499) * troubleshooting, system() function: I/O Functions. (line 85) * troubleshooting, typographical errors, global variables: Options. - (line 94) + (line 95) * true, logical: Truth Values. (line 6) * Trueman, David <1>: Contributors. (line 31) * Trueman, David <2>: Acknowledgments. (line 47) @@ -27239,7 +27240,7 @@ Index * Wall, Larry <1>: Future Extensions. (line 6) * Wall, Larry: Array Intro. (line 6) * Wallin, Anders: Acknowledgments. (line 60) -* warnings, issuing: Options. (line 146) +* warnings, issuing: Options. (line 147) * watch debugger command: Viewing And Changing Data. (line 67) * wc utility: Wc Program. (line 6) @@ -27251,7 +27252,7 @@ Index * whitespace, as field separators: Default Field Splitting. (line 6) * whitespace, functions, calling: Calling Built-in. (line 10) -* whitespace, newlines as: Options. (line 203) +* whitespace, newlines as: Options. (line 205) * Williams, Kent: Contributors. (line 35) * Woehlke, Matthew: Contributors. (line 77) * Woods, John: Contributors. (line 28) @@ -27305,412 +27306,412 @@ Index Tag Table: -Node: Top1416 -Node: Foreword33390 -Node: Preface37735 -Ref: Preface-Footnote-140702 -Ref: Preface-Footnote-240808 -Node: History41040 -Node: Names43431 -Ref: Names-Footnote-144908 -Node: This Manual44980 -Ref: This Manual-Footnote-149927 -Node: Conventions50027 -Node: Manual History52161 -Ref: Manual History-Footnote-155431 -Ref: Manual History-Footnote-255472 -Node: How To Contribute55546 -Node: Acknowledgments56690 -Node: Getting Started61021 -Node: Running gawk63400 -Node: One-shot64586 -Node: Read Terminal65811 -Ref: Read Terminal-Footnote-167461 -Ref: Read Terminal-Footnote-267737 -Node: Long67908 -Node: Executable Scripts69284 -Ref: Executable Scripts-Footnote-171153 -Ref: Executable Scripts-Footnote-271255 -Node: Comments71706 -Node: Quoting74173 -Node: DOS Quoting78796 -Node: Sample Data Files79471 -Node: Very Simple82503 -Node: Two Rules87102 -Node: More Complex89249 -Ref: More Complex-Footnote-192179 -Node: Statements/Lines92264 -Ref: Statements/Lines-Footnote-196726 -Node: Other Features96991 -Node: When97919 -Node: Invoking Gawk100066 -Node: Command Line101451 -Node: Options102234 -Ref: Options-Footnote-1115366 -Node: Other Arguments115391 -Node: Naming Standard Input118049 -Node: Environment Variables119143 -Node: AWKPATH Variable119587 -Ref: AWKPATH Variable-Footnote-1122184 -Node: Other Environment Variables122444 -Node: Exit Status124784 -Node: Include Files125459 -Node: Obsolete128944 -Node: Undocumented129630 -Node: Regexp129871 -Node: Regexp Usage131323 -Node: Escape Sequences133349 -Node: Regexp Operators139112 -Ref: Regexp Operators-Footnote-1146309 -Ref: Regexp Operators-Footnote-2146456 -Node: Bracket Expressions146554 -Ref: table-char-classes148357 -Node: GNU Regexp Operators151001 -Node: Case-sensitivity154724 -Ref: Case-sensitivity-Footnote-1157692 -Ref: Case-sensitivity-Footnote-2157927 -Node: Leftmost Longest158035 -Node: Computed Regexps159236 -Node: Locales162662 -Node: Reading Files166369 -Node: Records168310 -Ref: Records-Footnote-1176984 -Node: Fields177021 -Ref: Fields-Footnote-1180054 -Node: Nonconstant Fields180140 -Node: Changing Fields182342 -Node: Field Separators188320 -Node: Default Field Splitting190949 -Node: Regexp Field Splitting192066 -Node: Single Character Fields195408 -Node: Command Line Field Separator196467 -Node: Field Splitting Summary199908 -Ref: Field Splitting Summary-Footnote-1203100 -Node: Constant Size203201 -Node: Splitting By Content207785 -Ref: Splitting By Content-Footnote-1211511 -Node: Multiple Line211551 -Ref: Multiple Line-Footnote-1217398 -Node: Getline217577 -Node: Plain Getline219805 -Node: Getline/Variable221894 -Node: Getline/File223035 -Node: Getline/Variable/File224357 -Ref: Getline/Variable/File-Footnote-1225956 -Node: Getline/Pipe226043 -Node: Getline/Variable/Pipe228603 -Node: Getline/Coprocess229710 -Node: Getline/Variable/Coprocess230953 -Node: Getline Notes231667 -Node: Getline Summary233609 -Ref: table-getline-variants233952 -Node: Command line directories234808 -Node: Printing235433 -Node: Print237064 -Node: Print Examples238401 -Node: Output Separators241185 -Node: OFMT242945 -Node: Printf244303 -Node: Basic Printf245209 -Node: Control Letters246748 -Node: Format Modifiers250560 -Node: Printf Examples256569 -Node: Redirection259284 -Node: Special Files266268 -Node: Special FD266801 -Ref: Special FD-Footnote-1270426 -Node: Special Network270500 -Node: Special Caveats271350 -Node: Close Files And Pipes272146 -Ref: Close Files And Pipes-Footnote-1279169 -Ref: Close Files And Pipes-Footnote-2279317 -Node: Expressions279467 -Node: Values280536 -Node: Constants281212 -Node: Scalar Constants281892 -Ref: Scalar Constants-Footnote-1282751 -Node: Nondecimal-numbers282933 -Node: Regexp Constants285992 -Node: Using Constant Regexps286467 -Node: Variables289522 -Node: Using Variables290177 -Node: Assignment Options291901 -Node: Conversion293773 -Ref: table-locale-affects299149 -Ref: Conversion-Footnote-1299773 -Node: All Operators299882 -Node: Arithmetic Ops300512 -Node: Concatenation303017 -Ref: Concatenation-Footnote-1305810 -Node: Assignment Ops305930 -Ref: table-assign-ops310918 -Node: Increment Ops312326 -Node: Truth Values and Conditions315796 -Node: Truth Values316879 -Node: Typing and Comparison317928 -Node: Variable Typing318717 -Ref: Variable Typing-Footnote-1322614 -Node: Comparison Operators322736 -Ref: table-relational-ops323146 -Node: POSIX String Comparison326695 -Ref: POSIX String Comparison-Footnote-1327651 -Node: Boolean Ops327789 -Ref: Boolean Ops-Footnote-1331867 -Node: Conditional Exp331958 -Node: Function Calls333690 -Node: Precedence337284 -Node: Patterns and Actions340937 -Node: Pattern Overview341991 -Node: Regexp Patterns343657 -Node: Expression Patterns344200 -Node: Ranges347774 -Node: BEGIN/END350740 -Node: Using BEGIN/END351502 -Ref: Using BEGIN/END-Footnote-1354233 -Node: I/O And BEGIN/END354339 -Node: BEGINFILE/ENDFILE356621 -Node: Empty359452 -Node: Using Shell Variables359768 -Node: Action Overview362053 -Node: Statements364410 -Node: If Statement366264 -Node: While Statement367763 -Node: Do Statement369807 -Node: For Statement370963 -Node: Switch Statement374115 -Node: Break Statement376212 -Node: Continue Statement378202 -Node: Next Statement379989 -Node: Nextfile Statement382379 -Node: Exit Statement384676 -Node: Built-in Variables387092 -Node: User-modified388187 -Ref: User-modified-Footnote-1396213 -Node: Auto-set396275 -Ref: Auto-set-Footnote-1405566 -Node: ARGC and ARGV405771 -Node: Arrays409622 -Node: Array Basics411127 -Node: Array Intro411838 -Node: Reference to Elements416156 -Node: Assigning Elements418426 -Node: Array Example418917 -Node: Scanning an Array420649 -Node: Delete423315 -Ref: Delete-Footnote-1425750 -Node: Numeric Array Subscripts425807 -Node: Uninitialized Subscripts427990 -Node: Multi-dimensional429618 -Node: Multi-scanning432712 -Node: Arrays of Arrays434296 -Node: Functions438873 -Node: Built-in439695 -Node: Calling Built-in440773 -Node: Numeric Functions442761 -Ref: Numeric Functions-Footnote-1446526 -Ref: Numeric Functions-Footnote-2446883 -Ref: Numeric Functions-Footnote-3446931 -Node: String Functions447200 -Ref: String Functions-Footnote-1470697 -Ref: String Functions-Footnote-2470826 -Ref: String Functions-Footnote-3471074 -Node: Gory Details471161 -Ref: table-sub-escapes472840 -Ref: table-posix-sub474154 -Ref: table-gensub-escapes475067 -Node: I/O Functions476238 -Ref: I/O Functions-Footnote-1482893 -Node: Time Functions483040 -Ref: Time Functions-Footnote-1493932 -Ref: Time Functions-Footnote-2494000 -Ref: Time Functions-Footnote-3494158 -Ref: Time Functions-Footnote-4494269 -Ref: Time Functions-Footnote-5494381 -Ref: Time Functions-Footnote-6494608 -Node: Bitwise Functions494874 -Ref: table-bitwise-ops495432 -Ref: Bitwise Functions-Footnote-1499592 -Node: Type Functions499776 -Node: I18N Functions500246 -Node: User-defined501873 -Node: Definition Syntax502677 -Ref: Definition Syntax-Footnote-1507587 -Node: Function Example507656 -Node: Function Caveats510250 -Node: Calling A Function510671 -Node: Variable Scope511786 -Node: Pass By Value/Reference513761 -Node: Return Statement517201 -Node: Dynamic Typing520182 -Node: Indirect Calls520917 -Node: Internationalization530602 -Node: I18N and L10N532028 -Node: Explaining gettext532714 -Ref: Explaining gettext-Footnote-1537780 -Ref: Explaining gettext-Footnote-2537964 -Node: Programmer i18n538129 -Node: Translator i18n542329 -Node: String Extraction543122 -Ref: String Extraction-Footnote-1544083 -Node: Printf Ordering544169 -Ref: Printf Ordering-Footnote-1546953 -Node: I18N Portability547017 -Ref: I18N Portability-Footnote-1549466 -Node: I18N Example549529 -Ref: I18N Example-Footnote-1552164 -Node: Gawk I18N552236 -Node: Advanced Features552853 -Node: Nondecimal Data554366 -Node: Array Sorting555949 -Node: Controlling Array Traversal556649 -Node: Controlling Scanning With A Function557396 -Node: Controlling Scanning565099 -Ref: Controlling Scanning-Footnote-1568900 -Node: Array Sorting Functions569216 -Ref: Array Sorting Functions-Footnote-1572732 -Ref: Array Sorting Functions-Footnote-2572825 -Node: Two-way I/O573019 -Ref: Two-way I/O-Footnote-1578451 -Node: TCP/IP Networking578521 -Node: Profiling581365 -Node: Library Functions588839 -Ref: Library Functions-Footnote-1591846 -Node: Library Names592017 -Ref: Library Names-Footnote-1595488 -Ref: Library Names-Footnote-2595708 -Node: General Functions595794 -Node: Strtonum Function596747 -Node: Assert Function599677 -Node: Round Function603003 -Node: Cliff Random Function604546 -Node: Ordinal Functions605562 -Ref: Ordinal Functions-Footnote-1608632 -Ref: Ordinal Functions-Footnote-2608884 -Node: Join Function609093 -Ref: Join Function-Footnote-1610864 -Node: Gettimeofday Function611064 -Node: Data File Management614779 -Node: Filetrans Function615411 -Node: Rewind Function619550 -Node: File Checking620937 -Node: Empty Files622031 -Node: Ignoring Assigns624261 -Node: Getopt Function625814 -Ref: Getopt Function-Footnote-1637118 -Node: Passwd Functions637321 -Ref: Passwd Functions-Footnote-1646296 -Node: Group Functions646384 -Node: Walking Arrays654468 -Node: Sample Programs656037 -Node: Running Examples656702 -Node: Clones657430 -Node: Cut Program658654 -Node: Egrep Program668499 -Ref: Egrep Program-Footnote-1676272 -Node: Id Program676382 -Node: Split Program679998 -Ref: Split Program-Footnote-1683517 -Node: Tee Program683645 -Node: Uniq Program686448 -Node: Wc Program693877 -Ref: Wc Program-Footnote-1698143 -Ref: Wc Program-Footnote-2698343 -Node: Miscellaneous Programs698435 -Node: Dupword Program699623 -Node: Alarm Program701654 -Node: Translate Program706403 -Ref: Translate Program-Footnote-1710790 -Ref: Translate Program-Footnote-2711018 -Node: Labels Program711152 -Ref: Labels Program-Footnote-1714523 -Node: Word Sorting714607 -Node: History Sorting718491 -Node: Extract Program720330 -Ref: Extract Program-Footnote-1727813 -Node: Simple Sed727941 -Node: Igawk Program731003 -Ref: Igawk Program-Footnote-1746036 -Ref: Igawk Program-Footnote-2746237 -Node: Anagram Program746375 -Node: Signature Program749443 -Node: Debugger750543 -Node: Debugging751454 -Node: Debugging Concepts751867 -Node: Debugging Terms753723 -Node: Awk Debugging756346 -Node: Sample dgawk session757238 -Node: dgawk invocation757730 -Node: Finding The Bug758912 -Node: List of Debugger Commands765398 -Node: Breakpoint Control766709 -Node: Dgawk Execution Control770345 -Node: Viewing And Changing Data773696 -Node: Dgawk Stack777033 -Node: Dgawk Info778493 -Node: Miscellaneous Dgawk Commands782441 -Node: Readline Support787869 -Node: Dgawk Limitations788707 -Node: Language History790896 -Node: V7/SVR3.1792334 -Node: SVR4794655 -Node: POSIX796097 -Node: BTL797105 -Node: POSIX/GNU797839 -Node: Common Extensions802990 -Node: Contributors804091 -Node: Installation808267 -Node: Gawk Distribution809161 -Node: Getting809645 -Node: Extracting810471 -Node: Distribution contents812163 -Node: Unix Installation817385 -Node: Quick Installation818002 -Node: Additional Configuration Options819964 -Node: Configuration Philosophy821441 -Node: Non-Unix Installation823783 -Node: PC Installation824241 -Node: PC Binary Installation825540 -Node: PC Compiling827388 -Node: PC Testing830332 -Node: PC Using831508 -Node: Cygwin835693 -Node: MSYS836693 -Node: VMS Installation837207 -Node: VMS Compilation837810 -Ref: VMS Compilation-Footnote-1838817 -Node: VMS Installation Details838875 -Node: VMS Running840510 -Node: VMS Old Gawk842117 -Node: Bugs842591 -Node: Other Versions846501 -Node: Notes851780 -Node: Compatibility Mode852472 -Node: Additions853255 -Node: Accessing The Source854067 -Node: Adding Code855492 -Node: New Ports861459 -Node: Dynamic Extensions865572 -Node: Internals866948 -Node: Plugin License876051 -Node: Sample Library876685 -Node: Internal File Description877371 -Node: Internal File Ops881086 -Ref: Internal File Ops-Footnote-1885867 -Node: Using Internal File Ops886007 -Node: Future Extensions888384 -Node: Basic Concepts890888 -Node: Basic High Level891645 -Ref: Basic High Level-Footnote-1895680 -Node: Basic Data Typing895865 -Node: Floating Point Issues900390 -Node: String Conversion Precision901473 -Ref: String Conversion Precision-Footnote-1903173 -Node: Unexpected Results903282 -Node: POSIX Floating Point Problems905108 -Ref: POSIX Floating Point Problems-Footnote-1908813 -Node: Glossary908851 -Node: Copying933827 -Node: GNU Free Documentation License971384 -Node: Index996521 +Node: Top1346 +Node: Foreword33320 +Node: Preface37665 +Ref: Preface-Footnote-140632 +Ref: Preface-Footnote-240738 +Node: History40970 +Node: Names43361 +Ref: Names-Footnote-144838 +Node: This Manual44910 +Ref: This Manual-Footnote-149857 +Node: Conventions49957 +Node: Manual History52091 +Ref: Manual History-Footnote-155361 +Ref: Manual History-Footnote-255402 +Node: How To Contribute55476 +Node: Acknowledgments56620 +Node: Getting Started60951 +Node: Running gawk63330 +Node: One-shot64516 +Node: Read Terminal65741 +Ref: Read Terminal-Footnote-167391 +Ref: Read Terminal-Footnote-267667 +Node: Long67838 +Node: Executable Scripts69214 +Ref: Executable Scripts-Footnote-171083 +Ref: Executable Scripts-Footnote-271185 +Node: Comments71636 +Node: Quoting74103 +Node: DOS Quoting78726 +Node: Sample Data Files79401 +Node: Very Simple82433 +Node: Two Rules87032 +Node: More Complex89179 +Ref: More Complex-Footnote-192109 +Node: Statements/Lines92194 +Ref: Statements/Lines-Footnote-196656 +Node: Other Features96921 +Node: When97849 +Node: Invoking Gawk99996 +Node: Command Line101381 +Node: Options102164 +Ref: Options-Footnote-1115442 +Node: Other Arguments115467 +Node: Naming Standard Input118125 +Node: Environment Variables119219 +Node: AWKPATH Variable119663 +Ref: AWKPATH Variable-Footnote-1122260 +Node: Other Environment Variables122520 +Node: Exit Status124860 +Node: Include Files125535 +Node: Obsolete129020 +Node: Undocumented129706 +Node: Regexp129947 +Node: Regexp Usage131399 +Node: Escape Sequences133425 +Node: Regexp Operators139188 +Ref: Regexp Operators-Footnote-1146385 +Ref: Regexp Operators-Footnote-2146532 +Node: Bracket Expressions146630 +Ref: table-char-classes148433 +Node: GNU Regexp Operators151077 +Node: Case-sensitivity154800 +Ref: Case-sensitivity-Footnote-1157768 +Ref: Case-sensitivity-Footnote-2158003 +Node: Leftmost Longest158111 +Node: Computed Regexps159312 +Node: Locales162738 +Node: Reading Files166445 +Node: Records168386 +Ref: Records-Footnote-1177060 +Node: Fields177097 +Ref: Fields-Footnote-1180130 +Node: Nonconstant Fields180216 +Node: Changing Fields182418 +Node: Field Separators188396 +Node: Default Field Splitting191025 +Node: Regexp Field Splitting192142 +Node: Single Character Fields195484 +Node: Command Line Field Separator196543 +Node: Field Splitting Summary199984 +Ref: Field Splitting Summary-Footnote-1203176 +Node: Constant Size203277 +Node: Splitting By Content207861 +Ref: Splitting By Content-Footnote-1211587 +Node: Multiple Line211627 +Ref: Multiple Line-Footnote-1217474 +Node: Getline217653 +Node: Plain Getline219881 +Node: Getline/Variable221970 +Node: Getline/File223111 +Node: Getline/Variable/File224433 +Ref: Getline/Variable/File-Footnote-1226032 +Node: Getline/Pipe226119 +Node: Getline/Variable/Pipe228679 +Node: Getline/Coprocess229786 +Node: Getline/Variable/Coprocess231029 +Node: Getline Notes231743 +Node: Getline Summary233685 +Ref: table-getline-variants234028 +Node: Command line directories234884 +Node: Printing235509 +Node: Print237140 +Node: Print Examples238477 +Node: Output Separators241261 +Node: OFMT243021 +Node: Printf244379 +Node: Basic Printf245285 +Node: Control Letters246824 +Node: Format Modifiers250636 +Node: Printf Examples256645 +Node: Redirection259360 +Node: Special Files266344 +Node: Special FD266877 +Ref: Special FD-Footnote-1270502 +Node: Special Network270576 +Node: Special Caveats271426 +Node: Close Files And Pipes272222 +Ref: Close Files And Pipes-Footnote-1279245 +Ref: Close Files And Pipes-Footnote-2279393 +Node: Expressions279543 +Node: Values280612 +Node: Constants281288 +Node: Scalar Constants281968 +Ref: Scalar Constants-Footnote-1282827 +Node: Nondecimal-numbers283009 +Node: Regexp Constants286068 +Node: Using Constant Regexps286543 +Node: Variables289598 +Node: Using Variables290253 +Node: Assignment Options291977 +Node: Conversion293849 +Ref: table-locale-affects299225 +Ref: Conversion-Footnote-1299849 +Node: All Operators299958 +Node: Arithmetic Ops300588 +Node: Concatenation303093 +Ref: Concatenation-Footnote-1305886 +Node: Assignment Ops306006 +Ref: table-assign-ops310994 +Node: Increment Ops312402 +Node: Truth Values and Conditions315872 +Node: Truth Values316955 +Node: Typing and Comparison318004 +Node: Variable Typing318793 +Ref: Variable Typing-Footnote-1322690 +Node: Comparison Operators322812 +Ref: table-relational-ops323222 +Node: POSIX String Comparison326771 +Ref: POSIX String Comparison-Footnote-1327727 +Node: Boolean Ops327865 +Ref: Boolean Ops-Footnote-1331943 +Node: Conditional Exp332034 +Node: Function Calls333766 +Node: Precedence337360 +Node: Patterns and Actions341013 +Node: Pattern Overview342067 +Node: Regexp Patterns343733 +Node: Expression Patterns344276 +Node: Ranges347850 +Node: BEGIN/END350816 +Node: Using BEGIN/END351578 +Ref: Using BEGIN/END-Footnote-1354309 +Node: I/O And BEGIN/END354415 +Node: BEGINFILE/ENDFILE356697 +Node: Empty359528 +Node: Using Shell Variables359844 +Node: Action Overview362129 +Node: Statements364486 +Node: If Statement366340 +Node: While Statement367839 +Node: Do Statement369883 +Node: For Statement371039 +Node: Switch Statement374191 +Node: Break Statement376288 +Node: Continue Statement378278 +Node: Next Statement380065 +Node: Nextfile Statement382455 +Node: Exit Statement384752 +Node: Built-in Variables387168 +Node: User-modified388263 +Ref: User-modified-Footnote-1396289 +Node: Auto-set396351 +Ref: Auto-set-Footnote-1405642 +Node: ARGC and ARGV405847 +Node: Arrays409698 +Node: Array Basics411203 +Node: Array Intro411914 +Node: Reference to Elements416232 +Node: Assigning Elements418502 +Node: Array Example418993 +Node: Scanning an Array420725 +Node: Delete423391 +Ref: Delete-Footnote-1425826 +Node: Numeric Array Subscripts425883 +Node: Uninitialized Subscripts428066 +Node: Multi-dimensional429694 +Node: Multi-scanning432788 +Node: Arrays of Arrays434372 +Node: Functions438949 +Node: Built-in439771 +Node: Calling Built-in440849 +Node: Numeric Functions442837 +Ref: Numeric Functions-Footnote-1446602 +Ref: Numeric Functions-Footnote-2446959 +Ref: Numeric Functions-Footnote-3447007 +Node: String Functions447276 +Ref: String Functions-Footnote-1470773 +Ref: String Functions-Footnote-2470902 +Ref: String Functions-Footnote-3471150 +Node: Gory Details471237 +Ref: table-sub-escapes472916 +Ref: table-posix-sub474230 +Ref: table-gensub-escapes475143 +Node: I/O Functions476314 +Ref: I/O Functions-Footnote-1482969 +Node: Time Functions483116 +Ref: Time Functions-Footnote-1494008 +Ref: Time Functions-Footnote-2494076 +Ref: Time Functions-Footnote-3494234 +Ref: Time Functions-Footnote-4494345 +Ref: Time Functions-Footnote-5494457 +Ref: Time Functions-Footnote-6494684 +Node: Bitwise Functions494950 +Ref: table-bitwise-ops495508 +Ref: Bitwise Functions-Footnote-1499668 +Node: Type Functions499852 +Node: I18N Functions500322 +Node: User-defined501949 +Node: Definition Syntax502753 +Ref: Definition Syntax-Footnote-1507663 +Node: Function Example507732 +Node: Function Caveats510326 +Node: Calling A Function510747 +Node: Variable Scope511862 +Node: Pass By Value/Reference513837 +Node: Return Statement517277 +Node: Dynamic Typing520258 +Node: Indirect Calls520993 +Node: Internationalization530678 +Node: I18N and L10N532104 +Node: Explaining gettext532790 +Ref: Explaining gettext-Footnote-1537856 +Ref: Explaining gettext-Footnote-2538040 +Node: Programmer i18n538205 +Node: Translator i18n542405 +Node: String Extraction543198 +Ref: String Extraction-Footnote-1544159 +Node: Printf Ordering544245 +Ref: Printf Ordering-Footnote-1547029 +Node: I18N Portability547093 +Ref: I18N Portability-Footnote-1549542 +Node: I18N Example549605 +Ref: I18N Example-Footnote-1552240 +Node: Gawk I18N552312 +Node: Advanced Features552929 +Node: Nondecimal Data554442 +Node: Array Sorting556025 +Node: Controlling Array Traversal556725 +Node: Controlling Scanning With A Function557472 +Node: Controlling Scanning565175 +Ref: Controlling Scanning-Footnote-1568976 +Node: Array Sorting Functions569292 +Ref: Array Sorting Functions-Footnote-1572808 +Ref: Array Sorting Functions-Footnote-2572901 +Node: Two-way I/O573095 +Ref: Two-way I/O-Footnote-1578527 +Node: TCP/IP Networking578597 +Node: Profiling581441 +Node: Library Functions588915 +Ref: Library Functions-Footnote-1591922 +Node: Library Names592093 +Ref: Library Names-Footnote-1595564 +Ref: Library Names-Footnote-2595784 +Node: General Functions595870 +Node: Strtonum Function596823 +Node: Assert Function599753 +Node: Round Function603079 +Node: Cliff Random Function604622 +Node: Ordinal Functions605638 +Ref: Ordinal Functions-Footnote-1608708 +Ref: Ordinal Functions-Footnote-2608960 +Node: Join Function609169 +Ref: Join Function-Footnote-1610940 +Node: Gettimeofday Function611140 +Node: Data File Management614855 +Node: Filetrans Function615487 +Node: Rewind Function619626 +Node: File Checking621013 +Node: Empty Files622107 +Node: Ignoring Assigns624337 +Node: Getopt Function625890 +Ref: Getopt Function-Footnote-1637194 +Node: Passwd Functions637397 +Ref: Passwd Functions-Footnote-1646372 +Node: Group Functions646460 +Node: Walking Arrays654544 +Node: Sample Programs656113 +Node: Running Examples656778 +Node: Clones657506 +Node: Cut Program658730 +Node: Egrep Program668575 +Ref: Egrep Program-Footnote-1676348 +Node: Id Program676458 +Node: Split Program680074 +Ref: Split Program-Footnote-1683593 +Node: Tee Program683721 +Node: Uniq Program686524 +Node: Wc Program693953 +Ref: Wc Program-Footnote-1698219 +Ref: Wc Program-Footnote-2698419 +Node: Miscellaneous Programs698511 +Node: Dupword Program699699 +Node: Alarm Program701730 +Node: Translate Program706479 +Ref: Translate Program-Footnote-1710866 +Ref: Translate Program-Footnote-2711094 +Node: Labels Program711228 +Ref: Labels Program-Footnote-1714599 +Node: Word Sorting714683 +Node: History Sorting718567 +Node: Extract Program720406 +Ref: Extract Program-Footnote-1727889 +Node: Simple Sed728017 +Node: Igawk Program731079 +Ref: Igawk Program-Footnote-1746112 +Ref: Igawk Program-Footnote-2746313 +Node: Anagram Program746451 +Node: Signature Program749519 +Node: Debugger750619 +Node: Debugging751530 +Node: Debugging Concepts751943 +Node: Debugging Terms753799 +Node: Awk Debugging756422 +Node: Sample dgawk session757314 +Node: dgawk invocation757806 +Node: Finding The Bug758988 +Node: List of Debugger Commands765474 +Node: Breakpoint Control766785 +Node: Dgawk Execution Control770421 +Node: Viewing And Changing Data773772 +Node: Dgawk Stack777109 +Node: Dgawk Info778569 +Node: Miscellaneous Dgawk Commands782517 +Node: Readline Support787945 +Node: Dgawk Limitations788783 +Node: Language History790972 +Node: V7/SVR3.1792410 +Node: SVR4794731 +Node: POSIX796173 +Node: BTL797181 +Node: POSIX/GNU797915 +Node: Common Extensions803066 +Node: Contributors804167 +Node: Installation808343 +Node: Gawk Distribution809237 +Node: Getting809721 +Node: Extracting810547 +Node: Distribution contents812239 +Node: Unix Installation817461 +Node: Quick Installation818078 +Node: Additional Configuration Options820040 +Node: Configuration Philosophy821517 +Node: Non-Unix Installation823859 +Node: PC Installation824317 +Node: PC Binary Installation825616 +Node: PC Compiling827464 +Node: PC Testing830408 +Node: PC Using831584 +Node: Cygwin835769 +Node: MSYS836769 +Node: VMS Installation837283 +Node: VMS Compilation837886 +Ref: VMS Compilation-Footnote-1838893 +Node: VMS Installation Details838951 +Node: VMS Running840586 +Node: VMS Old Gawk842193 +Node: Bugs842667 +Node: Other Versions846577 +Node: Notes851856 +Node: Compatibility Mode852548 +Node: Additions853331 +Node: Accessing The Source854143 +Node: Adding Code855568 +Node: New Ports861535 +Node: Dynamic Extensions865648 +Node: Internals867024 +Node: Plugin License876127 +Node: Sample Library876761 +Node: Internal File Description877447 +Node: Internal File Ops881162 +Ref: Internal File Ops-Footnote-1885943 +Node: Using Internal File Ops886083 +Node: Future Extensions888460 +Node: Basic Concepts890964 +Node: Basic High Level891721 +Ref: Basic High Level-Footnote-1895756 +Node: Basic Data Typing895941 +Node: Floating Point Issues900466 +Node: String Conversion Precision901549 +Ref: String Conversion Precision-Footnote-1903249 +Node: Unexpected Results903358 +Node: POSIX Floating Point Problems905184 +Ref: POSIX Floating Point Problems-Footnote-1908889 +Node: Glossary908927 +Node: Copying933903 +Node: GNU Free Documentation License971460 +Node: Index996597 End Tag Table diff --git a/doc/gawk.texi b/doc/gawk.texi index ae040d9e..6145b105 100644 --- a/doc/gawk.texi +++ b/doc/gawk.texi @@ -3115,7 +3115,7 @@ which summarizes the extensions. Also see @cindex GPL (General Public License), printing Print the short version of the General Public License and then exit. -@item -d @r{[}@var{file}@r{]} +@item -d@r{[}@var{file}@r{]} @itemx --dump-variables@r{[}=@var{file}@r{]} @cindex @code{-d} option @cindex @code{--dump-variables} option @@ -3125,6 +3125,8 @@ Print the short version of the General Public License and then exit. Print a sorted list of global variables, their types, and final values to @var{file}. If no @var{file} is provided, print this list to the file named @file{awkvars.out} in the current directory. +No space is allowed between the @option{-d} and @var{file}, if +@var{file} is supplied. @cindex troubleshooting, typographical errors@comma{} global variables Having a list of all global variables is a good way to look for @@ -3254,7 +3256,7 @@ Enable some optimizations on the internal representation of the program. At the moment this includes just simple constant folding. The @command{gawk} maintainer hopes to add more optimizations over time. -@item -p @r{[}@var{file}@r{]} +@item -p@r{[}@var{file}@r{]} @itemx --profile@r{[}=@var{file}@r{]} @cindex @code{-p} option @cindex @code{--profile} option @@ -3264,6 +3266,8 @@ Enable profiling of @command{awk} programs By default, profiles are created in a file named @file{awkprof.out}. The optional @var{file} argument allows you to specify a different @value{FN} for the profile file. +No space is allowed between the @option{-p} and @var{file}, if +@var{file} is supplied. When run with @command{gawk}, the profile is just a ``pretty printed'' version of the program. When run with @command{pgawk}, the profile contains execution @@ -11427,6 +11431,28 @@ both @code{BEGINFILE} and @code{ENDFILE}. Only the @samp{getline In most other @command{awk} implementations, or if @command{gawk} is in compatibility mode (@pxref{Options}), they are not special. +@c FIXME: For 4.1 maybe deal with this? +@ignore +Date: Tue, 17 May 2011 02:06:10 PDT +From: rankin@pactechdata.com (Pat Rankin) +Message-Id: <110517015127.20240f4a@pactechdata.com> +Subject: BEGINFILE +To: arnold@skeeve.com + + The documentation for BEGINFILE states that FNR is 0, which seems +pretty obvious. It doesn't mention what the value of $0 is, and that's +not obvious. I think setting it to null before starting the BEGINFILE +action would be preferable to leaving whatever was there in the last +record of the previous file. + + ENDFILE can retain the last record in $0. I guess it has to if +the END rule's actions see that value too. But the beginning of a new +file doesn't just mean that the old one has been closed; the old file +is being superseded, so leaving the old data around feels wrong to me. +[If the user wants to keep it on hand, he or she can use an ENDFILE +rule to grab it before moving on to the next file.] +@end ignore + @node Empty @subsection The Empty Pattern @@ -12981,7 +13007,7 @@ BEGIN @{ for (i = 1; i < ARGC; i++) @{ if (ARGV[i] == "-v") verbose = 1 - else if (ARGV[i] == "-d") + else if (ARGV[i] == "-q") debug = 1 else if (ARGV[i] ~ /^-./) @{ e = sprintf("%s: unrecognized option -- %c", @@ -12999,7 +13025,7 @@ end the @command{awk} options with @option{--} and then supply the @command{awk} program's options, in the following manner: @example -awk -f myprog -- -v -d file1 file2 @dots{} +awk -f myprog -- -v -q file1 file2 @dots{} @end example @cindex differences in @command{awk} and @command{gawk}, @code{ARGC}/@code{ARGV} variables @@ -13011,11 +13037,11 @@ options that it might otherwise recognize. The previous example with @command{gawk} would be: @example -gawk -f myprog -d -v file1 file2 @dots{} +gawk -f myprog -q -v file1 file2 @dots{} @end example @noindent -Because @option{-d} is not a valid @command{gawk} option, +Because @option{-q} is not a valid @command{gawk} option, it and the following @option{-v} are passed on to the @command{awk} program. (@xref{Getopt Function}, for an @command{awk} library function |