diff options
| -rw-r--r-- | doc/ChangeLog | 5 | ||||
| -rw-r--r-- | doc/gawk.info | 404 | ||||
| -rw-r--r-- | doc/gawk.texi | 8 | ||||
| -rw-r--r-- | doc/gawktexi.in | 8 |
4 files changed, 215 insertions, 210 deletions
diff --git a/doc/ChangeLog b/doc/ChangeLog index 6ec03110..40f76755 100644 --- a/doc/ChangeLog +++ b/doc/ChangeLog @@ -1,3 +1,8 @@ +2019-01-11 Arnold D. Robbins <arnold@skeeve.com> + + * gawktexi.in (I18N Example): $LC_MESSAGES is involved here + also. Document this. + 2019-01-08 Arnold D. Robbins <arnold@skeeve.com> * gawktexi.in (I18N Example): Add more explanation of how to diff --git a/doc/gawk.info b/doc/gawk.info index ee736b9e..ee209f9f 100644 --- a/doc/gawk.info +++ b/doc/gawk.info @@ -21503,10 +21503,10 @@ object file and then to create the 'guide.mo' file. The directory has the form 'LOCALE/LC_MESSAGES', where LOCALE is a locale name known to the C 'gettext' routines. - How do we know which locale to use? It turns out that there are -three different environment variables used by the C 'gettext' routines. -In order, they are '$LANGUAGE', '$LC_ALL', and '$LANG'.(2) Thus, we -check the value of '$LANGUAGE': + How do we know which locale to use? It turns out that there are four +different environment variables used by the C 'gettext' routines. In +order, they are '$LANGUAGE', '$LC_ALL', '$LANG', and '$LC_MESSAGES'.(2) +Thus, we check the value of '$LANGUAGE': $ echo $LANGUAGE -| en_US.UTF-8 @@ -36590,203 +36590,203 @@ Ref: Printf Ordering-Footnote-1868241 Node: I18N Portability868305 Ref: I18N Portability-Footnote-1870761 Node: I18N Example870824 -Ref: I18N Example-Footnote-1874084 -Ref: I18N Example-Footnote-2874157 -Node: Gawk I18N874266 -Node: I18N Summary874911 -Node: Debugger876252 -Node: Debugging877272 -Node: Debugging Concepts877713 -Node: Debugging Terms879522 -Node: Awk Debugging882097 -Ref: Awk Debugging-Footnote-1883042 -Node: Sample Debugging Session883174 -Node: Debugger Invocation883708 -Node: Finding The Bug885094 -Node: List of Debugger Commands891568 -Node: Breakpoint Control892901 -Node: Debugger Execution Control896595 -Node: Viewing And Changing Data899957 -Node: Execution Stack903331 -Node: Debugger Info904968 -Node: Miscellaneous Debugger Commands909039 -Node: Readline Support914101 -Node: Limitations914997 -Node: Debugging Summary917106 -Node: Arbitrary Precision Arithmetic918385 -Node: Computer Arithmetic919870 -Ref: table-numeric-ranges923636 -Ref: table-floating-point-ranges924129 -Ref: Computer Arithmetic-Footnote-1924787 -Node: Math Definitions924844 -Ref: table-ieee-formats928160 -Ref: Math Definitions-Footnote-1928763 -Node: MPFR features928868 -Node: FP Math Caution930586 -Ref: FP Math Caution-Footnote-1931658 -Node: Inexactness of computations932027 -Node: Inexact representation932987 -Node: Comparing FP Values934347 -Node: Errors accumulate935588 -Node: Getting Accuracy937021 -Node: Try To Round939731 -Node: Setting precision940630 -Ref: table-predefined-precision-strings941327 -Node: Setting the rounding mode943157 -Ref: table-gawk-rounding-modes943531 -Ref: Setting the rounding mode-Footnote-1947462 -Node: Arbitrary Precision Integers947641 -Ref: Arbitrary Precision Integers-Footnote-1950816 -Node: Checking for MPFR950965 -Node: POSIX Floating Point Problems952439 -Ref: POSIX Floating Point Problems-Footnote-1956724 -Node: Floating point summary956762 -Node: Dynamic Extensions958952 -Node: Extension Intro960505 -Node: Plugin License961771 -Node: Extension Mechanism Outline962568 -Ref: figure-load-extension963007 -Ref: figure-register-new-function964572 -Ref: figure-call-new-function965664 -Node: Extension API Description967726 -Node: Extension API Functions Introduction969368 -Node: General Data Types974908 -Ref: General Data Types-Footnote-1983269 -Node: Memory Allocation Functions983568 -Ref: Memory Allocation Functions-Footnote-1987778 -Node: Constructor Functions987877 -Node: Registration Functions991463 -Node: Extension Functions992148 -Node: Exit Callback Functions997363 -Node: Extension Version String998613 -Node: Input Parsers999276 -Node: Output Wrappers1011997 -Node: Two-way processors1016509 -Node: Printing Messages1018774 -Ref: Printing Messages-Footnote-11019945 -Node: Updating ERRNO1020098 -Node: Requesting Values1020837 -Ref: table-value-types-returned1021574 -Node: Accessing Parameters1022510 -Node: Symbol Table Access1023745 -Node: Symbol table by name1024257 -Node: Symbol table by cookie1026046 -Ref: Symbol table by cookie-Footnote-11030231 -Node: Cached values1030295 -Ref: Cached values-Footnote-11033831 -Node: Array Manipulation1033984 -Ref: Array Manipulation-Footnote-11035075 -Node: Array Data Types1035112 -Ref: Array Data Types-Footnote-11037770 -Node: Array Functions1037862 -Node: Flattening Arrays1042360 -Node: Creating Arrays1049336 -Node: Redirection API1054103 -Node: Extension API Variables1056936 -Node: Extension Versioning1057647 -Ref: gawk-api-version1058076 -Node: Extension GMP/MPFR Versioning1059807 -Node: Extension API Informational Variables1061435 -Node: Extension API Boilerplate1062508 -Node: Changes from API V11066482 -Node: Finding Extensions1068054 -Node: Extension Example1068613 -Node: Internal File Description1069411 -Node: Internal File Ops1073491 -Ref: Internal File Ops-Footnote-11084841 -Node: Using Internal File Ops1084981 -Ref: Using Internal File Ops-Footnote-11087364 -Node: Extension Samples1087638 -Node: Extension Sample File Functions1089167 -Node: Extension Sample Fnmatch1096816 -Node: Extension Sample Fork1098303 -Node: Extension Sample Inplace1099521 -Node: Extension Sample Ord1102738 -Node: Extension Sample Readdir1103574 -Ref: table-readdir-file-types1104463 -Node: Extension Sample Revout1105268 -Node: Extension Sample Rev2way1105857 -Node: Extension Sample Read write array1106597 -Node: Extension Sample Readfile1108539 -Node: Extension Sample Time1109634 -Node: Extension Sample API Tests1110982 -Node: gawkextlib1111474 -Node: Extension summary1114392 -Node: Extension Exercises1118094 -Node: Language History1119592 -Node: V7/SVR3.11121248 -Node: SVR41123400 -Node: POSIX1124834 -Node: BTL1126214 -Node: POSIX/GNU1126943 -Node: Feature History1132721 -Node: Common Extensions1148580 -Node: Ranges and Locales1149863 -Ref: Ranges and Locales-Footnote-11154479 -Ref: Ranges and Locales-Footnote-21154506 -Ref: Ranges and Locales-Footnote-31154741 -Node: Contributors1154962 -Node: History summary1160907 -Node: Installation1162287 -Node: Gawk Distribution1163231 -Node: Getting1163715 -Node: Extracting1164678 -Node: Distribution contents1166316 -Node: Unix Installation1172796 -Node: Quick Installation1173478 -Node: Shell Startup Files1175892 -Node: Additional Configuration Options1176981 -Node: Configuration Philosophy1179274 -Node: Non-Unix Installation1181643 -Node: PC Installation1182103 -Node: PC Binary Installation1182941 -Node: PC Compiling1183376 -Node: PC Using1184493 -Node: Cygwin1187708 -Node: MSYS1188807 -Node: VMS Installation1189308 -Node: VMS Compilation1190099 -Ref: VMS Compilation-Footnote-11191328 -Node: VMS Dynamic Extensions1191386 -Node: VMS Installation Details1193071 -Node: VMS Running1195324 -Node: VMS GNV1199603 -Node: VMS Old Gawk1200338 -Node: Bugs1200809 -Node: Bug address1201472 -Node: Usenet1204454 -Node: Maintainers1205458 -Node: Other Versions1206719 -Node: Installation summary1213633 -Node: Notes1214835 -Node: Compatibility Mode1215629 -Node: Additions1216411 -Node: Accessing The Source1217336 -Node: Adding Code1218773 -Node: New Ports1224992 -Node: Derived Files1229480 -Ref: Derived Files-Footnote-11235126 -Ref: Derived Files-Footnote-21235161 -Ref: Derived Files-Footnote-31235759 -Node: Future Extensions1235873 -Node: Implementation Limitations1236531 -Node: Extension Design1237714 -Node: Old Extension Problems1238858 -Ref: Old Extension Problems-Footnote-11240376 -Node: Extension New Mechanism Goals1240433 -Ref: Extension New Mechanism Goals-Footnote-11243797 -Node: Extension Other Design Decisions1243986 -Node: Extension Future Growth1246099 -Node: Notes summary1246935 -Node: Basic Concepts1248110 -Node: Basic High Level1248791 -Ref: figure-general-flow1249073 -Ref: figure-process-flow1249758 -Ref: Basic High Level-Footnote-11253059 -Node: Basic Data Typing1253244 -Node: Glossary1256572 -Node: Copying1288410 -Node: GNU Free Documentation License1325953 -Node: Index1351073 +Ref: I18N Example-Footnote-1874099 +Ref: I18N Example-Footnote-2874172 +Node: Gawk I18N874281 +Node: I18N Summary874926 +Node: Debugger876267 +Node: Debugging877287 +Node: Debugging Concepts877728 +Node: Debugging Terms879537 +Node: Awk Debugging882112 +Ref: Awk Debugging-Footnote-1883057 +Node: Sample Debugging Session883189 +Node: Debugger Invocation883723 +Node: Finding The Bug885109 +Node: List of Debugger Commands891583 +Node: Breakpoint Control892916 +Node: Debugger Execution Control896610 +Node: Viewing And Changing Data899972 +Node: Execution Stack903346 +Node: Debugger Info904983 +Node: Miscellaneous Debugger Commands909054 +Node: Readline Support914116 +Node: Limitations915012 +Node: Debugging Summary917121 +Node: Arbitrary Precision Arithmetic918400 +Node: Computer Arithmetic919885 +Ref: table-numeric-ranges923651 +Ref: table-floating-point-ranges924144 +Ref: Computer Arithmetic-Footnote-1924802 +Node: Math Definitions924859 +Ref: table-ieee-formats928175 +Ref: Math Definitions-Footnote-1928778 +Node: MPFR features928883 +Node: FP Math Caution930601 +Ref: FP Math Caution-Footnote-1931673 +Node: Inexactness of computations932042 +Node: Inexact representation933002 +Node: Comparing FP Values934362 +Node: Errors accumulate935603 +Node: Getting Accuracy937036 +Node: Try To Round939746 +Node: Setting precision940645 +Ref: table-predefined-precision-strings941342 +Node: Setting the rounding mode943172 +Ref: table-gawk-rounding-modes943546 +Ref: Setting the rounding mode-Footnote-1947477 +Node: Arbitrary Precision Integers947656 +Ref: Arbitrary Precision Integers-Footnote-1950831 +Node: Checking for MPFR950980 +Node: POSIX Floating Point Problems952454 +Ref: POSIX Floating Point Problems-Footnote-1956739 +Node: Floating point summary956777 +Node: Dynamic Extensions958967 +Node: Extension Intro960520 +Node: Plugin License961786 +Node: Extension Mechanism Outline962583 +Ref: figure-load-extension963022 +Ref: figure-register-new-function964587 +Ref: figure-call-new-function965679 +Node: Extension API Description967741 +Node: Extension API Functions Introduction969383 +Node: General Data Types974923 +Ref: General Data Types-Footnote-1983284 +Node: Memory Allocation Functions983583 +Ref: Memory Allocation Functions-Footnote-1987793 +Node: Constructor Functions987892 +Node: Registration Functions991478 +Node: Extension Functions992163 +Node: Exit Callback Functions997378 +Node: Extension Version String998628 +Node: Input Parsers999291 +Node: Output Wrappers1012012 +Node: Two-way processors1016524 +Node: Printing Messages1018789 +Ref: Printing Messages-Footnote-11019960 +Node: Updating ERRNO1020113 +Node: Requesting Values1020852 +Ref: table-value-types-returned1021589 +Node: Accessing Parameters1022525 +Node: Symbol Table Access1023760 +Node: Symbol table by name1024272 +Node: Symbol table by cookie1026061 +Ref: Symbol table by cookie-Footnote-11030246 +Node: Cached values1030310 +Ref: Cached values-Footnote-11033846 +Node: Array Manipulation1033999 +Ref: Array Manipulation-Footnote-11035090 +Node: Array Data Types1035127 +Ref: Array Data Types-Footnote-11037785 +Node: Array Functions1037877 +Node: Flattening Arrays1042375 +Node: Creating Arrays1049351 +Node: Redirection API1054118 +Node: Extension API Variables1056951 +Node: Extension Versioning1057662 +Ref: gawk-api-version1058091 +Node: Extension GMP/MPFR Versioning1059822 +Node: Extension API Informational Variables1061450 +Node: Extension API Boilerplate1062523 +Node: Changes from API V11066497 +Node: Finding Extensions1068069 +Node: Extension Example1068628 +Node: Internal File Description1069426 +Node: Internal File Ops1073506 +Ref: Internal File Ops-Footnote-11084856 +Node: Using Internal File Ops1084996 +Ref: Using Internal File Ops-Footnote-11087379 +Node: Extension Samples1087653 +Node: Extension Sample File Functions1089182 +Node: Extension Sample Fnmatch1096831 +Node: Extension Sample Fork1098318 +Node: Extension Sample Inplace1099536 +Node: Extension Sample Ord1102753 +Node: Extension Sample Readdir1103589 +Ref: table-readdir-file-types1104478 +Node: Extension Sample Revout1105283 +Node: Extension Sample Rev2way1105872 +Node: Extension Sample Read write array1106612 +Node: Extension Sample Readfile1108554 +Node: Extension Sample Time1109649 +Node: Extension Sample API Tests1110997 +Node: gawkextlib1111489 +Node: Extension summary1114407 +Node: Extension Exercises1118109 +Node: Language History1119607 +Node: V7/SVR3.11121263 +Node: SVR41123415 +Node: POSIX1124849 +Node: BTL1126229 +Node: POSIX/GNU1126958 +Node: Feature History1132736 +Node: Common Extensions1148595 +Node: Ranges and Locales1149878 +Ref: Ranges and Locales-Footnote-11154494 +Ref: Ranges and Locales-Footnote-21154521 +Ref: Ranges and Locales-Footnote-31154756 +Node: Contributors1154977 +Node: History summary1160922 +Node: Installation1162302 +Node: Gawk Distribution1163246 +Node: Getting1163730 +Node: Extracting1164693 +Node: Distribution contents1166331 +Node: Unix Installation1172811 +Node: Quick Installation1173493 +Node: Shell Startup Files1175907 +Node: Additional Configuration Options1176996 +Node: Configuration Philosophy1179289 +Node: Non-Unix Installation1181658 +Node: PC Installation1182118 +Node: PC Binary Installation1182956 +Node: PC Compiling1183391 +Node: PC Using1184508 +Node: Cygwin1187723 +Node: MSYS1188822 +Node: VMS Installation1189323 +Node: VMS Compilation1190114 +Ref: VMS Compilation-Footnote-11191343 +Node: VMS Dynamic Extensions1191401 +Node: VMS Installation Details1193086 +Node: VMS Running1195339 +Node: VMS GNV1199618 +Node: VMS Old Gawk1200353 +Node: Bugs1200824 +Node: Bug address1201487 +Node: Usenet1204469 +Node: Maintainers1205473 +Node: Other Versions1206734 +Node: Installation summary1213648 +Node: Notes1214850 +Node: Compatibility Mode1215644 +Node: Additions1216426 +Node: Accessing The Source1217351 +Node: Adding Code1218788 +Node: New Ports1225007 +Node: Derived Files1229495 +Ref: Derived Files-Footnote-11235141 +Ref: Derived Files-Footnote-21235176 +Ref: Derived Files-Footnote-31235774 +Node: Future Extensions1235888 +Node: Implementation Limitations1236546 +Node: Extension Design1237729 +Node: Old Extension Problems1238873 +Ref: Old Extension Problems-Footnote-11240391 +Node: Extension New Mechanism Goals1240448 +Ref: Extension New Mechanism Goals-Footnote-11243812 +Node: Extension Other Design Decisions1244001 +Node: Extension Future Growth1246114 +Node: Notes summary1246950 +Node: Basic Concepts1248125 +Node: Basic High Level1248806 +Ref: figure-general-flow1249088 +Ref: figure-process-flow1249773 +Ref: Basic High Level-Footnote-11253074 +Node: Basic Data Typing1253259 +Node: Glossary1256587 +Node: Copying1288425 +Node: GNU Free Documentation License1325968 +Node: Index1351088 End Tag Table diff --git a/doc/gawk.texi b/doc/gawk.texi index c1095a9f..9990605d 100644 --- a/doc/gawk.texi +++ b/doc/gawk.texi @@ -30074,10 +30074,10 @@ The directory has the form @file{@var{locale}/LC_MESSAGES}, where @var{locale} is a locale name known to the C @command{gettext} routines. How do we know which locale to use? It turns out that there are -three different environment variables used by the C @command{gettext} routines. -In order, they are @env{$LANGUAGE}, @env{$LC_ALL}, and @env{$LANG}.@footnote{Well, -sort of. It seems that if @env{$LC_ALL} is set to @samp{C}, then no translations -are done. Go figure.} +four different environment variables used by the C @command{gettext} routines. +In order, they are @env{$LANGUAGE}, @env{$LC_ALL}, @env{$LANG}, and +@env{$LC_MESSAGES}.@footnote{Well, sort of. It seems that if @env{$LC_ALL} +is set to @samp{C}, then no translations are done. Go figure.} Thus, we check the value of @env{$LANGUAGE}: @example diff --git a/doc/gawktexi.in b/doc/gawktexi.in index f0416df1..2cda4028 100644 --- a/doc/gawktexi.in +++ b/doc/gawktexi.in @@ -29087,10 +29087,10 @@ The directory has the form @file{@var{locale}/LC_MESSAGES}, where @var{locale} is a locale name known to the C @command{gettext} routines. How do we know which locale to use? It turns out that there are -three different environment variables used by the C @command{gettext} routines. -In order, they are @env{$LANGUAGE}, @env{$LC_ALL}, and @env{$LANG}.@footnote{Well, -sort of. It seems that if @env{$LC_ALL} is set to @samp{C}, then no translations -are done. Go figure.} +four different environment variables used by the C @command{gettext} routines. +In order, they are @env{$LANGUAGE}, @env{$LC_ALL}, @env{$LANG}, and +@env{$LC_MESSAGES}.@footnote{Well, sort of. It seems that if @env{$LC_ALL} +is set to @samp{C}, then no translations are done. Go figure.} Thus, we check the value of @env{$LANGUAGE}: @example |