Minor documentation improvements.

5 files changed, 410 insertions, 400 deletions

diff --git a/doc/ChangeLog b/doc/ChangeLog
index cd7c51d9..8abc1fb3 100644
--- a/doc/ChangeLog
+++ b/doc/ChangeLog
@@ -1,3 +1,11 @@
+2013-01-31         Arnold D. Robbins     <arnold@skeeve.com>
+
+	* api-figure2.txt, api-figure3.txt: Convert tabs to spaces.
+	* gawk.texi (Gory Details): Fix a command that new makeinfo doesn't
+	recognize.
+	(Conversion): Update example to be in POSIX mode. Thanks to
+	Hermann Peifer.
+
 2013-01-27         Arnold D. Robbins     <arnold@skeeve.com>
 
 	* gawk.texi (Dynamic Typing): Clarify that gawk dies after the
diff --git a/doc/api-figure2.txt b/doc/api-figure2.txt
index 691bfde9..5ed8e2a8 100644
--- a/doc/api-figure2.txt
+++ b/doc/api-figure2.txt
@@ -1,7 +1,7 @@
             register_ext_func({ "chdir", do_chdir, 1 });
 
-	    +--------------------------------------------+
-	    |                                            |
+            +--------------------------------------------+
+            |                                            |
             V                                            |
 +-------+-+---+-+---+-+------------------+--------------+-+---+
 |       |x|   |x|   |x|                  |OOOOOOOOOOOOOO|X|OOO|
diff --git a/doc/api-figure3.txt b/doc/api-figure3.txt
index c4d222f0..a601ce94 100644
--- a/doc/api-figure3.txt
+++ b/doc/api-figure3.txt
@@ -1,8 +1,8 @@
     BEGIN {
         chdir("/path")                             (*fnptr)(1);
     }
-	    +--------------------------------------------+
-	    |                                            |
+            +--------------------------------------------+
+            |                                            |
             |                                            V
 +-------+-+---+-+---+-+------------------+--------------+-+---+
 |       |x|   |x|   |x|                  |OOOOOOOOOOOOOO|X|OOO|
diff --git a/doc/gawk.info b/doc/gawk.info
index c271041f..16506013 100644
--- a/doc/gawk.info
+++ b/doc/gawk.info
@@ -7149,19 +7149,20 @@ number to string conversion, the local decimal point character is used.
 Here are some examples indicating the difference in behavior, on a
 GNU/Linux system:
 
+     $ export POSIXLY_CORRECT=1                        Force POSIX behavior
      $ gawk 'BEGIN { printf "%g\n", 3.1415927 }'
      -| 3.14159
-     $ LC_ALL=en_DK gawk 'BEGIN { printf "%g\n", 3.1415927 }'
+     $ LC_ALL=en_DK.utf-8 gawk 'BEGIN { printf "%g\n", 3.1415927 }'
      -| 3,14159
      $ echo 4,321 | gawk '{ print $1 + 1 }'
      -| 5
-     $ echo 4,321 | LC_ALL=en_DK gawk '{ print $1 + 1 }'
+     $ echo 4,321 | LC_ALL=en_DK.utf-8 gawk '{ print $1 + 1 }'
      -| 5,321
 
-The `en_DK' locale is for English in Denmark, where the comma acts as
-the decimal point separator.  In the normal `"C"' locale, `gawk' treats
-`4,321' as `4', while in the Danish locale, it's treated as the full
-number, 4.321.
+The `en_DK.utf-8' locale is for English in Denmark, where the comma
+acts as the decimal point separator.  In the normal `"C"' locale, `gawk'
+treats `4,321' as `4', while in the Danish locale, it's treated as the
+full number, 4.321.
 
    Some earlier versions of `gawk' fully complied with this aspect of
 the standard.  However, many users in non-English locales complained
@@ -7171,7 +7172,7 @@ decimal point character.  You can use the `--use-lc-numeric' option
 (*note Options::) to force `gawk' to use the locale's decimal point
 character.  (`gawk' also uses the locale's decimal point character when
 in POSIX mode, either via `--posix', or the `POSIXLY_CORRECT'
-environment variable.)
+environment variable, as shown previously.)
 
    *note table-locale-affects:: describes the cases in which the
 locale's decimal point character is used and when a period is used.
@@ -21493,8 +21494,8 @@ load-new-function::.
 
             register_ext_func({ "chdir", do_chdir, 1 });
 
-	    +--------------------------------------------+
-	    |                                            |
+            +--------------------------------------------+
+            |                                            |
             V                                            |
 +-------+-+---+-+---+-+------------------+--------------+-+---+
 |       |x|   |x|   |x|                  |OOOOOOOOOOOOOO|X|OOO|
