[SCM] gawk branch, gawk-5.1-stable, updated. gawk-4.1.0-4400-g00932ab7

[Arnold Robbins]

This is an automated email from the git hooks/post-receive script. It was
generated because a ref change was pushed to the repository containing
the project "gawk".

The branch, gawk-5.1-stable has been updated
       via  00932ab70f6065cb2088c87020e35db8d5f0d52f (commit)
      from  a9c05f332c080dafea8356e91259e0bb61d72103 (commit)

Those revisions listed above that are new to this repository have
not appeared on any other notification email; so we list those
revisions in full, below.

- Log -----------------------------------------------------------------
http://git.sv.gnu.org/cgit/gawk.git/commit/?id=00932ab70f6065cb2088c87020e35db8d5f0d52f

commit 00932ab70f6065cb2088c87020e35db8d5f0d52f
Author: Arnold D. Robbins <arnold@skeeve.com>
Date:   Fri Apr 29 11:39:08 2022 +0300

    Small manual update.

diff --git a/awklib/eg/misc/arraymax.awk b/awklib/eg/misc/arrayorder.awk
similarity index 100%
rename from awklib/eg/misc/arraymax.awk
rename to awklib/eg/misc/arrayorder.awk
diff --git a/awklib/eg/misc/arraymax.data b/awklib/eg/misc/arrayorder.data
similarity index 100%
rename from awklib/eg/misc/arraymax.data
rename to awklib/eg/misc/arrayorder.data
diff --git a/doc/ChangeLog b/doc/ChangeLog
index 5e27074a..4c0f9d73 100644
--- a/doc/ChangeLog
+++ b/doc/ChangeLog
@@ -3,6 +3,11 @@
        * gawktexi.in: Fix a some minor grammar issues.
        Thanks to Alan Welsh <alan.welsh@proton.me> for the reports.
 
+       Unrelated:
+
+       * gawktexi.in (Array Example): After some whining in comp.lang.awk,
+       make the filenames clearer and add some more explanatory text.
+
 2022-04-27         Arnold D. Robbins     <arnold@skeeve.com>
 
        * gawktexi.in: Fix a typo. Thanks to Alan Welsh <alan.welsh@proton.me>
diff --git a/doc/gawk.info b/doc/gawk.info
index 5c1e6f43..664b3f15 100644
--- a/doc/gawk.info
+++ b/doc/gawk.info
@@ -12092,6 +12092,10 @@ easy improvement to the program's 'END' rule, as 
follows:
                  print arr[x]
      }
 
+   As mentioned, the program is simplistic.  It can be easily confused;
+for example, by using negative or nonalphabetic line numbers.  The point
+here is merely to demonstrate basic array usage.
+
 
 File: gawk.info,  Node: Scanning an Array,  Next: Controlling Scanning,  Prev: 
Array Example,  Up: Array Basics
 
@@ -38863,381 +38867,381 @@ Ref: Array Intro-Footnote-1510872
 Node: Reference to Elements511000
 Node: Assigning Elements513464
 Node: Array Example513955
