Doc fixes.

2 files changed, 214 insertions, 212 deletions

diff --git a/doc/gawk.info b/doc/gawk.info
index 157c61ba..3c648bf4 100644
--- a/doc/gawk.info
+++ b/doc/gawk.info
@@ -10326,11 +10326,12 @@ in a[1][3]' all evaluate to one (true) for our array `a'.
    The `for (item in array)' statement (*note Scanning an Array::) can
 be nested to scan all the elements of an array of arrays if it is
 rectangular in structure. In order to print the contents (scalar
-values) of a two-dimensional array of arrays with each subarray having
-the same length, you could use the following code:
+values) of a two-dimensional array of arrays (i.e., in which each
+first-level element is itself an array, not necessarily of the same
+length) you could use the following code:
 
      for (i in array)
-         for (j in array[j])
+         for (j in array[i])
              print array[i][j]
 
    If the structure of a jagged array of arrays is known in advance,
@@ -10338,7 +10339,7 @@ you can often devise workarounds using control statements. For example,
 the following code prints the elements of our main array `a':
 
      for (i in a) {
-         for (j in a[j]) {
+         for (j in a[i]) {
              if (j == 3) {
                  for (k in a[i][j])
                      print a[i][j][k]
@@ -27301,209 +27302,209 @@ Node: Multi-scanning426250
 Node: Array Sorting427834
 Ref: Array Sorting-Footnote-1431032
 Node: Arrays of Arrays431226
-Node: Functions435334
-Node: Built-in436156
-Node: Calling Built-in437170
-Node: Numeric Functions439146
-Ref: Numeric Functions-Footnote-1442855
-Ref: Numeric Functions-Footnote-2443191
-Ref: Numeric Functions-Footnote-3443239
-Node: String Functions443508
-Ref: String Functions-Footnote-1465307
-Ref: String Functions-Footnote-2465436
-Ref: String Functions-Footnote-3465684
-Node: Gory Details465771
-Ref: table-sub-escapes467428
-Ref: table-posix-sub468742
-Ref: table-gensub-escapes469642
-Node: I/O Functions470813
-Ref: I/O Functions-Footnote-1477510
-Node: Time Functions477657
-Ref: Time Functions-Footnote-1488313
-Ref: Time Functions-Footnote-2488381
-Ref: Time Functions-Footnote-3488539
-Ref: Time Functions-Footnote-4488650
-Ref: Time Functions-Footnote-5488762
-Ref: Time Functions-Footnote-6488989
-Node: Bitwise Functions489255
-Ref: table-bitwise-ops489813
-Ref: Bitwise Functions-Footnote-1493973
-Node: I18N Functions494157
-Node: User-defined495787
-Node: Definition Syntax496591
-Ref: Definition Syntax-Footnote-1501221
-Node: Function Example501290
-Node: Function Caveats503884
-Node: Calling A Function504305
-Node: Variable Scope505394
-Node: Pass By Value/Reference507322
-Node: Return Statement510762
-Node: Dynamic Typing513704
-Node: Indirect Calls514441
-Node: Internationalization524126
-Node: I18N and L10N525554
-Node: Explaining gettext526240
-Ref: Explaining gettext-Footnote-1531302
-Ref: Explaining gettext-Footnote-2531485
-Node: Programmer i18n531650
-Node: Translator i18n535913
-Node: String Extraction536706
-Ref: String Extraction-Footnote-1537667
-Node: Printf Ordering537753
-Ref: Printf Ordering-Footnote-1540537
-Node: I18N Portability540601
-Ref: I18N Portability-Footnote-1543050
-Node: I18N Example543113
-Ref: I18N Example-Footnote-1545748
-Node: Gawk I18N545820
-Node: Advanced Features546389
-Node: Nondecimal Data547708
-Node: Two-way I/O549269
-Ref: Two-way I/O-Footnote-1554683
-Node: TCP/IP Networking554760
-Node: Profiling557532
-Node: Library Functions564932
-Ref: Library Functions-Footnote-1567902
-Node: Library Names568073
-Ref: Library Names-Footnote-1571544
-Ref: Library Names-Footnote-2571764
-Node: General Functions571850
-Node: Nextfile Function572913
-Node: Strtonum Function577294
-Node: Assert Function580245
-Node: Round Function583571
-Node: Cliff Random Function585112
-Node: Ordinal Functions586128
-Ref: Ordinal Functions-Footnote-1589198
-Ref: Ordinal Functions-Footnote-2589450
-Node: Join Function589666
-Ref: Join Function-Footnote-1591437
-Node: Gettimeofday Function591637
-Node: Data File Management595352
-Node: Filetrans Function595984
-Node: Rewind Function600221
-Node: File Checking601674
-Node: Empty Files602768
-Node: Ignoring Assigns604998
-Node: Getopt Function606551
-Ref: Getopt Function-Footnote-1617876
-Node: Passwd Functions618079
-Ref: Passwd Functions-Footnote-1627067
-Node: Group Functions627155
-Node: Sample Programs635235
-Node: Running Examples635904
-Node: Clones636632
-Node: Cut Program637764
-Node: Egrep Program647531
-Ref: Egrep Program-Footnote-1655285
-Node: Id Program655395
-Node: Split Program659002
-Node: Tee Program662470
-Node: Uniq Program665213
-Node: Wc Program672590
-Ref: Wc Program-Footnote-1676836
-Node: Miscellaneous Programs677032
-Node: Dupword Program678152
-Node: Alarm Program680183
-Node: Translate Program684727
-Ref: Translate Program-Footnote-1689106
-Ref: Translate Program-Footnote-2689343
-Node: Labels Program689477
-Ref: Labels Program-Footnote-1692768
-Node: Word Sorting692852
-Node: History Sorting697199
-Node: Extract Program699037
-Node: Simple Sed706400
-Node: Igawk Program709457
-Ref: Igawk Program-Footnote-1724192
-Ref: Igawk Program-Footnote-2724393
-Node: Signature Program724531
-Node: Debugger725611
-Node: Debugging726487
-Node: Debugging Concepts726801
-Node: Debugging Terms728654
-Node: Awk Debugging731202
-Node: Sample dgawk session732094
-Node: dgawk invocation732586
-Node: Finding The Bug733770
-Node: List of Debugger Commands740285
-Node: Breakpoint Control741600
-Node: Dgawk Execution Control744810
-Node: Viewing And Changing Data748159
-Node: Dgawk Stack751455
-Node: Dgawk Info752916
-Node: Miscellaneous Dgawk Commands756854
-Node: Readline Support762570
-Node: Dgawk Limitations763386
-Node: Language History765558
-Node: V7/SVR3.1766935
-Node: SVR4769230
-Node: POSIX770675
-Node: BTL772387
-Node: POSIX/GNU774077
-Node: Contributors783824
-Node: Installation787433
-Node: Gawk Distribution788404
-Node: Getting788888
-Node: Extracting789714
-Node: Distribution contents791102
-Node: Unix Installation796175
-Node: Quick Installation796766
-Node: Additional Configuration Options798468
-Node: Configuration Philosophy800231
-Node: Non-Unix Installation802595
-Node: PC Installation803060
-Node: PC Binary Installation804366
-Node: PC Compiling806209
-Node: PC Dynamic810714
-Node: PC Using813077
-Node: Cygwin817625
-Node: MSYS818609
-Node: VMS Installation819115
-Node: VMS Compilation819719
-Node: VMS Installation Details821296
-Node: VMS Running822926
-Node: VMS POSIX824523
-Node: VMS Old Gawk825821
-Node: Unsupported826290
-Node: Atari Installation826752
-Node: Atari Compiling828039
-Node: Atari Using829928
-Node: BeOS Installation832775
-Node: Tandem Installation833920
-Node: Bugs835599
-Node: Other Versions839431
-Node: Notes844653
-Node: Compatibility Mode845345
-Node: Additions846128
-Node: Adding Code846878
-Node: New Ports852930
-Node: Dynamic Extensions857062
-Node: Internals858443
-Node: Plugin License868848
-Node: Sample Library869482
-Node: Internal File Description870146
-Node: Internal File Ops873841
-Ref: Internal File Ops-Footnote-1878717
-Node: Using Internal File Ops878865
-Node: Future Extensions880890
-Node: Basic Concepts884927
-Node: Basic High Level885684
-Ref: Basic High Level-Footnote-1889803
-Node: Basic Data Typing889997
-Node: Floating Point Issues894434
-Node: String Conversion Precision895517
-Ref: String Conversion Precision-Footnote-1897211
-Node: Unexpected Results897320
-Node: POSIX Floating Point Problems899146
-Ref: POSIX Floating Point Problems-Footnote-1902845
-Node: Glossary902883
-Node: Copying926666
-Node: GNU Free Documentation License964223
-Node: next-edition989367
-Node: unresolved989719
-Node: revision990219
-Node: consistency990642
-Node: Index993995
+Node: Functions435388
+Node: Built-in436210
+Node: Calling Built-in437224
+Node: Numeric Functions439200
+Ref: Numeric Functions-Footnote-1442909
+Ref: Numeric Functions-Footnote-2443245
+Ref: Numeric Functions-Footnote-3443293
+Node: String Functions443562
+Ref: String Functions-Footnote-1465361
+Ref: String Functions-Footnote-2465490
+Ref: String Functions-Footnote-3465738
+Node: Gory Details465825
+Ref: table-sub-escapes467482
+Ref: table-posix-sub468796
+Ref: table-gensub-escapes469696
+Node: I/O Functions470867
+Ref: I/O Functions-Footnote-1477564
+Node: Time Functions477711
+Ref: Time Functions-Footnote-1488367
+Ref: Time Functions-Footnote-2488435
+Ref: Time Functions-Footnote-3488593
+Ref: Time Functions-Footnote-4488704
+Ref: Time Functions-Footnote-5488816
+Ref: Time Functions-Footnote-6489043
+Node: Bitwise Functions489309
+Ref: table-bitwise-ops489867
+Ref: Bitwise Functions-Footnote-1494027
+Node: I18N Functions494211
+Node: User-defined495841
+Node: Definition Syntax496645
+Ref: Definition Syntax-Footnote-1501275
+Node: Function Example501344
+Node: Function Caveats503938
+Node: Calling A Function504359
+Node: Variable Scope505448
+Node: Pass By Value/Reference507376
+Node: Return Statement510816
+Node: Dynamic Typing513758
+Node: Indirect Calls514495
+Node: Internationalization524180
+Node: I18N and L10N525608
+Node: Explaining gettext526294
+Ref: Explaining gettext-Footnote-1531356
+Ref: Explaining gettext-Footnote-2531539
+Node: Programmer i18n531704
+Node: Translator i18n535967
+Node: String Extraction536760
+Ref: String Extraction-Footnote-1537721
+Node: Printf Ordering537807
+Ref: Printf Ordering-Footnote-1540591
+Node: I18N Portability540655
+Ref: I18N Portability-Footnote-1543104
+Node: I18N Example543167
+Ref: I18N Example-Footnote-1545802
+Node: Gawk I18N545874
+Node: Advanced Features546443
+Node: Nondecimal Data547762
+Node: Two-way I/O549323
+Ref: Two-way I/O-Footnote-1554737
+Node: TCP/IP Networking554814
+Node: Profiling557586
+Node: Library Functions564986
+Ref: Library Functions-Footnote-1567956
+Node: Library Names568127
+Ref: Library Names-Footnote-1571598
+Ref: Library Names-Footnote-2571818
+Node: General Functions571904
+Node: Nextfile Function572967
+Node: Strtonum Function577348
+Node: Assert Function580299
+Node: Round Function583625
+Node: Cliff Random Function585166
+Node: Ordinal Functions586182
+Ref: Ordinal Functions-Footnote-1589252
+Ref: Ordinal Functions-Footnote-2589504
+Node: Join Function589720
+Ref: Join Function-Footnote-1591491
+Node: Gettimeofday Function591691
+Node: Data File Management595406
+Node: Filetrans Function596038
+Node: Rewind Function600275
+Node: File Checking601728
+Node: Empty Files602822
+Node: Ignoring Assigns605052
+Node: Getopt Function606605
+Ref: Getopt Function-Footnote-1617930
+Node: Passwd Functions618133
+Ref: Passwd Functions-Footnote-1627121
+Node: Group Functions627209
+Node: Sample Programs635289
+Node: Running Examples635958
+Node: Clones636686
+Node: Cut Program637818
+Node: Egrep Program647585
+Ref: Egrep Program-Footnote-1655339
+Node: Id Program655449
+Node: Split Program659056
+Node: Tee Program662524
+Node: Uniq Program665267
+Node: Wc Program672644
+Ref: Wc Program-Footnote-1676890
+Node: Miscellaneous Programs677086
+Node: Dupword Program678206
+Node: Alarm Program680237
+Node: Translate Program684781
+Ref: Translate Program-Footnote-1689160
+Ref: Translate Program-Footnote-2689397
+Node: Labels Program689531
+Ref: Labels Program-Footnote-1692822
+Node: Word Sorting692906
+Node: History Sorting697253
+Node: Extract Program699091
+Node: Simple Sed706454
+Node: Igawk Program709511
+Ref: Igawk Program-Footnote-1724246
+Ref: Igawk Program-Footnote-2724447
+Node: Signature Program724585
+Node: Debugger725665
+Node: Debugging726541
+Node: Debugging Concepts726855
+Node: Debugging Terms728708
+Node: Awk Debugging731256
+Node: Sample dgawk session732148
+Node: dgawk invocation732640
+Node: Finding The Bug733824
+Node: List of Debugger Commands740339
+Node: Breakpoint Control741654
+Node: Dgawk Execution Control744864
+Node: Viewing And Changing Data748213
+Node: Dgawk Stack751509
+Node: Dgawk Info752970
+Node: Miscellaneous Dgawk Commands756908
+Node: Readline Support762624
+Node: Dgawk Limitations763440
+Node: Language History765612
+Node: V7/SVR3.1766989
+Node: SVR4769284
+Node: POSIX770729
+Node: BTL772441
+Node: POSIX/GNU774131
+Node: Contributors783878
+Node: Installation787487
+Node: Gawk Distribution788458
+Node: Getting788942
+Node: Extracting789768
+Node: Distribution contents791156
+Node: Unix Installation796229
+Node: Quick Installation796820
+Node: Additional Configuration Options798522
+Node: Configuration Philosophy800285
+Node: Non-Unix Installation802649
+Node: PC Installation803114
+Node: PC Binary Installation804420
+Node: PC Compiling806263
+Node: PC Dynamic810768
+Node: PC Using813131
+Node: Cygwin817679
+Node: MSYS818663
+Node: VMS Installation819169
+Node: VMS Compilation819773
+Node: VMS Installation Details821350
+Node: VMS Running822980
+Node: VMS POSIX824577
+Node: VMS Old Gawk825875
+Node: Unsupported826344
+Node: Atari Installation826806
+Node: Atari Compiling828093
+Node: Atari Using829982
+Node: BeOS Installation832829
+Node: Tandem Installation833974
+Node: Bugs835653
+Node: Other Versions839485
+Node: Notes844707
+Node: Compatibility Mode845399
+Node: Additions846182
+Node: Adding Code846932
+Node: New Ports852984
+Node: Dynamic Extensions857116
+Node: Internals858497
+Node: Plugin License868902
+Node: Sample Library869536
+Node: Internal File Description870200
+Node: Internal File Ops873895
+Ref: Internal File Ops-Footnote-1878771
+Node: Using Internal File Ops878919
+Node: Future Extensions880944
+Node: Basic Concepts884981
+Node: Basic High Level885738
+Ref: Basic High Level-Footnote-1889857
+Node: Basic Data Typing890051
+Node: Floating Point Issues894488
+Node: String Conversion Precision895571
+Ref: String Conversion Precision-Footnote-1897265
+Node: Unexpected Results897374
+Node: POSIX Floating Point Problems899200
+Ref: POSIX Floating Point Problems-Footnote-1902899
+Node: Glossary902937
+Node: Copying926720
+Node: GNU Free Documentation License964277
+Node: next-edition989421
+Node: unresolved989773
+Node: revision990273
+Node: consistency990696
+Node: Index994049
 
 End Tag Table
diff --git a/doc/gawk.texi b/doc/gawk.texi
index 747a7f69..dbda87d5 100644
--- a/doc/gawk.texi
+++ b/doc/gawk.texi
@@ -13895,12 +13895,13 @@ The @samp{for (item in array)} statement (@pxref{Scanning an Array})
 can be nested to scan all the
 elements of an array of arrays if it is rectangular in structure. In order
 to print the contents (scalar values) of a two-dimensional array of arrays
-with each subarray having the same length, you could use the following
-code:
+(i.e., in which each first-level element is itself an 
+array, not necessarily of the same length) 
+you could use the following code:
 
 @example
 for (i in array)
-    for (j in array[j])
+    for (j in array[i])
         print array[i][j] 
 @end example
 
@@ -13910,7 +13911,7 @@ the following code prints the elements of our main array @code{a}:
 
 @example
 for (i in a) @{
-    for (j in a[j]) @{
+    for (j in a[i]) @{
         if (j == 3) @{
             for (k in a[i][j])
                 print a[i][j][k]