@@ -21514,8 +21515,8 @@ calling convention.  This is shown in *note call-new-function::.
     BEGIN {
         chdir("/path")                             (*fnptr)(1);
     }
-	    +--------------------------------------------+
-	    |                                            |
+            +--------------------------------------------+
+            |                                            |
             |                                            V
 +-------+-+---+-+---+-+------------------+--------------+-+---+
 |       |x|   |x|   |x|                  |OOOOOOOOOOOOOO|X|OOO|
@@ -32047,385 +32048,385 @@ Node: Variables303878
 Node: Using Variables304533
 Node: Assignment Options306257
 Node: Conversion308129
-Ref: table-locale-affects313505
-Ref: Conversion-Footnote-1314129
-Node: All Operators314238
-Node: Arithmetic Ops314868
-Node: Concatenation317373
-Ref: Concatenation-Footnote-1320166
-Node: Assignment Ops320286
-Ref: table-assign-ops325274
-Node: Increment Ops326682
-Node: Truth Values and Conditions330152
-Node: Truth Values331235
-Node: Typing and Comparison332284
-Node: Variable Typing333073
-Ref: Variable Typing-Footnote-1336970
-Node: Comparison Operators337092
-Ref: table-relational-ops337502
-Node: POSIX String Comparison341051
-Ref: POSIX String Comparison-Footnote-1342007
-Node: Boolean Ops342145
-Ref: Boolean Ops-Footnote-1346223
-Node: Conditional Exp346314
-Node: Function Calls348046
-Node: Precedence351640
-Node: Locales355309
-Node: Patterns and Actions356398
-Node: Pattern Overview357452
-Node: Regexp Patterns359121
-Node: Expression Patterns359664
-Node: Ranges363349
-Node: BEGIN/END366315
-Node: Using BEGIN/END367077
-Ref: Using BEGIN/END-Footnote-1369808
-Node: I/O And BEGIN/END369914
-Node: BEGINFILE/ENDFILE372196
-Node: Empty375100
-Node: Using Shell Variables375416
-Node: Action Overview377701
-Node: Statements380058
-Node: If Statement381912
-Node: While Statement383411
-Node: Do Statement385455
-Node: For Statement386611
-Node: Switch Statement389763
-Node: Break Statement391860
-Node: Continue Statement393850
-Node: Next Statement395643
-Node: Nextfile Statement398033
-Node: Exit Statement400674
-Node: Built-in Variables403090
-Node: User-modified404185
-Ref: User-modified-Footnote-1412540
-Node: Auto-set412602
-Ref: Auto-set-Footnote-1424953
-Ref: Auto-set-Footnote-2425158
-Node: ARGC and ARGV425214
-Node: Arrays429065
-Node: Array Basics430570
-Node: Array Intro431396
-Node: Reference to Elements435714
-Node: Assigning Elements437984
-Node: Array Example438475
-Node: Scanning an Array440207
-Node: Controlling Scanning442521
-Ref: Controlling Scanning-Footnote-1447454
-Node: Delete447770
-Ref: Delete-Footnote-1450535
-Node: Numeric Array Subscripts450592
-Node: Uninitialized Subscripts452775
-Node: Multi-dimensional454403
-Node: Multi-scanning457497
-Node: Arrays of Arrays459088
-Node: Functions463733
-Node: Built-in464552
-Node: Calling Built-in465630
-Node: Numeric Functions467618
-Ref: Numeric Functions-Footnote-1471450
-Ref: Numeric Functions-Footnote-2471807
-Ref: Numeric Functions-Footnote-3471855
-Node: String Functions472124
-Ref: String Functions-Footnote-1495621
-Ref: String Functions-Footnote-2495750
-Ref: String Functions-Footnote-3495998
-Node: Gory Details496085
-Ref: table-sub-escapes497764
-Ref: table-sub-posix-92499118
-Ref: table-sub-proposed500469
-Ref: table-posix-sub501823
-Ref: table-gensub-escapes503368
-Ref: Gory Details-Footnote-1504575
-Ref: Gory Details-Footnote-2504626
-Node: I/O Functions504777
-Ref: I/O Functions-Footnote-1511882
-Node: Time Functions512029
-Ref: Time Functions-Footnote-1522962
-Ref: Time Functions-Footnote-2523030
-Ref: Time Functions-Footnote-3523188
-Ref: Time Functions-Footnote-4523299
-Ref: Time Functions-Footnote-5523411
-Ref: Time Functions-Footnote-6523638
-Node: Bitwise Functions523904
-Ref: table-bitwise-ops524462
-Ref: Bitwise Functions-Footnote-1528683
-Node: Type Functions528867
-Node: I18N Functions529337
-Node: User-defined530964
-Node: Definition Syntax531768
-Ref: Definition Syntax-Footnote-1536678
-Node: Function Example536747
-Node: Function Caveats539341
-Node: Calling A Function539762
-Node: Variable Scope540877
-Node: Pass By Value/Reference543840
-Node: Return Statement547280
-Node: Dynamic Typing550261
-Node: Indirect Calls551192
-Node: Library Functions560877
-Ref: Library Functions-Footnote-1564390
-Ref: Library Functions-Footnote-2564533
-Node: Library Names564704
-Ref: Library Names-Footnote-1568175
-Ref: Library Names-Footnote-2568395
-Node: General Functions568481
-Node: Strtonum Function569434
-Node: Assert Function572364
-Node: Round Function575690
-Node: Cliff Random Function577233
-Node: Ordinal Functions578249
-Ref: Ordinal Functions-Footnote-1581319
-Ref: Ordinal Functions-Footnote-2581571
-Node: Join Function581780
-Ref: Join Function-Footnote-1583551
-Node: Getlocaltime Function583751
-Node: Data File Management587466
-Node: Filetrans Function588098
-Node: Rewind Function592237
-Node: File Checking593624
-Node: Empty Files594718
-Node: Ignoring Assigns596948
-Node: Getopt Function598501
-Ref: Getopt Function-Footnote-1609805
-Node: Passwd Functions610008
-Ref: Passwd Functions-Footnote-1618983
-Node: Group Functions619071
-Node: Walking Arrays627155
-Node: Sample Programs628724
-Node: Running Examples629401
-Node: Clones630129
-Node: Cut Program631353
-Node: Egrep Program641198
-Ref: Egrep Program-Footnote-1648971
-Node: Id Program649081
-Node: Split Program652697
-Ref: Split Program-Footnote-1656216
-Node: Tee Program656344
-Node: Uniq Program659147
-Node: Wc Program666576
-Ref: Wc Program-Footnote-1670842
-Ref: Wc Program-Footnote-2671042
-Node: Miscellaneous Programs671134
-Node: Dupword Program672322
-Node: Alarm Program674353
-Node: Translate Program679102
-Ref: Translate Program-Footnote-1683489
-Ref: Translate Program-Footnote-2683717
-Node: Labels Program683851
-Ref: Labels Program-Footnote-1687222
-Node: Word Sorting687306
-Node: History Sorting691190
-Node: Extract Program693029
-Ref: Extract Program-Footnote-1700512
-Node: Simple Sed700640
-Node: Igawk Program703702
-Ref: Igawk Program-Footnote-1718859
-Ref: Igawk Program-Footnote-2719060
-Node: Anagram Program719198
-Node: Signature Program722266
-Node: Internationalization723366
-Node: I18N and L10N724798
-Node: Explaining gettext725484
-Ref: Explaining gettext-Footnote-1730550
-Ref: Explaining gettext-Footnote-2730734
-Node: Programmer i18n730899
-Node: Translator i18n735099
-Node: String Extraction735892
-Ref: String Extraction-Footnote-1736853
-Node: Printf Ordering736939
-Ref: Printf Ordering-Footnote-1739723
-Node: I18N Portability739787
-Ref: I18N Portability-Footnote-1742236
-Node: I18N Example742299
-Ref: I18N Example-Footnote-1744934
-Node: Gawk I18N745006
-Node: Advanced Features745623
-Node: Nondecimal Data747127
-Node: Array Sorting748710
-Node: Controlling Array Traversal749407
-Node: Array Sorting Functions757645
-Ref: Array Sorting Functions-Footnote-1761319
-Ref: Array Sorting Functions-Footnote-2761412
-Node: Two-way I/O761606
-Ref: Two-way I/O-Footnote-1767038
-Node: TCP/IP Networking767108
-Node: Profiling769952
-Node: Debugger777406
-Node: Debugging778374
-Node: Debugging Concepts778807
-Node: Debugging Terms780663
-Node: Awk Debugging783260
-Node: Sample Debugging Session784152
-Node: Debugger Invocation784672
-Node: Finding The Bug786001
-Node: List of Debugger Commands792489
-Node: Breakpoint Control793823
-Node: Debugger Execution Control797487
-Node: Viewing And Changing Data800847
-Node: Execution Stack804203
-Node: Debugger Info805670
-Node: Miscellaneous Debugger Commands809651
-Node: Readline Support815096
-Node: Limitations815927
-Node: Arbitrary Precision Arithmetic818179
-Ref: Arbitrary Precision Arithmetic-Footnote-1819821
-Node: General Arithmetic819969
-Node: Floating Point Issues821689
-Node: String Conversion Precision822570
-Ref: String Conversion Precision-Footnote-1824276
-Node: Unexpected Results824385
-Node: POSIX Floating Point Problems826538
-Ref: POSIX Floating Point Problems-Footnote-1830363
-Node: Integer Programming830401
-Node: Floating-point Programming832154
-Ref: Floating-point Programming-Footnote-1838463
-Node: Floating-point Representation838727
-Node: Floating-point Context839892
-Ref: table-ieee-formats840734
-Node: Rounding Mode842118
-Ref: table-rounding-modes842597
-Ref: Rounding Mode-Footnote-1845601
-Node: Gawk and MPFR845782
-Node: Arbitrary Precision Floats847024
-Ref: Arbitrary Precision Floats-Footnote-1849453
-Node: Setting Precision849764
-Node: Setting Rounding Mode852497
-Ref: table-gawk-rounding-modes852901
-Node: Floating-point Constants854081
-Node: Changing Precision855505
-Ref: Changing Precision-Footnote-1856905
-Node: Exact Arithmetic857079
-Node: Arbitrary Precision Integers860187
-Ref: Arbitrary Precision Integers-Footnote-1863187
-Node: Dynamic Extensions863334
-Node: Extension Intro864711
-Node: Plugin License865919
-Node: Extension Mechanism Outline866604
-Ref: load-extension867021
-Ref: load-new-function868499
-Ref: call-new-function869480
-Node: Extension API Description871474
-Node: Extension API Functions Introduction872813
-Node: General Data Types877591
-Ref: General Data Types-Footnote-1883193
-Node: Requesting Values883492
-Ref: table-value-types-returned884223
-Node: Constructor Functions885177
-Node: Registration Functions888173
-Node: Extension Functions888858
-Node: Exit Callback Functions891032
-Node: Extension Version String892275
-Node: Input Parsers892925
-Node: Output Wrappers902642
-Node: Two-way processors907058
-Node: Printing Messages909188
-Ref: Printing Messages-Footnote-1910265
-Node: Updating `ERRNO'910417
-Node: Accessing Parameters911156
-Node: Symbol Table Access912386
-Node: Symbol table by name912898
-Node: Symbol table by cookie914471
-Ref: Symbol table by cookie-Footnote-1918600
-Node: Cached values918663
-Ref: Cached values-Footnote-1922106
-Node: Array Manipulation922197
-Ref: Array Manipulation-Footnote-1923295
-Node: Array Data Types923334
-Ref: Array Data Types-Footnote-1926037
-Node: Array Functions926129
-Node: Flattening Arrays929895
-Node: Creating Arrays936734
-Node: Extension API Variables941529
-Node: Extension Versioning942165
-Node: Extension API Informational Variables944066
-Node: Extension API Boilerplate945152
-Node: Finding Extensions948983
-Node: Extension Example949530
-Node: Internal File Description950268
-Node: Internal File Ops953956
-Ref: Internal File Ops-Footnote-1965403
-Node: Using Internal File Ops965543
-Ref: Using Internal File Ops-Footnote-1967896
-Node: Extension Samples968162
-Node: Extension Sample File Functions969686
-Node: Extension Sample Fnmatch978159
-Node: Extension Sample Fork979885
-Node: Extension Sample Inplace981103
-Node: Extension Sample Ord982895
-Node: Extension Sample Readdir983674
-Node: Extension Sample Revout985178
-Node: Extension Sample Rev2way985771
-Node: Extension Sample Read write array986461
-Node: Extension Sample Readfile988344
-Node: Extension Sample API Tests989101
-Node: Extension Sample Time989626
-Node: gawkextlib990933
-Node: Language History993314
-Node: V7/SVR3.1994836
-Node: SVR4997157
-Node: POSIX998599
-Node: BTL999607
-Node: POSIX/GNU1000412
-Node: Common Extensions1005947
-Node: Ranges and Locales1007054
-Ref: Ranges and Locales-Footnote-11011672
-Ref: Ranges and Locales-Footnote-21011699
-Ref: Ranges and Locales-Footnote-31011959
-Node: Contributors1012180
-Node: Installation1016476
-Node: Gawk Distribution1017370
-Node: Getting1017854
-Node: Extracting1018680
-Node: Distribution contents1020372
-Node: Unix Installation1025633
-Node: Quick Installation1026250
-Node: Additional Configuration Options1028212
-Node: Configuration Philosophy1029689
-Node: Non-Unix Installation1032031
-Node: PC Installation1032489
-Node: PC Binary Installation1033788
-Node: PC Compiling1035636
-Node: PC Testing1038580
-Node: PC Using1039756
-Node: Cygwin1043941
-Node: MSYS1044941
-Node: VMS Installation1045455
-Node: VMS Compilation1046058
-Ref: VMS Compilation-Footnote-11047065
-Node: VMS Installation Details1047123
-Node: VMS Running1048758
-Node: VMS Old Gawk1050365
-Node: Bugs1050839
-Node: Other Versions1054691
-Node: Notes1060347
-Node: Compatibility Mode1061147
-Node: Additions1061930
-Node: Accessing The Source1062857
-Node: Adding Code1064460
-Node: New Ports1070502
-Node: Derived Files1074637
-Ref: Derived Files-Footnote-11079958
-Ref: Derived Files-Footnote-21079992
-Ref: Derived Files-Footnote-31080592
-Node: Future Extensions1080690
-Node: Implementation Limitations1081271
-Node: Extension Design1082523
-Node: Old Extension Problems1083672
-Ref: Old Extension Problems-Footnote-11085180
-Node: Extension New Mechanism Goals1085237
-Ref: Extension New Mechanism Goals-Footnote-11088596
-Node: Extension Other Design Decisions1088782
-Node: Extension Future Growth1090888
-Node: Old Extension Mechansim1091709
-Node: Basic Concepts1093466
-Node: Basic High Level1094147
-Ref: figure-general-flow1094418
-Ref: figure-process-flow1095017
-Ref: Basic High Level-Footnote-11098246
-Node: Basic Data Typing1098431
-Node: Glossary1101786
-Node: Copying1127097
-Node: GNU Free Documentation License1164654
-Node: Index1189791
+Ref: table-locale-affects313620
+Ref: Conversion-Footnote-1314244
+Node: All Operators314353
+Node: Arithmetic Ops314983
+Node: Concatenation317488
+Ref: Concatenation-Footnote-1320281
+Node: Assignment Ops320401
+Ref: table-assign-ops325389
+Node: Increment Ops326797
+Node: Truth Values and Conditions330267
+Node: Truth Values331350
+Node: Typing and Comparison332399
+Node: Variable Typing333188
+Ref: Variable Typing-Footnote-1337085
+Node: Comparison Operators337207
+Ref: table-relational-ops337617
+Node: POSIX String Comparison341166
+Ref: POSIX String Comparison-Footnote-1342122
+Node: Boolean Ops342260
+Ref: Boolean Ops-Footnote-1346338
+Node: Conditional Exp346429
+Node: Function Calls348161
+Node: Precedence351755
+Node: Locales355424
+Node: Patterns and Actions356513
+Node: Pattern Overview357567
+Node: Regexp Patterns359236
+Node: Expression Patterns359779
+Node: Ranges363464
+Node: BEGIN/END366430
+Node: Using BEGIN/END367192
+Ref: Using BEGIN/END-Footnote-1369923
+Node: I/O And BEGIN/END370029
+Node: BEGINFILE/ENDFILE372311
+Node: Empty375215
+Node: Using Shell Variables375531
+Node: Action Overview377816
+Node: Statements380173
+Node: If Statement382027
+Node: While Statement383526
+Node: Do Statement385570
+Node: For Statement386726
+Node: Switch Statement389878
+Node: Break Statement391975
+Node: Continue Statement393965
+Node: Next Statement395758
+Node: Nextfile Statement398148
+Node: Exit Statement400789
+Node: Built-in Variables403205
+Node: User-modified404300
+Ref: User-modified-Footnote-1412655
+Node: Auto-set412717
+Ref: Auto-set-Footnote-1425068
+Ref: Auto-set-Footnote-2425273
+Node: ARGC and ARGV425329
+Node: Arrays429180
+Node: Array Basics430685
+Node: Array Intro431511
+Node: Reference to Elements435829
+Node: Assigning Elements438099
+Node: Array Example438590
+Node: Scanning an Array440322
+Node: Controlling Scanning442636
+Ref: Controlling Scanning-Footnote-1447569
+Node: Delete447885
+Ref: Delete-Footnote-1450650
+Node: Numeric Array Subscripts450707
+Node: Uninitialized Subscripts452890
+Node: Multi-dimensional454518
+Node: Multi-scanning457612
+Node: Arrays of Arrays459203
+Node: Functions463848
+Node: Built-in464667
+Node: Calling Built-in465745
+Node: Numeric Functions467733
+Ref: Numeric Functions-Footnote-1471565
+Ref: Numeric Functions-Footnote-2471922
+Ref: Numeric Functions-Footnote-3471970
+Node: String Functions472239
+Ref: String Functions-Footnote-1495736
+Ref: String Functions-Footnote-2495865
+Ref: String Functions-Footnote-3496113
+Node: Gory Details496200
+Ref: table-sub-escapes497879
+Ref: table-sub-posix-92499233
+Ref: table-sub-proposed500584
+Ref: table-posix-sub501938
+Ref: table-gensub-escapes503483
+Ref: Gory Details-Footnote-1504690
+Ref: Gory Details-Footnote-2504741
+Node: I/O Functions504892
+Ref: I/O Functions-Footnote-1511997
+Node: Time Functions512144
+Ref: Time Functions-Footnote-1523077
+Ref: Time Functions-Footnote-2523145
+Ref: Time Functions-Footnote-3523303
+Ref: Time Functions-Footnote-4523414
+Ref: Time Functions-Footnote-5523526
+Ref: Time Functions-Footnote-6523753
+Node: Bitwise Functions524019
+Ref: table-bitwise-ops524577
+Ref: Bitwise Functions-Footnote-1528798
+Node: Type Functions528982
+Node: I18N Functions529452
+Node: User-defined531079
+Node: Definition Syntax531883
+Ref: Definition Syntax-Footnote-1536793
+Node: Function Example536862
+Node: Function Caveats539456
+Node: Calling A Function539877
+Node: Variable Scope540992
+Node: Pass By Value/Reference543955
+Node: Return Statement547395
+Node: Dynamic Typing550376
+Node: Indirect Calls551307
+Node: Library Functions560992
+Ref: Library Functions-Footnote-1564505
+Ref: Library Functions-Footnote-2564648
+Node: Library Names564819
+Ref: Library Names-Footnote-1568290
+Ref: Library Names-Footnote-2568510
+Node: General Functions568596
+Node: Strtonum Function569549
+Node: Assert Function572479
+Node: Round Function575805
+Node: Cliff Random Function577348
+Node: Ordinal Functions578364
+Ref: Ordinal Functions-Footnote-1581434
+Ref: Ordinal Functions-Footnote-2581686
+Node: Join Function581895
+Ref: Join Function-Footnote-1583666
+Node: Getlocaltime Function583866
+Node: Data File Management587581
+Node: Filetrans Function588213
+Node: Rewind Function592352
+Node: File Checking593739
+Node: Empty Files594833
+Node: Ignoring Assigns597063
+Node: Getopt Function598616
+Ref: Getopt Function-Footnote-1609920
+Node: Passwd Functions610123
+Ref: Passwd Functions-Footnote-1619098
+Node: Group Functions619186
+Node: Walking Arrays627270
+Node: Sample Programs628839
+Node: Running Examples629516
+Node: Clones630244
+Node: Cut Program631468
+Node: Egrep Program641313
+Ref: Egrep Program-Footnote-1649086
+Node: Id Program649196
+Node: Split Program652812
+Ref: Split Program-Footnote-1656331
+Node: Tee Program656459
+Node: Uniq Program659262
+Node: Wc Program666691
+Ref: Wc Program-Footnote-1670957
+Ref: Wc Program-Footnote-2671157
+Node: Miscellaneous Programs671249
+Node: Dupword Program672437
+Node: Alarm Program674468
+Node: Translate Program679217
+Ref: Translate Program-Footnote-1683604
+Ref: Translate Program-Footnote-2683832
+Node: Labels Program683966
+Ref: Labels Program-Footnote-1687337
+Node: Word Sorting687421
+Node: History Sorting691305
+Node: Extract Program693144
+Ref: Extract Program-Footnote-1700627
+Node: Simple Sed700755
+Node: Igawk Program703817
+Ref: Igawk Program-Footnote-1718974
+Ref: Igawk Program-Footnote-2719175
+Node: Anagram Program719313
+Node: Signature Program722381
+Node: Internationalization723481
+Node: I18N and L10N724913
+Node: Explaining gettext725599
+Ref: Explaining gettext-Footnote-1730665
+Ref: Explaining gettext-Footnote-2730849
+Node: Programmer i18n731014
+Node: Translator i18n735214
+Node: String Extraction736007
+Ref: String Extraction-Footnote-1736968
+Node: Printf Ordering737054
+Ref: Printf Ordering-Footnote-1739838
+Node: I18N Portability739902
+Ref: I18N Portability-Footnote-1742351
+Node: I18N Example742414
+Ref: I18N Example-Footnote-1745049
+Node: Gawk I18N745121
+Node: Advanced Features745738
+Node: Nondecimal Data747242
+Node: Array Sorting748825
+Node: Controlling Array Traversal749522
+Node: Array Sorting Functions757760
+Ref: Array Sorting Functions-Footnote-1761434
+Ref: Array Sorting Functions-Footnote-2761527
+Node: Two-way I/O761721
+Ref: Two-way I/O-Footnote-1767153
+Node: TCP/IP Networking767223
+Node: Profiling770067
+Node: Debugger777521
+Node: Debugging778489
+Node: Debugging Concepts778922
+Node: Debugging Terms780778
+Node: Awk Debugging783375
+Node: Sample Debugging Session784267
+Node: Debugger Invocation784787
+Node: Finding The Bug786116
+Node: List of Debugger Commands792604
+Node: Breakpoint Control793938
+Node: Debugger Execution Control797602
+Node: Viewing And Changing Data800962
+Node: Execution Stack804318
+Node: Debugger Info805785
+Node: Miscellaneous Debugger Commands809766
+Node: Readline Support815211
+Node: Limitations816042
+Node: Arbitrary Precision Arithmetic818294
+Ref: Arbitrary Precision Arithmetic-Footnote-1819936
+Node: General Arithmetic820084
+Node: Floating Point Issues821804
+Node: String Conversion Precision822685
+Ref: String Conversion Precision-Footnote-1824391
+Node: Unexpected Results824500
+Node: POSIX Floating Point Problems826653
+Ref: POSIX Floating Point Problems-Footnote-1830478
+Node: Integer Programming830516
+Node: Floating-point Programming832269
+Ref: Floating-point Programming-Footnote-1838578
+Node: Floating-point Representation838842
+Node: Floating-point Context840007
+Ref: table-ieee-formats840849
+Node: Rounding Mode842233
+Ref: table-rounding-modes842712
+Ref: Rounding Mode-Footnote-1845716
+Node: Gawk and MPFR845897
+Node: Arbitrary Precision Floats847139
+Ref: Arbitrary Precision Floats-Footnote-1849568
+Node: Setting Precision849879
+Node: Setting Rounding Mode852612
+Ref: table-gawk-rounding-modes853016
+Node: Floating-point Constants854196
+Node: Changing Precision855620
+Ref: Changing Precision-Footnote-1857020
+Node: Exact Arithmetic857194
+Node: Arbitrary Precision Integers860302
+Ref: Arbitrary Precision Integers-Footnote-1863302
+Node: Dynamic Extensions863449
+Node: Extension Intro864826
+Node: Plugin License866034
+Node: Extension Mechanism Outline866719
+Ref: load-extension867136
+Ref: load-new-function868614
+Ref: call-new-function869609
+Node: Extension API Description871617
+Node: Extension API Functions Introduction872956
+Node: General Data Types877734
+Ref: General Data Types-Footnote-1883336
+Node: Requesting Values883635
+Ref: table-value-types-returned884366
+Node: Constructor Functions885320
+Node: Registration Functions888316
+Node: Extension Functions889001
+Node: Exit Callback Functions891175
+Node: Extension Version String892418
+Node: Input Parsers893068
+Node: Output Wrappers902785
+Node: Two-way processors907201
+Node: Printing Messages909331
+Ref: Printing Messages-Footnote-1910408
+Node: Updating `ERRNO'910560
+Node: Accessing Parameters911299
+Node: Symbol Table Access912529
+Node: Symbol table by name913041
+Node: Symbol table by cookie914614
+Ref: Symbol table by cookie-Footnote-1918743
+Node: Cached values918806
+Ref: Cached values-Footnote-1922249
+Node: Array Manipulation922340
+Ref: Array Manipulation-Footnote-1923438
+Node: Array Data Types923477
+Ref: Array Data Types-Footnote-1926180
+Node: Array Functions926272
+Node: Flattening Arrays930038
+Node: Creating Arrays936877
+Node: Extension API Variables941672
+Node: Extension Versioning942308
+Node: Extension API Informational Variables944209
+Node: Extension API Boilerplate945295
+Node: Finding Extensions949126
+Node: Extension Example949673
+Node: Internal File Description950411
+Node: Internal File Ops954099
+Ref: Internal File Ops-Footnote-1965546
+Node: Using Internal File Ops965686
+Ref: Using Internal File Ops-Footnote-1968039
+Node: Extension Samples968305
+Node: Extension Sample File Functions969829
+Node: Extension Sample Fnmatch978302
+Node: Extension Sample Fork980028
+Node: Extension Sample Inplace981246
+Node: Extension Sample Ord983038
+Node: Extension Sample Readdir983817
+Node: Extension Sample Revout985321
+Node: Extension Sample Rev2way985914
+Node: Extension Sample Read write array986604
+Node: Extension Sample Readfile988487
+Node: Extension Sample API Tests989244
+Node: Extension Sample Time989769
+Node: gawkextlib991076
+Node: Language History993457
+Node: V7/SVR3.1994979
+Node: SVR4997300
+Node: POSIX998742
+Node: BTL999750
+Node: POSIX/GNU1000555
+Node: Common Extensions1006090
+Node: Ranges and Locales1007197
+Ref: Ranges and Locales-Footnote-11011815
+Ref: Ranges and Locales-Footnote-21011842
+Ref: Ranges and Locales-Footnote-31012102
+Node: Contributors1012323
+Node: Installation1016619
+Node: Gawk Distribution1017513
+Node: Getting1017997
+Node: Extracting1018823
+Node: Distribution contents1020515
+Node: Unix Installation1025776
+Node: Quick Installation1026393
+Node: Additional Configuration Options1028355
+Node: Configuration Philosophy1029832
+Node: Non-Unix Installation1032174
+Node: PC Installation1032632
+Node: PC Binary Installation1033931
+Node: PC Compiling1035779
+Node: PC Testing1038723
+Node: PC Using1039899
+Node: Cygwin1044084
+Node: MSYS1045084
+Node: VMS Installation1045598
+Node: VMS Compilation1046201
+Ref: VMS Compilation-Footnote-11047208
+Node: VMS Installation Details1047266
+Node: VMS Running1048901
+Node: VMS Old Gawk1050508
+Node: Bugs1050982
+Node: Other Versions1054834
+Node: Notes1060490
+Node: Compatibility Mode1061290
+Node: Additions1062073
+Node: Accessing The Source1063000
+Node: Adding Code1064603
+Node: New Ports1070645
+Node: Derived Files1074780
+Ref: Derived Files-Footnote-11080101
+Ref: Derived Files-Footnote-21080135
+Ref: Derived Files-Footnote-31080735
+Node: Future Extensions1080833
+Node: Implementation Limitations1081414
+Node: Extension Design1082666
+Node: Old Extension Problems1083815
+Ref: Old Extension Problems-Footnote-11085323
+Node: Extension New Mechanism Goals1085380
+Ref: Extension New Mechanism Goals-Footnote-11088739
+Node: Extension Other Design Decisions1088925
+Node: Extension Future Growth1091031
+Node: Old Extension Mechansim1091852
+Node: Basic Concepts1093609
+Node: Basic High Level1094290
+Ref: figure-general-flow1094561
+Ref: figure-process-flow1095160
+Ref: Basic High Level-Footnote-11098389
+Node: Basic Data Typing1098574
+Node: Glossary1101929
+Node: Copying1127240
+Node: GNU Free Documentation License1164797
+Node: Index1189934
 
 End Tag Table
