aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorArnold D. Robbins <arnold@skeeve.com>2012-04-27 12:20:02 +0300
committerArnold D. Robbins <arnold@skeeve.com>2012-04-27 12:20:02 +0300
commita7fe78d7a2ce2000837350ee4fa0e7ab70b2a9bc (patch)
treea28a59907310dd75f3f28d98e75865dc2c248e66
parent2ee1a96b398f3bd183a84509464770153a8890d4 (diff)
downloadegawk-a7fe78d7a2ce2000837350ee4fa0e7ab70b2a9bc.tar.gz
egawk-a7fe78d7a2ce2000837350ee4fa0e7ab70b2a9bc.tar.bz2
egawk-a7fe78d7a2ce2000837350ee4fa0e7ab70b2a9bc.zip
Update doc on -b.
-rw-r--r--doc/ChangeLog4
-rw-r--r--doc/gawk.info891
-rw-r--r--doc/gawk.texi3
3 files changed, 454 insertions, 444 deletions
diff --git a/doc/ChangeLog b/doc/ChangeLog
index 4d178867..8a1b004d 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 a33027cd..397daab6 100644
--- a/doc/gawk.info
+++ b/doc/gawk.info
@@ -2182,6 +2182,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
@@ -24721,73 +24724,73 @@ Index
* - (hyphen), filenames beginning with: Options. (line 59)
* - (hyphen), in bracket expressions: Bracket Expressions. (line 17)
* --assign option: Options. (line 32)
-* --c option: Options. (line 78)
+* --c option: Options. (line 81)
* --characters-as-bytes option: Options. (line 68)
-* --command option: Options. (line 231)
-* --copyright option: Options. (line 85)
+* --command option: Options. (line 234)
+* --copyright option: Options. (line 88)
* --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 113)
+* --dump-variables option: Options. (line 93)
+* --exec option: Options. (line 116)
* --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 245)
-* --lint option <1>: Options. (line 147)
+* --gen-pot option: Options. (line 138)
+* --help option: Options. (line 145)
+* --L option: Options. (line 248)
+* --lint option <1>: Options. (line 150)
* --lint option: Command Line. (line 20)
-* --lint-old option: Options. (line 245)
+* --lint-old option: Options. (line 248)
* --non-decimal-data option <1>: Nondecimal Data. (line 6)
-* --non-decimal-data option: Options. (line 166)
+* --non-decimal-data option: Options. (line 169)
* --non-decimal-data option, strtonum() function and: Nondecimal Data.
(line 36)
-* --optimize option: Options. (line 179)
-* --posix option: Options. (line 199)
-* --posix option, --traditional option and: Options. (line 218)
+* --optimize option: Options. (line 182)
+* --posix option: Options. (line 202)
+* --posix option, --traditional option and: Options. (line 221)
* --profile option <1>: Profiling. (line 15)
-* --profile option: Options. (line 186)
-* --re-interval option: Options. (line 224)
-* --sandbox option: Options. (line 236)
+* --profile option: Options. (line 189)
+* --re-interval option: Options. (line 227)
+* --sandbox option: Options. (line 239)
* --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)
-* --traditional option: Options. (line 78)
-* --traditional option, --posix option and: Options. (line 218)
-* --use-lc-numeric option: Options. (line 174)
-* --version option: Options. (line 250)
+* --source option: Options. (line 108)
+* --traditional option: Options. (line 81)
+* --traditional option, --posix option and: Options. (line 221)
+* --use-lc-numeric option: Options. (line 177)
+* --version option: Options. (line 253)
* --with-whiny-user-strftime configuration option: Additional Configuration Options.
(line 29)
* -b option: Options. (line 68)
-* -C option: Options. (line 85)
-* -d option: Options. (line 90)
-* -E option: Options. (line 113)
-* -e option: Options. (line 105)
+* -C option: Options. (line 88)
+* -d option: Options. (line 93)
+* -E option: Options. (line 116)
+* -e option: Options. (line 108)
* -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 258)
-* -f option, on command line: Options. (line 263)
-* -g option: Options. (line 135)
-* -h option: Options. (line 142)
-* -l option: Options. (line 147)
-* -N option: Options. (line 174)
-* -n option: Options. (line 166)
-* -O option: Options. (line 179)
-* -P option: Options. (line 199)
-* -p option: Options. (line 186)
-* -R option: Options. (line 231)
-* -r option: Options. (line 224)
-* -S option: Options. (line 236)
-* -V option: Options. (line 250)
+* -F option, -Ft sets FS to TAB: Options. (line 261)
+* -f option, on command line: Options. (line 266)
+* -g option: Options. (line 138)
+* -h option: Options. (line 145)
+* -l option: Options. (line 150)
+* -N option: Options. (line 177)
+* -n option: Options. (line 169)
+* -O option: Options. (line 182)
+* -P option: Options. (line 202)
+* -p option: Options. (line 189)
+* -R option: Options. (line 234)
+* -r option: Options. (line 227)
+* -S option: Options. (line 239)
+* -V option: Options. (line 253)
* -v option: Options. (line 32)
* -v option, variables, assigning: Assignment Options. (line 12)
* -W option: Options. (line 46)
@@ -25059,7 +25062,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 189)
* awk programs, running <1>: Long. (line 6)
* awk programs, running: Running gawk. (line 6)
* awk programs, running, from shell scripts: One-shot. (line 22)
@@ -25101,7 +25104,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 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)
@@ -25268,7 +25271,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 116)
* 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.
@@ -25354,7 +25357,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)
@@ -25399,7 +25402,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 305)
+* csh utility, POSIXLY_CORRECT environment variable: Options. (line 308)
* 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)
@@ -25567,7 +25570,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 215)
+* decimal point character, locale specific: Options. (line 218)
* decrement operators: Increment Ops. (line 35)
* default keyword: Switch Statement. (line 6)
* Deifik, Scott <1>: Bugs. (line 70)
@@ -25863,7 +25866,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 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)
@@ -25891,7 +25894,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 138)
* files, processing, ARGIND variable and: Auto-set. (line 47)
* files, reading: Rewind Function. (line 6)
* files, reading, multiline records: Multiple Line. (line 6)
@@ -25947,7 +25950,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 211)
+* FS variable, as TAB character: Options. (line 214)
* 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.
@@ -26032,7 +26035,7 @@ Index
(line 139)
* gawk, ERRNO variable in: Getline. (line 19)
* gawk, escape sequences: Escape Sequences. (line 125)
-* gawk, extensions, disabling: Options. (line 199)
+* gawk, extensions, disabling: Options. (line 202)
* gawk, features, adding: Adding Code. (line 6)
* gawk, features, advanced: Advanced Features. (line 6)
* gawk, fflush() function in: I/O Functions. (line 44)
@@ -26096,7 +26099,7 @@ Index
* gawk, TEXTDOMAIN variable in: User-modified. (line 153)
* gawk, timestamps: Time Functions. (line 6)
* gawk, uses for: Preface. (line 36)
-* gawk, versions of, information about, printing: Options. (line 250)
+* gawk, versions of, information about, printing: Options. (line 253)
* gawk, VMS version of: VMS Installation. (line 6)
* gawk, word-boundary operator: GNU Regexp Operators.
(line 63)
@@ -26157,7 +26160,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 142)
+* GNU long options, printing list of: Options. (line 145)
* GNU Project <1>: Glossary. (line 319)
* GNU Project: Manual History. (line 11)
* GNU/Linux <1>: Glossary. (line 611)
@@ -26165,7 +26168,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)
@@ -26188,7 +26191,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 169)
* histsort.awk program: History Sorting. (line 25)
* Hughes, Phil: Acknowledgments. (line 43)
* HUP signal: Profiling. (line 204)
@@ -26409,9 +26412,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 150)
* lint checking, POSIXLY_CORRECT environment variable: Options.
- (line 289)
+ (line 292)
* lint checking, undefined functions: Pass By Value/Reference.
(line 88)
* LINT variable: User-modified. (line 98)
@@ -26422,7 +26425,7 @@ Index
(line 74)
* local variables: Variable Scope. (line 6)
* locale categories: Explaining gettext. (line 80)
-* locale decimal point character: Options. (line 215)
+* locale decimal point character: Options. (line 218)
* locale, definition of: Locales. (line 6)
* localization: I18N and L10N. (line 6)
* localization, See internationalization, localization: I18N and L10N.
@@ -26490,7 +26493,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 208)
* newlines: Statements/Lines. (line 6)
* newlines, as field separators: Default Field Splitting.
(line 6)
@@ -26570,7 +26573,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 169)
* OFMT variable <1>: User-modified. (line 115)
* OFMT variable <2>: Conversion. (line 55)
* OFMT variable: OFMT. (line 15)
@@ -26623,7 +26626,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 145)
* OR bitwise operation: Bitwise Functions. (line 6)
* or Boolean-logic operator: Boolean Ops. (line 6)
* or() function (gawk): Bitwise Functions. (line 48)
@@ -26718,13 +26721,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 310)
+* portability, POSIXLY_CORRECT environment variable: Options. (line 313)
* 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 135)
+* portable object files, generating: Options. (line 138)
* portable object template files: Explaining gettext. (line 30)
* porting gawk: New Ports. (line 6)
* positional specifiers, printf statement <1>: Printf Ordering.
@@ -26768,11 +26771,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 199)
+* POSIX mode: Options. (line 202)
* 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 289)
+* POSIXLY_CORRECT environment variable: Options. (line 292)
* precedence <1>: Precedence. (line 6)
* precedence: Increment Ops. (line 61)
* precedence, regexp operators: Regexp Operators. (line 156)
@@ -26806,7 +26809,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 145)
* printing, mailing labels: Labels Program. (line 6)
* printing, unduplicated lines of text: Uniq Program. (line 6)
* printing, user information: Id Program. (line 6)
@@ -26929,7 +26932,7 @@ Index
(line 59)
* regular expressions, gawk, command-line options: GNU Regexp Operators.
(line 70)
-* regular expressions, interval expressions and: Options. (line 224)
+* regular expressions, interval expressions and: Options. (line 227)
* regular expressions, leftmost longest match: Leftmost Longest.
(line 6)
* regular expressions, operators <1>: Regexp Operators. (line 6)
@@ -27003,7 +27006,7 @@ Index
* rvalues/lvalues: Assignment Ops. (line 32)
* s debugger command (alias for step): Dgawk Execution Control.
(line 68)
-* sandbox mode: Options. (line 236)
+* sandbox mode: Options. (line 239)
* scalar values: Basic Data Typing. (line 13)
* Schorr, Andrew: Acknowledgments. (line 60)
* Schreiber, Bert: Acknowledgments. (line 38)
@@ -27099,7 +27102,7 @@ Index
* source code, jawk: Other Versions. (line 96)
* source code, libmawk: Other Versions. (line 104)
* source code, mawk: Other Versions. (line 35)
-* source code, mixing: Options. (line 105)
+* source code, mixing: Options. (line 108)
* source code, pawk: Other Versions. (line 69)
* source code, QSE Awk: Other Versions. (line 108)
* source code, QuikTrim Awk: Other Versions. (line 112)
@@ -27238,7 +27241,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 169)
* troubleshooting, == operator: Comparison Operators.
(line 37)
* troubleshooting, awk uses FS not IFS: Field Separators. (line 29)
@@ -27270,7 +27273,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)
@@ -27341,7 +27344,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)
@@ -27371,7 +27374,7 @@ Index
* Wall, Larry <1>: Future Extensions. (line 6)
* Wall, Larry: Array Intro. (line 6)
* Wallin, Anders: Acknowledgments. (line 60)
-* warnings, issuing: Options. (line 147)
+* warnings, issuing: Options. (line 150)
* watch debugger command: Viewing And Changing Data.
(line 67)
* wc utility: Wc Program. (line 6)
@@ -27383,7 +27386,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 208)
* Williams, Kent: Contributors. (line 35)
* Woehlke, Matthew: Contributors. (line 79)
* Woods, John: Contributors. (line 28)
@@ -27479,376 +27482,376 @@ Node: When94993
Node: Invoking Gawk97140
Node: Command Line98525
Node: Options99308
-Ref: Options-Footnote-1112745
-Node: Other Arguments112770
-Node: Naming Standard Input115428
-Node: Environment Variables116522
-Node: AWKPATH Variable116966
-Ref: AWKPATH Variable-Footnote-1119563
-Node: Other Environment Variables119823
-Node: Exit Status122163
-Node: Include Files122838
-Node: Obsolete126323
-Node: Undocumented127009
-Node: Regexp127250
-Node: Regexp Usage128639
-Node: Escape Sequences130665
-Node: Regexp Operators136428
-Ref: Regexp Operators-Footnote-1143808
-Ref: Regexp Operators-Footnote-2143955
-Node: Bracket Expressions144053
-Ref: table-char-classes145943
-Node: GNU Regexp Operators148466
-Node: Case-sensitivity152189
-Ref: Case-sensitivity-Footnote-1155157
-Ref: Case-sensitivity-Footnote-2155392
-Node: Leftmost Longest155500
-Node: Computed Regexps156701
-Node: Reading Files160111
-Node: Records162052
-Ref: Records-Footnote-1170726
-Node: Fields170763
-Ref: Fields-Footnote-1173796
-Node: Nonconstant Fields173882
-Node: Changing Fields176084
-Node: Field Separators182065
-Node: Default Field Splitting184694
-Node: Regexp Field Splitting185811
-Node: Single Character Fields189153
-Node: Command Line Field Separator190212
-Node: Field Splitting Summary193653
-Ref: Field Splitting Summary-Footnote-1196845
-Node: Constant Size196946
-Node: Splitting By Content201530
-Ref: Splitting By Content-Footnote-1205256
-Node: Multiple Line205296
-Ref: Multiple Line-Footnote-1211143
-Node: Getline211322
-Node: Plain Getline213550
-Node: Getline/Variable215639
-Node: Getline/File216780
-Node: Getline/Variable/File218102
-Ref: Getline/Variable/File-Footnote-1219701
-Node: Getline/Pipe219788
-Node: Getline/Variable/Pipe222348
-Node: Getline/Coprocess223455
-Node: Getline/Variable/Coprocess224698
-Node: Getline Notes225412
-Node: Getline Summary227354
-Ref: table-getline-variants227697
-Node: Command line directories228553
-Node: Printing229178
-Node: Print230809
-Node: Print Examples232146
-Node: Output Separators234930
-Node: OFMT236690
-Node: Printf238048
-Node: Basic Printf238954
-Node: Control Letters240493
-Node: Format Modifiers244305
-Node: Printf Examples250314
-Node: Redirection253029
-Node: Special Files260013
-Node: Special FD260546
-Ref: Special FD-Footnote-1264171
-Node: Special Network264245
-Node: Special Caveats265095
-Node: Close Files And Pipes265891
-Ref: Close Files And Pipes-Footnote-1272914
-Ref: Close Files And Pipes-Footnote-2273062
-Node: Expressions273212
-Node: Values274344
-Node: Constants275020
-Node: Scalar Constants275700
-Ref: Scalar Constants-Footnote-1276559
-Node: Nondecimal-numbers276741
-Node: Regexp Constants279800
-Node: Using Constant Regexps280275
-Node: Variables283330
-Node: Using Variables283985
-Node: Assignment Options285709
-Node: Conversion287581
-Ref: table-locale-affects292957
-Ref: Conversion-Footnote-1293581
-Node: All Operators293690
-Node: Arithmetic Ops294320
-Node: Concatenation296825
-Ref: Concatenation-Footnote-1299618
-Node: Assignment Ops299738
-Ref: table-assign-ops304726
-Node: Increment Ops306134
-Node: Truth Values and Conditions309604
-Node: Truth Values310687
-Node: Typing and Comparison311736
-Node: Variable Typing312525
-Ref: Variable Typing-Footnote-1316422
-Node: Comparison Operators316544
-Ref: table-relational-ops316954
-Node: POSIX String Comparison320503
-Ref: POSIX String Comparison-Footnote-1321459
-Node: Boolean Ops321597
-Ref: Boolean Ops-Footnote-1325675
-Node: Conditional Exp325766
-Node: Function Calls327498
-Node: Precedence331092
-Node: Locales334761
-Node: Patterns and Actions335850
-Node: Pattern Overview336904
-Node: Regexp Patterns338573
-Node: Expression Patterns339116
-Node: Ranges342801
-Node: BEGIN/END345767
-Node: Using BEGIN/END346529
-Ref: Using BEGIN/END-Footnote-1349260
-Node: I/O And BEGIN/END349366
-Node: BEGINFILE/ENDFILE351648
-Node: Empty354541
-Node: Using Shell Variables354857
-Node: Action Overview357142
-Node: Statements359499
-Node: If Statement361353
-Node: While Statement362852
-Node: Do Statement364896
-Node: For Statement366052
-Node: Switch Statement369204
-Node: Break Statement371301
-Node: Continue Statement373291
-Node: Next Statement375084
-Node: Nextfile Statement377474
-Node: Exit Statement380019
-Node: Built-in Variables382435
-Node: User-modified383530
-Ref: User-modified-Footnote-1391556
-Node: Auto-set391618
-Ref: Auto-set-Footnote-1400909
-Node: ARGC and ARGV401114
-Node: Arrays404965
-Node: Array Basics406470
-Node: Array Intro407296
-Node: Reference to Elements411614
-Node: Assigning Elements413884
-Node: Array Example414375
-Node: Scanning an Array416107
-Node: Controlling Scanning418421
-Ref: Controlling Scanning-Footnote-1423354
-Node: Delete423670
-Ref: Delete-Footnote-1426105
-Node: Numeric Array Subscripts426162
-Node: Uninitialized Subscripts428345
-Node: Multi-dimensional429973
-Node: Multi-scanning433067
-Node: Arrays of Arrays434658
-Node: Functions439303
-Node: Built-in440125
-Node: Calling Built-in441203
-Node: Numeric Functions443191
-Ref: Numeric Functions-Footnote-1447023
-Ref: Numeric Functions-Footnote-2447380
-Ref: Numeric Functions-Footnote-3447428
-Node: String Functions447697
-Ref: String Functions-Footnote-1471194
-Ref: String Functions-Footnote-2471323
-Ref: String Functions-Footnote-3471571
-Node: Gory Details471658
-Ref: table-sub-escapes473337
-Ref: table-sub-posix-92474691
-Ref: table-sub-proposed476034
-Ref: table-posix-sub477384
-Ref: table-gensub-escapes478930
-Ref: Gory Details-Footnote-1480137
-Ref: Gory Details-Footnote-2480188
-Node: I/O Functions480339
-Ref: I/O Functions-Footnote-1486994
-Node: Time Functions487141
-Ref: Time Functions-Footnote-1498033
-Ref: Time Functions-Footnote-2498101
-Ref: Time Functions-Footnote-3498259
-Ref: Time Functions-Footnote-4498370
-Ref: Time Functions-Footnote-5498482
-Ref: Time Functions-Footnote-6498709
-Node: Bitwise Functions498975
-Ref: table-bitwise-ops499533
-Ref: Bitwise Functions-Footnote-1503693
-Node: Type Functions503877
-Node: I18N Functions504347
-Node: User-defined505974
-Node: Definition Syntax506778
-Ref: Definition Syntax-Footnote-1511688
-Node: Function Example511757
-Node: Function Caveats514351
-Node: Calling A Function514772
-Node: Variable Scope515887
-Node: Pass By Value/Reference517862
-Node: Return Statement521302
-Node: Dynamic Typing524283
-Node: Indirect Calls525018
-Node: Internationalization534703
-Node: I18N and L10N536129
-Node: Explaining gettext536815
-Ref: Explaining gettext-Footnote-1541881
-Ref: Explaining gettext-Footnote-2542065
-Node: Programmer i18n542230
-Node: Translator i18n546430
-Node: String Extraction547223
-Ref: String Extraction-Footnote-1548184
-Node: Printf Ordering548270
-Ref: Printf Ordering-Footnote-1551054
-Node: I18N Portability551118
-Ref: I18N Portability-Footnote-1553567
-Node: I18N Example553630
-Ref: I18N Example-Footnote-1556265
-Node: Gawk I18N556337
-Node: Advanced Features556954
-Node: Nondecimal Data558467
-Node: Array Sorting560050
-Node: Controlling Array Traversal560747
-Node: Array Sorting Functions568984
-Ref: Array Sorting Functions-Footnote-1572658
-Ref: Array Sorting Functions-Footnote-2572751
-Node: Two-way I/O572945
-Ref: Two-way I/O-Footnote-1578377
-Node: TCP/IP Networking578447
-Node: Profiling581291
-Node: Library Functions588765
-Ref: Library Functions-Footnote-1591772
-Node: Library Names591943
-Ref: Library Names-Footnote-1595414
-Ref: Library Names-Footnote-2595634
-Node: General Functions595720
-Node: Strtonum Function596673
-Node: Assert Function599603
-Node: Round Function602929
-Node: Cliff Random Function604472
-Node: Ordinal Functions605488
-Ref: Ordinal Functions-Footnote-1608558
-Ref: Ordinal Functions-Footnote-2608810
-Node: Join Function609019
-Ref: Join Function-Footnote-1610790
-Node: Gettimeofday Function610990
-Node: Data File Management614705
-Node: Filetrans Function615337
-Node: Rewind Function619476
-Node: File Checking620863
-Node: Empty Files621957
-Node: Ignoring Assigns624187
-Node: Getopt Function625740
-Ref: Getopt Function-Footnote-1637044
-Node: Passwd Functions637247
-Ref: Passwd Functions-Footnote-1646222
-Node: Group Functions646310
-Node: Walking Arrays654394
-Node: Sample Programs655963
-Node: Running Examples656628
-Node: Clones657356
-Node: Cut Program658580
-Node: Egrep Program668425
-Ref: Egrep Program-Footnote-1676198
-Node: Id Program676308
-Node: Split Program679924
-Ref: Split Program-Footnote-1683443
-Node: Tee Program683571
-Node: Uniq Program686374
-Node: Wc Program693803
-Ref: Wc Program-Footnote-1698069
-Ref: Wc Program-Footnote-2698269
-Node: Miscellaneous Programs698361
-Node: Dupword Program699549
-Node: Alarm Program701580
-Node: Translate Program706329
-Ref: Translate Program-Footnote-1710716
-Ref: Translate Program-Footnote-2710944
-Node: Labels Program711078
-Ref: Labels Program-Footnote-1714449
-Node: Word Sorting714533
-Node: History Sorting718417
-Node: Extract Program720256
-Ref: Extract Program-Footnote-1727739
-Node: Simple Sed727867
-Node: Igawk Program730929
-Ref: Igawk Program-Footnote-1746086
-Ref: Igawk Program-Footnote-2746287
-Node: Anagram Program746425
-Node: Signature Program749493
-Node: Debugger750593
-Node: Debugging751504
-Node: Debugging Concepts751917
-Node: Debugging Terms753773
-Node: Awk Debugging756396
-Node: Sample dgawk session757288
-Node: dgawk invocation757780
-Node: Finding The Bug758962
-Node: List of Debugger Commands765448
-Node: Breakpoint Control766759
-Node: Dgawk Execution Control770395
-Node: Viewing And Changing Data773746
-Node: Dgawk Stack777083
-Node: Dgawk Info778543
-Node: Miscellaneous Dgawk Commands782491
-Node: Readline Support787919
-Node: Dgawk Limitations788757
-Node: Language History790946
-Node: V7/SVR3.1792458
-Node: SVR4794779
-Node: POSIX796221
-Node: BTL797229
-Node: POSIX/GNU797963
-Node: Common Extensions803114
-Node: Ranges and Locales804221
-Ref: Ranges and Locales-Footnote-1808825
-Node: Contributors809046
-Node: Installation813308
-Node: Gawk Distribution814202
-Node: Getting814686
-Node: Extracting815512
-Node: Distribution contents817204
-Node: Unix Installation822426
-Node: Quick Installation823043
-Node: Additional Configuration Options825005
-Node: Configuration Philosophy826482
-Node: Non-Unix Installation828824
-Node: PC Installation829282
-Node: PC Binary Installation830581
-Node: PC Compiling832429
-Node: PC Testing835373
-Node: PC Using836549
-Node: Cygwin840734
-Node: MSYS841734
-Node: VMS Installation842248
-Node: VMS Compilation842851
-Ref: VMS Compilation-Footnote-1843858
-Node: VMS Installation Details843916
-Node: VMS Running845551
-Node: VMS Old Gawk847158
-Node: Bugs847632
-Node: Other Versions851484
-Node: Notes856765
-Node: Compatibility Mode857457
-Node: Additions858240
-Node: Accessing The Source859052
-Node: Adding Code860477
-Node: New Ports866444
-Node: Dynamic Extensions870557
-Node: Internals871933
-Node: Plugin License881036
-Node: Sample Library881670
-Node: Internal File Description882356
-Node: Internal File Ops886071
-Ref: Internal File Ops-Footnote-1890852
-Node: Using Internal File Ops890992
-Node: Future Extensions893369
-Node: Basic Concepts895873
-Node: Basic High Level896630
-Ref: Basic High Level-Footnote-1900665
-Node: Basic Data Typing900850
-Node: Floating Point Issues905375
-Node: String Conversion Precision906458
-Ref: String Conversion Precision-Footnote-1908158
-Node: Unexpected Results908267
-Node: POSIX Floating Point Problems910093
-Ref: POSIX Floating Point Problems-Footnote-1913798
-Node: Glossary913836
-Node: Copying938812
-Node: GNU Free Documentation License976369
-Node: Index1001506
+Ref: Options-Footnote-1112852
+Node: Other Arguments112877
+Node: Naming Standard Input115535
+Node: Environment Variables116629
+Node: AWKPATH Variable117073
+Ref: AWKPATH Variable-Footnote-1119670
+Node: Other Environment Variables119930
+Node: Exit Status122270
+Node: Include Files122945
+Node: Obsolete126430
+Node: Undocumented127116
+Node: Regexp127357
+Node: Regexp Usage128746
+Node: Escape Sequences130772
+Node: Regexp Operators136535
+Ref: Regexp Operators-Footnote-1143915
+Ref: Regexp Operators-Footnote-2144062
+Node: Bracket Expressions144160
+Ref: table-char-classes146050
+Node: GNU Regexp Operators148573
+Node: Case-sensitivity152296
+Ref: Case-sensitivity-Footnote-1155264
+Ref: Case-sensitivity-Footnote-2155499
+Node: Leftmost Longest155607
+Node: Computed Regexps156808
+Node: Reading Files160218
+Node: Records162159
+Ref: Records-Footnote-1170833
+Node: Fields170870
+Ref: Fields-Footnote-1173903
+Node: Nonconstant Fields173989
+Node: Changing Fields176191
+Node: Field Separators182172
+Node: Default Field Splitting184801
+Node: Regexp Field Splitting185918
+Node: Single Character Fields189260
+Node: Command Line Field Separator190319
+Node: Field Splitting Summary193760
+Ref: Field Splitting Summary-Footnote-1196952
+Node: Constant Size197053
+Node: Splitting By Content201637
+Ref: Splitting By Content-Footnote-1205363
+Node: Multiple Line205403
+Ref: Multiple Line-Footnote-1211250
+Node: Getline211429
+Node: Plain Getline213657
+Node: Getline/Variable215746
+Node: Getline/File216887
+Node: Getline/Variable/File218209
+Ref: Getline/Variable/File-Footnote-1219808
+Node: Getline/Pipe219895
+Node: Getline/Variable/Pipe222455
+Node: Getline/Coprocess223562
+Node: Getline/Variable/Coprocess224805
+Node: Getline Notes225519
+Node: Getline Summary227461
+Ref: table-getline-variants227804
+Node: Command line directories228660
+Node: Printing229285
+Node: Print230916
+Node: Print Examples232253
+Node: Output Separators235037
+Node: OFMT236797
+Node: Printf238155
+Node: Basic Printf239061
+Node: Control Letters240600
+Node: Format Modifiers244412
+Node: Printf Examples250421
+Node: Redirection253136
+Node: Special Files260120
+Node: Special FD260653
+Ref: Special FD-Footnote-1264278
+Node: Special Network264352
+Node: Special Caveats265202
+Node: Close Files And Pipes265998
+Ref: Close Files And Pipes-Footnote-1273021
+Ref: Close Files And Pipes-Footnote-2273169
+Node: Expressions273319
+Node: Values274451
+Node: Constants275127
+Node: Scalar Constants275807
+Ref: Scalar Constants-Footnote-1276666
+Node: Nondecimal-numbers276848
+Node: Regexp Constants279907
+Node: Using Constant Regexps280382
+Node: Variables283437
+Node: Using Variables284092
+Node: Assignment Options285816
+Node: Conversion287688
+Ref: table-locale-affects293064
+Ref: Conversion-Footnote-1293688
+Node: All Operators293797
+Node: Arithmetic Ops294427
+Node: Concatenation296932
+Ref: Concatenation-Footnote-1299725
+Node: Assignment Ops299845
+Ref: table-assign-ops304833
+Node: Increment Ops306241
+Node: Truth Values and Conditions309711
+Node: Truth Values310794
+Node: Typing and Comparison311843
+Node: Variable Typing312632
+Ref: Variable Typing-Footnote-1316529
+Node: Comparison Operators316651
+Ref: table-relational-ops317061
+Node: POSIX String Comparison320610
+Ref: POSIX String Comparison-Footnote-1321566
+Node: Boolean Ops321704
+Ref: Boolean Ops-Footnote-1325782
+Node: Conditional Exp325873
+Node: Function Calls327605
+Node: Precedence331199
+Node: Locales334868
+Node: Patterns and Actions335957
+Node: Pattern Overview337011
+Node: Regexp Patterns338680
+Node: Expression Patterns339223
+Node: Ranges342908
+Node: BEGIN/END345874
+Node: Using BEGIN/END346636
+Ref: Using BEGIN/END-Footnote-1349367
+Node: I/O And BEGIN/END349473
+Node: BEGINFILE/ENDFILE351755
+Node: Empty354648
+Node: Using Shell Variables354964
+Node: Action Overview357249
+Node: Statements359606
+Node: If Statement361460
+Node: While Statement362959
+Node: Do Statement365003
+Node: For Statement366159
+Node: Switch Statement369311
+Node: Break Statement371408
+Node: Continue Statement373398
+Node: Next Statement375191
+Node: Nextfile Statement377581
+Node: Exit Statement380126
+Node: Built-in Variables382542
+Node: User-modified383637
+Ref: User-modified-Footnote-1391663
+Node: Auto-set391725
+Ref: Auto-set-Footnote-1401016
+Node: ARGC and ARGV401221
+Node: Arrays405072
+Node: Array Basics406577
+Node: Array Intro407403
+Node: Reference to Elements411721
+Node: Assigning Elements413991
+Node: Array Example414482
+Node: Scanning an Array416214
+Node: Controlling Scanning418528
+Ref: Controlling Scanning-Footnote-1423461
+Node: Delete423777
+Ref: Delete-Footnote-1426212
+Node: Numeric Array Subscripts426269
+Node: Uninitialized Subscripts428452
+Node: Multi-dimensional430080
+Node: Multi-scanning433174
+Node: Arrays of Arrays434765
+Node: Functions439410
+Node: Built-in440232
+Node: Calling Built-in441310
+Node: Numeric Functions443298
+Ref: Numeric Functions-Footnote-1447130
+Ref: Numeric Functions-Footnote-2447487
+Ref: Numeric Functions-Footnote-3447535
+Node: String Functions447804
+Ref: String Functions-Footnote-1471301
+Ref: String Functions-Footnote-2471430
+Ref: String Functions-Footnote-3471678
+Node: Gory Details471765
+Ref: table-sub-escapes473444
+Ref: table-sub-posix-92474798
+Ref: table-sub-proposed476141
+Ref: table-posix-sub477491
+Ref: table-gensub-escapes479037
+Ref: Gory Details-Footnote-1480244
+Ref: Gory Details-Footnote-2480295
+Node: I/O Functions480446
+Ref: I/O Functions-Footnote-1487101
+Node: Time Functions487248
+Ref: Time Functions-Footnote-1498140
+Ref: Time Functions-Footnote-2498208
+Ref: Time Functions-Footnote-3498366
+Ref: Time Functions-Footnote-4498477
+Ref: Time Functions-Footnote-5498589
+Ref: Time Functions-Footnote-6498816
+Node: Bitwise Functions499082
+Ref: table-bitwise-ops499640
+Ref: Bitwise Functions-Footnote-1503800
+Node: Type Functions503984
+Node: I18N Functions504454
+Node: User-defined506081
+Node: Definition Syntax506885
+Ref: Definition Syntax-Footnote-1511795
+Node: Function Example511864
+Node: Function Caveats514458
+Node: Calling A Function514879
+Node: Variable Scope515994
+Node: Pass By Value/Reference517969
+Node: Return Statement521409
+Node: Dynamic Typing524390
+Node: Indirect Calls525125
+Node: Internationalization534810
+Node: I18N and L10N536236
+Node: Explaining gettext536922
+Ref: Explaining gettext-Footnote-1541988
+Ref: Explaining gettext-Footnote-2542172
+Node: Programmer i18n542337
+Node: Translator i18n546537
+Node: String Extraction547330
+Ref: String Extraction-Footnote-1548291
+Node: Printf Ordering548377
+Ref: Printf Ordering-Footnote-1551161
+Node: I18N Portability551225
+Ref: I18N Portability-Footnote-1553674
+Node: I18N Example553737
+Ref: I18N Example-Footnote-1556372
+Node: Gawk I18N556444
+Node: Advanced Features557061
+Node: Nondecimal Data558574
+Node: Array Sorting560157
+Node: Controlling Array Traversal560854
+Node: Array Sorting Functions569091
+Ref: Array Sorting Functions-Footnote-1572765
+Ref: Array Sorting Functions-Footnote-2572858
+Node: Two-way I/O573052
+Ref: Two-way I/O-Footnote-1578484
+Node: TCP/IP Networking578554
+Node: Profiling581398
+Node: Library Functions588872
+Ref: Library Functions-Footnote-1591879
+Node: Library Names592050
+Ref: Library Names-Footnote-1595521
+Ref: Library Names-Footnote-2595741
+Node: General Functions595827
+Node: Strtonum Function596780
+Node: Assert Function599710
+Node: Round Function603036
+Node: Cliff Random Function604579
+Node: Ordinal Functions605595
+Ref: Ordinal Functions-Footnote-1608665
+Ref: Ordinal Functions-Footnote-2608917
+Node: Join Function609126
+Ref: Join Function-Footnote-1610897
+Node: Gettimeofday Function611097
+Node: Data File Management614812
+Node: Filetrans Function615444
+Node: Rewind Function619583
+Node: File Checking620970
+Node: Empty Files622064
+Node: Ignoring Assigns624294
+Node: Getopt Function625847
+Ref: Getopt Function-Footnote-1637151
+Node: Passwd Functions637354
+Ref: Passwd Functions-Footnote-1646329
+Node: Group Functions646417
+Node: Walking Arrays654501
+Node: Sample Programs656070
+Node: Running Examples656735
+Node: Clones657463
+Node: Cut Program658687
+Node: Egrep Program668532
+Ref: Egrep Program-Footnote-1676305
+Node: Id Program676415
+Node: Split Program680031
+Ref: Split Program-Footnote-1683550
+Node: Tee Program683678
+Node: Uniq Program686481
+Node: Wc Program693910
+Ref: Wc Program-Footnote-1698176
+Ref: Wc Program-Footnote-2698376
+Node: Miscellaneous Programs698468
+Node: Dupword Program699656
+Node: Alarm Program701687
+Node: Translate Program706436
+Ref: Translate Program-Footnote-1710823
+Ref: Translate Program-Footnote-2711051
+Node: Labels Program711185
+Ref: Labels Program-Footnote-1714556
+Node: Word Sorting714640
+Node: History Sorting718524
+Node: Extract Program720363
+Ref: Extract Program-Footnote-1727846
+Node: Simple Sed727974
+Node: Igawk Program731036
+Ref: Igawk Program-Footnote-1746193
+Ref: Igawk Program-Footnote-2746394
+Node: Anagram Program746532
+Node: Signature Program749600
+Node: Debugger750700
+Node: Debugging751611
+Node: Debugging Concepts752024
+Node: Debugging Terms753880
+Node: Awk Debugging756503
+Node: Sample dgawk session757395
+Node: dgawk invocation757887
+Node: Finding The Bug759069
+Node: List of Debugger Commands765555
+Node: Breakpoint Control766866
+Node: Dgawk Execution Control770502
+Node: Viewing And Changing Data773853
+Node: Dgawk Stack777190
+Node: Dgawk Info778650
+Node: Miscellaneous Dgawk Commands782598
+Node: Readline Support788026
+Node: Dgawk Limitations788864
+Node: Language History791053
+Node: V7/SVR3.1792565
+Node: SVR4794886
+Node: POSIX796328
+Node: BTL797336
+Node: POSIX/GNU798070
+Node: Common Extensions803221
+Node: Ranges and Locales804328
+Ref: Ranges and Locales-Footnote-1808932
+Node: Contributors809153
+Node: Installation813415
+Node: Gawk Distribution814309
+Node: Getting814793
+Node: Extracting815619
+Node: Distribution contents817311
+Node: Unix Installation822533
+Node: Quick Installation823150
+Node: Additional Configuration Options825112
+Node: Configuration Philosophy826589
+Node: Non-Unix Installation828931
+Node: PC Installation829389
+Node: PC Binary Installation830688
+Node: PC Compiling832536
+Node: PC Testing835480
+Node: PC Using836656
+Node: Cygwin840841
+Node: MSYS841841
+Node: VMS Installation842355
+Node: VMS Compilation842958
+Ref: VMS Compilation-Footnote-1843965
+Node: VMS Installation Details844023
+Node: VMS Running845658
+Node: VMS Old Gawk847265
+Node: Bugs847739
+Node: Other Versions851591
+Node: Notes856872
+Node: Compatibility Mode857564
+Node: Additions858347
+Node: Accessing The Source859159
+Node: Adding Code860584
+Node: New Ports866551
+Node: Dynamic Extensions870664
+Node: Internals872040
+Node: Plugin License881143
+Node: Sample Library881777
+Node: Internal File Description882463
+Node: Internal File Ops886178
+Ref: Internal File Ops-Footnote-1890959
+Node: Using Internal File Ops891099
+Node: Future Extensions893476
+Node: Basic Concepts895980
+Node: Basic High Level896737
+Ref: Basic High Level-Footnote-1900772
+Node: Basic Data Typing900957
+Node: Floating Point Issues905482
+Node: String Conversion Precision906565
+Ref: String Conversion Precision-Footnote-1908265
+Node: Unexpected Results908374
+Node: POSIX Floating Point Problems910200
+Ref: POSIX Floating Point Problems-Footnote-1913905
+Node: Glossary913943
+Node: Copying938919
+Node: GNU Free Documentation License976476
+Node: Index1001613

End Tag Table
diff --git a/doc/gawk.texi b/doc/gawk.texi
index 83bd3b5d..b22f7ced 100644
--- a/doc/gawk.texi
+++ b/doc/gawk.texi
@@ -3055,6 +3055,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