diff options
author | Arnold D. Robbins <arnold@skeeve.com> | 2012-04-27 12:20:02 +0300 |
---|---|---|
committer | Arnold D. Robbins <arnold@skeeve.com> | 2012-04-27 12:20:02 +0300 |
commit | a7fe78d7a2ce2000837350ee4fa0e7ab70b2a9bc (patch) | |
tree | a28a59907310dd75f3f28d98e75865dc2c248e66 | |
parent | 2ee1a96b398f3bd183a84509464770153a8890d4 (diff) | |
download | egawk-a7fe78d7a2ce2000837350ee4fa0e7ab70b2a9bc.tar.gz egawk-a7fe78d7a2ce2000837350ee4fa0e7ab70b2a9bc.tar.bz2 egawk-a7fe78d7a2ce2000837350ee4fa0e7ab70b2a9bc.zip |
Update doc on -b.
-rw-r--r-- | doc/ChangeLog | 4 | ||||
-rw-r--r-- | doc/gawk.info | 891 | ||||
-rw-r--r-- | doc/gawk.texi | 3 |
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 |