-Node: Scanning an Array515714
-Node: Controlling Scanning518736
-Ref: Controlling Scanning-Footnote-1525192
-Node: Numeric Array Subscripts525508
-Node: Uninitialized Subscripts527692
-Node: Delete529311
-Ref: Delete-Footnote-1532063
-Node: Multidimensional532120
-Node: Multiscanning535215
-Node: Arrays of Arrays536806
-Node: Arrays Summary541574
-Node: Functions543667
-Node: Built-in544705
-Node: Calling Built-in545786
-Node: Numeric Functions547782
-Ref: Numeric Functions-Footnote-1551810
-Ref: Numeric Functions-Footnote-2552458
-Ref: Numeric Functions-Footnote-3552506
-Node: String Functions552778
-Ref: String Functions-Footnote-1577620
-Ref: String Functions-Footnote-2577748
-Ref: String Functions-Footnote-3577996
-Node: Gory Details578083
-Ref: table-sub-escapes579874
-Ref: table-sub-proposed581394
-Ref: table-posix-sub582758
-Ref: table-gensub-escapes584300
-Ref: Gory Details-Footnote-1585124
-Node: I/O Functions585278
-Ref: table-system-return-values591732
-Ref: I/O Functions-Footnote-1593813
-Ref: I/O Functions-Footnote-2593961
-Node: Time Functions594081
-Ref: Time Functions-Footnote-1604752
-Ref: Time Functions-Footnote-2604820
-Ref: Time Functions-Footnote-3604978
-Ref: Time Functions-Footnote-4605089
-Ref: Time Functions-Footnote-5605201
-Ref: Time Functions-Footnote-6605428
-Node: Bitwise Functions605694
-Ref: table-bitwise-ops606288
-Ref: Bitwise Functions-Footnote-1612352
-Ref: Bitwise Functions-Footnote-2612525
-Node: Type Functions612716
-Node: I18N Functions616045
-Node: User-defined617696
-Node: Definition Syntax618508
-Ref: Definition Syntax-Footnote-1624202
-Node: Function Example624273
-Ref: Function Example-Footnote-1627195
-Node: Function Calling627217
-Node: Calling A Function627805
-Node: Variable Scope628763
-Node: Pass By Value/Reference631757
-Node: Function Caveats634401
-Ref: Function Caveats-Footnote-1636448
-Node: Return Statement636568
-Node: Dynamic Typing639547
-Node: Indirect Calls640477
-Node: Functions Summary651401
-Node: Library Functions654106
-Ref: Library Functions-Footnote-1657713
-Ref: Library Functions-Footnote-2657856
-Node: Library Names658027
-Ref: Library Names-Footnote-1661694
-Ref: Library Names-Footnote-2661917
-Node: General Functions662003
-Node: Strtonum Function663185
-Node: Assert Function666207
-Node: Round Function669533
-Node: Cliff Random Function671073
-Node: Ordinal Functions672089
-Ref: Ordinal Functions-Footnote-1675152
-Ref: Ordinal Functions-Footnote-2675404
-Node: Join Function675614
-Ref: Join Function-Footnote-1677384
-Node: Getlocaltime Function677584
-Node: Readfile Function681326
-Node: Shell Quoting683303
-Node: Isnumeric Function684731
-Node: Data File Management686119
-Node: Filetrans Function686751
-Node: Rewind Function690847
-Node: File Checking692756
-Ref: File Checking-Footnote-1694090
-Node: Empty Files694291
-Node: Ignoring Assigns696270
-Node: Getopt Function697820
-Ref: Getopt Function-Footnote-1713117
-Node: Passwd Functions713317
-Ref: Passwd Functions-Footnote-1722156
-Node: Group Functions722244
-Ref: Group Functions-Footnote-1730142
-Node: Walking Arrays730349
-Node: Library Functions Summary733357
-Node: Library Exercises734763
-Node: Sample Programs735228
-Node: Running Examples735998
-Node: Clones736726
-Node: Cut Program737950
-Node: Egrep Program748090
-Node: Id Program757091
-Node: Split Program767026
-Ref: Split Program-Footnote-1776919
-Node: Tee Program777092
-Node: Uniq Program779882
-Node: Wc Program787470
-Node: Bytes vs. Characters787857
-Node: Using extensions789405
-Node: wc program790159
-Node: Miscellaneous Programs795024
-Node: Dupword Program796237
-Node: Alarm Program798267
-Node: Translate Program803122
-Ref: Translate Program-Footnote-1807687
-Node: Labels Program807957
-Ref: Labels Program-Footnote-1811308
-Node: Word Sorting811392
-Node: History Sorting815464
-Node: Extract Program817689
-Node: Simple Sed825702
-Node: Igawk Program828776
-Ref: Igawk Program-Footnote-1843107
-Ref: Igawk Program-Footnote-2843309
-Ref: Igawk Program-Footnote-3843431
-Node: Anagram Program843546
-Node: Signature Program846608
-Node: Programs Summary847855
-Node: Programs Exercises849069
-Ref: Programs Exercises-Footnote-1853199
-Node: Advanced Features853285
-Node: Nondecimal Data855352
-Node: Array Sorting856943
-Node: Controlling Array Traversal857643
-Ref: Controlling Array Traversal-Footnote-1866011
-Node: Array Sorting Functions866129
-Ref: Array Sorting Functions-Footnote-1872040
-Node: Two-way I/O872236
-Ref: Two-way I/O-Footnote-1879962
-Ref: Two-way I/O-Footnote-2880149
-Node: TCP/IP Networking880231
-Node: Profiling883307
-Node: Extension Philosophy892616
-Node: Advanced Features Summary894095
-Node: Internationalization896110
-Node: I18N and L10N897784
-Node: Explaining gettext898471
-Ref: Explaining gettext-Footnote-1904363
-Ref: Explaining gettext-Footnote-2904548
-Node: Programmer i18n904713
-Ref: Programmer i18n-Footnote-1909662
-Node: Translator i18n909711
-Node: String Extraction910505
-Ref: String Extraction-Footnote-1911637
-Node: Printf Ordering911723
-Ref: Printf Ordering-Footnote-1914509
-Node: I18N Portability914573
-Ref: I18N Portability-Footnote-1917029
-Node: I18N Example917092
-Ref: I18N Example-Footnote-1920367
-Ref: I18N Example-Footnote-2920440
-Node: Gawk I18N920549
-Node: I18N Summary921171
-Node: Debugger922512
-Node: Debugging923512
-Node: Debugging Concepts923953
-Node: Debugging Terms925762
-Node: Awk Debugging928337
-Ref: Awk Debugging-Footnote-1929282
-Node: Sample Debugging Session929414
-Node: Debugger Invocation929948
-Node: Finding The Bug931334
-Node: List of Debugger Commands937808
-Node: Breakpoint Control939141
-Node: Debugger Execution Control942835
-Node: Viewing And Changing Data946197
-Node: Execution Stack949738
-Node: Debugger Info951375
-Node: Miscellaneous Debugger Commands955446
-Node: Readline Support960508
-Node: Limitations961404
-Node: Debugging Summary963958
-Node: Namespaces965237
-Node: Global Namespace966348
-Node: Qualified Names967746
-Node: Default Namespace968745
-Node: Changing The Namespace969486
-Node: Naming Rules971100
-Node: Internal Name Management972948
-Node: Namespace Example973990
-Node: Namespace And Features976552
-Node: Namespace Summary977987
-Node: Arbitrary Precision Arithmetic979464
-Node: Computer Arithmetic980951
-Ref: table-numeric-ranges984717
-Ref: table-floating-point-ranges985211
-Ref: Computer Arithmetic-Footnote-1985870
-Node: Math Definitions985927
-Ref: table-ieee-formats989243
-Ref: Math Definitions-Footnote-1989847
-Node: MPFR features989952
-Node: FP Math Caution991670
-Ref: FP Math Caution-Footnote-1992742
-Node: Inexactness of computations993111
-Node: Inexact representation994071
-Node: Comparing FP Values995431
-Node: Errors accumulate996672
-Node: Getting Accuracy998105
-Node: Try To Round1000815
-Node: Setting precision1001714
-Ref: table-predefined-precision-strings1002411
-Node: Setting the rounding mode1004242
-Ref: table-gawk-rounding-modes1004616
-Ref: Setting the rounding mode-Footnote-11008548
-Node: Arbitrary Precision Integers1008727
-Ref: Arbitrary Precision Integers-Footnote-11011902
-Node: Checking for MPFR1012051
-Node: POSIX Floating Point Problems1013525
-Ref: POSIX Floating Point Problems-Footnote-11018178
-Node: Floating point summary1018216
-Node: Dynamic Extensions1020406
-Node: Extension Intro1021959
-Node: Plugin License1023225
-Node: Extension Mechanism Outline1024022
-Ref: figure-load-extension1024461
-Ref: figure-register-new-function1026027
-Ref: figure-call-new-function1027120
-Node: Extension API Description1029183
-Node: Extension API Functions Introduction1030896
-Ref: table-api-std-headers1032732
-Node: General Data Types1036982
-Ref: General Data Types-Footnote-11045612
-Node: Memory Allocation Functions1045911
-Ref: Memory Allocation Functions-Footnote-11050412
-Node: Constructor Functions1050511
-Node: API Ownership of MPFR and GMP Values1053977
-Node: Registration Functions1055290
-Node: Extension Functions1055990
-Node: Exit Callback Functions1061312
-Node: Extension Version String1062562
-Node: Input Parsers1063225
-Node: Output Wrappers1075946
-Node: Two-way processors1080458
-Node: Printing Messages1082723
-Ref: Printing Messages-Footnote-11083894
-Node: Updating ERRNO1084047
-Node: Requesting Values1084786
-Ref: table-value-types-returned1085523
-Node: Accessing Parameters1086460
-Node: Symbol Table Access1087697
-Node: Symbol table by name1088209
-Ref: Symbol table by name-Footnote-11091234
-Node: Symbol table by cookie1091362
-Ref: Symbol table by cookie-Footnote-11095547
-Node: Cached values1095611
-Ref: Cached values-Footnote-11099147
-Node: Array Manipulation1099300
-Ref: Array Manipulation-Footnote-11100391
-Node: Array Data Types1100428
-Ref: Array Data Types-Footnote-11103086
-Node: Array Functions1103178
-Node: Flattening Arrays1107676
-Node: Creating Arrays1114652
-Node: Redirection API1119419
-Node: Extension API Variables1122252
-Node: Extension Versioning1122963
-Ref: gawk-api-version1123392
-Node: Extension GMP/MPFR Versioning1125124
-Node: Extension API Informational Variables1126752
-Node: Extension API Boilerplate1127825
-Node: Changes from API V11131799
-Node: Finding Extensions1133371
-Node: Extension Example1133930
-Node: Internal File Description1134728
-Node: Internal File Ops1138808
-Ref: Internal File Ops-Footnote-11150158
-Node: Using Internal File Ops1150298
-Ref: Using Internal File Ops-Footnote-11152681
-Node: Extension Samples1152955
-Node: Extension Sample File Functions1154484
-Node: Extension Sample Fnmatch1162133
-Node: Extension Sample Fork1163620
-Node: Extension Sample Inplace1164838
-Node: Extension Sample Ord1168464
-Node: Extension Sample Readdir1169300
-Ref: table-readdir-file-types1170189
-Node: Extension Sample Revout1171257
-Node: Extension Sample Rev2way1171846
-Node: Extension Sample Read write array1172586
-Node: Extension Sample Readfile1174528
-Node: Extension Sample Time1175623
-Node: Extension Sample API Tests1177375
-Node: gawkextlib1177867
-Node: Extension summary1180785
-Node: Extension Exercises1184487
-Node: Language History1185729
-Node: V7/SVR3.11187385
-Node: SVR41189537
-Node: POSIX1190971
-Node: BTL1192352
-Node: POSIX/GNU1193081
-Node: Feature History1198859
-Node: Common Extensions1216034
-Node: Ranges and Locales1217317
-Ref: Ranges and Locales-Footnote-11221933
-Ref: Ranges and Locales-Footnote-21221960
-Ref: Ranges and Locales-Footnote-31222195
-Node: Contributors1222418
-Node: History summary1228415
-Node: Installation1229795
-Node: Gawk Distribution1230739
-Node: Getting1231223
-Node: Extracting1232186
-Node: Distribution contents1233824
-Node: Unix Installation1240885
-Node: Quick Installation1241689
-Node: Compiling with MPFR1244109
-Node: Shell Startup Files1244799
-Node: Additional Configuration Options1245888
-Node: Configuration Philosophy1248203
-Node: Compiling from Git1250599
-Node: Building the Documentation1251154
-Node: Non-Unix Installation1252538
-Node: PC Installation1252998
-Node: PC Binary Installation1253836
-Node: PC Compiling1254709
-Node: PC Using1255826
-Node: Cygwin1259379
-Node: MSYS1260603
-Node: VMS Installation1261205
-Node: VMS Compilation1261924
-Ref: VMS Compilation-Footnote-11263153
-Node: VMS Dynamic Extensions1263211
-Node: VMS Installation Details1264896
-Node: VMS Running1267158
-Node: VMS GNV1271437
-Node: Bugs1272151
-Node: Bug definition1273063
-Node: Bug address1275999
-Node: Usenet1279387
-Node: Performance bugs1280576
-Node: Asking for help1283497
-Node: Maintainers1285464
-Node: Other Versions1286658
-Node: Installation summary1294822
-Node: Notes1296186
-Node: Compatibility Mode1296980
-Node: Additions1297762
-Node: Accessing The Source1298687
-Node: Adding Code1300124
-Node: New Ports1306939
-Node: Derived Files1311314
-Ref: Derived Files-Footnote-11316974
-Ref: Derived Files-Footnote-21317009
-Ref: Derived Files-Footnote-31317607
-Node: Future Extensions1317721
-Node: Implementation Limitations1318379
-Node: Extension Design1319589
-Node: Old Extension Problems1320733
-Ref: Old Extension Problems-Footnote-11322251
-Node: Extension New Mechanism Goals1322308
-Ref: Extension New Mechanism Goals-Footnote-11325672
-Node: Extension Other Design Decisions1325861
-Node: Extension Future Growth1327974
-Node: Notes summary1328580
-Node: Basic Concepts1329738
-Node: Basic High Level1330419
-Ref: figure-general-flow1330701
-Ref: figure-process-flow1331387
-Ref: Basic High Level-Footnote-11334689
-Node: Basic Data Typing1334874
-Node: Glossary1338202
-Node: Copying1370087
-Node: GNU Free Documentation License1407630
-Node: Index1432750
+Node: Scanning an Array515909
+Node: Controlling Scanning518931
+Ref: Controlling Scanning-Footnote-1525387
+Node: Numeric Array Subscripts525703
+Node: Uninitialized Subscripts527887
+Node: Delete529506
+Ref: Delete-Footnote-1532258
+Node: Multidimensional532315
+Node: Multiscanning535410
+Node: Arrays of Arrays537001
+Node: Arrays Summary541769
+Node: Functions543862
+Node: Built-in544900
+Node: Calling Built-in545981
+Node: Numeric Functions547977
+Ref: Numeric Functions-Footnote-1552005
+Ref: Numeric Functions-Footnote-2552653
+Ref: Numeric Functions-Footnote-3552701
+Node: String Functions552973
+Ref: String Functions-Footnote-1577815
+Ref: String Functions-Footnote-2577943
+Ref: String Functions-Footnote-3578191
+Node: Gory Details578278
+Ref: table-sub-escapes580069
+Ref: table-sub-proposed581589
+Ref: table-posix-sub582953
+Ref: table-gensub-escapes584495
+Ref: Gory Details-Footnote-1585319
+Node: I/O Functions585473
+Ref: table-system-return-values591927
+Ref: I/O Functions-Footnote-1594008
+Ref: I/O Functions-Footnote-2594156
+Node: Time Functions594276
+Ref: Time Functions-Footnote-1604947
+Ref: Time Functions-Footnote-2605015
+Ref: Time Functions-Footnote-3605173
+Ref: Time Functions-Footnote-4605284
+Ref: Time Functions-Footnote-5605396
+Ref: Time Functions-Footnote-6605623
+Node: Bitwise Functions605889
+Ref: table-bitwise-ops606483
+Ref: Bitwise Functions-Footnote-1612547
+Ref: Bitwise Functions-Footnote-2612720
+Node: Type Functions612911
+Node: I18N Functions616240
+Node: User-defined617891
+Node: Definition Syntax618703
+Ref: Definition Syntax-Footnote-1624397
+Node: Function Example624468
+Ref: Function Example-Footnote-1627390
+Node: Function Calling627412
+Node: Calling A Function628000
+Node: Variable Scope628958
+Node: Pass By Value/Reference631952
+Node: Function Caveats634596
+Ref: Function Caveats-Footnote-1636643
+Node: Return Statement636763
+Node: Dynamic Typing639742
+Node: Indirect Calls640672
+Node: Functions Summary651596
+Node: Library Functions654301
+Ref: Library Functions-Footnote-1657908
+Ref: Library Functions-Footnote-2658051
+Node: Library Names658222
+Ref: Library Names-Footnote-1661889
+Ref: Library Names-Footnote-2662112
+Node: General Functions662198
+Node: Strtonum Function663380
+Node: Assert Function666402
+Node: Round Function669728
+Node: Cliff Random Function671268
+Node: Ordinal Functions672284
+Ref: Ordinal Functions-Footnote-1675347
+Ref: Ordinal Functions-Footnote-2675599
+Node: Join Function675809
+Ref: Join Function-Footnote-1677579
+Node: Getlocaltime Function677779
+Node: Readfile Function681521
+Node: Shell Quoting683498
+Node: Isnumeric Function684926
+Node: Data File Management686314
+Node: Filetrans Function686946
+Node: Rewind Function691042
+Node: File Checking692951
+Ref: File Checking-Footnote-1694285
+Node: Empty Files694486
+Node: Ignoring Assigns696465
+Node: Getopt Function698015
+Ref: Getopt Function-Footnote-1713312
+Node: Passwd Functions713512
+Ref: Passwd Functions-Footnote-1722351
+Node: Group Functions722439
+Ref: Group Functions-Footnote-1730337
+Node: Walking Arrays730544
+Node: Library Functions Summary733552
+Node: Library Exercises734958
+Node: Sample Programs735423
+Node: Running Examples736193
+Node: Clones736921
+Node: Cut Program738145
+Node: Egrep Program748285
+Node: Id Program757286
+Node: Split Program767221
+Ref: Split Program-Footnote-1777114
+Node: Tee Program777287
+Node: Uniq Program780077
+Node: Wc Program787665
+Node: Bytes vs. Characters788052
+Node: Using extensions789600
+Node: wc program790354
+Node: Miscellaneous Programs795219
+Node: Dupword Program796432
+Node: Alarm Program798462
+Node: Translate Program803317
+Ref: Translate Program-Footnote-1807882
+Node: Labels Program808152
+Ref: Labels Program-Footnote-1811503
+Node: Word Sorting811587
+Node: History Sorting815659
+Node: Extract Program817884
+Node: Simple Sed825897
+Node: Igawk Program828971
+Ref: Igawk Program-Footnote-1843302
+Ref: Igawk Program-Footnote-2843504
+Ref: Igawk Program-Footnote-3843626
+Node: Anagram Program843741
+Node: Signature Program846803
+Node: Programs Summary848050
+Node: Programs Exercises849264
+Ref: Programs Exercises-Footnote-1853394
+Node: Advanced Features853480
+Node: Nondecimal Data855547
+Node: Array Sorting857138
+Node: Controlling Array Traversal857838
+Ref: Controlling Array Traversal-Footnote-1866206
+Node: Array Sorting Functions866324
+Ref: Array Sorting Functions-Footnote-1872235
+Node: Two-way I/O872431
+Ref: Two-way I/O-Footnote-1880157
+Ref: Two-way I/O-Footnote-2880344
+Node: TCP/IP Networking880426
+Node: Profiling883502
+Node: Extension Philosophy892811
+Node: Advanced Features Summary894290
+Node: Internationalization896305
+Node: I18N and L10N897979
+Node: Explaining gettext898666
+Ref: Explaining gettext-Footnote-1904558
+Ref: Explaining gettext-Footnote-2904743
+Node: Programmer i18n904908
+Ref: Programmer i18n-Footnote-1909857
+Node: Translator i18n909906
+Node: String Extraction910700
+Ref: String Extraction-Footnote-1911832
+Node: Printf Ordering911918
+Ref: Printf Ordering-Footnote-1914704
+Node: I18N Portability914768
+Ref: I18N Portability-Footnote-1917224
+Node: I18N Example917287
+Ref: I18N Example-Footnote-1920562
+Ref: I18N Example-Footnote-2920635
+Node: Gawk I18N920744
+Node: I18N Summary921366
+Node: Debugger922707
+Node: Debugging923707
+Node: Debugging Concepts924148
+Node: Debugging Terms925957
+Node: Awk Debugging928532
+Ref: Awk Debugging-Footnote-1929477
+Node: Sample Debugging Session929609
+Node: Debugger Invocation930143
+Node: Finding The Bug931529
+Node: List of Debugger Commands938003
+Node: Breakpoint Control939336
+Node: Debugger Execution Control943030
+Node: Viewing And Changing Data946392
+Node: Execution Stack949933
+Node: Debugger Info951570
+Node: Miscellaneous Debugger Commands955641
+Node: Readline Support960703
+Node: Limitations961599
+Node: Debugging Summary964153
+Node: Namespaces965432
+Node: Global Namespace966543
+Node: Qualified Names967941
+Node: Default Namespace968940
+Node: Changing The Namespace969681
+Node: Naming Rules971295
+Node: Internal Name Management973143
+Node: Namespace Example974185
+Node: Namespace And Features976747
+Node: Namespace Summary978182
+Node: Arbitrary Precision Arithmetic979659
+Node: Computer Arithmetic981146
+Ref: table-numeric-ranges984912
+Ref: table-floating-point-ranges985406
+Ref: Computer Arithmetic-Footnote-1986065
+Node: Math Definitions986122
+Ref: table-ieee-formats989438
+Ref: Math Definitions-Footnote-1990042
+Node: MPFR features990147
+Node: FP Math Caution991865
+Ref: FP Math Caution-Footnote-1992937
+Node: Inexactness of computations993306
+Node: Inexact representation994266
+Node: Comparing FP Values995626
+Node: Errors accumulate996867
+Node: Getting Accuracy998300
+Node: Try To Round1001010
+Node: Setting precision1001909
+Ref: table-predefined-precision-strings1002606
+Node: Setting the rounding mode1004437
+Ref: table-gawk-rounding-modes1004811
+Ref: Setting the rounding mode-Footnote-11008743
+Node: Arbitrary Precision Integers1008922
+Ref: Arbitrary Precision Integers-Footnote-11012097
+Node: Checking for MPFR1012246
+Node: POSIX Floating Point Problems1013720
+Ref: POSIX Floating Point Problems-Footnote-11018373
+Node: Floating point summary1018411
+Node: Dynamic Extensions1020601
+Node: Extension Intro1022154
+Node: Plugin License1023420
+Node: Extension Mechanism Outline1024217
+Ref: figure-load-extension1024656
+Ref: figure-register-new-function1026222
+Ref: figure-call-new-function1027315
+Node: Extension API Description1029378
+Node: Extension API Functions Introduction1031091
+Ref: table-api-std-headers1032927
+Node: General Data Types1037177
+Ref: General Data Types-Footnote-11045807
+Node: Memory Allocation Functions1046106
+Ref: Memory Allocation Functions-Footnote-11050607
+Node: Constructor Functions1050706
+Node: API Ownership of MPFR and GMP Values1054172
+Node: Registration Functions1055485
+Node: Extension Functions1056185
+Node: Exit Callback Functions1061507
+Node: Extension Version String1062757
+Node: Input Parsers1063420
+Node: Output Wrappers1076141
+Node: Two-way processors1080653
+Node: Printing Messages1082918
+Ref: Printing Messages-Footnote-11084089
+Node: Updating ERRNO1084242
+Node: Requesting Values1084981
+Ref: table-value-types-returned1085718
+Node: Accessing Parameters1086655
+Node: Symbol Table Access1087892
+Node: Symbol table by name1088404
+Ref: Symbol table by name-Footnote-11091429
+Node: Symbol table by cookie1091557
+Ref: Symbol table by cookie-Footnote-11095742
+Node: Cached values1095806
+Ref: Cached values-Footnote-11099342
+Node: Array Manipulation1099495
+Ref: Array Manipulation-Footnote-11100586
+Node: Array Data Types1100623
+Ref: Array Data Types-Footnote-11103281
+Node: Array Functions1103373
+Node: Flattening Arrays1107871
+Node: Creating Arrays1114847
+Node: Redirection API1119614
+Node: Extension API Variables1122447
+Node: Extension Versioning1123158
+Ref: gawk-api-version1123587
+Node: Extension GMP/MPFR Versioning1125319
+Node: Extension API Informational Variables1126947
+Node: Extension API Boilerplate1128020
+Node: Changes from API V11131994
+Node: Finding Extensions1133566
+Node: Extension Example1134125
+Node: Internal File Description1134923
+Node: Internal File Ops1139003
+Ref: Internal File Ops-Footnote-11150353
+Node: Using Internal File Ops1150493
+Ref: Using Internal File Ops-Footnote-11152876
+Node: Extension Samples1153150
+Node: Extension Sample File Functions1154679
+Node: Extension Sample Fnmatch1162328
+Node: Extension Sample Fork1163815
+Node: Extension Sample Inplace1165033
+Node: Extension Sample Ord1168659
+Node: Extension Sample Readdir1169495
+Ref: table-readdir-file-types1170384
+Node: Extension Sample Revout1171452
+Node: Extension Sample Rev2way1172041
+Node: Extension Sample Read write array1172781
+Node: Extension Sample Readfile1174723
+Node: Extension Sample Time1175818
+Node: Extension Sample API Tests1177570
+Node: gawkextlib1178062
+Node: Extension summary1180980
+Node: Extension Exercises1184682
+Node: Language History1185924
+Node: V7/SVR3.11187580
+Node: SVR41189732
+Node: POSIX1191166
+Node: BTL1192547
+Node: POSIX/GNU1193276
+Node: Feature History1199054
+Node: Common Extensions1216229
+Node: Ranges and Locales1217512
+Ref: Ranges and Locales-Footnote-11222128
+Ref: Ranges and Locales-Footnote-21222155
+Ref: Ranges and Locales-Footnote-31222390
+Node: Contributors1222613
+Node: History summary1228610
+Node: Installation1229990
+Node: Gawk Distribution1230934
+Node: Getting1231418
+Node: Extracting1232381
+Node: Distribution contents1234019
+Node: Unix Installation1241080
+Node: Quick Installation1241884
+Node: Compiling with MPFR1244304
+Node: Shell Startup Files1244994
+Node: Additional Configuration Options1246083
+Node: Configuration Philosophy1248398
+Node: Compiling from Git1250794
+Node: Building the Documentation1251349
+Node: Non-Unix Installation1252733
+Node: PC Installation1253193
+Node: PC Binary Installation1254031
+Node: PC Compiling1254904
+Node: PC Using1256021
+Node: Cygwin1259574
+Node: MSYS1260798
+Node: VMS Installation1261400
+Node: VMS Compilation1262119
+Ref: VMS Compilation-Footnote-11263348
+Node: VMS Dynamic Extensions1263406
+Node: VMS Installation Details1265091
+Node: VMS Running1267353
+Node: VMS GNV1271632
+Node: Bugs1272346
+Node: Bug definition1273258
+Node: Bug address1276194
+Node: Usenet1279582
+Node: Performance bugs1280771
+Node: Asking for help1283692
+Node: Maintainers1285659
+Node: Other Versions1286853
+Node: Installation summary1295017
+Node: Notes1296381
+Node: Compatibility Mode1297175
+Node: Additions1297957
+Node: Accessing The Source1298882
+Node: Adding Code1300319
+Node: New Ports1307134
+Node: Derived Files1311509
+Ref: Derived Files-Footnote-11317169
+Ref: Derived Files-Footnote-21317204
+Ref: Derived Files-Footnote-31317802
+Node: Future Extensions1317916
+Node: Implementation Limitations1318574
+Node: Extension Design1319784
+Node: Old Extension Problems1320928
+Ref: Old Extension Problems-Footnote-11322446
+Node: Extension New Mechanism Goals1322503
+Ref: Extension New Mechanism Goals-Footnote-11325867
+Node: Extension Other Design Decisions1326056
+Node: Extension Future Growth1328169
+Node: Notes summary1328775
+Node: Basic Concepts1329933
+Node: Basic High Level1330614
+Ref: figure-general-flow1330896
+Ref: figure-process-flow1331582
+Ref: Basic High Level-Footnote-11334884
+Node: Basic Data Typing1335069
+Node: Glossary1338397
+Node: Copying1370282
+Node: GNU Free Documentation License1407825
+Node: Index1432945
 
 End Tag Table
 
