Merge branch 'gawk-4.2-stable'

4 files changed, 215 insertions, 210 deletions

diff --git a/doc/ChangeLog b/doc/ChangeLog
index 287f2cd1..270bdf2c 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-09         Andrew J. Schorr     <aschorr@telemetry-investments.com>
 
 	* gawktexi.in (Undocumented): Discuss typeof's optional 2nd argument.
diff --git a/doc/gawk.info b/doc/gawk.info
index 2171d6f2..35d1f56f 100644
--- a/doc/gawk.info
+++ b/doc/gawk.info
@@ -21520,10 +21520,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
@@ -36610,203 +36610,203 @@ Ref: Printf Ordering-Footnote-1868756
 Node: I18N Portability868820
 Ref: I18N Portability-Footnote-1871276
 Node: I18N Example871339
-Ref: I18N Example-Footnote-1874599
-Ref: I18N Example-Footnote-2874672
-Node: Gawk I18N874781
-Node: I18N Summary875426
-Node: Debugger876767
-Node: Debugging877787
-Node: Debugging Concepts878228
-Node: Debugging Terms880037
-Node: Awk Debugging882612
-Ref: Awk Debugging-Footnote-1883557
-Node: Sample Debugging Session883689
-Node: Debugger Invocation884223
-Node: Finding The Bug885609
-Node: List of Debugger Commands892083
-Node: Breakpoint Control893416
-Node: Debugger Execution Control897110
-Node: Viewing And Changing Data900472
-Node: Execution Stack903846
-Node: Debugger Info905483
-Node: Miscellaneous Debugger Commands909554
-Node: Readline Support914616
-Node: Limitations915512
-Node: Debugging Summary917621
-Node: Arbitrary Precision Arithmetic918900
-Node: Computer Arithmetic920385
-Ref: table-numeric-ranges924151
-Ref: table-floating-point-ranges924644
-Ref: Computer Arithmetic-Footnote-1925302
-Node: Math Definitions925359
-Ref: table-ieee-formats928675
-Ref: Math Definitions-Footnote-1929278
-Node: MPFR features929383
-Node: FP Math Caution931101
-Ref: FP Math Caution-Footnote-1932173
-Node: Inexactness of computations932542
-Node: Inexact representation933502
-Node: Comparing FP Values934862
-Node: Errors accumulate936103
-Node: Getting Accuracy937536
-Node: Try To Round940246
-Node: Setting precision941145
-Ref: table-predefined-precision-strings941842
-Node: Setting the rounding mode943672
-Ref: table-gawk-rounding-modes944046
-Ref: Setting the rounding mode-Footnote-1947977
-Node: Arbitrary Precision Integers948156
-Ref: Arbitrary Precision Integers-Footnote-1951331
-Node: Checking for MPFR951480
-Node: POSIX Floating Point Problems952954
-Ref: POSIX Floating Point Problems-Footnote-1957239
-Node: Floating point summary957277
-Node: Dynamic Extensions959467
-Node: Extension Intro961020
-Node: Plugin License962286
-Node: Extension Mechanism Outline963083
-Ref: figure-load-extension963522
-Ref: figure-register-new-function965087
-Ref: figure-call-new-function966179
-Node: Extension API Description968241
-Node: Extension API Functions Introduction969883
-Node: General Data Types975423
-Ref: General Data Types-Footnote-1983784
-Node: Memory Allocation Functions984083
-Ref: Memory Allocation Functions-Footnote-1988293
-Node: Constructor Functions988392
-Node: Registration Functions991978
-Node: Extension Functions992663
-Node: Exit Callback Functions997878
-Node: Extension Version String999128
-Node: Input Parsers999791
-Node: Output Wrappers1012512
-Node: Two-way processors1017024
-Node: Printing Messages1019289
-Ref: Printing Messages-Footnote-11020460
-Node: Updating ERRNO1020613
-Node: Requesting Values1021352
-Ref: table-value-types-returned1022089
-Node: Accessing Parameters1023025
-Node: Symbol Table Access1024260
-Node: Symbol table by name1024772
-Node: Symbol table by cookie1026561
-Ref: Symbol table by cookie-Footnote-11030746
-Node: Cached values1030810
-Ref: Cached values-Footnote-11034346
-Node: Array Manipulation1034499
-Ref: Array Manipulation-Footnote-11035590
-Node: Array Data Types1035627
-Ref: Array Data Types-Footnote-11038285
-Node: Array Functions1038377
-Node: Flattening Arrays1042875
-Node: Creating Arrays1049851
-Node: Redirection API1054618
-Node: Extension API Variables1057451
-Node: Extension Versioning1058162
-Ref: gawk-api-version1058591
-Node: Extension GMP/MPFR Versioning1060322
-Node: Extension API Informational Variables1061950
-Node: Extension API Boilerplate1063023
-Node: Changes from API V11066997
-Node: Finding Extensions1068569
-Node: Extension Example1069128
-Node: Internal File Description1069926
-Node: Internal File Ops1074006
-Ref: Internal File Ops-Footnote-11085356
-Node: Using Internal File Ops1085496
-Ref: Using Internal File Ops-Footnote-11087879
-Node: Extension Samples1088153
-Node: Extension Sample File Functions1089682
-Node: Extension Sample Fnmatch1097331
-Node: Extension Sample Fork1098818
-Node: Extension Sample Inplace1100036
-Node: Extension Sample Ord1103253
-Node: Extension Sample Readdir1104089
-Ref: table-readdir-file-types1104978
-Node: Extension Sample Revout1105783
-Node: Extension Sample Rev2way1106372
-Node: Extension Sample Read write array1107112
-Node: Extension Sample Readfile1109054
-Node: Extension Sample Time1110149
-Node: Extension Sample API Tests1111497
-Node: gawkextlib1111989
-Node: Extension summary1114907
-Node: Extension Exercises1118609
-Node: Language History1120107
-Node: V7/SVR3.11121763
-Node: SVR41123915
-Node: POSIX1125349
-Node: BTL1126729
-Node: POSIX/GNU1127458
-Node: Feature History1133236
-Node: Common Extensions1149282
-Node: Ranges and Locales1150565
-Ref: Ranges and Locales-Footnote-11155181
-Ref: Ranges and Locales-Footnote-21155208
-Ref: Ranges and Locales-Footnote-31155443
-Node: Contributors1155664
-Node: History summary1161609
-Node: Installation1162989
-Node: Gawk Distribution1163933
-Node: Getting1164417
-Node: Extracting1165380
-Node: Distribution contents1167018
-Node: Unix Installation1173498
-Node: Quick Installation1174180
-Node: Shell Startup Files1176594
-Node: Additional Configuration Options1177683
-Node: Configuration Philosophy1179848
-Node: Non-Unix Installation1182217
-Node: PC Installation1182677
-Node: PC Binary Installation1183515
-Node: PC Compiling1183950
-Node: PC Using1185067
-Node: Cygwin1188620
-Node: MSYS1189719
-Node: VMS Installation1190220
-Node: VMS Compilation1191011
-Ref: VMS Compilation-Footnote-11192240
-Node: VMS Dynamic Extensions1192298
-Node: VMS Installation Details1193983
-Node: VMS Running1196236
-Node: VMS GNV1200515
-Node: VMS Old Gawk1201250
-Node: Bugs1201721
-Node: Bug address1202384
-Node: Usenet1205366
-Node: Maintainers1206370
-Node: Other Versions1207631
-Node: Installation summary1214545
-Node: Notes1215747
-Node: Compatibility Mode1216541
-Node: Additions1217323
-Node: Accessing The Source1218248
-Node: Adding Code1219685
-Node: New Ports1225904
-Node: Derived Files1230392
-Ref: Derived Files-Footnote-11236038
-Ref: Derived Files-Footnote-21236073
-Ref: Derived Files-Footnote-31236671
-Node: Future Extensions1236785
-Node: Implementation Limitations1237443
-Node: Extension Design1238626
-Node: Old Extension Problems1239770
-Ref: Old Extension Problems-Footnote-11241288
-Node: Extension New Mechanism Goals1241345
-Ref: Extension New Mechanism Goals-Footnote-11244709
-Node: Extension Other Design Decisions1244898
-Node: Extension Future Growth1247011
-Node: Notes summary1247847
-Node: Basic Concepts1249022
-Node: Basic High Level1249703
-Ref: figure-general-flow1249985
-Ref: figure-process-flow1250670
-Ref: Basic High Level-Footnote-11253971
-Node: Basic Data Typing1254156
-Node: Glossary1257484
-Node: Copying1289322
-Node: GNU Free Documentation License1326865
-Node: Index1351985
+Ref: I18N Example-Footnote-1874614
+Ref: I18N Example-Footnote-2874687
+Node: Gawk I18N874796
+Node: I18N Summary875441
+Node: Debugger876782
+Node: Debugging877802
+Node: Debugging Concepts878243
+Node: Debugging Terms880052
+Node: Awk Debugging882627
+Ref: Awk Debugging-Footnote-1883572
+Node: Sample Debugging Session883704
+Node: Debugger Invocation884238
+Node: Finding The Bug885624
+Node: List of Debugger Commands892098
+Node: Breakpoint Control893431
+Node: Debugger Execution Control897125
+Node: Viewing And Changing Data900487
+Node: Execution Stack903861
+Node: Debugger Info905498
+Node: Miscellaneous Debugger Commands909569
+Node: Readline Support914631
+Node: Limitations915527
+Node: Debugging Summary917636
+Node: Arbitrary Precision Arithmetic918915
+Node: Computer Arithmetic920400
+Ref: table-numeric-ranges924166
+Ref: table-floating-point-ranges924659
+Ref: Computer Arithmetic-Footnote-1925317
+Node: Math Definitions925374
+Ref: table-ieee-formats928690
+Ref: Math Definitions-Footnote-1929293
+Node: MPFR features929398
+Node: FP Math Caution931116
+Ref: FP Math Caution-Footnote-1932188
+Node: Inexactness of computations932557
+Node: Inexact representation933517
+Node: Comparing FP Values934877
+Node: Errors accumulate936118
+Node: Getting Accuracy937551
+Node: Try To Round940261
+Node: Setting precision941160
+Ref: table-predefined-precision-strings941857
+Node: Setting the rounding mode943687
+Ref: table-gawk-rounding-modes944061
+Ref: Setting the rounding mode-Footnote-1947992
+Node: Arbitrary Precision Integers948171
+Ref: Arbitrary Precision Integers-Footnote-1951346
+Node: Checking for MPFR951495
+Node: POSIX Floating Point Problems952969
+Ref: POSIX Floating Point Problems-Footnote-1957254
+Node: Floating point summary957292
+Node: Dynamic Extensions959482
+Node: Extension Intro961035
+Node: Plugin License962301
+Node: Extension Mechanism Outline963098
+Ref: figure-load-extension963537
+Ref: figure-register-new-function965102
+Ref: figure-call-new-function966194
+Node: Extension API Description968256
+Node: Extension API Functions Introduction969898
+Node: General Data Types975438
+Ref: General Data Types-Footnote-1983799
+Node: Memory Allocation Functions984098
+Ref: Memory Allocation Functions-Footnote-1988308
+Node: Constructor Functions988407
+Node: Registration Functions991993
+Node: Extension Functions992678
+Node: Exit Callback Functions997893
+Node: Extension Version String999143
+Node: Input Parsers999806
+Node: Output Wrappers1012527
+Node: Two-way processors1017039
+Node: Printing Messages1019304
+Ref: Printing Messages-Footnote-11020475
+Node: Updating ERRNO1020628
+Node: Requesting Values1021367
+Ref: table-value-types-returned1022104
+Node: Accessing Parameters1023040
+Node: Symbol Table Access1024275
+Node: Symbol table by name1024787
+Node: Symbol table by cookie1026576
+Ref: Symbol table by cookie-Footnote-11030761
+Node: Cached values1030825
+Ref: Cached values-Footnote-11034361
+Node: Array Manipulation1034514
+Ref: Array Manipulation-Footnote-11035605
+Node: Array Data Types1035642
+Ref: Array Data Types-Footnote-11038300
+Node: Array Functions1038392
+Node: Flattening Arrays1042890
+Node: Creating Arrays1049866
+Node: Redirection API1054633
+Node: Extension API Variables1057466
+Node: Extension Versioning1058177
+Ref: gawk-api-version1058606
+Node: Extension GMP/MPFR Versioning1060337
+Node: Extension API Informational Variables1061965
+Node: Extension API Boilerplate1063038
+Node: Changes from API V11067012
+Node: Finding Extensions1068584
+Node: Extension Example1069143
+Node: Internal File Description1069941
+Node: Internal File Ops1074021
+Ref: Internal File Ops-Footnote-11085371
+Node: Using Internal File Ops1085511
+Ref: Using Internal File Ops-Footnote-11087894
+Node: Extension Samples1088168
+Node: Extension Sample File Functions1089697
+Node: Extension Sample Fnmatch1097346
+Node: Extension Sample Fork1098833
+Node: Extension Sample Inplace1100051
+Node: Extension Sample Ord1103268
+Node: Extension Sample Readdir1104104
+Ref: table-readdir-file-types1104993
+Node: Extension Sample Revout1105798
+Node: Extension Sample Rev2way1106387
+Node: Extension Sample Read write array1107127
+Node: Extension Sample Readfile1109069
+Node: Extension Sample Time1110164
+Node: Extension Sample API Tests1111512
+Node: gawkextlib1112004
+Node: Extension summary1114922
+Node: Extension Exercises1118624
+Node: Language History1120122
+Node: V7/SVR3.11121778
+Node: SVR41123930
+Node: POSIX1125364
+Node: BTL1126744
+Node: POSIX/GNU1127473
+Node: Feature History1133251
+Node: Common Extensions1149297
+Node: Ranges and Locales1150580
+Ref: Ranges and Locales-Footnote-11155196
+Ref: Ranges and Locales-Footnote-21155223
+Ref: Ranges and Locales-Footnote-31155458
+Node: Contributors1155679
+Node: History summary1161624
+Node: Installation1163004
+Node: Gawk Distribution1163948
+Node: Getting1164432
+Node: Extracting1165395
+Node: Distribution contents1167033
+Node: Unix Installation1173513
+Node: Quick Installation1174195
+Node: Shell Startup Files1176609
+Node: Additional Configuration Options1177698
+Node: Configuration Philosophy1179863
+Node: Non-Unix Installation1182232
+Node: PC Installation1182692
+Node: PC Binary Installation1183530
+Node: PC Compiling1183965
+Node: PC Using1185082
+Node: Cygwin1188635
+Node: MSYS1189734
+Node: VMS Installation1190235
+Node: VMS Compilation1191026
+Ref: VMS Compilation-Footnote-11192255
+Node: VMS Dynamic Extensions1192313
+Node: VMS Installation Details1193998
+Node: VMS Running1196251
+Node: VMS GNV1200530
+Node: VMS Old Gawk1201265
+Node: Bugs1201736
+Node: Bug address1202399
+Node: Usenet1205381
+Node: Maintainers1206385
+Node: Other Versions1207646
+Node: Installation summary1214560
+Node: Notes1215762
+Node: Compatibility Mode1216556
+Node: Additions1217338
+Node: Accessing The Source1218263
+Node: Adding Code1219700
+Node: New Ports1225919
+Node: Derived Files1230407
+Ref: Derived Files-Footnote-11236053
+Ref: Derived Files-Footnote-21236088
+Ref: Derived Files-Footnote-31236686
+Node: Future Extensions1236800
+Node: Implementation Limitations1237458
+Node: Extension Design1238641
+Node: Old Extension Problems1239785
+Ref: Old Extension Problems-Footnote-11241303
+Node: Extension New Mechanism Goals1241360
+Ref: Extension New Mechanism Goals-Footnote-11244724
+Node: Extension Other Design Decisions1244913
+Node: Extension Future Growth1247026
+Node: Notes summary1247862
+Node: Basic Concepts1249037
+Node: Basic High Level1249718
+Ref: figure-general-flow1250000
+Ref: figure-process-flow1250685
+Ref: Basic High Level-Footnote-11253986
+Node: Basic Data Typing1254171
+Node: Glossary1257499
+Node: Copying1289337
+Node: GNU Free Documentation License1326880
+Node: Index1352000
 
 End Tag Table
diff --git a/doc/gawk.texi b/doc/gawk.texi
index 44c00d00..5f304a1b 100644
--- a/doc/gawk.texi
+++ b/doc/gawk.texi
@@ -30108,10 +30108,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 ac099ccc..84618fd6 100644
--- a/doc/gawktexi.in
+++ b/doc/gawktexi.in
@@ -29121,10 +29121,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