diff options
| author | Arnold D. Robbins <arnold@skeeve.com> | 2011-01-02 20:12:07 +0200 |
|---|---|---|
| committer | Arnold D. Robbins <arnold@skeeve.com> | 2011-01-02 20:12:07 +0200 |
| commit | 001c8d1eb6130aeaa16b35bcf17141f0667e58fb (patch) | |
| tree | a22bb9a469a318407adf99fb0fdb4105f09fc16e /doc | |
| parent | 20b4f94a70bab9fa62e9628cd560cd81147a5218 (diff) | |
| download | egawk-001c8d1eb6130aeaa16b35bcf17141f0667e58fb.tar.gz egawk-001c8d1eb6130aeaa16b35bcf17141f0667e58fb.tar.bz2 egawk-001c8d1eb6130aeaa16b35bcf17141f0667e58fb.zip | |
Doc updates.
Diffstat (limited to 'doc')
| -rw-r--r-- | doc/gawk.info | 1079 | ||||
| -rw-r--r-- | doc/gawk.texi | 95 |
2 files changed, 575 insertions, 599 deletions
diff --git a/doc/gawk.info b/doc/gawk.info index 59f0f0fb..27c578b5 100644 --- a/doc/gawk.info +++ b/doc/gawk.info @@ -433,7 +433,7 @@ texts being (a) (see below), and with the Back-Cover Texts being (b) * SVR4:: Minor changes between System V Releases 3.1 and 4. * POSIX:: New features from the POSIX standard. -* BTL:: New features from the Bell Laboratories +* BTL:: New features from Brian Kernighan's version of `awk'. * POSIX/GNU:: The extensions in `gawk' not in POSIX `awk'. @@ -700,7 +700,7 @@ of `awk' was written in 1977 at AT&T Bell Laboratories. In 1985, a new version made the programming language more powerful, introducing user-defined functions, multiple input streams, and computed regular expressions. This new version became widely available with Unix System -V Release 3.1 (1987) The version in System V Release 4 (1989) added +V Release 3.1 (1987). The version in System V Release 4 (1989) added some new features and cleaned up the behavior in some of the "dark corners" of the language. The specification for `awk' in the POSIX Command Language and Utilities standard further clarified the language. @@ -1089,11 +1089,11 @@ byte-code interpreter, including the debugger. Stephen Davies contributed to the effort to bring the byte-code changes into the mainstream code base. - I would like to thank Brian Kernighan of Bell Laboratories for -invaluable assistance during the testing and debugging of `gawk', and -for ongoing help in clarifying numerous points about the language. We -could not have done nearly as good a job on either `gawk' or its -documentation without his help. + I would like to thank Brian Kernighan for invaluable assistance +during the testing and debugging of `gawk', and for ongoing help in +clarifying numerous points about the language. We could not have done +nearly as good a job on either `gawk' or its documentation without his +help. I must thank my wonderful wife, Miriam, for her patience through the many versions of this project, for her proofreading, and for sharing me @@ -2174,10 +2174,9 @@ The following list describes options mandated by the POSIX standard: `-c' `--traditional' Specify "compatibility mode", in which the GNU extensions to the - `awk' language are disabled, so that `gawk' behaves just like the - Bell Laboratories research version of Unix `awk'. *Note - POSIX/GNU::, which summarizes the extensions. Also see *note - Compatibility Mode::. + `awk' language are disabled, so that `gawk' behaves just like + Brian Kernighan's version `awk'. *Note POSIX/GNU::, which + summarizes the extensions. Also see *note Compatibility Mode::. `-C' `--copyright' @@ -3365,9 +3364,9 @@ No options Traditional Unix `awk' regexps are matched. The GNU operators are not special, and interval expressions are not available. The POSIX character classes (`[[:alnum:]]', etc.) are supported, as - modern Unix `awk' does support them. Characters described by - octal and hexadecimal escape sequences are treated literally, even - if they represent regexp metacharacters. + Brian Kernighan's `awk' does support them. Characters described + by octal and hexadecimal escape sequences are treated literally, + even if they represent regexp metacharacters. `--re-interval' Allow interval expressions in regexps, if `--traditional' has been @@ -4284,9 +4283,9 @@ field separator a new string? It turns out that different `awk' versions answer this question differently, and you should not rely on any specific behavior in your programs. (d.c.) - As a point of information, the Bell Labs `awk' allows `^' to match -only at the beginning of the record. `gawk' also works this way. For -example: + As a point of information, the Brian Kernighan's `awk' allows `^' to +match only at the beginning of the record. `gawk' also works this way. +For example: $ echo 'xxAA xxBxx C' | > gawk -F '(^x+)|( +)' '{ for (i = 1; i <= NF; i++) @@ -8964,7 +8963,7 @@ listed in `ARGV'. `nextfile', see *note Nextfile Function::, for a user-defined function that simulates the `nextfile' statement. - The current version of the Bell Laboratories `awk' (*note Other + The current version of the Brian Kernighan's `awk' (*note Other Versions::) also supports `nextfile'. However, it doesn't allow the `nextfile' statement inside function bodies (*note User-defined::). `gawk' does; a `nextfile' inside a function body reads the next record @@ -11246,17 +11245,16 @@ parameters are enclosed in square brackets ([ ]): function--`gawk' also buffers its output and the `fflush()' function forces `gawk' to flush its buffers. - `fflush()' was added to the Bell Laboratories research version of - `awk' in 1994; it is not part of the POSIX standard and is not - available if `--posix' has been specified on the command line - (*note Options::). + `fflush()' was added to Brian Kernighan's version of `awk' in + 1994; it is not part of the POSIX standard and is not available if + `--posix' has been specified on the command line (*note Options::). `gawk' extends the `fflush()' function in two ways. The first is to allow no argument at all. In this case, the buffer for the standard output is flushed. The second is to allow the null string (`""') as the argument. In this case, the buffers for _all_ open - output files and pipes are flushed. Current versions of the Bell - Labs `awk' also support these extensions. + output files and pipes are flushed. Current versions of the Brian + Kernighan's `awk' also support these extensions. `fflush()' returns zero if the buffer is successfully flushed; otherwise, it returns -1. In the case where all buffers are @@ -13264,10 +13262,10 @@ File: gawk.info, Node: Gawk I18N, Prev: I18N Example, Up: Internationalizatio =================================== `gawk' itself has been internationalized using the GNU `gettext' -package. (GNU `gettext' is described in complete detail in *note -Top::.) As of this writing, the latest version of GNU `gettext' is -version 0.18.1.1 -(ftp://ftp.gnu.org/gnu/gettext/gettext-0.18.1.1.tar.gz). +package. (GNU `gettext' is described in complete detail in *note (GNU +`gettext' utilities)Top:: gettext, GNU gettext tools.) As of this +writing, the latest version of GNU `gettext' is version 0.18.1 +(ftp://ftp.gnu.org/gnu/gettext/gettext-0.18.1.tar.gz). If a translation of `gawk''s messages exists, then `gawk' produces usage messages, warnings, and fatal errors in the local language. @@ -13551,8 +13549,10 @@ TCP `daytime' server. It then prints the results and closes the connection. Because this topic is extensive, the use of `gawk' for TCP/IP -programming is documented separately. *Note Top::, for a much more -complete introduction and discussion, as well as extensive examples. +programming is documented separately. See *note (General +Introduction)Top:: gawkinet, TCP/IP Internetworking with `gawk', for a +much more complete introduction and discussion, as well as extensive +examples. File: gawk.info, Node: Profiling, Prev: TCP/IP Networking, Up: Advanced Features @@ -17405,7 +17405,8 @@ Texinfo input file into separate files. This Info file is written in Texinfo (http://texinfo.org), the GNU project's document formatting language. A single Texinfo source file can be used to produce both printed and online documentation. The -Texinfo language is described fully, starting with *note Top::. +Texinfo language is described fully, starting with *note (Texinfo)Top:: +texinfo,Texinfo--The GNU Documentation Format. For our purposes, it is enough to know three things about Texinfo input files: @@ -19148,7 +19149,7 @@ find more information. * SVR4:: Minor changes between System V Releases 3.1 and 4. * POSIX:: New features from the POSIX standard. -* BTL:: New features from the Bell Laboratories +* BTL:: New features from Brian Kernighan's version of `awk'. * POSIX/GNU:: The extensions in `gawk' not in POSIX `awk'. @@ -19329,8 +19330,8 @@ standard: File: gawk.info, Node: BTL, Next: POSIX/GNU, Prev: POSIX, Up: Language History -A.4 Extensions in the Bell Laboratories `awk' -============================================= +A.4 Extensions in Brian Kernighan's `awk' +========================================= Brian Kernighan, one of the original designers of Unix `awk', has made his version available via his home page (*note Other Versions::). This @@ -19347,8 +19348,8 @@ POSIX `awk': Definition Syntax::). - The Bell Laboratories `awk' also incorporates the following -extensions, originally developed for `gawk': + Brian Kernighan's `awk' also incorporates the following extensions, +originally developed for `gawk': * The `\x' escape sequence (*note Escape Sequences::). @@ -19468,8 +19469,8 @@ the current version of `gawk'. - The `extension()' built-in function and the ability to add new functions dynamically (*note Dynamic Extensions::). - - The `fflush()' function from the Bell Laboratories research - version of `awk' (*note I/O Functions::). + - The `fflush()' function from Brian Kernighan's version of + `awk' (*note I/O Functions::). - The `gensub()', `patsplit()', and `strtonum()' functions for more powerful text manipulation (*note String Functions::). @@ -19768,6 +19769,9 @@ Various `.c', `.y', and `.h' files A short article describing why `gawk' is a good language for AI (Artificial Intelligence) programming. +`doc/bc_notes' + A brief description of `gawk''s "byte code" internals. + `doc/README.card' `doc/ad.block' `doc/awkcard.in' @@ -19795,9 +19799,11 @@ Various `.c', `.y', and `.h' files The generated Info file for this Info file. `doc/gawkinet.texi' - The Texinfo source file for *Note Top::. It should be processed - with TeX (via `texi2dvi' or `texi2pdf') to produce a printed - document and with `makeinfo' to produce an Info or HTML file. + The Texinfo source file for *note (General Introduction)Top:: + gawkinet, TCP/IP Internetworking with `gawk'. It should be + processed with TeX (via `texi2dvi' or `texi2pdf') to produce a + printed document and with `makeinfo' to produce an Info or HTML + file. `doc/gawkinet.info' The generated Info file for `TCP/IP Internetworking with `gawk''. @@ -19894,7 +19900,8 @@ environment for MS-Windows. automatically for your system by running the `configure' program. This program is a Bourne shell script that is generated automatically using GNU `autoconf'. (The `autoconf' software is described fully starting -with *note Top::.) +with *note (Autoconf)Top:: autoconf,Autoconf--Generating Automatic +Configuration Scripts.) To configure `gawk', simply run `configure': @@ -24164,10 +24171,10 @@ Index (line 96) * * (asterisk), ** operator <1>: Precedence. (line 49) * * (asterisk), ** operator <2>: Arithmetic Ops. (line 81) -* * (asterisk), ** operator: Options. (line 214) +* * (asterisk), ** operator: Options. (line 213) * * (asterisk), **= operator <1>: Precedence. (line 95) * * (asterisk), **= operator <2>: Assignment Ops. (line 129) -* * (asterisk), **= operator: Options. (line 214) +* * (asterisk), **= operator: Options. (line 213) * * (asterisk), *= operator <1>: Precedence. (line 95) * * (asterisk), *= operator: Assignment Ops. (line 129) * + (plus sign): Regexp Operators. (line 101) @@ -24189,70 +24196,70 @@ Index * --assign option: Options. (line 32) * --c option: Options. (line 78) * --characters-as-bytes option: Options. (line 68) -* --command option: Options. (line 241) -* --copyright option: Options. (line 86) +* --command option: Options. (line 240) +* --copyright option: Options. (line 85) * --disable-lint configuration option: Additional Configuration Options. (line 13) * --disable-nls configuration option: Additional Configuration Options. (line 28) * --dump-variables option <1>: Library Names. (line 45) -* --dump-variables option: Options. (line 91) -* --exec option: Options. (line 113) +* --dump-variables option: Options. (line 90) +* --exec option: Options. (line 112) * --field-separator option: Options. (line 21) * --file option: Options. (line 25) * --gen-pot option <1>: String Extraction. (line 6) -* --gen-pot option: Options. (line 135) -* --help option: Options. (line 142) -* --L option: Options. (line 255) -* --lint option <1>: Options. (line 147) +* --gen-pot option: Options. (line 134) +* --help option: Options. (line 141) +* --L option: Options. (line 254) +* --lint option <1>: Options. (line 146) * --lint option: Command Line. (line 20) -* --lint-old option: Options. (line 255) +* --lint-old option: Options. (line 254) * --non-decimal-data option <1>: Nondecimal Data. (line 6) -* --non-decimal-data option: Options. (line 166) +* --non-decimal-data option: Options. (line 165) * --non-decimal-data option, strtonum() function and: Nondecimal Data. (line 36) -* --optimize option: Options. (line 179) -* --posix option: Options. (line 198) -* --posix option, --traditional option and: Options. (line 228) +* --optimize option: Options. (line 178) +* --posix option: Options. (line 197) +* --posix option, --traditional option and: Options. (line 227) * --profile option <1>: Profiling. (line 15) -* --profile option: Options. (line 186) -* --re-interval option: Options. (line 234) -* --sandbox option: Options. (line 246) -* --sandbox option, disabling system function: I/O Functions. (line 86) +* --profile option: Options. (line 185) +* --re-interval option: Options. (line 233) +* --sandbox option: Options. (line 245) +* --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 105) +* --source option: Options. (line 104) * --traditional option: Options. (line 78) -* --traditional option, --posix option and: Options. (line 228) -* --use-lc-numeric option: Options. (line 174) -* --version option: Options. (line 260) +* --traditional option, --posix option and: Options. (line 227) +* --use-lc-numeric option: Options. (line 173) +* --version option: Options. (line 259) * --with-whiny-user-strftime configuration option: Additional Configuration Options. (line 9) * -b option: Options. (line 68) -* -C option: Options. (line 86) -* -d option: Options. (line 91) -* -E option: Options. (line 113) -* -e option: Options. (line 105) +* -C option: Options. (line 85) +* -d option: Options. (line 90) +* -E option: Options. (line 112) +* -e option: Options. (line 104) * -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 268) -* -f option, on command line: Options. (line 273) -* -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 198) -* -p option: Options. (line 186) -* -R option: Options. (line 241) -* -r option: Options. (line 234) -* -S option: Options. (line 246) -* -V option: Options. (line 260) +* -F option, -Ft sets FS to TAB: Options. (line 267) +* -f option, on command line: Options. (line 272) +* -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 240) +* -r option: Options. (line 233) +* -S option: Options. (line 245) +* -V option: Options. (line 259) * -v option: Options. (line 32) * -v option, variables, assigning: Assignment Options. (line 12) * -W option: Options. (line 46) @@ -24362,10 +24369,10 @@ Index (line 59) * ^ (caret): Regexp Operators. (line 22) * ^ (caret), ^ operator <1>: Precedence. (line 49) -* ^ (caret), ^ operator: Options. (line 214) +* ^ (caret), ^ operator: Options. (line 213) * ^ (caret), ^= operator <1>: Precedence. (line 95) * ^ (caret), ^= operator <2>: Assignment Ops. (line 129) -* ^ (caret), ^= operator: Options. (line 214) +* ^ (caret), ^= operator: Options. (line 213) * ^ (caret), in character lists: Character Lists. (line 16) * ^, in FS: Regexp Field Splitting. (line 59) @@ -24385,7 +24392,7 @@ Index * adding, features to gawk: Adding Code. (line 6) * adding, fields: Changing Fields. (line 53) * adding, functions to gawk: Dynamic Extensions. (line 10) -* advanced features, buffering: I/O Functions. (line 99) +* advanced features, buffering: I/O Functions. (line 98) * advanced features, close() function: Close Files And Pipes. (line 131) * advanced features, constants, values of: Nondecimal-numbers. @@ -24496,10 +24503,10 @@ Index (line 96) * asterisk (*), ** operator <1>: Precedence. (line 49) * asterisk (*), ** operator <2>: Arithmetic Ops. (line 81) -* asterisk (*), ** operator: Options. (line 214) +* asterisk (*), ** operator: Options. (line 213) * asterisk (*), **= operator <1>: Precedence. (line 95) * asterisk (*), **= operator <2>: Assignment Ops. (line 129) -* asterisk (*), **= operator: Options. (line 214) +* asterisk (*), **= operator: Options. (line 213) * asterisk (*), *= operator <1>: Precedence. (line 95) * asterisk (*), *= operator: Assignment Ops. (line 129) * atan2() function: Numeric Functions. (line 11) @@ -24520,7 +24527,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 186) +* awk programs, profiling, enabling: Options. (line 185) * awk programs, running <1>: Long. (line 6) * awk programs, running: Running gawk. (line 6) * awk programs, running, from shell scripts: One-shot. (line 22) @@ -24552,7 +24559,7 @@ Index * awk, versions of, changes between SVR4 and POSIX awk: POSIX. (line 6) * awk, versions of, changes between V7 and SVR3.1: V7/SVR3.1. (line 6) -* awk, versions of, See Also Bell Laboratories awk: BTL. (line 6) +* awk, versions of, See Also Brian Kernighan's awk: BTL. (line 6) * awk.h file (internal): Internals. (line 15) * awka compiler for awk: Other Versions. (line 81) * AWKNUM internal type: Internals. (line 19) @@ -24560,7 +24567,7 @@ Index * AWKPATH environment variable: AWKPATH Variable. (line 6) * awkprof.out file: Profiling. (line 10) * awksed.awk program: Simple Sed. (line 25) -* awkvars.out file: Options. (line 91) +* awkvars.out file: Options. (line 90) * b debugger command (alias for break): Breakpoint Control. (line 11) * backslash (\) <1>: Regexp Operators. (line 18) * backslash (\) <2>: Quoting. (line 31) @@ -24641,7 +24648,6 @@ Index (line 73) * BEGINFILE special pattern: BEGINFILE/ENDFILE. (line 6) * beginfile() user-defined function: Filetrans Function. (line 62) -* Bell Laboratories awk extensions: BTL. (line 6) * Benzinger, Michael: Contributors. (line 92) * Berry, Karl: Acknowledgments. (line 32) * binary input/output: User-modified. (line 10) @@ -24672,6 +24678,7 @@ Index * Brennan, Michael <2>: Simple Sed. (line 25) * Brennan, Michael <3>: Two-way I/O. (line 6) * Brennan, Michael: Delete. (line 51) +* Brian Kernighan's awk, extensions: BTL. (line 6) * Broder, Alan J.: Contributors. (line 83) * Brown, Martin: Contributors. (line 78) * BSD-based operating systems: Glossary. (line 580) @@ -24680,8 +24687,8 @@ Index * Buening, Andreas <2>: Contributors. (line 87) * Buening, Andreas: Acknowledgments. (line 59) * buffering, input/output <1>: Two-way I/O. (line 70) -* buffering, input/output: I/O Functions. (line 131) -* buffering, interactive vs. noninteractive: I/O Functions. (line 99) +* buffering, input/output: I/O Functions. (line 130) +* buffering, interactive vs. noninteractive: I/O Functions. (line 98) * buffers, flushing: I/O Functions. (line 29) * buffers, operators for: GNU Regexp Operators. (line 48) @@ -24701,10 +24708,10 @@ Index (line 59) * caret (^): Regexp Operators. (line 22) * caret (^), ^ operator <1>: Precedence. (line 49) -* caret (^), ^ operator: Options. (line 214) +* caret (^), ^ operator: Options. (line 213) * caret (^), ^= operator <1>: Precedence. (line 95) * caret (^), ^= operator <2>: Assignment Ops. (line 129) -* caret (^), ^= operator: Options. (line 214) +* caret (^), ^= operator: Options. (line 213) * caret (^), in character lists: Character Lists. (line 16) * case keyword: Switch Statement. (line 6) * case sensitivity, array indices and: Array Intro. (line 92) @@ -24714,7 +24721,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 113) +* CGI, awk scripts for: Options. (line 112) * character encodings: Ordinal Functions. (line 45) * character lists <1>: Character Lists. (line 6) * character lists: Regexp Operators. (line 55) @@ -24835,7 +24842,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 311) +* csh utility, POSIXLY_CORRECT environment variable: Options. (line 310) * 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) @@ -25004,7 +25011,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 222) +* decimal point character, locale specific: Options. (line 221) * decrement operators: Increment Ops. (line 35) * default keyword: Switch Statement. (line 6) * Deifik, Scott <1>: Bugs. (line 70) @@ -25167,7 +25174,7 @@ Index * escape processing, gsub()/gensub()/sub() functions: Gory Details. (line 6) * escape sequences: Escape Sequences. (line 6) -* escape sequences, unrecognized: Options. (line 202) +* escape sequences, unrecognized: Options. (line 201) * eval debugger command: Viewing And Changing Data. (line 23) * evaluation order: Increment Ops. (line 61) @@ -25206,11 +25213,11 @@ Index * Extended Regular Expressions (EREs): Character Lists. (line 23) * extension() function (gawk): Using Internal File Ops. (line 15) -* extensions, Bell Laboratories awk: BTL. (line 6) +* extensions, Brian Kernighan's awk: BTL. (line 6) * extensions, common, \x escape sequence: Escape Sequences. (line 61) * extensions, in gawk, not in POSIX awk: POSIX/GNU. (line 6) * extensions, mawk: Other Versions. (line 51) -* extract.awk program: Extract Program. (line 77) +* extract.awk program: Extract Program. (line 78) * extraction, of marked strings (internationalization): String Extraction. (line 6) * f debugger command (alias for frame): Dgawk Stack. (line 25) @@ -25224,7 +25231,7 @@ Index * Fenlason, Jay <1>: Contributors. (line 19) * Fenlason, Jay: History. (line 30) * fflush() function: I/O Functions. (line 25) -* fflush() function, unsupported: Options. (line 225) +* fflush() function, unsupported: Options. (line 224) * field numbers: Nonconstant Fields. (line 6) * field operator $: Fields. (line 19) * field operators, dollar sign as: Fields. (line 19) @@ -25282,7 +25289,7 @@ Index * files, as single records: Records. (line 196) * files, awk programs in: Long. (line 6) * files, awkprof.out: Profiling. (line 10) -* files, awkvars.out: Options. (line 91) +* files, awkvars.out: Options. (line 90) * files, closing: I/O Functions. (line 10) * files, descriptors, See file descriptors: Special FD. (line 6) * files, group: Group Functions. (line 6) @@ -25310,7 +25317,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 135) +* files, portable object, generating: Options. (line 134) * files, processing, ARGIND variable and: Auto-set. (line 47) * files, reading: Rewind Function. (line 6) * files, reading, multiline records: Multiple Line. (line 6) @@ -25364,7 +25371,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 218) +* FS variable, as TAB character: Options. (line 217) * 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. @@ -25443,10 +25450,10 @@ Index * gawk, distribution: Distribution contents. (line 6) * gawk, escape sequences: Escape Sequences. (line 125) -* gawk, extensions, disabling: Options. (line 198) +* gawk, extensions, disabling: Options. (line 197) * gawk, features, adding: Adding Code. (line 6) * gawk, features, advanced: Advanced Features. (line 6) -* gawk, fflush() function in: I/O Functions. (line 45) +* gawk, fflush() function in: I/O Functions. (line 44) * gawk, field separators and: User-modified. (line 77) * gawk, FIELDWIDTHS variable in: User-modified. (line 41) * gawk, file names in: Special Files. (line 6) @@ -25490,7 +25497,7 @@ Index * gawk, string-translation functions: I18N Functions. (line 6) * gawk, timestamps: Time Functions. (line 6) * gawk, uses for: Preface. (line 35) -* gawk, versions of, information about, printing: Options. (line 260) +* gawk, versions of, information about, printing: Options. (line 259) * gawk, word-boundary operator: GNU Regexp Operators. (line 63) * General Public License (GPL): Glossary. (line 295) @@ -25548,7 +25555,7 @@ Index * GNU Lesser General Public License: Glossary. (line 374) * GNU long options <1>: Options. (line 6) * GNU long options: Command Line. (line 13) -* GNU long options, printing list of: Options. (line 142) +* GNU long options, printing list of: Options. (line 141) * GNU Project <1>: Glossary. (line 304) * GNU Project: Manual History. (line 11) * GNU/Linux <1>: Glossary. (line 580) @@ -25556,7 +25563,7 @@ Index * GNU/Linux: Manual History. (line 28) * GPL (General Public License) <1>: Glossary. (line 295) * GPL (General Public License): Manual History. (line 11) -* GPL (General Public License), printing: Options. (line 86) +* GPL (General Public License), printing: Options. (line 85) * grcat program: Group Functions. (line 16) * Grigera, Juan: Contributors. (line 55) * group database, reading: Group Functions. (line 6) @@ -25579,7 +25586,7 @@ Index * help debugger command: Miscellaneous Dgawk Commands. (line 68) * hexadecimal numbers: Nondecimal-numbers. (line 6) -* hexadecimal values, enabling interpretation of: Options. (line 166) +* hexadecimal values, enabling interpretation of: Options. (line 165) * histsort.awk program: History Sorting. (line 25) * Hughes, Phil: Acknowledgments. (line 42) * HUP signal: Profiling. (line 204) @@ -25650,7 +25657,7 @@ Index * int() function: Numeric Functions. (line 22) * integers: Basic Data Typing. (line 21) * integers, unsigned: Basic Data Typing. (line 28) -* interacting with other programs: I/O Functions. (line 64) +* interacting with other programs: I/O Functions. (line 63) * internationalization <1>: I18N and L10N. (line 6) * internationalization: I18N Functions. (line 6) * internationalization, localization <1>: Internationalization. @@ -25764,9 +25771,9 @@ Index * lint checking, array subscripts: Uninitialized Subscripts. (line 43) * lint checking, empty programs: Command Line. (line 16) -* lint checking, issuing warnings: Options. (line 147) +* lint checking, issuing warnings: Options. (line 146) * lint checking, POSIXLY_CORRECT environment variable: Options. - (line 298) + (line 297) * lint checking, undefined functions: Pass By Value/Reference. (line 88) * LINT variable: User-modified. (line 98) @@ -25777,7 +25784,7 @@ Index (line 74) * local variables: Variable Scope. (line 6) * locale categories: Explaining gettext. (line 80) -* locale decimal point character: Options. (line 222) +* locale decimal point character: Options. (line 221) * locale, definition of: Locales. (line 6) * localization: I18N and L10N. (line 6) * localization, See internationalization, localization: I18N and L10N. @@ -25845,7 +25852,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 205) +* newlines <2>: Options. (line 204) * newlines: Statements/Lines. (line 6) * newlines, as field separators: Default Field Splitting. (line 6) @@ -25923,7 +25930,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 166) +* octal values, enabling interpretation of: Options. (line 165) * OFMT variable <1>: User-modified. (line 115) * OFMT variable <2>: Conversion. (line 54) * OFMT variable: OFMT. (line 15) @@ -25976,7 +25983,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 142) +* options, printing list of: Options. (line 141) * OR bitwise operation: Bitwise Functions. (line 6) * or Boolean-logic operator: Boolean Ops. (line 6) * or() function (gawk): Bitwise Functions. (line 48) @@ -26070,13 +26077,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 316) +* portability, POSIXLY_CORRECT environment variable: Options. (line 315) * portability, substr() function: String Functions. (line 484) * 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 135) +* portable object files, generating: Options. (line 134) * portable object template files: Explaining gettext. (line 30) * porting gawk: New Ports. (line 6) * positional specifiers, printf statement <1>: Printf Ordering. @@ -26118,11 +26125,11 @@ Index * POSIX awk, regular expressions and: Regexp Operators. (line 156) * POSIX awk, timestamps and: Time Functions. (line 6) * POSIX awk, | I/O operator and: Getline/Pipe. (line 52) -* POSIX mode: Options. (line 198) +* POSIX mode: Options. (line 197) * 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 298) +* POSIXLY_CORRECT environment variable: Options. (line 297) * precedence <1>: Precedence. (line 6) * precedence: Increment Ops. (line 61) * precedence, regexp operators: Regexp Operators. (line 151) @@ -26156,7 +26163,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 142) +* printing, list of options: Options. (line 141) * printing, mailing labels: Labels Program. (line 6) * printing, unduplicated lines of text: Uniq Program. (line 6) * printing, user information: Id Program. (line 6) @@ -26274,7 +26281,7 @@ Index (line 59) * regular expressions, gawk, command-line options: GNU Regexp Operators. (line 70) -* regular expressions, interval expressions and: Options. (line 234) +* regular expressions, interval expressions and: Options. (line 233) * regular expressions, leftmost longest match: Leftmost Longest. (line 6) * regular expressions, operators <1>: Regexp Operators. (line 6) @@ -26347,7 +26354,7 @@ Index * rvalues/lvalues: Assignment Ops. (line 32) * s debugger command (alias for step): Dgawk Execution Control. (line 68) -* sandbox mode: Options. (line 246) +* sandbox mode: Options. (line 245) * scalar values: Basic Data Typing. (line 13) * Schorr, Andrew: Acknowledgments. (line 59) * Schreiber, Bert: Acknowledgments. (line 37) @@ -26431,7 +26438,7 @@ Index * source code, Bell Laboratories awk: Other Versions. (line 13) * source code, gawk: Gawk Distribution. (line 6) * source code, mawk: Other Versions. (line 34) -* source code, mixing: Options. (line 105) +* source code, mixing: Options. (line 104) * source files, search path for: Igawk Program. (line 364) * sparse arrays: Array Intro. (line 71) * Spencer, Henry: Glossary. (line 12) @@ -26512,7 +26519,7 @@ Index * switch statement: Switch Statement. (line 6) * syntactic ambiguity: /= operator vs. /=.../ regexp constant: Assignment Ops. (line 148) -* system() function: I/O Functions. (line 64) +* system() function: I/O Functions. (line 63) * systime() function (gawk): Time Functions. (line 64) * t debugger command (alias for tbreak): Breakpoint Control. (line 86) * tbreak debugger command: Breakpoint Control. (line 86) @@ -26525,7 +26532,7 @@ Index * testbits.awk program: Bitwise Functions. (line 68) * Texinfo <1>: Adding Code. (line 90) * Texinfo <2>: Distribution contents. - (line 68) + (line 71) * Texinfo <3>: Extract Program. (line 12) * Texinfo <4>: Dupword Program. (line 17) * Texinfo <5>: Library Functions. (line 22) @@ -26564,7 +26571,7 @@ Index * trace debugger command: Miscellaneous Dgawk Commands. (line 110) * translate.awk program: Translate Program. (line 55) -* troubleshooting, --non-decimal-data option: Options. (line 166) +* troubleshooting, --non-decimal-data option: Options. (line 165) * troubleshooting, == operator: Comparison Operators. (line 37) * troubleshooting, awk uses FS not IFS: Field Separators. (line 29) @@ -26575,7 +26582,7 @@ Index (line 22) * troubleshooting, fatal errors, printf format strings: Format Modifiers. (line 159) -* troubleshooting, fflush() function: I/O Functions. (line 52) +* troubleshooting, fflush() function: I/O Functions. (line 51) * troubleshooting, function call syntax: Function Calls. (line 28) * troubleshooting, gawk: Compatibility Mode. (line 6) * troubleshooting, gawk, bug reports: Bugs. (line 9) @@ -26594,9 +26601,9 @@ Index (line 38) * troubleshooting, string concatenation: Concatenation. (line 27) * troubleshooting, substr() function: String Functions. (line 471) -* troubleshooting, system() function: I/O Functions. (line 86) +* troubleshooting, system() function: I/O Functions. (line 85) * troubleshooting, typographical errors, global variables: Options. - (line 95) + (line 94) * true, logical: Truth Values. (line 6) * Trueman, David <1>: Contributors. (line 31) * Trueman, David <2>: Acknowledgments. (line 46) @@ -26667,7 +26674,7 @@ Index (line 6) * variables, getline command into, using: Getline/Variable. (line 6) * variables, global, for library functions: Library Names. (line 11) -* variables, global, printing list of: Options. (line 91) +* variables, global, printing list of: Options. (line 90) * variables, initializing: Using Variables. (line 20) * variables, local: Variable Scope. (line 6) * variables, names of: Arrays. (line 18) @@ -26696,7 +26703,7 @@ Index * Wall, Larry <1>: Future Extensions. (line 6) * Wall, Larry: Array Intro. (line 6) * Wallin, Anders: Acknowledgments. (line 59) -* warnings, issuing: Options. (line 147) +* warnings, issuing: Options. (line 146) * watch debugger command: Viewing And Changing Data. (line 67) * wc utility: Wc Program. (line 6) @@ -26708,7 +26715,7 @@ Index * whitespace, as field separators: Default Field Splitting. (line 6) * whitespace, functions, calling: Calling Built-in. (line 10) -* whitespace, newlines as: Options. (line 205) +* whitespace, newlines as: Options. (line 204) * Williams, Kent: Contributors. (line 37) * Woehlke, Matthew: Contributors. (line 75) * Woods, John: Contributors. (line 28) @@ -26761,405 +26768,405 @@ Index Tag Table: Node: Top1340 -Node: Foreword29975 -Node: Preface34295 -Ref: Preface-Footnote-137247 -Ref: Preface-Footnote-237353 -Node: History37585 -Node: Names39817 -Ref: Names-Footnote-141294 -Node: This Manual41366 -Ref: This Manual-Footnote-146264 -Node: Conventions46364 -Node: Manual History48423 -Ref: Manual History-Footnote-151601 -Ref: Manual History-Footnote-251642 -Node: How To Contribute51716 -Node: Acknowledgments52860 -Node: Getting Started57129 -Node: Running gawk59508 -Node: One-shot60694 -Node: Read Terminal61919 -Ref: Read Terminal-Footnote-163569 -Ref: Read Terminal-Footnote-263843 -Node: Long64014 -Node: Executable Scripts65390 -Ref: Executable Scripts-Footnote-167251 -Ref: Executable Scripts-Footnote-267353 -Node: Comments67804 -Node: Quoting70271 -Node: DOS Quoting74888 -Node: Sample Data Files75563 -Node: Very Simple78595 -Node: Two Rules83192 -Node: More Complex85339 -Ref: More Complex-Footnote-188269 -Node: Statements/Lines88349 -Ref: Statements/Lines-Footnote-192811 -Node: Other Features93076 -Node: When93945 -Node: Invoking Gawk96088 -Node: Command Line97473 -Node: Options98256 -Ref: Options-Footnote-1111627 -Node: Other Arguments111652 -Node: Naming Standard Input114315 -Node: Environment Variables115279 -Node: AWKPATH Variable115723 -Ref: AWKPATH Variable-Footnote-1118460 -Node: Other Environment Variables118720 -Node: Exit Status121068 -Node: Include Files121743 -Node: Obsolete125134 -Node: Undocumented125820 -Node: Regexp126061 -Node: Regexp Usage127513 -Node: Escape Sequences129539 -Node: Regexp Operators135282 -Ref: Regexp Operators-Footnote-1142454 -Ref: Regexp Operators-Footnote-2142601 -Node: Character Lists142699 -Ref: table-char-classes144474 -Node: GNU Regexp Operators147114 -Node: Case-sensitivity150827 -Ref: Case-sensitivity-Footnote-1153782 -Ref: Case-sensitivity-Footnote-2154017 -Node: Leftmost Longest154125 -Node: Computed Regexps155326 -Node: Locales158743 -Node: Reading Files162285 -Node: Records164226 -Ref: Records-Footnote-1172898 -Node: Fields172935 -Ref: Fields-Footnote-1175967 -Node: Nonconstant Fields176053 -Node: Changing Fields178255 -Node: Field Separators183545 -Node: Default Field Splitting186174 -Node: Regexp Field Splitting187291 -Node: Single Character Fields190641 -Node: Command Line Field Separator191692 -Node: Field Splitting Summary195131 -Ref: Field Splitting Summary-Footnote-1198317 -Node: Constant Size198418 -Node: Splitting By Content202980 -Ref: Splitting By Content-Footnote-1206706 -Node: Multiple Line206746 -Ref: Multiple Line-Footnote-1212593 -Node: Getline212772 -Node: Plain Getline215000 -Node: Getline/Variable217089 -Node: Getline/File218230 -Node: Getline/Variable/File219552 -Ref: Getline/Variable/File-Footnote-1221151 -Node: Getline/Pipe221238 -Node: Getline/Variable/Pipe223786 -Node: Getline/Coprocess224893 -Node: Getline/Variable/Coprocess226136 -Node: Getline Notes226850 -Node: Getline Summary228792 -Ref: table-getline-variants229076 -Node: Command line directories229981 -Node: Printing230606 -Node: Print232237 -Node: Print Examples233574 -Node: Output Separators236358 -Node: OFMT238117 -Node: Printf239475 -Node: Basic Printf240381 -Node: Control Letters241918 -Node: Format Modifiers245730 -Node: Printf Examples251741 -Node: Redirection254456 -Node: Special Files261434 -Node: Special FD261967 -Ref: Special FD-Footnote-1265542 -Node: Special Network265616 -Node: Special Caveats266471 -Node: Close Files And Pipes267265 -Ref: Close Files And Pipes-Footnote-1274209 -Ref: Close Files And Pipes-Footnote-2274357 -Node: Expressions274507 -Node: Values275576 -Node: Constants276252 -Node: Scalar Constants276932 -Ref: Scalar Constants-Footnote-1277791 -Node: Nondecimal-numbers277973 -Node: Regexp Constants281032 -Node: Using Constant Regexps281507 -Node: Variables284512 -Node: Using Variables285167 -Node: Assignment Options286894 -Node: Conversion288775 -Ref: table-locale-affects294149 -Ref: Conversion-Footnote-1294773 -Node: All Operators294882 -Node: Arithmetic Ops295512 -Node: Concatenation298011 -Ref: Concatenation-Footnote-1300804 -Node: Assignment Ops300923 -Ref: table-assign-ops305911 -Node: Increment Ops307312 -Node: Truth Values and Conditions310790 -Node: Truth Values311873 -Node: Typing and Comparison312921 -Node: Variable Typing313710 -Ref: Variable Typing-Footnote-1317607 -Node: Comparison Operators317729 -Ref: table-relational-ops318139 -Node: POSIX String Comparison321688 -Ref: POSIX String Comparison-Footnote-1322645 -Node: Boolean Ops322783 -Ref: Boolean Ops-Footnote-1326861 -Node: Conditional Exp326952 -Node: Function Calls328684 -Node: Precedence332274 -Node: Patterns and Actions335927 -Node: Pattern Overview336981 -Node: Regexp Patterns338647 -Node: Expression Patterns339190 -Node: Ranges342764 -Node: BEGIN/END345730 -Node: Using BEGIN/END346480 -Ref: Using BEGIN/END-Footnote-1349211 -Node: I/O And BEGIN/END349325 -Node: Empty351594 -Node: BEGINFILE/ENDFILE351928 -Node: Using Shell Variables354753 -Node: Action Overview357032 -Node: Statements359389 -Node: If Statement361248 -Node: While Statement362747 -Node: Do Statement364791 -Node: For Statement365947 -Node: Switch Statement369099 -Node: Break Statement371196 -Node: Continue Statement373172 -Node: Next Statement374873 -Node: Nextfile Statement377255 -Node: Exit Statement379773 -Node: Built-in Variables382104 -Node: User-modified383199 -Ref: User-modified-Footnote-1391200 -Node: Auto-set391262 -Ref: Auto-set-Footnote-1400245 -Node: ARGC and ARGV400450 -Node: Arrays404209 -Node: Array Basics405780 -Node: Array Intro406491 -Node: Reference to Elements410809 -Node: Assigning Elements413079 -Node: Array Example413570 -Node: Scanning an Array415302 -Node: Delete417579 -Ref: Delete-Footnote-1420002 -Node: Numeric Array Subscripts420059 -Node: Uninitialized Subscripts422242 -Node: Multi-dimensional423870 -Node: Multi-scanning426961 -Node: Array Sorting428545 -Ref: Array Sorting-Footnote-1431743 -Node: Arrays of Arrays431937 -Node: Functions436099 -Node: Built-in436921 -Node: Calling Built-in437935 -Node: Numeric Functions439911 -Ref: Numeric Functions-Footnote-1443668 -Ref: Numeric Functions-Footnote-2444004 -Ref: Numeric Functions-Footnote-3444052 -Node: String Functions444321 -Ref: String Functions-Footnote-1466120 -Ref: String Functions-Footnote-2466249 -Ref: String Functions-Footnote-3466497 -Node: Gory Details466584 -Ref: table-sub-escapes468241 -Ref: table-posix-sub469555 -Ref: table-gensub-escapes470455 -Node: I/O Functions471626 -Ref: I/O Functions-Footnote-1478323 -Node: Time Functions478470 -Ref: Time Functions-Footnote-1489337 -Ref: Time Functions-Footnote-2489405 -Ref: Time Functions-Footnote-3489563 -Ref: Time Functions-Footnote-4489674 -Ref: Time Functions-Footnote-5489786 -Ref: Time Functions-Footnote-6490013 -Node: Bitwise Functions490279 -Ref: table-bitwise-ops490837 -Ref: Bitwise Functions-Footnote-1494997 -Node: I18N Functions495181 -Node: User-defined496811 -Node: Definition Syntax497615 -Ref: Definition Syntax-Footnote-1502245 -Node: Function Example502314 -Node: Function Caveats504908 -Node: Calling A Function505329 -Node: Variable Scope506444 -Node: Pass By Value/Reference508372 -Node: Return Statement511812 -Node: Dynamic Typing514754 -Node: Indirect Calls515491 -Node: Internationalization525176 -Node: I18N and L10N526604 -Node: Explaining gettext527290 -Ref: Explaining gettext-Footnote-1532352 -Ref: Explaining gettext-Footnote-2532535 -Node: Programmer i18n532700 -Node: Translator i18n536991 -Node: String Extraction537784 -Ref: String Extraction-Footnote-1538745 -Node: Printf Ordering538831 -Ref: Printf Ordering-Footnote-1541615 -Node: I18N Portability541679 -Ref: I18N Portability-Footnote-1544128 -Node: I18N Example544191 -Ref: I18N Example-Footnote-1546826 -Node: Gawk I18N546898 -Node: Advanced Features547467 -Node: Nondecimal Data548786 -Node: Two-way I/O550367 -Ref: Two-way I/O-Footnote-1555781 -Node: TCP/IP Networking555858 -Node: Profiling558630 -Node: Library Functions566030 -Ref: Library Functions-Footnote-1569000 -Node: Library Names569171 -Ref: Library Names-Footnote-1572642 -Ref: Library Names-Footnote-2572862 -Node: General Functions572948 -Node: Nextfile Function574011 -Node: Strtonum Function578392 -Node: Assert Function581343 -Node: Round Function584669 -Node: Cliff Random Function586210 -Node: Ordinal Functions587226 -Ref: Ordinal Functions-Footnote-1590296 -Ref: Ordinal Functions-Footnote-2590548 -Node: Join Function590764 -Ref: Join Function-Footnote-1592535 -Node: Gettimeofday Function592735 -Node: Data File Management596450 -Node: Filetrans Function597082 -Node: Rewind Function601319 -Node: File Checking602772 -Node: Empty Files603866 -Node: Ignoring Assigns606096 -Node: Getopt Function607649 -Ref: Getopt Function-Footnote-1618974 -Node: Passwd Functions619177 -Ref: Passwd Functions-Footnote-1628165 -Node: Group Functions628253 -Node: Sample Programs636333 -Node: Running Examples636998 -Node: Clones637726 -Node: Cut Program638849 -Node: Egrep Program648690 -Ref: Egrep Program-Footnote-1656461 -Node: Id Program656571 -Node: Split Program660187 -Ref: Split Program-Footnote-1663706 -Node: Tee Program663834 -Node: Uniq Program666637 -Node: Wc Program674060 -Ref: Wc Program-Footnote-1678324 -Node: Miscellaneous Programs678524 -Node: Dupword Program679644 -Node: Alarm Program681675 -Node: Translate Program686397 -Ref: Translate Program-Footnote-1690776 -Ref: Translate Program-Footnote-2691004 -Node: Labels Program691138 -Ref: Labels Program-Footnote-1694509 -Node: Word Sorting694593 -Node: History Sorting698938 -Node: Extract Program700776 -Ref: Extract Program-Footnote-1708202 -Node: Simple Sed708330 -Node: Igawk Program711392 -Ref: Igawk Program-Footnote-1726426 -Ref: Igawk Program-Footnote-2726627 -Node: Signature Program726765 -Node: Debugger727845 -Node: Debugging728756 -Node: Debugging Concepts729070 -Node: Debugging Terms730926 -Node: Awk Debugging733471 -Node: Sample dgawk session734363 -Node: dgawk invocation734855 -Node: Finding The Bug736037 -Node: List of Debugger Commands742521 -Node: Breakpoint Control743832 -Node: Dgawk Execution Control747308 -Node: Viewing And Changing Data750659 -Node: Dgawk Stack753968 -Node: Dgawk Info755428 -Node: Miscellaneous Dgawk Commands759376 -Node: Readline Support764804 -Node: Dgawk Limitations765631 -Node: Language History767770 -Node: V7/SVR3.1769147 -Node: SVR4771442 -Node: POSIX772887 -Node: BTL775142 -Node: POSIX/GNU776546 -Node: Contributors781676 -Node: Installation785621 -Node: Gawk Distribution786515 -Node: Getting786999 -Node: Extracting787825 -Node: Distribution contents789503 -Node: Unix Installation794368 -Node: Quick Installation794985 -Node: Additional Configuration Options796875 -Node: Configuration Philosophy798352 -Node: Non-Unix Installation800694 -Node: PC Installation801152 -Node: PC Binary Installation802451 -Node: PC Compiling804299 -Node: PC Testing807705 -Node: PC Using808529 -Node: Cygwin812706 -Node: MSYS813703 -Node: VMS Installation814217 -Node: VMS Compilation814821 -Node: VMS Installation Details816398 -Node: VMS Running818028 -Node: VMS POSIX819625 -Node: VMS Old Gawk820923 -Node: Bugs821395 -Node: Other Versions825260 -Node: Notes830708 -Node: Compatibility Mode831400 -Node: Additions832183 -Node: Accessing The Source832995 -Node: Adding Code834418 -Node: New Ports839966 -Node: Dynamic Extensions844079 -Node: Internals845455 -Node: Plugin License854574 -Node: Sample Library855208 -Node: Internal File Description855894 -Node: Internal File Ops859601 -Ref: Internal File Ops-Footnote-1864485 -Node: Using Internal File Ops864633 -Node: Future Extensions866658 -Node: Basic Concepts869495 -Node: Basic High Level870252 -Ref: Basic High Level-Footnote-1874371 -Node: Basic Data Typing874565 -Node: Floating Point Issues879002 -Node: String Conversion Precision880085 -Ref: String Conversion Precision-Footnote-1881779 -Node: Unexpected Results881888 -Node: POSIX Floating Point Problems883714 -Ref: POSIX Floating Point Problems-Footnote-1887413 -Node: Glossary887451 -Node: Copying911086 -Node: GNU Free Documentation License948643 -Node: next-edition973787 -Node: unresolved974139 -Node: revision974639 -Node: consistency975062 -Node: Index978415 +Node: Foreword29971 +Node: Preface34291 +Ref: Preface-Footnote-137243 +Ref: Preface-Footnote-237349 +Node: History37581 +Node: Names39815 +Ref: Names-Footnote-141292 +Node: This Manual41364 +Ref: This Manual-Footnote-146262 +Node: Conventions46362 +Node: Manual History48421 +Ref: Manual History-Footnote-151599 +Ref: Manual History-Footnote-251640 +Node: How To Contribute51714 +Node: Acknowledgments52858 +Node: Getting Started57106 +Node: Running gawk59485 +Node: One-shot60671 +Node: Read Terminal61896 +Ref: Read Terminal-Footnote-163546 +Ref: Read Terminal-Footnote-263820 +Node: Long63991 +Node: Executable Scripts65367 +Ref: Executable Scripts-Footnote-167228 +Ref: Executable Scripts-Footnote-267330 +Node: Comments67781 +Node: Quoting70248 +Node: DOS Quoting74865 +Node: Sample Data Files75540 +Node: Very Simple78572 +Node: Two Rules83169 +Node: More Complex85316 +Ref: More Complex-Footnote-188246 +Node: Statements/Lines88326 +Ref: Statements/Lines-Footnote-192788 +Node: Other Features93053 +Node: When93922 +Node: Invoking Gawk96065 +Node: Command Line97450 +Node: Options98233 +Ref: Options-Footnote-1111578 +Node: Other Arguments111603 +Node: Naming Standard Input114266 +Node: Environment Variables115230 +Node: AWKPATH Variable115674 +Ref: AWKPATH Variable-Footnote-1118411 +Node: Other Environment Variables118671 +Node: Exit Status121019 +Node: Include Files121694 +Node: Obsolete125085 +Node: Undocumented125771 +Node: Regexp126012 +Node: Regexp Usage127464 +Node: Escape Sequences129490 +Node: Regexp Operators135233 +Ref: Regexp Operators-Footnote-1142405 +Ref: Regexp Operators-Footnote-2142552 +Node: Character Lists142650 +Ref: table-char-classes144425 +Node: GNU Regexp Operators147065 +Node: Case-sensitivity150784 +Ref: Case-sensitivity-Footnote-1153739 +Ref: Case-sensitivity-Footnote-2153974 +Node: Leftmost Longest154082 +Node: Computed Regexps155283 +Node: Locales158700 +Node: Reading Files162242 +Node: Records164183 +Ref: Records-Footnote-1172855 +Node: Fields172892 +Ref: Fields-Footnote-1175924 +Node: Nonconstant Fields176010 +Node: Changing Fields178212 +Node: Field Separators183502 +Node: Default Field Splitting186131 +Node: Regexp Field Splitting187248 +Node: Single Character Fields190606 +Node: Command Line Field Separator191657 +Node: Field Splitting Summary195096 +Ref: Field Splitting Summary-Footnote-1198282 +Node: Constant Size198383 +Node: Splitting By Content202945 +Ref: Splitting By Content-Footnote-1206671 +Node: Multiple Line206711 +Ref: Multiple Line-Footnote-1212558 +Node: Getline212737 +Node: Plain Getline214965 +Node: Getline/Variable217054 +Node: Getline/File218195 +Node: Getline/Variable/File219517 +Ref: Getline/Variable/File-Footnote-1221116 +Node: Getline/Pipe221203 +Node: Getline/Variable/Pipe223751 +Node: Getline/Coprocess224858 +Node: Getline/Variable/Coprocess226101 +Node: Getline Notes226815 +Node: Getline Summary228757 +Ref: table-getline-variants229041 +Node: Command line directories229946 +Node: Printing230571 +Node: Print232202 +Node: Print Examples233539 +Node: Output Separators236323 +Node: OFMT238082 +Node: Printf239440 +Node: Basic Printf240346 +Node: Control Letters241883 +Node: Format Modifiers245695 +Node: Printf Examples251706 +Node: Redirection254421 +Node: Special Files261399 +Node: Special FD261932 +Ref: Special FD-Footnote-1265507 +Node: Special Network265581 +Node: Special Caveats266436 +Node: Close Files And Pipes267230 +Ref: Close Files And Pipes-Footnote-1274174 +Ref: Close Files And Pipes-Footnote-2274322 +Node: Expressions274472 +Node: Values275541 +Node: Constants276217 +Node: Scalar Constants276897 +Ref: Scalar Constants-Footnote-1277756 +Node: Nondecimal-numbers277938 +Node: Regexp Constants280997 +Node: Using Constant Regexps281472 +Node: Variables284477 +Node: Using Variables285132 +Node: Assignment Options286859 +Node: Conversion288740 +Ref: table-locale-affects294114 +Ref: Conversion-Footnote-1294738 +Node: All Operators294847 +Node: Arithmetic Ops295477 +Node: Concatenation297976 +Ref: Concatenation-Footnote-1300769 +Node: Assignment Ops300888 +Ref: table-assign-ops305876 +Node: Increment Ops307277 +Node: Truth Values and Conditions310755 +Node: Truth Values311838 +Node: Typing and Comparison312886 +Node: Variable Typing313675 +Ref: Variable Typing-Footnote-1317572 +Node: Comparison Operators317694 +Ref: table-relational-ops318104 +Node: POSIX String Comparison321653 +Ref: POSIX String Comparison-Footnote-1322610 +Node: Boolean Ops322748 +Ref: Boolean Ops-Footnote-1326826 +Node: Conditional Exp326917 +Node: Function Calls328649 +Node: Precedence332239 +Node: Patterns and Actions335892 +Node: Pattern Overview336946 +Node: Regexp Patterns338612 +Node: Expression Patterns339155 +Node: Ranges342729 +Node: BEGIN/END345695 +Node: Using BEGIN/END346445 +Ref: Using BEGIN/END-Footnote-1349176 +Node: I/O And BEGIN/END349290 +Node: Empty351559 +Node: BEGINFILE/ENDFILE351893 +Node: Using Shell Variables354718 +Node: Action Overview356997 +Node: Statements359354 +Node: If Statement361213 +Node: While Statement362712 +Node: Do Statement364756 +Node: For Statement365912 +Node: Switch Statement369064 +Node: Break Statement371161 +Node: Continue Statement373137 +Node: Next Statement374838 +Node: Nextfile Statement377220 +Node: Exit Statement379738 +Node: Built-in Variables382069 +Node: User-modified383164 +Ref: User-modified-Footnote-1391165 +Node: Auto-set391227 +Ref: Auto-set-Footnote-1400210 +Node: ARGC and ARGV400415 +Node: Arrays404174 +Node: Array Basics405745 +Node: Array Intro406456 +Node: Reference to Elements410774 +Node: Assigning Elements413044 +Node: Array Example413535 +Node: Scanning an Array415267 +Node: Delete417544 +Ref: Delete-Footnote-1419967 +Node: Numeric Array Subscripts420024 +Node: Uninitialized Subscripts422207 +Node: Multi-dimensional423835 +Node: Multi-scanning426926 +Node: Array Sorting428510 +Ref: Array Sorting-Footnote-1431708 +Node: Arrays of Arrays431902 +Node: Functions436064 +Node: Built-in436886 +Node: Calling Built-in437900 +Node: Numeric Functions439876 +Ref: Numeric Functions-Footnote-1443633 +Ref: Numeric Functions-Footnote-2443969 +Ref: Numeric Functions-Footnote-3444017 +Node: String Functions444286 +Ref: String Functions-Footnote-1466085 +Ref: String Functions-Footnote-2466214 +Ref: String Functions-Footnote-3466462 +Node: Gory Details466549 +Ref: table-sub-escapes468206 +Ref: table-posix-sub469520 +Ref: table-gensub-escapes470420 +Node: I/O Functions471591 +Ref: I/O Functions-Footnote-1478278 +Node: Time Functions478425 +Ref: Time Functions-Footnote-1489292 +Ref: Time Functions-Footnote-2489360 +Ref: Time Functions-Footnote-3489518 +Ref: Time Functions-Footnote-4489629 +Ref: Time Functions-Footnote-5489741 +Ref: Time Functions-Footnote-6489968 +Node: Bitwise Functions490234 +Ref: table-bitwise-ops490792 +Ref: Bitwise Functions-Footnote-1494952 +Node: I18N Functions495136 +Node: User-defined496766 +Node: Definition Syntax497570 +Ref: Definition Syntax-Footnote-1502200 +Node: Function Example502269 +Node: Function Caveats504863 +Node: Calling A Function505284 +Node: Variable Scope506399 +Node: Pass By Value/Reference508327 +Node: Return Statement511767 +Node: Dynamic Typing514709 +Node: Indirect Calls515446 +Node: Internationalization525131 +Node: I18N and L10N526559 +Node: Explaining gettext527245 +Ref: Explaining gettext-Footnote-1532307 +Ref: Explaining gettext-Footnote-2532490 +Node: Programmer i18n532655 +Node: Translator i18n536946 +Node: String Extraction537739 +Ref: String Extraction-Footnote-1538700 +Node: Printf Ordering538786 +Ref: Printf Ordering-Footnote-1541570 +Node: I18N Portability541634 +Ref: I18N Portability-Footnote-1544083 +Node: I18N Example544146 +Ref: I18N Example-Footnote-1546781 +Node: Gawk I18N546853 +Node: Advanced Features547470 +Node: Nondecimal Data548789 +Node: Two-way I/O550370 +Ref: Two-way I/O-Footnote-1555784 +Node: TCP/IP Networking555861 +Node: Profiling558704 +Node: Library Functions566104 +Ref: Library Functions-Footnote-1569074 +Node: Library Names569245 +Ref: Library Names-Footnote-1572716 +Ref: Library Names-Footnote-2572936 +Node: General Functions573022 +Node: Nextfile Function574085 +Node: Strtonum Function578466 +Node: Assert Function581417 +Node: Round Function584743 +Node: Cliff Random Function586284 +Node: Ordinal Functions587300 +Ref: Ordinal Functions-Footnote-1590370 +Ref: Ordinal Functions-Footnote-2590622 +Node: Join Function590838 +Ref: Join Function-Footnote-1592609 +Node: Gettimeofday Function592809 +Node: Data File Management596524 +Node: Filetrans Function597156 +Node: Rewind Function601393 +Node: File Checking602846 +Node: Empty Files603940 +Node: Ignoring Assigns606170 +Node: Getopt Function607723 +Ref: Getopt Function-Footnote-1619048 +Node: Passwd Functions619251 +Ref: Passwd Functions-Footnote-1628239 +Node: Group Functions628327 +Node: Sample Programs636407 +Node: Running Examples637072 +Node: Clones637800 +Node: Cut Program638923 +Node: Egrep Program648764 +Ref: Egrep Program-Footnote-1656535 +Node: Id Program656645 +Node: Split Program660261 +Ref: Split Program-Footnote-1663780 +Node: Tee Program663908 +Node: Uniq Program666711 +Node: Wc Program674134 +Ref: Wc Program-Footnote-1678398 +Node: Miscellaneous Programs678598 +Node: Dupword Program679718 +Node: Alarm Program681749 +Node: Translate Program686471 +Ref: Translate Program-Footnote-1690850 +Ref: Translate Program-Footnote-2691078 +Node: Labels Program691212 +Ref: Labels Program-Footnote-1694583 +Node: Word Sorting694667 +Node: History Sorting699012 +Node: Extract Program700850 +Ref: Extract Program-Footnote-1708331 +Node: Simple Sed708459 +Node: Igawk Program711521 +Ref: Igawk Program-Footnote-1726555 +Ref: Igawk Program-Footnote-2726756 +Node: Signature Program726894 +Node: Debugger727974 +Node: Debugging728885 +Node: Debugging Concepts729199 +Node: Debugging Terms731055 +Node: Awk Debugging733600 +Node: Sample dgawk session734492 +Node: dgawk invocation734984 +Node: Finding The Bug736166 +Node: List of Debugger Commands742650 +Node: Breakpoint Control743961 +Node: Dgawk Execution Control747437 +Node: Viewing And Changing Data750788 +Node: Dgawk Stack754097 +Node: Dgawk Info755557 +Node: Miscellaneous Dgawk Commands759505 +Node: Readline Support764933 +Node: Dgawk Limitations765760 +Node: Language History767899 +Node: V7/SVR3.1769272 +Node: SVR4771567 +Node: POSIX773012 +Node: BTL775267 +Node: POSIX/GNU776659 +Node: Contributors781776 +Node: Installation785721 +Node: Gawk Distribution786615 +Node: Getting787099 +Node: Extracting787925 +Node: Distribution contents789603 +Node: Unix Installation794621 +Node: Quick Installation795238 +Node: Additional Configuration Options797200 +Node: Configuration Philosophy798677 +Node: Non-Unix Installation801019 +Node: PC Installation801477 +Node: PC Binary Installation802776 +Node: PC Compiling804624 +Node: PC Testing808030 +Node: PC Using808854 +Node: Cygwin813031 +Node: MSYS814028 +Node: VMS Installation814542 +Node: VMS Compilation815146 +Node: VMS Installation Details816723 +Node: VMS Running818353 +Node: VMS POSIX819950 +Node: VMS Old Gawk821248 +Node: Bugs821720 +Node: Other Versions825585 +Node: Notes831033 +Node: Compatibility Mode831725 +Node: Additions832508 +Node: Accessing The Source833320 +Node: Adding Code834743 +Node: New Ports840291 +Node: Dynamic Extensions844404 +Node: Internals845780 +Node: Plugin License854899 +Node: Sample Library855533 +Node: Internal File Description856219 +Node: Internal File Ops859926 +Ref: Internal File Ops-Footnote-1864810 +Node: Using Internal File Ops864958 +Node: Future Extensions866983 +Node: Basic Concepts869820 +Node: Basic High Level870577 +Ref: Basic High Level-Footnote-1874696 +Node: Basic Data Typing874890 +Node: Floating Point Issues879327 +Node: String Conversion Precision880410 +Ref: String Conversion Precision-Footnote-1882104 +Node: Unexpected Results882213 +Node: POSIX Floating Point Problems884039 +Ref: POSIX Floating Point Problems-Footnote-1887738 +Node: Glossary887776 +Node: Copying911411 +Node: GNU Free Documentation License948968 +Node: next-edition974112 +Node: unresolved974464 +Node: revision974964 +Node: consistency975387 +Node: Index978740 End Tag Table diff --git a/doc/gawk.texi b/doc/gawk.texi index a6d1703f..86a422fb 100644 --- a/doc/gawk.texi +++ b/doc/gawk.texi @@ -2,9 +2,6 @@ @ignore TODO: Document common extensions with COMMONEXT marking & index entry. - Pick a reasonable name for BWK awk and use it everywhere (search - for Bell Laboratories) - Fix refs to other info docs to use @inforef. DONE: Globally add () after built in function names. Globally add () after awk function names. @@ -13,6 +10,9 @@ DONE: MS-Windows vs MS Windows Review use of "Modern xxx systems..." Go through CAUTION, NOTE, @strong, @quotation, etc. + Fix refs to other info docs to use @inforef. + Pick a reasonable name for BWK awk and use it everywhere (search + for Bell Laboratories) @end ignore @c %**start of header (This is for running Texinfo on a region.) @setfilename gawk.info @@ -645,7 +645,7 @@ particular records in a file and perform operations upon them. * SVR4:: Minor changes between System V Releases 3.1 and 4. * POSIX:: New features from the POSIX standard. -* BTL:: New features from the Bell Laboratories +* BTL:: New features from Brian Kernighan's version of @command{awk}. * POSIX/GNU:: The extensions in @command{gawk} not in POSIX @command{awk}. @@ -986,7 +986,7 @@ In 1985, a new version made the programming language more powerful, introducing user-defined functions, multiple input streams, and computed regular expressions. This new version became widely available with Unix System V -Release 3.1 (1987) +Release 3.1 (1987). The version in System V Release 4 (1989) added some new features and cleaned up the behavior in some of the ``dark corners'' of the language. The specification for @command{awk} in the POSIX Command Language @@ -1597,7 +1597,7 @@ contributed to the effort to bring the byte-code changes into the mainstream code base. @cindex Kernighan, Brian -I would like to thank Brian Kernighan of Bell Laboratories for +I would like to thank Brian Kernighan for invaluable assistance during the testing and debugging of @command{gawk}, and for ongoing help in clarifying numerous points about the language. We could not have @@ -3012,21 +3012,6 @@ values of those variables as it needs to, possibly ignoring any predefined value you may have given. @end quotation -@ignore -@item -mf @var{N} -@itemx -mr @var{N} -@cindex @code{-mf}/@code{-mr} options -@cindex memory, setting limits -Set various memory limits to the value @var{N}. The @samp{f} flag sets -the maximum number of fields and the @samp{r} flag sets the maximum -record size. These two flags and the @option{-m} option are from the -Bell Laboratories research version of Unix @command{awk}. They are provided -for compatibility but otherwise ignored by -@command{gawk}, since @command{gawk} has no predefined limits. -(The Bell Laboratories @command{awk} no longer needs these options; -it continues to accept them to avoid breaking old programs.) -@end ignore - @item -W @var{gawk-opt} @cindex @code{-W} option Provide an implementation-specific option. @@ -3078,7 +3063,7 @@ multibyte characters. This option is an easy way to tell @command{gawk}: @cindex compatibility mode (@command{gawk}), specifying Specify @dfn{compatibility mode}, in which the GNU extensions to the @command{awk} language are disabled, so that @command{gawk} behaves just -like the Bell Laboratories research version of Unix @command{awk}. +like Brian Kernighan's version @command{awk}. @xref{POSIX/GNU}, which summarizes the extensions. Also see @ref{Compatibility Mode}. @@ -4822,8 +4807,7 @@ are allowed. Traditional Unix @command{awk} regexps are matched. The GNU operators are not special, and interval expressions are not available. The POSIX character classes (@code{[[:alnum:]]}, etc.) are supported, -@c Bell Labs - name -as modern Unix @command{awk} does support them. +as Brian Kernighan's @command{awk} does support them. Characters described by octal and hexadecimal escape sequences are treated literally, even if they represent regexp metacharacters. @@ -6025,7 +6009,7 @@ different @command{awk} versions answer this question differently, and you should not rely on any specific behavior in your programs. @value{DARKCORNER} -As a point of information, the Bell Labs @command{awk} allows @samp{^} +As a point of information, the Brian Kernighan's @command{awk} allows @samp{^} to match only at the beginning of the record. @command{gawk} also works this way. For example: @@ -12150,7 +12134,7 @@ statement. @cindex functions, user-defined, @code{next}/@code{nextfile} statements and @cindex @code{nextfile} statement, user-defined functions and -The current version of the Bell Laboratories @command{awk} (@pxref{Other +The current version of the Brian Kernighan's @command{awk} (@pxref{Other Versions}) also supports @code{nextfile}. However, it doesn't allow the @code{nextfile} statement inside function bodies (@pxref{User-defined}). @command{gawk} does; a @code{nextfile} inside a function body reads the @@ -15320,7 +15304,7 @@ This is the purpose of the @code{fflush()} function---@command{gawk} also buffers its output and the @code{fflush()} function forces @command{gawk} to flush its buffers. -@code{fflush()} was added to the Bell Laboratories research +@code{fflush()} was added to Brian Kernighan's version of @command{awk} in 1994; it is not part of the POSIX standard and is not available if @option{--posix} has been specified on the command line (@pxref{Options}). @@ -15331,9 +15315,8 @@ is to allow no argument at all. In this case, the buffer for the standard output is flushed. The second is to allow the null string (@w{@code{""}}) as the argument. In this case, the buffers for @emph{all} open output files and pipes are flushed. -Current versions of the Bell Labs @command{awk} also +Current versions of the Brian Kernighan's @command{awk} also support these extensions. -@c As of 2002, but I didn't know about it until 4/2009! @c @cindex automatic warnings @c @cindex warnings, automatic @@ -17976,18 +17959,16 @@ $ @kbd{gawk --posix -f guide.awk -f libintl.awk} @command{gawk} itself has been internationalized using the GNU @code{gettext} package. -@ifinfo (GNU @code{gettext} is described in complete detail in -@ref{Top}.) +@ifinfo +@inforef{Top, , GNU @code{gettext} utilities, gettext, GNU gettext tools}.) @end ifinfo @ifnotinfo -(GNU @code{gettext} is described in -complete detail in @cite{GNU gettext tools}.) @end ifnotinfo As of this writing, the latest version of GNU @code{gettext} is -@uref{ftp://ftp.gnu.org/gnu/gettext/gettext-0.18.1.1.tar.gz, @value{PVERSION} 0.18.1.1}. +@uref{ftp://ftp.gnu.org/gnu/gettext/gettext-0.18.1.tar.gz, @value{PVERSION} 0.18.1}. If a translation of @command{gawk}'s messages exists, then @command{gawk} produces usage messages, warnings, @@ -18366,7 +18347,8 @@ It then prints the results and closes the connection. Because this topic is extensive, the use of @command{gawk} for TCP/IP programming is documented separately. @ifinfo -@xref{Top}, +See +@inforef{Top, , General Introduction, gawkinet, TCP/IP Internetworking with @command{gawk}}, @end ifinfo @ifnotinfo See @cite{TCP/IP Internetworking with @command{gawk}}, @@ -23525,7 +23507,7 @@ available from the Free Software Foundation. @end ifnotinfo @ifinfo The Texinfo language is described fully, starting with -@ref{Top}. +@inforef{Top, , Texinfo, texinfo,Texinfo---The GNU Documentation Format}. @end ifinfo For our purposes, it is enough to know three things about Texinfo input @@ -25706,7 +25688,7 @@ of the @value{DOCUMENT} where you can find more information. * SVR4:: Minor changes between System V Releases 3.1 and 4. * POSIX:: New features from the POSIX standard. -* BTL:: New features from the Bell Laboratories +* BTL:: New features from Brian Kernighan's version of @command{awk}. * POSIX/GNU:: The extensions in @command{gawk} not in POSIX @command{awk}. @@ -25964,11 +25946,11 @@ The 2008 POSIX standard can be found online at @c ENDOFRANGE gawkv @node BTL -@appendixsec Extensions in the Bell Laboratories @command{awk} +@appendixsec Extensions in Brian Kernighan's @command{awk} -@cindex @command{awk}, versions of, See Also Bell Laboratories @command{awk} -@cindex extensions, Bell Laboratories @command{awk} -@cindex Bell Laboratories @command{awk} extensions +@cindex @command{awk}, versions of, See Also Brian Kernighan's @command{awk} +@cindex extensions, Brian Kernighan's @command{awk} +@cindex Brian Kernighan's @command{awk}, extensions @cindex Kernighan, Brian Brian Kernighan, one of the original designers of Unix @command{awk}, has made his version available via his home page @@ -25977,16 +25959,6 @@ This @value{SECTION} describes extensions in his version of @command{awk} that a not in POSIX @command{awk}: @itemize @bullet -@ignore -@item -The @samp{-mf @var{N}} and @samp{-mr @var{N}} command-line options -to set the maximum number of fields and the maximum -record size, respectively -(@pxref{Options}). -As a side note, his @command{awk} no longer needs these options; -it continues to accept them to avoid breaking old programs. -@end ignore - @item The @code{fflush()} built-in function for flushing buffered output (@pxref{I/O Functions}). @@ -26010,7 +25982,7 @@ or array elements through it. @end ignore @end itemize -The Bell Laboratories @command{awk} also incorporates the following extensions, +Brian Kernighan's @command{awk} also incorporates the following extensions, originally developed for @command{gawk}: @itemize @bullet @@ -26221,8 +26193,8 @@ new functions dynamically (@pxref{Dynamic Extensions}). @item -The @code{fflush()} function from the -Bell Laboratories research version of @command{awk} +The @code{fflush()} function from Brian Kernighan's +version of @command{awk} (@pxref{I/O Functions}). @item @@ -26681,6 +26653,9 @@ incorrect as well as how @command{gawk} handles the problem. A short article describing why @command{gawk} is a good language for AI (Artificial Intelligence) programming. +@item doc/bc_notes +A brief description of @command{gawk}'s ``byte code'' internals. + @item doc/README.card @itemx doc/ad.block @itemx doc/awkcard.in @@ -26712,7 +26687,7 @@ The generated Info file for this @value{DOCUMENT}. @item doc/gawkinet.texi The Texinfo source file for @ifinfo -@xref{Top}. +@inforef{Top, , General Introduction, gawkinet, TCP/IP Internetworking with @command{gawk}}. @end ifinfo @ifnotinfo @cite{TCP/IP Internetworking with @command{gawk}}. @@ -26831,7 +26806,7 @@ the Free Software Foundation's web site}.) @end ifnotinfo @ifinfo (The @command{autoconf} software is described fully starting with -@ref{Top}.) +@inforef{Top, , Autoconf, autoconf,Autoconf---Generating Automatic Configuration Scripts}.) @end ifinfo To configure @command{gawk}, simply run @command{configure}: @@ -27714,13 +27689,6 @@ called @command{mawk}. It is available under the GPL (@pxref{Copying}), just as @command{gawk} is. -@ignore -You can get it via anonymous @command{ftp} to the host -@code{@w{ftp.whidbey.net}}. Change directory to @file{/pub/brennan}. -Use ``binary'' or ``image'' mode, and retrieve @file{mawk1.3.3.tar.gz} -(or the latest version that is there). -@end ignore - The original distribution site for the @command{mawk} source code no longer has it. A copy has been made available at @uref{http://www.skeeve.com/gawk/mawk1.3.3.tar.gz}. @@ -27801,6 +27769,7 @@ is under the LGPL. To get @command{awka}, go to @url{http://sourceforge.net/projects/awka}. @c You can reach Andrew Sumner at @email{andrew@@zbcom.net}. +@c andrewsumner@@yahoo.net The project seems to be frozen; no new code changes have been made since approximately 2003. |