diff --git a/doc/gawk.texi b/doc/gawk.texi
index c7d83857..28291e53 100644
--- a/doc/gawk.texi
+++ b/doc/gawk.texi
@@ -17361,7 +17361,7 @@ confused upon encountering repeated numbers, gaps, or 
lines that don't
 begin with a number:
 
 @example
-@c file eg/misc/arraymax.awk
+@c file eg/misc/arrayorder.awk
 @{
     if ($1 > max)
         max = $1
@@ -17384,7 +17384,7 @@ When this program is run with the following input:
 
 @example
 @group
-@c file eg/misc/arraymax.data
+@c file eg/misc/arrayorder.data
 5  I am the Five man
 2  Who are you?  The new number two!
 4  . . . And four on the floor
@@ -17422,6 +17422,10 @@ END @{
 @end group
 @end example
 
+As mentioned, the program is simplistic. It can be easily
+confused; for example, by using negative or nonalphabetic line numbers.
+The point here is merely to demonstrate basic array usage.
+
 @node Scanning an Array
 @subsection Scanning All Elements of an Array
 @cindex elements in arrays @subentry scanning
diff --git a/doc/gawktexi.in b/doc/gawktexi.in
index 830826ae..d24afef3 100644
--- a/doc/gawktexi.in
+++ b/doc/gawktexi.in
@@ -16502,7 +16502,7 @@ confused upon encountering repeated numbers, gaps, or 
lines that don't
 begin with a number:
 
 @example
-@c file eg/misc/arraymax.awk
+@c file eg/misc/arrayorder.awk
 @{
     if ($1 > max)
         max = $1
@@ -16525,7 +16525,7 @@ When this program is run with the following input:
 
 @example
 @group
-@c file eg/misc/arraymax.data
+@c file eg/misc/arrayorder.data
 5  I am the Five man
 2  Who are you?  The new number two!
 4  . . . And four on the floor
@@ -16563,6 +16563,10 @@ END @{
 @end group
 @end example
 
+As mentioned, the program is simplistic. It can be easily
+confused; for example, by using negative or nonalphabetic line numbers.
+The point here is merely to demonstrate basic array usage.
+
 @node Scanning an Array
 @subsection Scanning All Elements of an Array
 @cindex elements in arrays @subentry scanning

-----------------------------------------------------------------------

Summary of changes:
 awklib/eg/misc/{arraymax.awk => arrayorder.awk}   |   0
 awklib/eg/misc/{arraymax.data => arrayorder.data} |   0
 doc/ChangeLog                                     |   5 +
 doc/gawk.info                                     | 754 +++++++++++-----------
 doc/gawk.texi                                     |   8 +-
 doc/gawktexi.in                                   |   8 +-
 6 files changed, 396 insertions(+), 379 deletions(-)
 rename awklib/eg/misc/{arraymax.awk => arrayorder.awk} (100%)
 rename awklib/eg/misc/{arraymax.data => arrayorder.data} (100%)


hooks/post-receive
-- 
gawk