summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorArnold D. Robbins <arnold@skeeve.com>2012-05-09 20:08:15 +0300
committerArnold D. Robbins <arnold@skeeve.com>2012-05-09 20:08:15 +0300
commit8ff0b4eaa7592280b5a55087c0326c6ef1f88db5 (patch)
treeeae689a948e50dbf462b7e0d0c3d225409f6c7b0 /doc
parent17a2a7c14dc27248d87f2561a1ec311ad4972355 (diff)
parentfe0a0998411173db5cab614253562b2efd6f9664 (diff)
downloadgawk-8ff0b4eaa7592280b5a55087c0326c6ef1f88db5.tar.gz
Merge branch 'gawk-4.0-stable'
Diffstat (limited to 'doc')
-rw-r--r--doc/ChangeLog4
-rw-r--r--doc/gawk.info955
-rw-r--r--doc/gawk.texi3
3 files changed, 486 insertions, 476 deletions
diff --git a/doc/ChangeLog b/doc/ChangeLog
index 7ea0c491..240ca756 100644
--- a/doc/ChangeLog
+++ b/doc/ChangeLog
@@ -1,5 +1,9 @@
2012-04-27 Arnold D. Robbins <arnold@skeeve.com>
+ * gawk.texi: Add that -b affects output.
+
+2012-04-27 Arnold D. Robbins <arnold@skeeve.com>
+
* texinfo.tex: Update to latest from automake 1.12.
2012-04-09 Arnold D. Robbins <arnold@skeeve.com>
diff --git a/doc/gawk.info b/doc/gawk.info
index bf279828..daae67b4 100644
--- a/doc/gawk.info
+++ b/doc/gawk.info
@@ -2203,6 +2203,9 @@ The following list describes options mandated by the POSIX standard:
`-b'
`--characters-as-bytes'
Cause `gawk' to treat all input data as single-byte characters.
+ In addition, all output written with `print' or `printf' are
+ treated as single-byte characters.
+
Normally, `gawk' follows the POSIX standard and attempts to process
its input data according to the current locale. This can often
involve converting multibyte characters into wide characters
@@ -25671,78 +25674,78 @@ Index
* - (hyphen), filenames beginning with: Options. (line 59)
* - (hyphen), in bracket expressions: Bracket Expressions. (line 17)
* --assign option: Options. (line 32)
-* --bignum option: Options. (line 182)
-* --c option: Options. (line 78)
+* --bignum option: Options. (line 185)
+* --c option: Options. (line 81)
* --characters-as-bytes option: Options. (line 68)
-* --copyright option: Options. (line 85)
-* --debug option: Options. (line 105)
+* --copyright option: Options. (line 88)
+* --debug option: Options. (line 108)
* --disable-lint configuration option: Additional Configuration Options.
(line 9)
* --disable-nls configuration option: Additional Configuration Options.
(line 24)
* --dump-variables option <1>: Library Names. (line 45)
-* --dump-variables option: Options. (line 90)
-* --exec option: Options. (line 122)
+* --dump-variables option: Options. (line 93)
+* --exec option: Options. (line 125)
* --field-separator option: Options. (line 21)
* --file option: Options. (line 25)
* --gen-pot option <1>: String Extraction. (line 6)
-* --gen-pot option: Options. (line 144)
-* --help option: Options. (line 151)
-* --L option: Options. (line 269)
-* --lint option <1>: Options. (line 163)
+* --gen-pot option: Options. (line 147)
+* --help option: Options. (line 154)
+* --L option: Options. (line 272)
+* --lint option <1>: Options. (line 166)
* --lint option: Command Line. (line 20)
-* --lint-old option: Options. (line 269)
-* --load option: Options. (line 156)
+* --lint-old option: Options. (line 272)
+* --load option: Options. (line 159)
* --non-decimal-data option <1>: Nondecimal Data. (line 6)
-* --non-decimal-data option: Options. (line 188)
+* --non-decimal-data option: Options. (line 191)
* --non-decimal-data option, strtonum() function and: Nondecimal Data.
(line 36)
-* --optimize option: Options. (line 209)
-* --posix option: Options. (line 228)
-* --posix option, --traditional option and: Options. (line 247)
-* --pretty-print option: Options. (line 201)
+* --optimize option: Options. (line 212)
+* --posix option: Options. (line 231)
+* --posix option, --traditional option and: Options. (line 250)
+* --pretty-print option: Options. (line 204)
* --profile option <1>: Profiling. (line 12)
-* --profile option: Options. (line 216)
-* --re-interval option: Options. (line 253)
-* --sandbox option: Options. (line 260)
+* --profile option: Options. (line 219)
+* --re-interval option: Options. (line 256)
+* --sandbox option: Options. (line 263)
* --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 114)
-* --traditional option: Options. (line 78)
-* --traditional option, --posix option and: Options. (line 247)
-* --use-lc-numeric option: Options. (line 196)
-* --version option: Options. (line 274)
+* --source option: Options. (line 117)
+* --traditional option: Options. (line 81)
+* --traditional option, --posix option and: Options. (line 250)
+* --use-lc-numeric option: Options. (line 199)
+* --version option: Options. (line 277)
* --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 105)
-* -d option: Options. (line 90)
-* -E option: Options. (line 122)
-* -e option: Options. (line 114)
+* -C option: Options. (line 88)
+* -D option: Options. (line 108)
+* -d option: Options. (line 93)
+* -E option: Options. (line 125)
+* -e option: Options. (line 117)
* -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 282)
-* -f option, on command line: Options. (line 287)
-* -g option: Options. (line 144)
-* -h option: Options. (line 151)
-* -l option: Options. (line 156)
-* -M option: Options. (line 182)
-* -N option: Options. (line 196)
-* -n option: Options. (line 188)
-* -O option: Options. (line 209)
-* -o option: Options. (line 201)
-* -P option: Options. (line 228)
-* -p option: Options. (line 216)
-* -r option: Options. (line 253)
-* -S option: Options. (line 260)
-* -V option: Options. (line 274)
+* -F option, -Ft sets FS to TAB: Options. (line 285)
+* -f option, on command line: Options. (line 290)
+* -g option: Options. (line 147)
+* -h option: Options. (line 154)
+* -l option: Options. (line 159)
+* -M option: Options. (line 185)
+* -N option: Options. (line 199)
+* -n option: Options. (line 191)
+* -O option: Options. (line 212)
+* -o option: Options. (line 204)
+* -P option: Options. (line 231)
+* -p option: Options. (line 219)
+* -r option: Options. (line 256)
+* -S option: Options. (line 263)
+* -V option: Options. (line 277)
* -v option: Options. (line 32)
* -v option, variables, assigning: Assignment Options. (line 12)
* -W option: Options. (line 46)
@@ -26000,10 +26003,10 @@ Index
* asterisk (*), *= operator: Assignment Ops. (line 129)
* atan2() function: Numeric Functions. (line 11)
* awf (amazingly workable formatter) program: Glossary. (line 25)
-* awk debugging, enabling: Options. (line 105)
-* awk enabling: Options. (line 201)
+* awk debugging, enabling: Options. (line 108)
+* awk enabling: Options. (line 204)
* awk language, POSIX version: Assignment Ops. (line 136)
-* awk profiling, enabling: Options. (line 216)
+* awk profiling, enabling: Options. (line 219)
* awk programs <1>: Two Rules. (line 6)
* awk programs <2>: Executable Scripts. (line 6)
* awk programs: Getting Started. (line 12)
@@ -26060,7 +26063,7 @@ Index
* AWKPATH environment variable: AWKPATH Variable. (line 6)
* awkprof.out file: Profiling. (line 6)
* awksed.awk program: Simple Sed. (line 25)
-* awkvars.out file: Options. (line 90)
+* awkvars.out file: Options. (line 93)
* b debugger command (alias for break): Breakpoint Control. (line 11)
* backslash (\) <1>: Regexp Operators. (line 18)
* backslash (\) <2>: Quoting. (line 31)
@@ -26227,7 +26230,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 122)
+* CGI, awk scripts for: Options. (line 125)
* 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.
@@ -26313,7 +26316,7 @@ Index
(line 60)
* compatibility mode (gawk), octal numbers: Nondecimal-numbers.
(line 60)
-* compatibility mode (gawk), specifying: Options. (line 78)
+* compatibility mode (gawk), specifying: Options. (line 81)
* compiled programs <1>: Glossary. (line 161)
* compiled programs: Basic High Level. (line 14)
* compiling gawk for Cygwin: Cygwin. (line 6)
@@ -26362,7 +26365,7 @@ Index
* cos() function: Numeric Functions. (line 15)
* counting: Wc Program. (line 6)
* csh utility: Statements/Lines. (line 44)
-* csh utility, POSIXLY_CORRECT environment variable: Options. (line 329)
+* csh utility, POSIXLY_CORRECT environment variable: Options. (line 332)
* 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)
@@ -26531,7 +26534,7 @@ Index
(line 67)
* debugging awk programs: Debugger. (line 6)
* debugging gawk, bug reports: Bugs. (line 9)
-* decimal point character, locale specific: Options. (line 244)
+* decimal point character, locale specific: Options. (line 247)
* decrement operators: Increment Ops. (line 35)
* default keyword: Switch Statement. (line 6)
* Deifik, Scott <1>: Bugs. (line 70)
@@ -26826,7 +26829,7 @@ Index
* files, as single records: Records. (line 196)
* files, awk programs in: Long. (line 6)
* files, awkprof.out: Profiling. (line 6)
-* files, awkvars.out: Options. (line 90)
+* files, awkvars.out: Options. (line 93)
* files, closing: I/O Functions. (line 10)
* files, descriptors, See file descriptors: Special FD. (line 6)
* files, group: Group Functions. (line 6)
@@ -26854,7 +26857,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 144)
+* files, portable object, generating: Options. (line 147)
* files, processing, ARGIND variable and: Auto-set. (line 47)
* files, reading: Rewind Function. (line 6)
* files, reading, multiline records: Multiple Line. (line 6)
@@ -26912,7 +26915,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 240)
+* FS variable, as TAB character: Options. (line 243)
* 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.
@@ -26998,7 +27001,7 @@ Index
(line 139)
* gawk, ERRNO variable in: Getline. (line 19)
* gawk, escape sequences: Escape Sequences. (line 125)
-* gawk, extensions, disabling: Options. (line 228)
+* gawk, extensions, disabling: Options. (line 231)
* gawk, features, adding: Adding Code. (line 6)
* gawk, features, advanced: Advanced Features. (line 6)
* gawk, fflush() function in: I/O Functions. (line 44)
@@ -27063,7 +27066,7 @@ Index
* gawk, TEXTDOMAIN variable in: User-modified. (line 162)
* gawk, timestamps: Time Functions. (line 6)
* gawk, uses for: Preface. (line 36)
-* gawk, versions of, information about, printing: Options. (line 274)
+* gawk, versions of, information about, printing: Options. (line 277)
* gawk, VMS version of: VMS Installation. (line 6)
* gawk, word-boundary operator: GNU Regexp Operators.
(line 63)
@@ -27125,7 +27128,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 151)
+* GNU long options, printing list of: Options. (line 154)
* GNU Project <1>: Glossary. (line 319)
* GNU Project: Manual History. (line 11)
* GNU/Linux <1>: Glossary. (line 611)
@@ -27133,7 +27136,7 @@ Index
* GNU/Linux: Manual History. (line 28)
* GPL (General Public License) <1>: Glossary. (line 310)
* GPL (General Public License): Manual History. (line 11)
-* GPL (General Public License), printing: Options. (line 85)
+* GPL (General Public License), printing: Options. (line 88)
* grcat program: Group Functions. (line 16)
* Grigera, Juan: Contributors. (line 58)
* group database, reading: Group Functions. (line 6)
@@ -27156,7 +27159,7 @@ Index
* help debugger command: Miscellaneous Debugger Commands.
(line 68)
* hexadecimal numbers: Nondecimal-numbers. (line 6)
-* hexadecimal values, enabling interpretation of: Options. (line 188)
+* hexadecimal values, enabling interpretation of: Options. (line 191)
* histsort.awk program: History Sorting. (line 25)
* Hughes, Phil: Acknowledgments. (line 43)
* HUP signal: Profiling. (line 203)
@@ -27385,9 +27388,9 @@ Index
* lint checking, array subscripts: Uninitialized Subscripts.
(line 43)
* lint checking, empty programs: Command Line. (line 16)
-* lint checking, issuing warnings: Options. (line 163)
+* lint checking, issuing warnings: Options. (line 166)
* lint checking, POSIXLY_CORRECT environment variable: Options.
- (line 313)
+ (line 316)
* lint checking, undefined functions: Pass By Value/Reference.
(line 88)
* LINT variable: User-modified. (line 98)
@@ -27397,10 +27400,10 @@ Index
* list debugger command: Miscellaneous Debugger Commands.
(line 74)
* loading extension: Loading Extensions. (line 6)
-* loading, library: Options. (line 156)
+* loading, library: Options. (line 159)
* local variables: Variable Scope. (line 6)
* locale categories: Explaining gettext. (line 80)
-* locale decimal point character: Options. (line 244)
+* locale decimal point character: Options. (line 247)
* locale, definition of: Locales. (line 6)
* localization: I18N and L10N. (line 6)
* localization, See internationalization, localization: I18N and L10N.
@@ -27472,7 +27475,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 234)
+* newlines <2>: Options. (line 237)
* newlines: Statements/Lines. (line 6)
* newlines, as field separators: Default Field Splitting.
(line 6)
@@ -27552,7 +27555,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 188)
+* octal values, enabling interpretation of: Options. (line 191)
* OFMT variable <1>: User-modified. (line 115)
* OFMT variable <2>: Conversion. (line 55)
* OFMT variable: OFMT. (line 15)
@@ -27605,7 +27608,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 151)
+* options, printing list of: Options. (line 154)
* OR bitwise operation: Bitwise Functions. (line 6)
* or Boolean-logic operator: Boolean Ops. (line 6)
* or() function (gawk): Bitwise Functions. (line 48)
@@ -27697,13 +27700,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 334)
+* portability, POSIXLY_CORRECT environment variable: Options. (line 337)
* 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 144)
+* portable object files, generating: Options. (line 147)
* portable object template files: Explaining gettext. (line 30)
* porting gawk: New Ports. (line 6)
* positional specifiers, printf statement <1>: Printf Ordering.
@@ -27747,11 +27750,11 @@ Index
* POSIX awk, regular expressions and: Regexp Operators. (line 161)
* POSIX awk, timestamps and: Time Functions. (line 6)
* POSIX awk, | I/O operator and: Getline/Pipe. (line 52)
-* POSIX mode: Options. (line 228)
+* POSIX mode: Options. (line 231)
* POSIX, awk and: Preface. (line 23)
* POSIX, gawk extensions not included in: POSIX/GNU. (line 6)
* POSIX, programs, implementing in awk: Clones. (line 6)
-* POSIXLY_CORRECT environment variable: Options. (line 313)
+* POSIXLY_CORRECT environment variable: Options. (line 316)
* PREC variable <1>: Setting Precision. (line 6)
* PREC variable: User-modified. (line 134)
* precedence <1>: Precedence. (line 6)
@@ -27787,7 +27790,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 151)
+* printing, list of options: Options. (line 154)
* printing, mailing labels: Labels Program. (line 6)
* printing, unduplicated lines of text: Uniq Program. (line 6)
* printing, user information: Id Program. (line 6)
@@ -27910,7 +27913,7 @@ Index
(line 59)
* regular expressions, gawk, command-line options: GNU Regexp Operators.
(line 70)
-* regular expressions, interval expressions and: Options. (line 253)
+* regular expressions, interval expressions and: Options. (line 256)
* regular expressions, leftmost longest match: Leftmost Longest.
(line 6)
* regular expressions, operators <1>: Regexp Operators. (line 6)
@@ -27988,7 +27991,7 @@ Index
* rvalues/lvalues: Assignment Ops. (line 32)
* s debugger command (alias for step): Debugger Execution Control.
(line 68)
-* sandbox mode: Options. (line 260)
+* sandbox mode: Options. (line 263)
* scalar values: Basic Data Typing. (line 13)
* Schorr, Andrew: Acknowledgments. (line 60)
* Schreiber, Bert: Acknowledgments. (line 38)
@@ -28084,7 +28087,7 @@ Index
* source code, jawk: Other Versions. (line 97)
* source code, libmawk: Other Versions. (line 105)
* source code, mawk: Other Versions. (line 35)
-* source code, mixing: Options. (line 114)
+* source code, mixing: Options. (line 117)
* source code, pawk: Other Versions. (line 69)
* source code, QSE Awk: Other Versions. (line 109)
* source code, QuikTrim Awk: Other Versions. (line 113)
@@ -28224,7 +28227,7 @@ Index
* trace debugger command: Miscellaneous Debugger Commands.
(line 110)
* translate.awk program: Translate Program. (line 55)
-* troubleshooting, --non-decimal-data option: Options. (line 188)
+* troubleshooting, --non-decimal-data option: Options. (line 191)
* troubleshooting, == operator: Comparison Operators.
(line 37)
* troubleshooting, awk uses FS not IFS: Field Separators. (line 29)
@@ -28256,7 +28259,7 @@ Index
* troubleshooting, substr() function: String Functions. (line 499)
* troubleshooting, system() function: I/O Functions. (line 85)
* troubleshooting, typographical errors, global variables: Options.
- (line 95)
+ (line 98)
* true, logical: Truth Values. (line 6)
* Trueman, David <1>: Contributors. (line 31)
* Trueman, David <2>: Acknowledgments. (line 47)
@@ -28327,7 +28330,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 90)
+* variables, global, printing list of: Options. (line 93)
* variables, initializing: Using Variables. (line 20)
* variables, local: Variable Scope. (line 6)
* variables, names of: Arrays. (line 18)
@@ -28357,7 +28360,7 @@ Index
* Wall, Larry <1>: Future Extensions. (line 6)
* Wall, Larry: Array Intro. (line 6)
* Wallin, Anders: Acknowledgments. (line 60)
-* warnings, issuing: Options. (line 163)
+* warnings, issuing: Options. (line 166)
* watch debugger command: Viewing And Changing Data.
(line 67)
* wc utility: Wc Program. (line 6)
@@ -28369,7 +28372,7 @@ Index
* whitespace, as field separators: Default Field Splitting.
(line 6)
* whitespace, functions, calling: Calling Built-in. (line 10)
-* whitespace, newlines as: Options. (line 234)
+* whitespace, newlines as: Options. (line 237)
* Williams, Kent: Contributors. (line 35)
* Woehlke, Matthew: Contributors. (line 79)
* Woods, John: Contributors. (line 28)
@@ -28465,400 +28468,400 @@ Node: When96426
Node: Invoking Gawk98573
Node: Command Line99958
Node: Options100741
-Ref: Options-Footnote-1115098
-Node: Other Arguments115123
-Node: Naming Standard Input117781
-Node: Environment Variables118875
-Node: AWKPATH Variable119319
-Ref: AWKPATH Variable-Footnote-1121916
-Node: Other Environment Variables122176
-Node: Exit Status124668
-Node: Include Files125343
-Node: Obsolete128828
-Node: Undocumented129514
-Node: Regexp129755
-Node: Regexp Usage131144
-Node: Escape Sequences133170
-Node: Regexp Operators138933
-Ref: Regexp Operators-Footnote-1146313
-Ref: Regexp Operators-Footnote-2146460
-Node: Bracket Expressions146558
-Ref: table-char-classes148448
-Node: GNU Regexp Operators150971
-Node: Case-sensitivity154694
-Ref: Case-sensitivity-Footnote-1157662
-Ref: Case-sensitivity-Footnote-2157897
-Node: Leftmost Longest158005
-Node: Computed Regexps159206
-Node: Reading Files162616
-Node: Records164620
-Ref: Records-Footnote-1173294
-Node: Fields173331
-Ref: Fields-Footnote-1176364
-Node: Nonconstant Fields176450
-Node: Changing Fields178652
-Node: Field Separators184633
-Node: Default Field Splitting187262
-Node: Regexp Field Splitting188379
-Node: Single Character Fields191721
-Node: Command Line Field Separator192780
-Node: Field Splitting Summary196221
-Ref: Field Splitting Summary-Footnote-1199413
-Node: Constant Size199514
-Node: Splitting By Content204098
-Ref: Splitting By Content-Footnote-1207824
-Node: Multiple Line207864
-Ref: Multiple Line-Footnote-1213711
-Node: Getline213890
-Node: Plain Getline216106
-Node: Getline/Variable218195
-Node: Getline/File219336
-Node: Getline/Variable/File220658
-Ref: Getline/Variable/File-Footnote-1222257
-Node: Getline/Pipe222344
-Node: Getline/Variable/Pipe224904
-Node: Getline/Coprocess226011
-Node: Getline/Variable/Coprocess227254
-Node: Getline Notes227968
-Node: Getline Summary229910
-Ref: table-getline-variants230253
-Node: Read Timeout231109
-Ref: Read Timeout-Footnote-1234854
-Node: Command line directories234911
-Node: Printing235541
-Node: Print237172
-Node: Print Examples238509
-Node: Output Separators241293
-Node: OFMT243053
-Node: Printf244411
-Node: Basic Printf245317
-Node: Control Letters246856
-Node: Format Modifiers250668
-Node: Printf Examples256677
-Node: Redirection259392
-Node: Special Files266376
-Node: Special FD266909
-Ref: Special FD-Footnote-1270534
-Node: Special Network270608
-Node: Special Caveats271458
-Node: Close Files And Pipes272254
-Ref: Close Files And Pipes-Footnote-1279277
-Ref: Close Files And Pipes-Footnote-2279425
-Node: Expressions279575
-Node: Values280707
-Node: Constants281383
-Node: Scalar Constants282063
-Ref: Scalar Constants-Footnote-1282922
-Node: Nondecimal-numbers283104
-Node: Regexp Constants286163
-Node: Using Constant Regexps286638
-Node: Variables289693
-Node: Using Variables290348
-Node: Assignment Options292072
-Node: Conversion293944
-Ref: table-locale-affects299320
-Ref: Conversion-Footnote-1299944
-Node: All Operators300053
-Node: Arithmetic Ops300683
-Node: Concatenation303188
-Ref: Concatenation-Footnote-1305981
-Node: Assignment Ops306101
-Ref: table-assign-ops311089
-Node: Increment Ops312497
-Node: Truth Values and Conditions315967
-Node: Truth Values317050
-Node: Typing and Comparison318099
-Node: Variable Typing318888
-Ref: Variable Typing-Footnote-1322785
-Node: Comparison Operators322907
-Ref: table-relational-ops323317
-Node: POSIX String Comparison326866
-Ref: POSIX String Comparison-Footnote-1327822
-Node: Boolean Ops327960
-Ref: Boolean Ops-Footnote-1332038
-Node: Conditional Exp332129
-Node: Function Calls333861
-Node: Precedence337455
-Node: Locales341124
-Node: Patterns and Actions342213
-Node: Pattern Overview343267
-Node: Regexp Patterns344936
-Node: Expression Patterns345479
-Node: Ranges349164
-Node: BEGIN/END352130
-Node: Using BEGIN/END352892
-Ref: Using BEGIN/END-Footnote-1355623
-Node: I/O And BEGIN/END355729
-Node: BEGINFILE/ENDFILE358011
-Node: Empty360904
-Node: Using Shell Variables361220
-Node: Action Overview363505
-Node: Statements365862
-Node: If Statement367716
-Node: While Statement369215
-Node: Do Statement371259
-Node: For Statement372415
-Node: Switch Statement375567
-Node: Break Statement377664
-Node: Continue Statement379654
-Node: Next Statement381447
-Node: Nextfile Statement383837
-Node: Exit Statement386382
-Node: Built-in Variables388798
-Node: User-modified389893
-Ref: User-modified-Footnote-1398248
-Node: Auto-set398310
-Ref: Auto-set-Footnote-1408156
-Node: ARGC and ARGV408361
-Node: Arrays412212
-Node: Array Basics413717
-Node: Array Intro414543
-Node: Reference to Elements418861
-Node: Assigning Elements421131
-Node: Array Example421622
-Node: Scanning an Array423354
-Node: Controlling Scanning425668
-Ref: Controlling Scanning-Footnote-1430601
-Node: Delete430917
-Ref: Delete-Footnote-1433352
-Node: Numeric Array Subscripts433409
-Node: Uninitialized Subscripts435592
-Node: Multi-dimensional437220
-Node: Multi-scanning440314
-Node: Arrays of Arrays441905
-Node: Functions446550
-Node: Built-in447372
-Node: Calling Built-in448450
-Node: Numeric Functions450438
-Ref: Numeric Functions-Footnote-1454270
-Ref: Numeric Functions-Footnote-2454627
-Ref: Numeric Functions-Footnote-3454675
-Node: String Functions454944
-Ref: String Functions-Footnote-1478441
-Ref: String Functions-Footnote-2478570
-Ref: String Functions-Footnote-3478818
-Node: Gory Details478905
-Ref: table-sub-escapes480584
-Ref: table-sub-posix-92481938
-Ref: table-sub-proposed483281
-Ref: table-posix-sub484631
-Ref: table-gensub-escapes486177
-Ref: Gory Details-Footnote-1487384
-Ref: Gory Details-Footnote-2487435
-Node: I/O Functions487586
-Ref: I/O Functions-Footnote-1494241
-Node: Time Functions494388
-Ref: Time Functions-Footnote-1505280
-Ref: Time Functions-Footnote-2505348
-Ref: Time Functions-Footnote-3505506
-Ref: Time Functions-Footnote-4505617
-Ref: Time Functions-Footnote-5505729
-Ref: Time Functions-Footnote-6505956
-Node: Bitwise Functions506222
-Ref: table-bitwise-ops506780
-Ref: Bitwise Functions-Footnote-1510940
-Node: Type Functions511124
-Node: I18N Functions511594
-Node: User-defined513221
-Node: Definition Syntax514025
-Ref: Definition Syntax-Footnote-1518935
-Node: Function Example519004
-Node: Function Caveats521598
-Node: Calling A Function522019
-Node: Variable Scope523134
-Node: Pass By Value/Reference525109
-Node: Return Statement528549
-Node: Dynamic Typing531530
-Node: Indirect Calls532265
-Node: Internationalization541950
-Node: I18N and L10N543389
-Node: Explaining gettext544075
-Ref: Explaining gettext-Footnote-1549141
-Ref: Explaining gettext-Footnote-2549325
-Node: Programmer i18n549490
-Node: Translator i18n553690
-Node: String Extraction554483
-Ref: String Extraction-Footnote-1555444
-Node: Printf Ordering555530
-Ref: Printf Ordering-Footnote-1558314
-Node: I18N Portability558378
-Ref: I18N Portability-Footnote-1560827
-Node: I18N Example560890
-Ref: I18N Example-Footnote-1563525
-Node: Gawk I18N563597
-Node: Arbitrary Precision Arithmetic564214
-Ref: Arbitrary Precision Arithmetic-Footnote-1567089
-Node: Floating-point Programming567237
-Node: Floating-point Representation572507
-Node: Floating-point Context573611
-Ref: table-ieee-formats574446
-Node: Rounding Mode575816
-Ref: table-rounding-modes576443
-Ref: Rounding Mode-Footnote-1579566
-Node: Arbitrary Precision Floats579747
-Ref: Arbitrary Precision Floats-Footnote-1581788
-Node: Setting Precision582099
-Node: Setting Rounding Mode584857
-Node: Floating-point Constants585774
-Node: Changing Precision587193
-Ref: Changing Precision-Footnote-1588593
-Node: Exact Arithmetic588766
-Node: Integer Programming591779
-Node: Arbitrary Precision Integers593559
-Ref: Arbitrary Precision Integers-Footnote-1596583
-Node: MPFR and GMP Libraries596729
-Node: Advanced Features597114
-Node: Nondecimal Data598637
-Node: Array Sorting600220
-Node: Controlling Array Traversal600917
-Node: Array Sorting Functions609154
-Ref: Array Sorting Functions-Footnote-1612828
-Ref: Array Sorting Functions-Footnote-2612921
-Node: Two-way I/O613115
-Ref: Two-way I/O-Footnote-1618547
-Node: TCP/IP Networking618617
-Node: Profiling621461
-Node: Library Functions628915
-Ref: Library Functions-Footnote-1631922
-Node: Library Names632093
-Ref: Library Names-Footnote-1635564
-Ref: Library Names-Footnote-2635784
-Node: General Functions635870
-Node: Strtonum Function636823
-Node: Assert Function639753
-Node: Round Function643079
-Node: Cliff Random Function644622
-Node: Ordinal Functions645638
-Ref: Ordinal Functions-Footnote-1648708
-Ref: Ordinal Functions-Footnote-2648960
-Node: Join Function649169
-Ref: Join Function-Footnote-1650940
-Node: Gettimeofday Function651140
-Node: Data File Management654855
-Node: Filetrans Function655487
-Node: Rewind Function659626
-Node: File Checking661013
-Node: Empty Files662107
-Node: Ignoring Assigns664337
-Node: Getopt Function665890
-Ref: Getopt Function-Footnote-1677194
-Node: Passwd Functions677397
-Ref: Passwd Functions-Footnote-1686372
-Node: Group Functions686460
-Node: Walking Arrays694544
-Node: Sample Programs696113
-Node: Running Examples696778
-Node: Clones697506
-Node: Cut Program698730
-Node: Egrep Program708575
-Ref: Egrep Program-Footnote-1716348
-Node: Id Program716458
-Node: Split Program720074
-Ref: Split Program-Footnote-1723593
-Node: Tee Program723721
-Node: Uniq Program726524
-Node: Wc Program733953
-Ref: Wc Program-Footnote-1738219
-Ref: Wc Program-Footnote-2738419
-Node: Miscellaneous Programs738511
-Node: Dupword Program739699
-Node: Alarm Program741730
-Node: Translate Program746479
-Ref: Translate Program-Footnote-1750866
-Ref: Translate Program-Footnote-2751094
-Node: Labels Program751228
-Ref: Labels Program-Footnote-1754599
-Node: Word Sorting754683
-Node: History Sorting758567
-Node: Extract Program760406
-Ref: Extract Program-Footnote-1767889
-Node: Simple Sed768017
-Node: Igawk Program771079
-Ref: Igawk Program-Footnote-1786236
-Ref: Igawk Program-Footnote-2786437
-Node: Anagram Program786575
-Node: Signature Program789643
-Node: Debugger790743
-Node: Debugging791695
-Node: Debugging Concepts792128
-Node: Debugging Terms793984
-Node: Awk Debugging796581
-Node: Sample Debugging Session797473
-Node: Debugger Invocation797993
-Node: Finding The Bug799322
-Node: List of Debugger Commands805810
-Node: Breakpoint Control807144
-Node: Debugger Execution Control810808
-Node: Viewing And Changing Data814168
-Node: Execution Stack817524
-Node: Debugger Info818991
-Node: Miscellaneous Debugger Commands822972
-Node: Readline Support828417
-Node: Limitations829248
-Node: Language History831500
-Node: V7/SVR3.1833012
-Node: SVR4835333
-Node: POSIX836775
-Node: BTL837783
-Node: POSIX/GNU838517
-Node: Common Extensions843668
-Node: Ranges and Locales844775
-Ref: Ranges and Locales-Footnote-1849379
-Node: Contributors849600
-Node: Installation853861
-Node: Gawk Distribution854755
-Node: Getting855239
-Node: Extracting856065
-Node: Distribution contents857757
-Node: Unix Installation862979
-Node: Quick Installation863596
-Node: Additional Configuration Options865558
-Node: Configuration Philosophy867035
-Node: Non-Unix Installation869377
-Node: PC Installation869835
-Node: PC Binary Installation871134
-Node: PC Compiling872982
-Node: PC Testing875926
-Node: PC Using877102
-Node: Cygwin881287
-Node: MSYS882287
-Node: VMS Installation882801
-Node: VMS Compilation883404
-Ref: VMS Compilation-Footnote-1884411
-Node: VMS Installation Details884469
-Node: VMS Running886104
-Node: VMS Old Gawk887711
-Node: Bugs888185
-Node: Other Versions892037
-Node: Notes897352
-Node: Compatibility Mode898044
-Node: Additions898827
-Node: Accessing The Source899639
-Node: Adding Code901064
-Node: New Ports907031
-Node: Dynamic Extensions911144
-Node: Internals912584
-Node: Plugin License921103
-Node: Loading Extensions921741
-Node: Sample Library923551
-Node: Internal File Description924241
-Node: Internal File Ops927956
-Ref: Internal File Ops-Footnote-1932680
-Node: Using Internal File Ops932820
-Node: Future Extensions935197
-Node: Basic Concepts937701
-Node: Basic High Level938458
-Ref: Basic High Level-Footnote-1942493
-Node: Basic Data Typing942678
-Node: Floating Point Issues947203
-Node: String Conversion Precision948286
-Ref: String Conversion Precision-Footnote-1949986
-Node: Unexpected Results950095
-Node: POSIX Floating Point Problems951921
-Ref: POSIX Floating Point Problems-Footnote-1955626
-Node: Glossary955664
-Node: Copying980640
-Node: GNU Free Documentation License1018197
-Node: Index1043334
+Ref: Options-Footnote-1115205
+Node: Other Arguments115230
+Node: Naming Standard Input117888
+Node: Environment Variables118982
+Node: AWKPATH Variable119426
+Ref: AWKPATH Variable-Footnote-1122023
+Node: Other Environment Variables122283
+Node: Exit Status124775
+Node: Include Files125450
+Node: Obsolete128935
+Node: Undocumented129621
+Node: Regexp129862
+Node: Regexp Usage131251
+Node: Escape Sequences133277
+Node: Regexp Operators139040
+Ref: Regexp Operators-Footnote-1146420
+Ref: Regexp Operators-Footnote-2146567
+Node: Bracket Expressions146665
+Ref: table-char-classes148555
+Node: GNU Regexp Operators151078
+Node: Case-sensitivity154801
+Ref: Case-sensitivity-Footnote-1157769
+Ref: Case-sensitivity-Footnote-2158004
+Node: Leftmost Longest158112
+Node: Computed Regexps159313
+Node: Reading Files162723
+Node: Records164727
+Ref: Records-Footnote-1173401
+Node: Fields173438
+Ref: Fields-Footnote-1176471
+Node: Nonconstant Fields176557
+Node: Changing Fields178759
+Node: Field Separators184740
+Node: Default Field Splitting187369
+Node: Regexp Field Splitting188486
+Node: Single Character Fields191828
+Node: Command Line Field Separator192887
+Node: Field Splitting Summary196328
+Ref: Field Splitting Summary-Footnote-1199520
+Node: Constant Size199621
+Node: Splitting By Content204205
+Ref: Splitting By Content-Footnote-1207931
+Node: Multiple Line207971
+Ref: Multiple Line-Footnote-1213818
+Node: Getline213997
+Node: Plain Getline216213
+Node: Getline/Variable218302
+Node: Getline/File219443
+Node: Getline/Variable/File220765
+Ref: Getline/Variable/File-Footnote-1222364
+Node: Getline/Pipe222451
+Node: Getline/Variable/Pipe225011
+Node: Getline/Coprocess226118
+Node: Getline/Variable/Coprocess227361
+Node: Getline Notes228075
+Node: Getline Summary230017
+Ref: table-getline-variants230360
+Node: Read Timeout231216
+Ref: Read Timeout-Footnote-1234961
+Node: Command line directories235018
+Node: Printing235648
+Node: Print237279
+Node: Print Examples238616
+Node: Output Separators241400
+Node: OFMT243160
+Node: Printf244518
+Node: Basic Printf245424
+Node: Control Letters246963
+Node: Format Modifiers250775
+Node: Printf Examples256784
+Node: Redirection259499
+Node: Special Files266483
+Node: Special FD267016
+Ref: Special FD-Footnote-1270641
+Node: Special Network270715
+Node: Special Caveats271565
+Node: Close Files And Pipes272361
+Ref: Close Files And Pipes-Footnote-1279384
+Ref: Close Files And Pipes-Footnote-2279532
+Node: Expressions279682
+Node: Values280814
+Node: Constants281490
+Node: Scalar Constants282170
+Ref: Scalar Constants-Footnote-1283029
+Node: Nondecimal-numbers283211
+Node: Regexp Constants286270
+Node: Using Constant Regexps286745
+Node: Variables289800
+Node: Using Variables290455
+Node: Assignment Options292179
+Node: Conversion294051
+Ref: table-locale-affects299427
+Ref: Conversion-Footnote-1300051
+Node: All Operators300160
+Node: Arithmetic Ops300790
+Node: Concatenation303295
+Ref: Concatenation-Footnote-1306088
+Node: Assignment Ops306208
+Ref: table-assign-ops311196
+Node: Increment Ops312604
+Node: Truth Values and Conditions316074
+Node: Truth Values317157
+Node: Typing and Comparison318206
+Node: Variable Typing318995
+Ref: Variable Typing-Footnote-1322892
+Node: Comparison Operators323014
+Ref: table-relational-ops323424
+Node: POSIX String Comparison326973
+Ref: POSIX String Comparison-Footnote-1327929
+Node: Boolean Ops328067
+Ref: Boolean Ops-Footnote-1332145
+Node: Conditional Exp332236
+Node: Function Calls333968
+Node: Precedence337562
+Node: Locales341231
+Node: Patterns and Actions342320
+Node: Pattern Overview343374
+Node: Regexp Patterns345043
+Node: Expression Patterns345586
+Node: Ranges349271
+Node: BEGIN/END352237
+Node: Using BEGIN/END352999
+Ref: Using BEGIN/END-Footnote-1355730
+Node: I/O And BEGIN/END355836
+Node: BEGINFILE/ENDFILE358118
+Node: Empty361011
+Node: Using Shell Variables361327
+Node: Action Overview363612
+Node: Statements365969
+Node: If Statement367823
+Node: While Statement369322
+Node: Do Statement371366
+Node: For Statement372522
+Node: Switch Statement375674
+Node: Break Statement377771
+Node: Continue Statement379761
+Node: Next Statement381554
+Node: Nextfile Statement383944
+Node: Exit Statement386489
+Node: Built-in Variables388905
+Node: User-modified390000
+Ref: User-modified-Footnote-1398355
+Node: Auto-set398417
+Ref: Auto-set-Footnote-1408263
+Node: ARGC and ARGV408468
+Node: Arrays412319
+Node: Array Basics413824
+Node: Array Intro414650
+Node: Reference to Elements418968
+Node: Assigning Elements421238
+Node: Array Example421729
+Node: Scanning an Array423461
+Node: Controlling Scanning425775
+Ref: Controlling Scanning-Footnote-1430708
+Node: Delete431024
+Ref: Delete-Footnote-1433459
+Node: Numeric Array Subscripts433516
+Node: Uninitialized Subscripts435699
+Node: Multi-dimensional437327
+Node: Multi-scanning440421
+Node: Arrays of Arrays442012
+Node: Functions446657
+Node: Built-in447479
+Node: Calling Built-in448557
+Node: Numeric Functions450545
+Ref: Numeric Functions-Footnote-1454377
+Ref: Numeric Functions-Footnote-2454734
+Ref: Numeric Functions-Footnote-3454782
+Node: String Functions455051
+Ref: String Functions-Footnote-1478548
+Ref: String Functions-Footnote-2478677
+Ref: String Functions-Footnote-3478925
+Node: Gory Details479012
+Ref: table-sub-escapes480691
+Ref: table-sub-posix-92482045
+Ref: table-sub-proposed483388
+Ref: table-posix-sub484738
+Ref: table-gensub-escapes486284
+Ref: Gory Details-Footnote-1487491
+Ref: Gory Details-Footnote-2487542
+Node: I/O Functions487693
+Ref: I/O Functions-Footnote-1494348
+Node: Time Functions494495
+Ref: Time Functions-Footnote-1505387
+Ref: Time Functions-Footnote-2505455
+Ref: Time Functions-Footnote-3505613
+Ref: Time Functions-Footnote-4505724
+Ref: Time Functions-Footnote-5505836
+Ref: Time Functions-Footnote-6506063
+Node: Bitwise Functions506329
+Ref: table-bitwise-ops506887
+Ref: Bitwise Functions-Footnote-1511047
+Node: Type Functions511231
+Node: I18N Functions511701
+Node: User-defined513328
+Node: Definition Syntax514132
+Ref: Definition Syntax-Footnote-1519042
+Node: Function Example519111
+Node: Function Caveats521705
+Node: Calling A Function522126
+Node: Variable Scope523241
+Node: Pass By Value/Reference525216
+Node: Return Statement528656
+Node: Dynamic Typing531637
+Node: Indirect Calls532372
+Node: Internationalization542057
+Node: I18N and L10N543496
+Node: Explaining gettext544182
+Ref: Explaining gettext-Footnote-1549248
+Ref: Explaining gettext-Footnote-2549432
+Node: Programmer i18n549597
+Node: Translator i18n553797
+Node: String Extraction554590
+Ref: String Extraction-Footnote-1555551
+Node: Printf Ordering555637
+Ref: Printf Ordering-Footnote-1558421
+Node: I18N Portability558485
+Ref: I18N Portability-Footnote-1560934
+Node: I18N Example560997
+Ref: I18N Example-Footnote-1563632
+Node: Gawk I18N563704
+Node: Arbitrary Precision Arithmetic564321
+Ref: Arbitrary Precision Arithmetic-Footnote-1567196
+Node: Floating-point Programming567344
+Node: Floating-point Representation572614
+Node: Floating-point Context573718
+Ref: table-ieee-formats574553
+Node: Rounding Mode575923
+Ref: table-rounding-modes576550
+Ref: Rounding Mode-Footnote-1579673
+Node: Arbitrary Precision Floats579854
+Ref: Arbitrary Precision Floats-Footnote-1581895
+Node: Setting Precision582206
+Node: Setting Rounding Mode584964
+Node: Floating-point Constants585881
+Node: Changing Precision587300
+Ref: Changing Precision-Footnote-1588700
+Node: Exact Arithmetic588873
+Node: Integer Programming591886
+Node: Arbitrary Precision Integers593666
+Ref: Arbitrary Precision Integers-Footnote-1596690
+Node: MPFR and GMP Libraries596836
+Node: Advanced Features597221
+Node: Nondecimal Data598744
+Node: Array Sorting600327
+Node: Controlling Array Traversal601024
+Node: Array Sorting Functions609261
+Ref: Array Sorting Functions-Footnote-1612935
+Ref: Array Sorting Functions-Footnote-2613028
+Node: Two-way I/O613222
+Ref: Two-way I/O-Footnote-1618654
+Node: TCP/IP Networking618724
+Node: Profiling621568
+Node: Library Functions629022
+Ref: Library Functions-Footnote-1632029
+Node: Library Names632200
+Ref: Library Names-Footnote-1635671
+Ref: Library Names-Footnote-2635891
+Node: General Functions635977
+Node: Strtonum Function636930
+Node: Assert Function639860
+Node: Round Function643186
+Node: Cliff Random Function644729
+Node: Ordinal Functions645745
+Ref: Ordinal Functions-Footnote-1648815
+Ref: Ordinal Functions-Footnote-2649067
+Node: Join Function649276
+Ref: Join Function-Footnote-1651047
+Node: Gettimeofday Function651247
+Node: Data File Management654962
+Node: Filetrans Function655594
+Node: Rewind Function659733
+Node: File Checking661120
+Node: Empty Files662214
+Node: Ignoring Assigns664444
+Node: Getopt Function665997
+Ref: Getopt Function-Footnote-1677301
+Node: Passwd Functions677504
+Ref: Passwd Functions-Footnote-1686479
+Node: Group Functions686567
+Node: Walking Arrays694651
+Node: Sample Programs696220
+Node: Running Examples696885
+Node: Clones697613
+Node: Cut Program698837
+Node: Egrep Program708682
+Ref: Egrep Program-Footnote-1716455
+Node: Id Program716565
+Node: Split Program720181
+Ref: Split Program-Footnote-1723700
+Node: Tee Program723828
+Node: Uniq Program726631
+Node: Wc Program734060
+Ref: Wc Program-Footnote-1738326
+Ref: Wc Program-Footnote-2738526
+Node: Miscellaneous Programs738618
+Node: Dupword Program739806
+Node: Alarm Program741837
+Node: Translate Program746586
+Ref: Translate Program-Footnote-1750973
+Ref: Translate Program-Footnote-2751201
+Node: Labels Program751335
+Ref: Labels Program-Footnote-1754706
+Node: Word Sorting754790
+Node: History Sorting758674
+Node: Extract Program760513
+Ref: Extract Program-Footnote-1767996
+Node: Simple Sed768124
+Node: Igawk Program771186
+Ref: Igawk Program-Footnote-1786343
+Ref: Igawk Program-Footnote-2786544
+Node: Anagram Program786682
+Node: Signature Program789750
+Node: Debugger790850
+Node: Debugging791802
+Node: Debugging Concepts792235
+Node: Debugging Terms794091
+Node: Awk Debugging796688
+Node: Sample Debugging Session797580
+Node: Debugger Invocation798100
+Node: Finding The Bug799429
+Node: List of Debugger Commands805917
+Node: Breakpoint Control807251
+Node: Debugger Execution Control810915
+Node: Viewing And Changing Data814275
+Node: Execution Stack817631
+Node: Debugger Info819098
+Node: Miscellaneous Debugger Commands823079
+Node: Readline Support828524
+Node: Limitations829355
+Node: Language History831607
+Node: V7/SVR3.1833119
+Node: SVR4835440
+Node: POSIX836882
+Node: BTL837890
+Node: POSIX/GNU838624
+Node: Common Extensions843775
+Node: Ranges and Locales844882
+Ref: Ranges and Locales-Footnote-1849486
+Node: Contributors849707
+Node: Installation853968
+Node: Gawk Distribution854862
+Node: Getting855346
+Node: Extracting856172
+Node: Distribution contents857864
+Node: Unix Installation863086
+Node: Quick Installation863703
+Node: Additional Configuration Options865665
+Node: Configuration Philosophy867142
+Node: Non-Unix Installation869484
+Node: PC Installation869942
+Node: PC Binary Installation871241
+Node: PC Compiling873089
+Node: PC Testing876033
+Node: PC Using877209
+Node: Cygwin881394
+Node: MSYS882394
+Node: VMS Installation882908
+Node: VMS Compilation883511
+Ref: VMS Compilation-Footnote-1884518
+Node: VMS Installation Details884576
+Node: VMS Running886211
+Node: VMS Old Gawk887818
+Node: Bugs888292
+Node: Other Versions892144
+Node: Notes897459
+Node: Compatibility Mode898151
+Node: Additions898934
+Node: Accessing The Source899746
+Node: Adding Code901171
+Node: New Ports907138
+Node: Dynamic Extensions911251
+Node: Internals912691
+Node: Plugin License921210
+Node: Loading Extensions921848
+Node: Sample Library923658
+Node: Internal File Description924348
+Node: Internal File Ops928063
+Ref: Internal File Ops-Footnote-1932787
+Node: Using Internal File Ops932927
+Node: Future Extensions935304
+Node: Basic Concepts937808
+Node: Basic High Level938565
+Ref: Basic High Level-Footnote-1942600
+Node: Basic Data Typing942785
+Node: Floating Point Issues947310
+Node: String Conversion Precision948393
+Ref: String Conversion Precision-Footnote-1950093
+Node: Unexpected Results950202
+Node: POSIX Floating Point Problems952028
+Ref: POSIX Floating Point Problems-Footnote-1955733
+Node: Glossary955771
+Node: Copying980747
+Node: GNU Free Documentation License1018304
+Node: Index1043441

End Tag Table
diff --git a/doc/gawk.texi b/doc/gawk.texi
index 8cd7e38e..22215d93 100644
--- a/doc/gawk.texi
+++ b/doc/gawk.texi
@@ -3078,6 +3078,9 @@ The following list describes @command{gawk}-specific options:
@cindex @code{-b} option
@cindex @code{--characters-as-bytes} option
Cause @command{gawk} to treat all input data as single-byte characters.
+In addition, all output written with @code{print} or @code{printf}
+are treated as single-byte characters.
+
Normally, @command{gawk} follows the POSIX standard and attempts to process
its input data according to the current locale. This can often involve
converting multibyte characters into wide characters (internally), and