diff options
| -rw-r--r-- | doc/ChangeLog | 4 | ||||
| -rw-r--r-- | doc/gawk.info | 1037 | ||||
| -rw-r--r-- | doc/gawk.texi | 25 | ||||
| -rw-r--r-- | doc/gawktexi.in | 2 |
4 files changed, 560 insertions, 508 deletions
diff --git a/doc/ChangeLog b/doc/ChangeLog index d06f5632..709992f8 100644 --- a/doc/ChangeLog +++ b/doc/ChangeLog @@ -1,3 +1,7 @@ +2016-07-18 Arnold D. Robbins <arnold@skeeve.com> + + * gawktexi.in: Fix a typo. Thanks to Antonio Colombo for reporting. + 2016-07-17 Arnold D. Robbins <arnold@skeeve.com> * gawktexi.in: Document GAWK_LOCALE_DIR env var and also to not diff --git a/doc/gawk.info b/doc/gawk.info index fab22030..f4759a08 100644 --- a/doc/gawk.info +++ b/doc/gawk.info @@ -3035,6 +3035,11 @@ change. The variables are: source of a message, as there are multiple places that produce the same warning or error message. +'GAWK_LOCALE_DIR' + Specifies the location of compiled message object files for 'gawk' + itself. This is passed to the 'bindtextdomain()' function when + 'gawk' starts up. + 'GAWK_NO_DFA' If this variable exists, 'gawk' does not use the DFA regexp matcher for "does it match" kinds of tests. This can cause 'gawk' to be @@ -20248,6 +20253,23 @@ are: 'LC_ALL' All of the above. (Not too useful in the context of 'gettext'.) + NOTE: As described in *note Locales::, environment variables with + the same name as the locale categories ('LC_CTYPE', 'LC_ALL', etc.) + influence 'gawk''s behavior (and that of other utilities). + + Normally, these variables also affect how the 'gettext' library + finds translations. However, the 'LANGUAGE' environment variable + overrides the 'LC_XXX' variables. Many GNU/Linux systems may + define this variable without your knowledge, causing 'gawk' to not + find the correct translations. If this happens to you, look to see + if 'LANGUAGE' is defined, and if so, use the shell's 'unset' + command to remove it. + + For testing translations of 'gawk' itself, you can set the +'GAWK_LOCALE_DIR' environment variable. See the documentation for the C +'bindtextdomain()' function and also see *note Other Environment +Variables::. + ---------- Footnotes ---------- (1) For some operating systems, the 'gawk' port doesn't support GNU @@ -33468,6 +33490,7 @@ Index (line 75) * labels.awk program: Labels Program. (line 51) * Langston, Peter: Advanced Features. (line 6) +* LANGUAGE environment variable: Explaining gettext. (line 120) * languages, data-driven: Basic High Level. (line 74) * LC_ALL locale category: Explaining gettext. (line 117) * LC_COLLATE locale category: Explaining gettext. (line 94) @@ -34737,512 +34760,512 @@ Ref: AWKPATH Variable-Footnote-1140119 Ref: AWKPATH Variable-Footnote-2140164 Node: AWKLIBPATH Variable140425 Node: Other Environment Variables141569 -Node: Exit Status145334 -Node: Include Files146011 -Node: Loading Shared Libraries149606 -Node: Obsolete151034 -Node: Undocumented151726 -Node: Invoking Summary152023 -Node: Regexp153683 -Node: Regexp Usage155137 -Node: Escape Sequences157174 -Node: Regexp Operators163188 -Ref: Regexp Operators-Footnote-1170604 -Ref: Regexp Operators-Footnote-2170751 -Node: Bracket Expressions170849 -Ref: table-char-classes173325 -Node: Leftmost Longest176462 -Node: Computed Regexps177765 -Node: GNU Regexp Operators181192 -Node: Case-sensitivity184871 -Ref: Case-sensitivity-Footnote-1187758 -Ref: Case-sensitivity-Footnote-2187993 -Node: Regexp Summary188101 -Node: Reading Files189567 -Node: Records191661 -Node: awk split records192394 -Node: gawk split records197325 -Ref: gawk split records-Footnote-1201865 -Node: Fields201902 -Ref: Fields-Footnote-1204682 -Node: Nonconstant Fields204768 -Ref: Nonconstant Fields-Footnote-1207004 -Node: Changing Fields207208 -Node: Field Separators213136 -Node: Default Field Splitting215834 -Node: Regexp Field Splitting216952 -Node: Single Character Fields220305 -Node: Command Line Field Separator221365 -Node: Full Line Fields224583 -Ref: Full Line Fields-Footnote-1226105 -Ref: Full Line Fields-Footnote-2226151 -Node: Field Splitting Summary226252 -Node: Constant Size228326 -Node: Splitting By Content232904 -Ref: Splitting By Content-Footnote-1236875 -Node: Multiple Line237038 -Ref: Multiple Line-Footnote-1242920 -Node: Getline243099 -Node: Plain Getline245303 -Node: Getline/Variable247942 -Node: Getline/File249091 -Node: Getline/Variable/File250477 -Ref: Getline/Variable/File-Footnote-1252080 -Node: Getline/Pipe252168 -Node: Getline/Variable/Pipe254873 -Node: Getline/Coprocess256006 -Node: Getline/Variable/Coprocess257271 -Node: Getline Notes258011 -Node: Getline Summary260806 -Ref: table-getline-variants261228 -Node: Read Timeout261976 -Ref: Read Timeout-Footnote-1265817 -Node: Command-line directories265875 -Node: Input Summary266779 -Node: Input Exercises269951 -Node: Printing270679 -Node: Print272455 -Node: Print Examples273912 -Node: Output Separators276692 -Node: OFMT278709 -Node: Printf280065 -Node: Basic Printf280850 -Node: Control Letters282424 -Node: Format Modifiers286412 -Node: Printf Examples292427 -Node: Redirection294913 -Node: Special FD301754 -Ref: Special FD-Footnote-1304922 -Node: Special Files304996 -Node: Other Inherited Files305613 -Node: Special Network306614 -Node: Special Caveats307474 -Node: Close Files And Pipes308423 -Ref: Close Files And Pipes-Footnote-1315616 -Ref: Close Files And Pipes-Footnote-2315764 -Node: Output Summary315915 -Node: Output Exercises316913 -Node: Expressions317592 -Node: Values318780 -Node: Constants319458 -Node: Scalar Constants320149 -Ref: Scalar Constants-Footnote-1321013 -Node: Nondecimal-numbers321263 -Node: Regexp Constants324276 -Node: Using Constant Regexps324802 -Node: Variables327965 -Node: Using Variables328622 -Node: Assignment Options330532 -Node: Conversion332405 -Node: Strings And Numbers332929 -Ref: Strings And Numbers-Footnote-1335992 -Node: Locale influences conversions336101 -Ref: table-locale-affects338859 -Node: All Operators339477 -Node: Arithmetic Ops340106 -Node: Concatenation342612 -Ref: Concatenation-Footnote-1345459 -Node: Assignment Ops345566 -Ref: table-assign-ops350557 -Node: Increment Ops351870 -Node: Truth Values and Conditions355330 -Node: Truth Values356404 -Node: Typing and Comparison357452 -Node: Variable Typing358272 -Node: Comparison Operators361896 -Ref: table-relational-ops362315 -Node: POSIX String Comparison365810 -Ref: POSIX String Comparison-Footnote-1366884 -Node: Boolean Ops367023 -Ref: Boolean Ops-Footnote-1371505 -Node: Conditional Exp371597 -Node: Function Calls373333 -Node: Precedence377210 -Node: Locales380869 -Node: Expressions Summary382501 -Node: Patterns and Actions385074 -Node: Pattern Overview386194 -Node: Regexp Patterns387871 -Node: Expression Patterns388413 -Node: Ranges392194 -Node: BEGIN/END395302 -Node: Using BEGIN/END396063 -Ref: Using BEGIN/END-Footnote-1398799 -Node: I/O And BEGIN/END398905 -Node: BEGINFILE/ENDFILE401219 -Node: Empty404126 -Node: Using Shell Variables404443 -Node: Action Overview406717 -Node: Statements409042 -Node: If Statement410890 -Node: While Statement412385 -Node: Do Statement414413 -Node: For Statement415561 -Node: Switch Statement418719 -Node: Break Statement421105 -Node: Continue Statement423197 -Node: Next Statement425024 -Node: Nextfile Statement427407 -Node: Exit Statement430059 -Node: Built-in Variables432462 -Node: User-modified433595 -Ref: User-modified-Footnote-1441220 -Node: Auto-set441282 -Ref: Auto-set-Footnote-1454638 -Ref: Auto-set-Footnote-2454844 -Node: ARGC and ARGV454900 -Node: Pattern Action Summary459113 -Node: Arrays461543 -Node: Array Basics462872 -Node: Array Intro463716 -Ref: figure-array-elements465691 -Ref: Array Intro-Footnote-1468395 -Node: Reference to Elements468523 -Node: Assigning Elements470987 -Node: Array Example471478 -Node: Scanning an Array473237 -Node: Controlling Scanning476259 -Ref: Controlling Scanning-Footnote-1481658 -Node: Numeric Array Subscripts481974 -Node: Uninitialized Subscripts484158 -Node: Delete485777 -Ref: Delete-Footnote-1488529 -Node: Multidimensional488586 -Node: Multiscanning491681 -Node: Arrays of Arrays493272 -Node: Arrays Summary498039 -Node: Functions500132 -Node: Built-in501170 -Node: Calling Built-in502251 -Node: Numeric Functions504247 -Ref: Numeric Functions-Footnote-1508275 -Ref: Numeric Functions-Footnote-2508632 -Ref: Numeric Functions-Footnote-3508680 -Node: String Functions508952 -Ref: String Functions-Footnote-1532456 -Ref: String Functions-Footnote-2532584 -Ref: String Functions-Footnote-3532832 -Node: Gory Details532919 -Ref: table-sub-escapes534710 -Ref: table-sub-proposed536229 -Ref: table-posix-sub537592 -Ref: table-gensub-escapes539133 -Ref: Gory Details-Footnote-1539956 -Node: I/O Functions540110 -Ref: table-system-return-values546692 -Ref: I/O Functions-Footnote-1548672 -Ref: I/O Functions-Footnote-2548820 -Node: Time Functions548940 -Ref: Time Functions-Footnote-1559445 -Ref: Time Functions-Footnote-2559513 -Ref: Time Functions-Footnote-3559671 -Ref: Time Functions-Footnote-4559782 -Ref: Time Functions-Footnote-5559894 -Ref: Time Functions-Footnote-6560121 -Node: Bitwise Functions560387 -Ref: table-bitwise-ops560981 -Ref: Bitwise Functions-Footnote-1565319 -Node: Type Functions565492 -Node: I18N Functions566648 -Node: User-defined568299 -Node: Definition Syntax569104 -Ref: Definition Syntax-Footnote-1574791 -Node: Function Example574862 -Ref: Function Example-Footnote-1577784 -Node: Function Caveats577806 -Node: Calling A Function578324 -Node: Variable Scope579282 -Node: Pass By Value/Reference582276 -Node: Return Statement585775 -Node: Dynamic Typing588754 -Node: Indirect Calls589684 -Ref: Indirect Calls-Footnote-1599935 -Node: Functions Summary600063 -Node: Library Functions602768 -Ref: Library Functions-Footnote-1606375 -Ref: Library Functions-Footnote-2606518 -Node: Library Names606689 -Ref: Library Names-Footnote-1610149 -Ref: Library Names-Footnote-2610372 -Node: General Functions610458 -Node: Strtonum Function611561 -Node: Assert Function614583 -Node: Round Function617909 -Node: Cliff Random Function619450 -Node: Ordinal Functions620466 -Ref: Ordinal Functions-Footnote-1623529 -Ref: Ordinal Functions-Footnote-2623781 -Node: Join Function623991 -Ref: Join Function-Footnote-1625761 -Node: Getlocaltime Function625961 -Node: Readfile Function629703 -Node: Shell Quoting631675 -Node: Data File Management633076 -Node: Filetrans Function633708 -Node: Rewind Function637804 -Node: File Checking639709 -Ref: File Checking-Footnote-1641043 -Node: Empty Files641244 -Node: Ignoring Assigns643223 -Node: Getopt Function644773 -Ref: Getopt Function-Footnote-1656242 -Node: Passwd Functions656442 -Ref: Passwd Functions-Footnote-1665281 -Node: Group Functions665369 -Ref: Group Functions-Footnote-1673266 -Node: Walking Arrays673473 -Node: Library Functions Summary676481 -Node: Library Exercises677887 -Node: Sample Programs678352 -Node: Running Examples679122 -Node: Clones679850 -Node: Cut Program681074 -Node: Egrep Program691003 -Ref: Egrep Program-Footnote-1698515 -Node: Id Program698625 -Node: Split Program702305 -Ref: Split Program-Footnote-1705764 -Node: Tee Program705893 -Node: Uniq Program708683 -Node: Wc Program716109 -Ref: Wc Program-Footnote-1720364 -Node: Miscellaneous Programs720458 -Node: Dupword Program721671 -Node: Alarm Program723701 -Node: Translate Program728556 -Ref: Translate Program-Footnote-1733121 -Node: Labels Program733391 -Ref: Labels Program-Footnote-1736742 -Node: Word Sorting736826 -Node: History Sorting740898 -Node: Extract Program742733 -Node: Simple Sed750262 -Node: Igawk Program753336 -Ref: Igawk Program-Footnote-1767667 -Ref: Igawk Program-Footnote-2767869 -Ref: Igawk Program-Footnote-3767991 -Node: Anagram Program768106 -Node: Signature Program771168 -Node: Programs Summary772415 -Node: Programs Exercises773629 -Ref: Programs Exercises-Footnote-1777758 -Node: Advanced Features777849 -Node: Nondecimal Data779839 -Node: Array Sorting781430 -Node: Controlling Array Traversal782130 -Ref: Controlling Array Traversal-Footnote-1790497 -Node: Array Sorting Functions790615 -Ref: Array Sorting Functions-Footnote-1795706 -Node: Two-way I/O795902 -Ref: Two-way I/O-Footnote-1802196 -Ref: Two-way I/O-Footnote-2802383 -Node: TCP/IP Networking802465 -Node: Profiling805583 -Node: Advanced Features Summary813122 -Node: Internationalization815058 -Node: I18N and L10N816538 -Node: Explaining gettext817225 -Ref: Explaining gettext-Footnote-1822248 -Ref: Explaining gettext-Footnote-2822433 -Node: Programmer i18n822598 -Ref: Programmer i18n-Footnote-1827453 -Node: Translator i18n827502 -Node: String Extraction828296 -Ref: String Extraction-Footnote-1829428 -Node: Printf Ordering829514 -Ref: Printf Ordering-Footnote-1832300 -Node: I18N Portability832364 -Ref: I18N Portability-Footnote-1834820 -Node: I18N Example834883 -Ref: I18N Example-Footnote-1837689 -Node: Gawk I18N837762 -Node: I18N Summary838407 -Node: Debugger839748 -Node: Debugging840770 -Node: Debugging Concepts841211 -Node: Debugging Terms843020 -Node: Awk Debugging845595 -Node: Sample Debugging Session846501 -Node: Debugger Invocation847035 -Node: Finding The Bug848421 -Node: List of Debugger Commands854899 -Node: Breakpoint Control856232 -Node: Debugger Execution Control859926 -Node: Viewing And Changing Data863288 -Node: Execution Stack866662 -Node: Debugger Info868299 -Node: Miscellaneous Debugger Commands872370 -Node: Readline Support877458 -Node: Limitations878354 -Node: Debugging Summary880463 -Node: Arbitrary Precision Arithmetic881636 -Node: Computer Arithmetic883052 -Ref: table-numeric-ranges886643 -Ref: Computer Arithmetic-Footnote-1887365 -Node: Math Definitions887422 -Ref: table-ieee-formats890736 -Ref: Math Definitions-Footnote-1891339 -Node: MPFR features891444 -Node: FP Math Caution893161 -Ref: FP Math Caution-Footnote-1894233 -Node: Inexactness of computations894602 -Node: Inexact representation895562 -Node: Comparing FP Values896922 -Node: Errors accumulate898004 -Node: Getting Accuracy899437 -Node: Try To Round902147 -Node: Setting precision903046 -Ref: table-predefined-precision-strings903743 -Node: Setting the rounding mode905573 -Ref: table-gawk-rounding-modes905947 -Ref: Setting the rounding mode-Footnote-1909355 -Node: Arbitrary Precision Integers909534 -Ref: Arbitrary Precision Integers-Footnote-1912518 -Node: POSIX Floating Point Problems912667 -Ref: POSIX Floating Point Problems-Footnote-1916549 -Node: Floating point summary916587 -Node: Dynamic Extensions918777 -Node: Extension Intro920330 -Node: Plugin License921596 -Node: Extension Mechanism Outline922393 -Ref: figure-load-extension922832 -Ref: figure-register-new-function924397 -Ref: figure-call-new-function925489 -Node: Extension API Description927551 -Node: Extension API Functions Introduction928999 -Node: General Data Types933811 -Ref: General Data Types-Footnote-1939766 -Node: Memory Allocation Functions940065 -Ref: Memory Allocation Functions-Footnote-1942910 -Node: Constructor Functions943009 -Node: Registration Functions944754 -Node: Extension Functions945439 -Node: Exit Callback Functions947738 -Node: Extension Version String948988 -Node: Input Parsers949651 -Node: Output Wrappers959533 -Node: Two-way processors964045 -Node: Printing Messages966310 -Ref: Printing Messages-Footnote-1967384 -Node: Updating ERRNO967537 -Node: Requesting Values968276 -Ref: table-value-types-returned969013 -Node: Accessing Parameters969896 -Node: Symbol Table Access971131 -Node: Symbol table by name971643 -Node: Symbol table by cookie973664 -Ref: Symbol table by cookie-Footnote-1977816 -Node: Cached values977880 -Ref: Cached values-Footnote-1981387 -Node: Array Manipulation981478 -Ref: Array Manipulation-Footnote-1982577 -Node: Array Data Types982614 -Ref: Array Data Types-Footnote-1985272 -Node: Array Functions985364 -Node: Flattening Arrays989222 -Node: Creating Arrays996130 -Node: Extension API Variables1000899 -Node: Extension Versioning1001535 -Ref: gawk-api-version1001972 -Node: Extension API Informational Variables1003728 -Node: Extension API Boilerplate1004792 -Node: Finding Extensions1008606 -Node: Extension Example1009165 -Node: Internal File Description1009963 -Node: Internal File Ops1014043 -Ref: Internal File Ops-Footnote-11025805 -Node: Using Internal File Ops1025945 -Ref: Using Internal File Ops-Footnote-11028328 -Node: Extension Samples1028602 -Node: Extension Sample File Functions1030131 -Node: Extension Sample Fnmatch1037780 -Node: Extension Sample Fork1039267 -Node: Extension Sample Inplace1040485 -Node: Extension Sample Ord1043695 -Node: Extension Sample Readdir1044531 -Ref: table-readdir-file-types1045420 -Node: Extension Sample Revout1046225 -Node: Extension Sample Rev2way1046814 -Node: Extension Sample Read write array1047554 -Node: Extension Sample Readfile1049496 -Node: Extension Sample Time1050591 -Node: Extension Sample API Tests1051939 -Node: gawkextlib1052431 -Node: Extension summary1054855 -Node: Extension Exercises1058547 -Node: Language History1060044 -Node: V7/SVR3.11061700 -Node: SVR41063852 -Node: POSIX1065286 -Node: BTL1066665 -Node: POSIX/GNU1067394 -Node: Feature History1072915 -Node: Common Extensions1086244 -Node: Ranges and Locales1087527 -Ref: Ranges and Locales-Footnote-11092143 -Ref: Ranges and Locales-Footnote-21092170 -Ref: Ranges and Locales-Footnote-31092405 -Node: Contributors1092626 -Node: History summary1098195 -Node: Installation1099575 -Node: Gawk Distribution1100519 -Node: Getting1101003 -Node: Extracting1101964 -Node: Distribution contents1103602 -Node: Unix Installation1109353 -Node: Quick Installation1109969 -Node: Additional Configuration Options1112396 -Node: Configuration Philosophy1114200 -Node: Non-Unix Installation1116569 -Node: PC Installation1117027 -Node: PC Binary Installation1118347 -Node: PC Compiling1120199 -Ref: PC Compiling-Footnote-11123223 -Node: PC Testing1123332 -Node: PC Using1124512 -Node: Cygwin1128626 -Node: MSYS1129396 -Node: VMS Installation1129897 -Node: VMS Compilation1130688 -Ref: VMS Compilation-Footnote-11131917 -Node: VMS Dynamic Extensions1131975 -Node: VMS Installation Details1133660 -Node: VMS Running1135913 -Node: VMS GNV1140192 -Node: VMS Old Gawk1140927 -Node: Bugs1141398 -Node: Other Versions1145595 -Node: Installation summary1152179 -Node: Notes1153237 -Node: Compatibility Mode1154102 -Node: Additions1154884 -Node: Accessing The Source1155809 -Node: Adding Code1157244 -Node: New Ports1163463 -Node: Derived Files1167951 -Ref: Derived Files-Footnote-11173436 -Ref: Derived Files-Footnote-21173471 -Ref: Derived Files-Footnote-31174069 -Node: Future Extensions1174183 -Node: Implementation Limitations1174841 -Node: Extension Design1176024 -Node: Old Extension Problems1177178 -Ref: Old Extension Problems-Footnote-11178696 -Node: Extension New Mechanism Goals1178753 -Ref: Extension New Mechanism Goals-Footnote-11182117 -Node: Extension Other Design Decisions1182306 -Node: Extension Future Growth1184419 -Node: Old Extension Mechanism1185255 -Node: Notes summary1187018 -Node: Basic Concepts1188200 -Node: Basic High Level1188881 -Ref: figure-general-flow1189163 -Ref: figure-process-flow1189848 -Ref: Basic High Level-Footnote-11193149 -Node: Basic Data Typing1193334 -Node: Glossary1196662 -Node: Copying1228608 -Node: GNU Free Documentation License1266147 -Node: Index1291265 +Node: Exit Status145517 +Node: Include Files146194 +Node: Loading Shared Libraries149789 +Node: Obsolete151217 +Node: Undocumented151909 +Node: Invoking Summary152206 +Node: Regexp153866 +Node: Regexp Usage155320 +Node: Escape Sequences157357 +Node: Regexp Operators163371 +Ref: Regexp Operators-Footnote-1170787 +Ref: Regexp Operators-Footnote-2170934 +Node: Bracket Expressions171032 +Ref: table-char-classes173508 +Node: Leftmost Longest176645 +Node: Computed Regexps177948 +Node: GNU Regexp Operators181375 +Node: Case-sensitivity185054 +Ref: Case-sensitivity-Footnote-1187941 +Ref: Case-sensitivity-Footnote-2188176 +Node: Regexp Summary188284 +Node: Reading Files189750 +Node: Records191844 +Node: awk split records192577 +Node: gawk split records197508 +Ref: gawk split records-Footnote-1202048 +Node: Fields202085 +Ref: Fields-Footnote-1204865 +Node: Nonconstant Fields204951 +Ref: Nonconstant Fields-Footnote-1207187 +Node: Changing Fields207391 +Node: Field Separators213319 +Node: Default Field Splitting216017 +Node: Regexp Field Splitting217135 +Node: Single Character Fields220488 +Node: Command Line Field Separator221548 +Node: Full Line Fields224766 +Ref: Full Line Fields-Footnote-1226288 +Ref: Full Line Fields-Footnote-2226334 +Node: Field Splitting Summary226435 +Node: Constant Size228509 +Node: Splitting By Content233087 +Ref: Splitting By Content-Footnote-1237058 +Node: Multiple Line237221 +Ref: Multiple Line-Footnote-1243103 +Node: Getline243282 +Node: Plain Getline245486 +Node: Getline/Variable248125 +Node: Getline/File249274 +Node: Getline/Variable/File250660 +Ref: Getline/Variable/File-Footnote-1252263 +Node: Getline/Pipe252351 +Node: Getline/Variable/Pipe255056 +Node: Getline/Coprocess256189 +Node: Getline/Variable/Coprocess257454 +Node: Getline Notes258194 +Node: Getline Summary260989 +Ref: table-getline-variants261411 +Node: Read Timeout262159 +Ref: Read Timeout-Footnote-1266000 +Node: Command-line directories266058 +Node: Input Summary266962 +Node: Input Exercises270134 +Node: Printing270862 +Node: Print272638 +Node: Print Examples274095 +Node: Output Separators276875 +Node: OFMT278892 +Node: Printf280248 +Node: Basic Printf281033 +Node: Control Letters282607 +Node: Format Modifiers286595 +Node: Printf Examples292610 +Node: Redirection295096 +Node: Special FD301937 +Ref: Special FD-Footnote-1305105 +Node: Special Files305179 +Node: Other Inherited Files305796 +Node: Special Network306797 +Node: Special Caveats307657 +Node: Close Files And Pipes308606 +Ref: Close Files And Pipes-Footnote-1315799 +Ref: Close Files And Pipes-Footnote-2315947 +Node: Output Summary316098 +Node: Output Exercises317096 +Node: Expressions317775 +Node: Values318963 +Node: Constants319641 +Node: Scalar Constants320332 +Ref: Scalar Constants-Footnote-1321196 +Node: Nondecimal-numbers321446 +Node: Regexp Constants324459 +Node: Using Constant Regexps324985 +Node: Variables328148 +Node: Using Variables328805 +Node: Assignment Options330715 +Node: Conversion332588 +Node: Strings And Numbers333112 +Ref: Strings And Numbers-Footnote-1336175 +Node: Locale influences conversions336284 +Ref: table-locale-affects339042 +Node: All Operators339660 +Node: Arithmetic Ops340289 +Node: Concatenation342795 +Ref: Concatenation-Footnote-1345642 +Node: Assignment Ops345749 +Ref: table-assign-ops350740 +Node: Increment Ops352053 +Node: Truth Values and Conditions355513 +Node: Truth Values356587 +Node: Typing and Comparison357635 +Node: Variable Typing358455 +Node: Comparison Operators362079 +Ref: table-relational-ops362498 +Node: POSIX String Comparison365993 +Ref: POSIX String Comparison-Footnote-1367067 +Node: Boolean Ops367206 +Ref: Boolean Ops-Footnote-1371688 +Node: Conditional Exp371780 +Node: Function Calls373516 +Node: Precedence377393 +Node: Locales381052 +Node: Expressions Summary382684 +Node: Patterns and Actions385257 +Node: Pattern Overview386377 +Node: Regexp Patterns388054 +Node: Expression Patterns388596 +Node: Ranges392377 +Node: BEGIN/END395485 +Node: Using BEGIN/END396246 +Ref: Using BEGIN/END-Footnote-1398982 +Node: I/O And BEGIN/END399088 +Node: BEGINFILE/ENDFILE401402 +Node: Empty404309 +Node: Using Shell Variables404626 +Node: Action Overview406900 +Node: Statements409225 +Node: If Statement411073 +Node: While Statement412568 +Node: Do Statement414596 +Node: For Statement415744 +Node: Switch Statement418902 +Node: Break Statement421288 +Node: Continue Statement423380 +Node: Next Statement425207 +Node: Nextfile Statement427590 +Node: Exit Statement430242 +Node: Built-in Variables432645 +Node: User-modified433778 +Ref: User-modified-Footnote-1441403 +Node: Auto-set441465 +Ref: Auto-set-Footnote-1454821 +Ref: Auto-set-Footnote-2455027 +Node: ARGC and ARGV455083 +Node: Pattern Action Summary459296 +Node: Arrays461726 +Node: Array Basics463055 +Node: Array Intro463899 +Ref: figure-array-elements465874 +Ref: Array Intro-Footnote-1468578 +Node: Reference to Elements468706 +Node: Assigning Elements471170 +Node: Array Example471661 +Node: Scanning an Array473420 +Node: Controlling Scanning476442 +Ref: Controlling Scanning-Footnote-1481841 +Node: Numeric Array Subscripts482157 +Node: Uninitialized Subscripts484341 +Node: Delete485960 +Ref: Delete-Footnote-1488712 +Node: Multidimensional488769 +Node: Multiscanning491864 +Node: Arrays of Arrays493455 +Node: Arrays Summary498222 +Node: Functions500315 +Node: Built-in501353 +Node: Calling Built-in502434 +Node: Numeric Functions504430 +Ref: Numeric Functions-Footnote-1508458 +Ref: Numeric Functions-Footnote-2508815 +Ref: Numeric Functions-Footnote-3508863 +Node: String Functions509135 +Ref: String Functions-Footnote-1532639 +Ref: String Functions-Footnote-2532767 +Ref: String Functions-Footnote-3533015 +Node: Gory Details533102 +Ref: table-sub-escapes534893 +Ref: table-sub-proposed536412 +Ref: table-posix-sub537775 +Ref: table-gensub-escapes539316 +Ref: Gory Details-Footnote-1540139 +Node: I/O Functions540293 +Ref: table-system-return-values546875 +Ref: I/O Functions-Footnote-1548855 +Ref: I/O Functions-Footnote-2549003 +Node: Time Functions549123 +Ref: Time Functions-Footnote-1559628 +Ref: Time Functions-Footnote-2559696 +Ref: Time Functions-Footnote-3559854 +Ref: Time Functions-Footnote-4559965 +Ref: Time Functions-Footnote-5560077 +Ref: Time Functions-Footnote-6560304 +Node: Bitwise Functions560570 +Ref: table-bitwise-ops561164 +Ref: Bitwise Functions-Footnote-1565502 +Node: Type Functions565675 +Node: I18N Functions566831 +Node: User-defined568482 +Node: Definition Syntax569287 +Ref: Definition Syntax-Footnote-1574974 +Node: Function Example575045 +Ref: Function Example-Footnote-1577967 +Node: Function Caveats577989 +Node: Calling A Function578507 +Node: Variable Scope579465 +Node: Pass By Value/Reference582459 +Node: Return Statement585958 +Node: Dynamic Typing588937 +Node: Indirect Calls589867 +Ref: Indirect Calls-Footnote-1600118 +Node: Functions Summary600246 +Node: Library Functions602951 +Ref: Library Functions-Footnote-1606558 +Ref: Library Functions-Footnote-2606701 +Node: Library Names606872 +Ref: Library Names-Footnote-1610332 +Ref: Library Names-Footnote-2610555 +Node: General Functions610641 +Node: Strtonum Function611744 +Node: Assert Function614766 +Node: Round Function618092 +Node: Cliff Random Function619633 +Node: Ordinal Functions620649 +Ref: Ordinal Functions-Footnote-1623712 +Ref: Ordinal Functions-Footnote-2623964 +Node: Join Function624174 +Ref: Join Function-Footnote-1625944 +Node: Getlocaltime Function626144 +Node: Readfile Function629886 +Node: Shell Quoting631858 +Node: Data File Management633259 +Node: Filetrans Function633891 +Node: Rewind Function637987 +Node: File Checking639892 +Ref: File Checking-Footnote-1641226 +Node: Empty Files641427 +Node: Ignoring Assigns643406 +Node: Getopt Function644956 +Ref: Getopt Function-Footnote-1656425 +Node: Passwd Functions656625 +Ref: Passwd Functions-Footnote-1665464 +Node: Group Functions665552 +Ref: Group Functions-Footnote-1673449 +Node: Walking Arrays673656 +Node: Library Functions Summary676664 +Node: Library Exercises678070 +Node: Sample Programs678535 +Node: Running Examples679305 +Node: Clones680033 +Node: Cut Program681257 +Node: Egrep Program691186 +Ref: Egrep Program-Footnote-1698698 +Node: Id Program698808 +Node: Split Program702488 +Ref: Split Program-Footnote-1705947 +Node: Tee Program706076 +Node: Uniq Program708866 +Node: Wc Program716292 +Ref: Wc Program-Footnote-1720547 +Node: Miscellaneous Programs720641 +Node: Dupword Program721854 +Node: Alarm Program723884 +Node: Translate Program728739 +Ref: Translate Program-Footnote-1733304 +Node: Labels Program733574 +Ref: Labels Program-Footnote-1736925 +Node: Word Sorting737009 +Node: History Sorting741081 +Node: Extract Program742916 +Node: Simple Sed750445 +Node: Igawk Program753519 +Ref: Igawk Program-Footnote-1767850 +Ref: Igawk Program-Footnote-2768052 +Ref: Igawk Program-Footnote-3768174 +Node: Anagram Program768289 +Node: Signature Program771351 +Node: Programs Summary772598 +Node: Programs Exercises773812 +Ref: Programs Exercises-Footnote-1777941 +Node: Advanced Features778032 +Node: Nondecimal Data780022 +Node: Array Sorting781613 +Node: Controlling Array Traversal782313 +Ref: Controlling Array Traversal-Footnote-1790680 +Node: Array Sorting Functions790798 +Ref: Array Sorting Functions-Footnote-1795889 +Node: Two-way I/O796085 +Ref: Two-way I/O-Footnote-1802379 +Ref: Two-way I/O-Footnote-2802566 +Node: TCP/IP Networking802648 +Node: Profiling805766 +Node: Advanced Features Summary813305 +Node: Internationalization815241 +Node: I18N and L10N816721 +Node: Explaining gettext817408 +Ref: Explaining gettext-Footnote-1823300 +Ref: Explaining gettext-Footnote-2823485 +Node: Programmer i18n823650 +Ref: Programmer i18n-Footnote-1828505 +Node: Translator i18n828554 +Node: String Extraction829348 +Ref: String Extraction-Footnote-1830480 +Node: Printf Ordering830566 +Ref: Printf Ordering-Footnote-1833352 +Node: I18N Portability833416 +Ref: I18N Portability-Footnote-1835872 +Node: I18N Example835935 +Ref: I18N Example-Footnote-1838741 +Node: Gawk I18N838814 +Node: I18N Summary839459 +Node: Debugger840800 +Node: Debugging841822 +Node: Debugging Concepts842263 +Node: Debugging Terms844072 +Node: Awk Debugging846647 +Node: Sample Debugging Session847553 +Node: Debugger Invocation848087 +Node: Finding The Bug849473 +Node: List of Debugger Commands855951 +Node: Breakpoint Control857284 +Node: Debugger Execution Control860978 +Node: Viewing And Changing Data864340 +Node: Execution Stack867714 +Node: Debugger Info869351 +Node: Miscellaneous Debugger Commands873422 +Node: Readline Support878510 +Node: Limitations879406 +Node: Debugging Summary881515 +Node: Arbitrary Precision Arithmetic882688 +Node: Computer Arithmetic884104 +Ref: table-numeric-ranges887695 +Ref: Computer Arithmetic-Footnote-1888417 +Node: Math Definitions888474 +Ref: table-ieee-formats891788 +Ref: Math Definitions-Footnote-1892391 +Node: MPFR features892496 +Node: FP Math Caution894213 +Ref: FP Math Caution-Footnote-1895285 +Node: Inexactness of computations895654 +Node: Inexact representation896614 +Node: Comparing FP Values897974 +Node: Errors accumulate899056 +Node: Getting Accuracy900489 +Node: Try To Round903199 +Node: Setting precision904098 +Ref: table-predefined-precision-strings904795 +Node: Setting the rounding mode906625 +Ref: table-gawk-rounding-modes906999 +Ref: Setting the rounding mode-Footnote-1910407 +Node: Arbitrary Precision Integers910586 +Ref: Arbitrary Precision Integers-Footnote-1913570 +Node: POSIX Floating Point Problems913719 +Ref: POSIX Floating Point Problems-Footnote-1917601 +Node: Floating point summary917639 +Node: Dynamic Extensions919829 +Node: Extension Intro921382 +Node: Plugin License922648 +Node: Extension Mechanism Outline923445 +Ref: figure-load-extension923884 +Ref: figure-register-new-function925449 +Ref: figure-call-new-function926541 +Node: Extension API Description928603 +Node: Extension API Functions Introduction930051 +Node: General Data Types934863 +Ref: General Data Types-Footnote-1940818 +Node: Memory Allocation Functions941117 +Ref: Memory Allocation Functions-Footnote-1943962 +Node: Constructor Functions944061 +Node: Registration Functions945806 +Node: Extension Functions946491 +Node: Exit Callback Functions948790 +Node: Extension Version String950040 +Node: Input Parsers950703 +Node: Output Wrappers960585 +Node: Two-way processors965097 +Node: Printing Messages967362 +Ref: Printing Messages-Footnote-1968436 +Node: Updating ERRNO968589 +Node: Requesting Values969328 +Ref: table-value-types-returned970065 +Node: Accessing Parameters970948 +Node: Symbol Table Access972183 +Node: Symbol table by name972695 +Node: Symbol table by cookie974716 +Ref: Symbol table by cookie-Footnote-1978868 +Node: Cached values978932 +Ref: Cached values-Footnote-1982439 +Node: Array Manipulation982530 +Ref: Array Manipulation-Footnote-1983629 +Node: Array Data Types983666 +Ref: Array Data Types-Footnote-1986324 +Node: Array Functions986416 +Node: Flattening Arrays990274 +Node: Creating Arrays997182 +Node: Extension API Variables1001951 +Node: Extension Versioning1002587 +Ref: gawk-api-version1003024 +Node: Extension API Informational Variables1004780 +Node: Extension API Boilerplate1005844 +Node: Finding Extensions1009658 +Node: Extension Example1010217 +Node: Internal File Description1011015 +Node: Internal File Ops1015095 +Ref: Internal File Ops-Footnote-11026857 +Node: Using Internal File Ops1026997 +Ref: Using Internal File Ops-Footnote-11029380 +Node: Extension Samples1029654 +Node: Extension Sample File Functions1031183 +Node: Extension Sample Fnmatch1038832 +Node: Extension Sample Fork1040319 +Node: Extension Sample Inplace1041537 +Node: Extension Sample Ord1044747 +Node: Extension Sample Readdir1045583 +Ref: table-readdir-file-types1046472 +Node: Extension Sample Revout1047277 +Node: Extension Sample Rev2way1047866 +Node: Extension Sample Read write array1048606 +Node: Extension Sample Readfile1050548 +Node: Extension Sample Time1051643 +Node: Extension Sample API Tests1052991 +Node: gawkextlib1053483 +Node: Extension summary1055907 +Node: Extension Exercises1059599 +Node: Language History1061096 +Node: V7/SVR3.11062752 +Node: SVR41064904 +Node: POSIX1066338 +Node: BTL1067717 +Node: POSIX/GNU1068446 +Node: Feature History1073967 +Node: Common Extensions1087296 +Node: Ranges and Locales1088579 +Ref: Ranges and Locales-Footnote-11093195 +Ref: Ranges and Locales-Footnote-21093222 +Ref: Ranges and Locales-Footnote-31093457 +Node: Contributors1093678 +Node: History summary1099247 +Node: Installation1100627 +Node: Gawk Distribution1101571 +Node: Getting1102055 +Node: Extracting1103016 +Node: Distribution contents1104654 +Node: Unix Installation1110405 +Node: Quick Installation1111021 +Node: Additional Configuration Options1113448 +Node: Configuration Philosophy1115252 +Node: Non-Unix Installation1117621 +Node: PC Installation1118079 +Node: PC Binary Installation1119399 +Node: PC Compiling1121251 +Ref: PC Compiling-Footnote-11124275 +Node: PC Testing1124384 +Node: PC Using1125564 +Node: Cygwin1129678 +Node: MSYS1130448 +Node: VMS Installation1130949 +Node: VMS Compilation1131740 +Ref: VMS Compilation-Footnote-11132969 +Node: VMS Dynamic Extensions1133027 +Node: VMS Installation Details1134712 +Node: VMS Running1136965 +Node: VMS GNV1141244 +Node: VMS Old Gawk1141979 +Node: Bugs1142450 +Node: Other Versions1146647 +Node: Installation summary1153231 +Node: Notes1154289 +Node: Compatibility Mode1155154 +Node: Additions1155936 +Node: Accessing The Source1156861 +Node: Adding Code1158296 +Node: New Ports1164515 +Node: Derived Files1169003 +Ref: Derived Files-Footnote-11174488 +Ref: Derived Files-Footnote-21174523 +Ref: Derived Files-Footnote-31175121 +Node: Future Extensions1175235 +Node: Implementation Limitations1175893 +Node: Extension Design1177076 +Node: Old Extension Problems1178230 +Ref: Old Extension Problems-Footnote-11179748 +Node: Extension New Mechanism Goals1179805 +Ref: Extension New Mechanism Goals-Footnote-11183169 +Node: Extension Other Design Decisions1183358 +Node: Extension Future Growth1185471 +Node: Old Extension Mechanism1186307 +Node: Notes summary1188070 +Node: Basic Concepts1189252 +Node: Basic High Level1189933 +Ref: figure-general-flow1190215 +Ref: figure-process-flow1190900 +Ref: Basic High Level-Footnote-11194201 +Node: Basic Data Typing1194386 +Node: Glossary1197714 +Node: Copying1229660 +Node: GNU Free Documentation License1267199 +Node: Index1292317 End Tag Table diff --git a/doc/gawk.texi b/doc/gawk.texi index 6b2cf3cf..42d103e5 100644 --- a/doc/gawk.texi +++ b/doc/gawk.texi @@ -4566,6 +4566,11 @@ are generated. Its purpose is to help isolate the source of a message, as there are multiple places that produce the same warning or error message. +@item GAWK_LOCALE_DIR +Specifies the location of compiled message object files +for @command{gawk} itself. This is passed to the @code{bindtextdomain()} +function when @command{gawk} starts up. + @item GAWK_NO_DFA If this variable exists, @command{gawk} does not use the DFA regexp matcher for ``does it match'' kinds of tests. This can cause @command{gawk} @@ -28309,6 +28314,26 @@ before or after the day in a date, local month abbreviations, and so on. All of the above. (Not too useful in the context of @command{gettext}.) @end table +@quotation NOTE +@cindex @env{LANGUAGE} environment variable +As described in @ref{Locales}, environment variables with the same +name as the locale categories (@env{LC_CTYPE}, @env{LC_ALL}, etc.) +influence @command{gawk}'s behavior (and that of other utilities). + +Normally, these variables also affect how the @code{gettext} library +finds translations. However, the @env{LANGUAGE} environment variable +overrides the @env{LC_@var{xxx}} variables. Many GNU/Linux systems +may define this variable without your knowledge, causing @command{gawk} +to not find the correct translations. If this happens to you, +look to see if @env{LANGUAGE} is defined, and if so, use the shell's +@command{unset} command to remove it. +@end quotation + +For testing translations of @command{gawk} itself, you can set +the @env{GAWK_LOCALE_DIR} environment variable. See the documentation +for the C @code{bindtextdomain()} function and also see +@ref{Other Environment Variables}. + @node Programmer i18n @section Internationalizing @command{awk} Programs @cindex @command{awk} programs, internationalizing diff --git a/doc/gawktexi.in b/doc/gawktexi.in index 002936c8..9714f1a4 100644 --- a/doc/gawktexi.in +++ b/doc/gawktexi.in @@ -27416,7 +27416,7 @@ finds translations. However, the @env{LANGUAGE} environment variable overrides the @env{LC_@var{xxx}} variables. Many GNU/Linux systems may define this variable without your knowledge, causing @command{gawk} to not find the correct translations. If this happens to you, -look to see if @env{LANGAUGE} is defined, and if so, use the shell's +look to see if @env{LANGUAGE} is defined, and if so, use the shell's @command{unset} command to remove it. @end quotation |