diff --git a/doc/gawk.texi b/doc/gawk.texi
index 941d8e04..ee3977bc 100644
--- a/doc/gawk.texi
+++ b/doc/gawk.texi
@@ -9585,18 +9585,19 @@ Here are some examples indicating the difference in behavior,
 on a GNU/Linux system:
 
 @example
+$ @kbd{export POSIXLY_CORRECT=1}                        @ii{Force POSIX behavior}
 $ @kbd{gawk 'BEGIN @{ printf "%g\n", 3.1415927 @}'}
 @print{} 3.14159
-$ @kbd{LC_ALL=en_DK gawk 'BEGIN @{ printf "%g\n", 3.1415927 @}'}
+$ @kbd{LC_ALL=en_DK.utf-8 gawk 'BEGIN @{ printf "%g\n", 3.1415927 @}'}
 @print{} 3,14159
 $ @kbd{echo 4,321 | gawk '@{ print $1 + 1 @}'}
 @print{} 5
-$ @kbd{echo 4,321 | LC_ALL=en_DK gawk '@{ print $1 + 1 @}'}
+$ @kbd{echo 4,321 | LC_ALL=en_DK.utf-8 gawk '@{ print $1 + 1 @}'}
 @print{} 5,321
 @end example
 
 @noindent
-The @samp{en_DK} locale is for English in Denmark, where the comma acts as
+The @samp{en_DK.utf-8} locale is for English in Denmark, where the comma acts as
 the decimal point separator.  In the normal @code{"C"} locale, @command{gawk}
 treats @samp{4,321} as @samp{4}, while in the Danish locale, it's treated
 as the full number, 4.321.
@@ -9609,7 +9610,7 @@ decimal point character.  You can use the @option{--use-lc-numeric}
 option (@pxref{Options}) to force @command{gawk} to use the locale's
 decimal point character.  (@command{gawk} also uses the locale's decimal
 point character when in POSIX mode, either via @option{--posix}, or the
-@env{POSIXLY_CORRECT} environment variable.)
+@env{POSIXLY_CORRECT} environment variable, as shown previously.)
 
 @ref{table-locale-affects} describes the cases in which the locale's decimal
 point character is used and when a period is used. Some of these
@@ -15704,7 +15705,7 @@ _hrulefill!_hrulefill!_hrulefill_cr
 @code{\\\\&}!     @code{\\&}!a literal @samp{\}, then the matched text_cr
 @code{\\\\\\&}!  @code{\\\&}!a literal @samp{\&}_cr
 }
-@bigskip}
+_bigskip}
 @end tex
 @ifdocbook
 @multitable @columnfractions .20 .20 .60