[gawk-diffs] [SCM] gawk branch, gawk-4.1-stable, updated. gawk-4.1.0-787-gc5fbf47

[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-4.1-stable has been updated
       via  c5fbf475a8efa76f67c5e795d6adbb4bb0769ee8 (commit)
      from  fec67185e69458b550c5f8c8591176d715134e33 (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=c5fbf475a8efa76f67c5e795d6adbb4bb0769ee8

commit c5fbf475a8efa76f67c5e795d6adbb4bb0769ee8
Author: Arnold D. Robbins <address@hidden>
Date:   Fri Jan 15 04:57:02 2016 +0200

    Improve example for asort with comparison function.

diff --git a/doc/ChangeLog b/doc/ChangeLog
index 43594dd..7cb7f3e 100644
--- a/doc/ChangeLog
+++ b/doc/ChangeLog
@@ -1,3 +1,9 @@
+2016-01-15         Arnold D. Robbins     <address@hidden>
+
+       * gawktexi.in (Array Sorting Functions): Clean up the code some,
+       per suggestion from Michal Jaegermann. Tighten up the prose
+       a bit too.
+
 2016-01-14         Arnold D. Robbins     <address@hidden>
 
        * ChangeLog: Remove spurious whitespace.
diff --git a/doc/gawk.info b/doc/gawk.info
index 3be5cea..a29ba20 100644
--- a/doc/gawk.info
+++ b/doc/gawk.info
@@ -19446,8 +19446,8 @@ Note also that the locale's sorting order does _not_ 
come into play;
 comparisons are based on character values only.(1)
 
    The following example demonstrates the use of a comparison function
-with 'asort()'.  The comparison function, 'case_fold_compare()', does a
-string comparison ignoring case (by mapping both values to lowercase).
+with 'asort()'.  The comparison function, 'case_fold_compare()', maps
+both values to lowercase in order to compare them ignoring case.
 
      # case_fold_compare --- compare as strings, ignoring case
 
@@ -19475,9 +19475,10 @@ string comparison ignoring case (by mapping both 
values to lowercase).
 
          asort(data, result, "case_fold_compare")
 
-         for (i = 1; i <= 52; i++) {
+         j = length(result)
+         for (i = 1; i <= j; i++) {
              printf("%s", result[i])
-             if (i % 26 == 0)
+             if (i % (j/2) == 0)
                  printf("\n")
              else
                  printf(" ")
@@ -34874,216 +34875,216 @@ Node: Array Sorting778396
 Node: Controlling Array Traversal779096
 Ref: Controlling Array Traversal-Footnote-1787465
 Node: Array Sorting Functions787583
-Ref: Array Sorting Functions-Footnote-1792652
-Node: Two-way I/O792848
-Ref: Two-way I/O-Footnote-1797799
-Ref: Two-way I/O-Footnote-2797986
-Node: TCP/IP Networking798068
-Node: Profiling801186
-Node: Advanced Features Summary808725
-Node: Internationalization810661
-Node: I18N and L10N812141
-Node: Explaining gettext812828
-Ref: Explaining gettext-Footnote-1817851
-Ref: Explaining gettext-Footnote-2818036
-Node: Programmer i18n818201
-Ref: Programmer i18n-Footnote-1823057
-Node: Translator i18n823106
-Node: String Extraction823900
-Ref: String Extraction-Footnote-1825033
-Node: Printf Ordering825119
-Ref: Printf Ordering-Footnote-1827905
-Node: I18N Portability827969
-Ref: I18N Portability-Footnote-1830425
-Node: I18N Example830488
-Ref: I18N Example-Footnote-1833294
-Node: Gawk I18N833367
-Node: I18N Summary834012
-Node: Debugger835353
-Node: Debugging836375
-Node: Debugging Concepts836816
-Node: Debugging Terms838625
-Node: Awk Debugging841200
-Node: Sample Debugging Session842106
-Node: Debugger Invocation842640
-Node: Finding The Bug844026
-Node: List of Debugger Commands850504
-Node: Breakpoint Control851837
-Node: Debugger Execution Control855531
-Node: Viewing And Changing Data858893
-Node: Execution Stack862267
-Node: Debugger Info863904
-Node: Miscellaneous Debugger Commands867975
-Node: Readline Support873063
-Node: Limitations873959
-Node: Debugging Summary876068
-Node: Arbitrary Precision Arithmetic877241
-Node: Computer Arithmetic878657
-Ref: table-numeric-ranges882248
-Ref: Computer Arithmetic-Footnote-1882970
-Node: Math Definitions883027
-Ref: table-ieee-formats886341
-Ref: Math Definitions-Footnote-1886944
-Node: MPFR features887049
-Node: FP Math Caution888722
-Ref: FP Math Caution-Footnote-1889794
-Node: Inexactness of computations890163
-Node: Inexact representation891123
-Node: Comparing FP Values892483
-Node: Errors accumulate893565
-Node: Getting Accuracy894998
-Node: Try To Round897708
-Node: Setting precision898607
-Ref: table-predefined-precision-strings899304
-Node: Setting the rounding mode901134
-Ref: table-gawk-rounding-modes901508
-Ref: Setting the rounding mode-Footnote-1904916
-Node: Arbitrary Precision Integers905095
-Ref: Arbitrary Precision Integers-Footnote-1908079
-Node: POSIX Floating Point Problems908228
-Ref: POSIX Floating Point Problems-Footnote-1912110
-Node: Floating point summary912148
-Node: Dynamic Extensions914338
-Node: Extension Intro915891
-Node: Plugin License917157
-Node: Extension Mechanism Outline917954
-Ref: figure-load-extension918393
-Ref: figure-register-new-function919958
-Ref: figure-call-new-function921050
-Node: Extension API Description923113
-Node: Extension API Functions Introduction924561
-Node: General Data Types929373
-Ref: General Data Types-Footnote-1935328
-Node: Memory Allocation Functions935627
-Ref: Memory Allocation Functions-Footnote-1938472
-Node: Constructor Functions938571
-Node: Registration Functions940316
-Node: Extension Functions941001
-Node: Exit Callback Functions943300
-Node: Extension Version String944550
-Node: Input Parsers945213
-Node: Output Wrappers955098
-Node: Two-way processors959610
-Node: Printing Messages961874
-Ref: Printing Messages-Footnote-1962948
-Node: Updating ERRNO963101
-Node: Requesting Values963840
-Ref: table-value-types-returned964577
-Node: Accessing Parameters965460
-Node: Symbol Table Access966696
-Node: Symbol table by name967208
-Node: Symbol table by cookie969229
-Ref: Symbol table by cookie-Footnote-1973378
-Node: Cached values973442
-Ref: Cached values-Footnote-1976943
-Node: Array Manipulation977034
-Ref: Array Manipulation-Footnote-1978133
-Node: Array Data Types978170
-Ref: Array Data Types-Footnote-1980828
-Node: Array Functions980920
-Node: Flattening Arrays984779
-Node: Creating Arrays991687
-Node: Extension API Variables996459
-Node: Extension Versioning997095
-Node: Extension API Informational Variables998986
-Node: Extension API Boilerplate1000050
-Node: Finding Extensions1003864
-Node: Extension Example1004424
-Node: Internal File Description1005222
-Node: Internal File Ops1009302
-Ref: Internal File Ops-Footnote-11021064
-Node: Using Internal File Ops1021204
-Ref: Using Internal File Ops-Footnote-11023587
-Node: Extension Samples1023862
-Node: Extension Sample File Functions1025391
-Node: Extension Sample Fnmatch1033040
-Node: Extension Sample Fork1034527
-Node: Extension Sample Inplace1035745
-Node: Extension Sample Ord1038955
-Node: Extension Sample Readdir1039791
-Ref: table-readdir-file-types1040680
-Node: Extension Sample Revout1041485
-Node: Extension Sample Rev2way1042074
-Node: Extension Sample Read write array1042814
-Node: Extension Sample Readfile1044756
-Node: Extension Sample Time1045851
-Node: Extension Sample API Tests1047199
-Node: gawkextlib1047691
-Node: Extension summary1050115
-Node: Extension Exercises1053807
-Node: Language History1055304
-Node: V7/SVR3.11056960
-Node: SVR41059112
-Node: POSIX1060546
-Node: BTL1061926
-Node: POSIX/GNU1062656
-Node: Feature History1068177
-Node: Common Extensions1081506
-Node: Ranges and Locales1082789
-Ref: Ranges and Locales-Footnote-11087405
-Ref: Ranges and Locales-Footnote-21087432
-Ref: Ranges and Locales-Footnote-31087667
-Node: Contributors1087888
-Node: History summary1093457
-Node: Installation1094837
-Node: Gawk Distribution1095782
-Node: Getting1096266
-Node: Extracting1097227
-Node: Distribution contents1098865
-Node: Unix Installation1104618
-Node: Quick Installation1105234
-Node: Additional Configuration Options1107661
-Node: Configuration Philosophy1109465
-Node: Non-Unix Installation1111835
-Node: PC Installation1112293
-Node: PC Binary Installation1113613
-Node: PC Compiling1115465
-Ref: PC Compiling-Footnote-11118489
-Node: PC Testing1118598
-Node: PC Using1119778
-Node: Cygwin1123892
-Node: MSYS1124662
-Node: VMS Installation1125163
-Node: VMS Compilation1125954
-Ref: VMS Compilation-Footnote-11127184
-Node: VMS Dynamic Extensions1127242
-Node: VMS Installation Details1128927
-Node: VMS Running1131180
-Node: VMS GNV1134021
-Node: VMS Old Gawk1134756
-Node: Bugs1135227
-Node: Other Versions1139424
-Node: Installation summary1146010
-Node: Notes1147068
-Node: Compatibility Mode1147933
-Node: Additions1148715
-Node: Accessing The Source1149640
-Node: Adding Code1151076
-Node: New Ports1157295
-Node: Derived Files1161783
-Ref: Derived Files-Footnote-11167268
-Ref: Derived Files-Footnote-21167303
-Ref: Derived Files-Footnote-31167901
-Node: Future Extensions1168015
-Node: Implementation Limitations1168673
-Node: Extension Design1169856
-Node: Old Extension Problems1171010
-Ref: Old Extension Problems-Footnote-11172528
-Node: Extension New Mechanism Goals1172585
-Ref: Extension New Mechanism Goals-Footnote-11175949
-Node: Extension Other Design Decisions1176138
-Node: Extension Future Growth1178251
-Node: Old Extension Mechanism1179087
-Node: Notes summary1180850
-Node: Basic Concepts1182032
-Node: Basic High Level1182713
-Ref: figure-general-flow1182995
-Ref: figure-process-flow1183680
-Ref: Basic High Level-Footnote-11186981
-Node: Basic Data Typing1187166
-Node: Glossary1190494
-Node: Copying1222440
-Node: GNU Free Documentation License1259979
-Node: Index1285097
+Ref: Array Sorting Functions-Footnote-1792674
+Node: Two-way I/O792870
+Ref: Two-way I/O-Footnote-1797821
+Ref: Two-way I/O-Footnote-2798008
+Node: TCP/IP Networking798090
+Node: Profiling801208
+Node: Advanced Features Summary808747
+Node: Internationalization810683
+Node: I18N and L10N812163
+Node: Explaining gettext812850
+Ref: Explaining gettext-Footnote-1817873
+Ref: Explaining gettext-Footnote-2818058
+Node: Programmer i18n818223
+Ref: Programmer i18n-Footnote-1823079
+Node: Translator i18n823128
+Node: String Extraction823922
+Ref: String Extraction-Footnote-1825055
+Node: Printf Ordering825141
+Ref: Printf Ordering-Footnote-1827927
+Node: I18N Portability827991
+Ref: I18N Portability-Footnote-1830447
+Node: I18N Example830510
+Ref: I18N Example-Footnote-1833316
+Node: Gawk I18N833389
+Node: I18N Summary834034
+Node: Debugger835375
+Node: Debugging836397
+Node: Debugging Concepts836838
+Node: Debugging Terms838647
+Node: Awk Debugging841222
+Node: Sample Debugging Session842128
+Node: Debugger Invocation842662
+Node: Finding The Bug844048
+Node: List of Debugger Commands850526
+Node: Breakpoint Control851859
+Node: Debugger Execution Control855553
+Node: Viewing And Changing Data858915
+Node: Execution Stack862289
+Node: Debugger Info863926
+Node: Miscellaneous Debugger Commands867997
+Node: Readline Support873085
+Node: Limitations873981
+Node: Debugging Summary876090
+Node: Arbitrary Precision Arithmetic877263
+Node: Computer Arithmetic878679
+Ref: table-numeric-ranges882270
+Ref: Computer Arithmetic-Footnote-1882992
+Node: Math Definitions883049
+Ref: table-ieee-formats886363
+Ref: Math Definitions-Footnote-1886966
+Node: MPFR features887071
+Node: FP Math Caution888744
+Ref: FP Math Caution-Footnote-1889816
+Node: Inexactness of computations890185
+Node: Inexact representation891145
+Node: Comparing FP Values892505
+Node: Errors accumulate893587
+Node: Getting Accuracy895020
+Node: Try To Round897730
+Node: Setting precision898629
+Ref: table-predefined-precision-strings899326
+Node: Setting the rounding mode901156
+Ref: table-gawk-rounding-modes901530
+Ref: Setting the rounding mode-Footnote-1904938
+Node: Arbitrary Precision Integers905117
+Ref: Arbitrary Precision Integers-Footnote-1908101
+Node: POSIX Floating Point Problems908250
+Ref: POSIX Floating Point Problems-Footnote-1912132
+Node: Floating point summary912170
+Node: Dynamic Extensions914360
+Node: Extension Intro915913
+Node: Plugin License917179
+Node: Extension Mechanism Outline917976
+Ref: figure-load-extension918415
+Ref: figure-register-new-function919980
+Ref: figure-call-new-function921072
+Node: Extension API Description923135
+Node: Extension API Functions Introduction924583
+Node: General Data Types929395
+Ref: General Data Types-Footnote-1935350
+Node: Memory Allocation Functions935649
+Ref: Memory Allocation Functions-Footnote-1938494
+Node: Constructor Functions938593
+Node: Registration Functions940338
+Node: Extension Functions941023
+Node: Exit Callback Functions943322
+Node: Extension Version String944572
+Node: Input Parsers945235
+Node: Output Wrappers955120
+Node: Two-way processors959632
+Node: Printing Messages961896
+Ref: Printing Messages-Footnote-1962970
+Node: Updating ERRNO963123
+Node: Requesting Values963862
+Ref: table-value-types-returned964599
+Node: Accessing Parameters965482
+Node: Symbol Table Access966718
+Node: Symbol table by name967230
+Node: Symbol table by cookie969251
+Ref: Symbol table by cookie-Footnote-1973400
+Node: Cached values973464
+Ref: Cached values-Footnote-1976965
+Node: Array Manipulation977056
+Ref: Array Manipulation-Footnote-1978155
+Node: Array Data Types978192
+Ref: Array Data Types-Footnote-1980850
+Node: Array Functions980942
+Node: Flattening Arrays984801
+Node: Creating Arrays991709
+Node: Extension API Variables996481
+Node: Extension Versioning997117
+Node: Extension API Informational Variables999008
+Node: Extension API Boilerplate1000072
+Node: Finding Extensions1003886
+Node: Extension Example1004446
+Node: Internal File Description1005244
+Node: Internal File Ops1009324
+Ref: Internal File Ops-Footnote-11021086
+Node: Using Internal File Ops1021226
+Ref: Using Internal File Ops-Footnote-11023609
+Node: Extension Samples1023884
+Node: Extension Sample File Functions1025413
+Node: Extension Sample Fnmatch1033062
+Node: Extension Sample Fork1034549
+Node: Extension Sample Inplace1035767
+Node: Extension Sample Ord1038977
+Node: Extension Sample Readdir1039813
+Ref: table-readdir-file-types1040702
+Node: Extension Sample Revout1041507
+Node: Extension Sample Rev2way1042096
+Node: Extension Sample Read write array1042836
+Node: Extension Sample Readfile1044778
+Node: Extension Sample Time1045873
+Node: Extension Sample API Tests1047221
+Node: gawkextlib1047713
+Node: Extension summary1050137
+Node: Extension Exercises1053829
+Node: Language History1055326
+Node: V7/SVR3.11056982
+Node: SVR41059134
+Node: POSIX1060568
+Node: BTL1061948
+Node: POSIX/GNU1062678
+Node: Feature History1068199
+Node: Common Extensions1081528
+Node: Ranges and Locales1082811
+Ref: Ranges and Locales-Footnote-11087427
+Ref: Ranges and Locales-Footnote-21087454
+Ref: Ranges and Locales-Footnote-31087689
+Node: Contributors1087910
+Node: History summary1093479
+Node: Installation1094859
+Node: Gawk Distribution1095804
+Node: Getting1096288
+Node: Extracting1097249
+Node: Distribution contents1098887
+Node: Unix Installation1104640
+Node: Quick Installation1105256
+Node: Additional Configuration Options1107683
+Node: Configuration Philosophy1109487
+Node: Non-Unix Installation1111857
+Node: PC Installation1112315
+Node: PC Binary Installation1113635
+Node: PC Compiling1115487
+Ref: PC Compiling-Footnote-11118511
+Node: PC Testing1118620
+Node: PC Using1119800
+Node: Cygwin1123914
+Node: MSYS1124684
+Node: VMS Installation1125185
+Node: VMS Compilation1125976
+Ref: VMS Compilation-Footnote-11127206
+Node: VMS Dynamic Extensions1127264
+Node: VMS Installation Details1128949
+Node: VMS Running1131202
+Node: VMS GNV1134043
+Node: VMS Old Gawk1134778
+Node: Bugs1135249
+Node: Other Versions1139446
+Node: Installation summary1146032
+Node: Notes1147090
+Node: Compatibility Mode1147955
+Node: Additions1148737
+Node: Accessing The Source1149662
+Node: Adding Code1151098
+Node: New Ports1157317
+Node: Derived Files1161805
+Ref: Derived Files-Footnote-11167290
+Ref: Derived Files-Footnote-21167325
+Ref: Derived Files-Footnote-31167923
+Node: Future Extensions1168037
+Node: Implementation Limitations1168695
+Node: Extension Design1169878
+Node: Old Extension Problems1171032
+Ref: Old Extension Problems-Footnote-11172550
+Node: Extension New Mechanism Goals1172607
+Ref: Extension New Mechanism Goals-Footnote-11175971
+Node: Extension Other Design Decisions1176160
+Node: Extension Future Growth1178273
+Node: Old Extension Mechanism1179109
+Node: Notes summary1180872
+Node: Basic Concepts1182054
+Node: Basic High Level1182735
+Ref: figure-general-flow1183017
+Ref: figure-process-flow1183702
+Ref: Basic High Level-Footnote-11187003
+Node: Basic Data Typing1187188
+Node: Glossary1190516
+Node: Copying1222462
+Node: GNU Free Documentation License1260001
+Node: Index1285119
 
 End Tag Table
diff --git a/doc/gawk.texi b/doc/gawk.texi
index 5d1e45c..3260250 100644
--- a/doc/gawk.texi
+++ b/doc/gawk.texi
@@ -27238,10 +27238,9 @@ is true because locale-based comparison occurs only 
when in
 POSIX-compatibility mode, and because @code{asort()} and @code{asorti()} are
 @command{gawk} extensions, they are not available in that case.}
 
-The following example demonstrates the use of a comparison function
-with @code{asort()}.  The comparison function,
address@hidden()}, does a string comparison ignoring case
-(by mapping both values to lowercase).
+The following example demonstrates the use of a comparison function with
address@hidden()}.  The comparison function, @code{case_fold_compare()}, maps
+both values to lowercase in order to compare them ignoring case.
 
 @example
 # case_fold_compare --- compare as strings, ignoring case
@@ -27272,9 +27271,10 @@ BEGIN @{
 
     asort(data, result, "case_fold_compare")
 
-    for (i = 1; i <= 52; i++) @{
+    j = length(result)
+    for (i = 1; i <= j; i++) @{
         printf("%s", result[i])
-        if (i % 26 == 0)
+        if (i % (j/2) == 0)
             printf("\n")
         else
             printf(" ")
diff --git a/doc/gawktexi.in b/doc/gawktexi.in
index 081e067..deb212e 100644
--- a/doc/gawktexi.in
+++ b/doc/gawktexi.in
@@ -26329,10 +26329,9 @@ is true because locale-based comparison occurs only 
when in
 POSIX-compatibility mode, and because @code{asort()} and @code{asorti()} are
 @command{gawk} extensions, they are not available in that case.}
 
-The following example demonstrates the use of a comparison function
-with @code{asort()}.  The comparison function,
address@hidden()}, does a string comparison ignoring case
-(by mapping both values to lowercase).
+The following example demonstrates the use of a comparison function with
address@hidden()}.  The comparison function, @code{case_fold_compare()}, maps
+both values to lowercase in order to compare them ignoring case.
 
 @example
 # case_fold_compare --- compare as strings, ignoring case
@@ -26363,9 +26362,10 @@ BEGIN @{
 
     asort(data, result, "case_fold_compare")
 
-    for (i = 1; i <= 52; i++) @{
+    j = length(result)
+    for (i = 1; i <= j; i++) @{
         printf("%s", result[i])
-        if (i % 26 == 0)
+        if (i % (j/2) == 0)
             printf("\n")
         else
             printf(" ")

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

Summary of changes:
 doc/ChangeLog   |    6 +
 doc/gawk.info   |  431 ++++++++++++++++++++++++++++---------------------------
 doc/gawk.texi   |   12 +-
 doc/gawktexi.in |   12 +-
 4 files changed, 234 insertions(+), 227 deletions(-)


hooks/post-receive
-- 
gawk