Fix doc on ranges and locales again. Add test.

3 files changed, 65 insertions, 63 deletions

diff --git a/doc/ChangeLog b/doc/ChangeLog
index 88743adc..f279986c 100644
--- a/doc/ChangeLog
+++ b/doc/ChangeLog
@@ -1,3 +1,8 @@
+2012-08-12         Arnold D. Robbins     <arnold@skeeve.com>
+
+	* gawk.texi (Ranges and Locales): Clarified ranges and
+	locales. Again.
+
 2012-08-05         Arnold D. Robbins     <arnold@skeeve.com>
 
 	* gawk.texi (PC Binary Installation): Document Eli Zaretskii's
diff --git a/doc/gawk.info b/doc/gawk.info
index 91c9d516..275188ef 100644
--- a/doc/gawk.info
+++ b/doc/gawk.info
@@ -20186,8 +20186,7 @@ outside those locales, the ordering was defined to be based on
    In many locales, `A' and `a' are both less than `B'.  In other
 words, these locales sort characters in dictionary order, and
 `[a-dx-z]' is typically not equivalent to `[abcdxyz]'; instead it might
-be equivalent to `[aBbCcDdXxYyZz]', for example.  (And to make things
-worse, on other systems, it might be equivalent to `[aAbBcCdDxXyYz]'.)
+be equivalent to `[ABCXYabcdxyz]', for example.
 
    This point needs to be emphasized: Much literature teaches that you
 should use `[a-z]' to match a lowercase character.  But on systems with
@@ -27834,63 +27833,63 @@ Node: BTL798431
 Node: POSIX/GNU799165
 Node: Common Extensions804316
 Node: Ranges and Locales805423
-Ref: Ranges and Locales-Footnote-1810134
-Ref: Ranges and Locales-Footnote-2810161
-Ref: Ranges and Locales-Footnote-3810421
-Node: Contributors810642
-Node: Installation814904
-Node: Gawk Distribution815798
-Node: Getting816282
-Node: Extracting817108
-Node: Distribution contents818800
-Node: Unix Installation824022
-Node: Quick Installation824639
-Node: Additional Configuration Options826601
-Node: Configuration Philosophy828078
-Node: Non-Unix Installation830420
-Node: PC Installation830878
-Node: PC Binary Installation832177
-Node: PC Compiling834192
-Node: PC Testing837136
-Node: PC Using838312
-Node: Cygwin842497
-Node: MSYS843497
-Node: VMS Installation844011
-Node: VMS Compilation844614
-Ref: VMS Compilation-Footnote-1845621
-Node: VMS Installation Details845679
-Node: VMS Running847314
-Node: VMS Old Gawk848921
-Node: Bugs849395
-Node: Other Versions853247
-Node: Notes858528
-Node: Compatibility Mode859220
-Node: Additions860003
-Node: Accessing The Source860815
-Node: Adding Code862240
-Node: New Ports868207
-Node: Dynamic Extensions872320
-Node: Internals873696
-Node: Plugin License882799
-Node: Sample Library883433
-Node: Internal File Description884119
-Node: Internal File Ops887834
-Ref: Internal File Ops-Footnote-1892615
-Node: Using Internal File Ops892755
-Node: Future Extensions895132
-Node: Basic Concepts897636
-Node: Basic High Level898393
-Ref: Basic High Level-Footnote-1902428
-Node: Basic Data Typing902613
-Node: Floating Point Issues907138
-Node: String Conversion Precision908221
-Ref: String Conversion Precision-Footnote-1909921
-Node: Unexpected Results910030
-Node: POSIX Floating Point Problems911856
-Ref: POSIX Floating Point Problems-Footnote-1915561
-Node: Glossary915599
-Node: Copying940575
-Node: GNU Free Documentation License978132
-Node: Index1003269
+Ref: Ranges and Locales-Footnote-1810041
+Ref: Ranges and Locales-Footnote-2810068
+Ref: Ranges and Locales-Footnote-3810328
+Node: Contributors810549
+Node: Installation814811
+Node: Gawk Distribution815705
+Node: Getting816189
+Node: Extracting817015
+Node: Distribution contents818707
+Node: Unix Installation823929
+Node: Quick Installation824546
+Node: Additional Configuration Options826508
+Node: Configuration Philosophy827985
+Node: Non-Unix Installation830327
+Node: PC Installation830785
+Node: PC Binary Installation832084
+Node: PC Compiling834099
+Node: PC Testing837043
+Node: PC Using838219
+Node: Cygwin842404
+Node: MSYS843404
+Node: VMS Installation843918
+Node: VMS Compilation844521
+Ref: VMS Compilation-Footnote-1845528
+Node: VMS Installation Details845586
+Node: VMS Running847221
+Node: VMS Old Gawk848828
+Node: Bugs849302
+Node: Other Versions853154
+Node: Notes858435
+Node: Compatibility Mode859127
+Node: Additions859910
+Node: Accessing The Source860722
+Node: Adding Code862147
+Node: New Ports868114
+Node: Dynamic Extensions872227
+Node: Internals873603
+Node: Plugin License882706
+Node: Sample Library883340
+Node: Internal File Description884026
+Node: Internal File Ops887741
+Ref: Internal File Ops-Footnote-1892522
+Node: Using Internal File Ops892662
+Node: Future Extensions895039
+Node: Basic Concepts897543
+Node: Basic High Level898300
+Ref: Basic High Level-Footnote-1902335
+Node: Basic Data Typing902520
+Node: Floating Point Issues907045
+Node: String Conversion Precision908128
+Ref: String Conversion Precision-Footnote-1909828
+Node: Unexpected Results909937
+Node: POSIX Floating Point Problems911763
+Ref: POSIX Floating Point Problems-Footnote-1915468
+Node: Glossary915506
+Node: Copying940482
+Node: GNU Free Documentation License978039
+Node: Index1003176
 
 End Tag Table
diff --git a/doc/gawk.texi b/doc/gawk.texi
index b2044649..1ff75230 100644
--- a/doc/gawk.texi
+++ b/doc/gawk.texi
@@ -27095,9 +27095,7 @@ But outside those locales, the ordering was defined to be based on
 In many locales, @samp{A} and @samp{a} are both less than @samp{B}.
 In other words, these locales sort characters in dictionary order,
 and @samp{[a-dx-z]} is typically not equivalent to @samp{[abcdxyz]};
-instead it might be equivalent to @samp{[aBbCcDdXxYyZz]}, for example.
-(And to make things worse, on other systems, it might be equivalent to
-@samp{[aAbBcCdDxXyYz]}.)
+instead it might be equivalent to @samp{[ABCXYabcdxyz]}, for example.
 
 This point needs to be emphasized: Much literature teaches that you should
 use @samp{[a-z]} to match a lowercase character.  But on systems with