[SCM] gawk branch, feature/pma2, updated. gawk-4.1.0-4769-g2b84c068

[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, feature/pma2 has been updated
       via  2b84c068b0568b4efaf93f9f6ffeaf2105295de7 (commit)
      from  ce3bb88b7e71e1185c243bcc22cdcc7dbb250988 (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=2b84c068b0568b4efaf93f9f6ffeaf2105295de7

commit 2b84c068b0568b4efaf93f9f6ffeaf2105295de7
Author: Arnold D. Robbins <arnold@skeeve.com>
Date:   Wed Jun 22 22:02:59 2022 +0300

    A few more small doc updates.

diff --git a/doc/gawk.info b/doc/gawk.info
index 1c94a882..aa5c0189 100644
--- a/doc/gawk.info
+++ b/doc/gawk.info
@@ -22175,7 +22175,8 @@ and arrays, not the totality of 'gawk''s internal 
state.  This lets you
 share data between unrelated programs, eliminating the need for scripts
 to communicate via text files.
 
-   Terence Kelly provides the following advice about the backing file:
+   Terence Kelly, the author of the persistent memory allocator 'gawk'
+uses, provides the following advice about the backing file:
 
      Regarding backing file size, I recommend making it far larger than
      all of the data that will ever reside in it, assuming that the file
@@ -22189,8 +22190,8 @@ to communicate via text files.
      'gawk' should still work even without sparse files.
 
    You can disable the use of the persistent memory allocator in 'gawk'
-with the '--disable-pma' to the 'configure' command at the time that you
-are building 'gawk' (*note Unix Installation::).
+with the '--disable-pma' option to the 'configure' command at the time
+that you build 'gawk' (*note Unix Installation::).
 
    Here are articles and web links that provide more information about
 persistent memory and why it's useful in a scripting language like
@@ -39366,244 +39367,244 @@ Ref: Two-way I/O-Footnote-2884071
 Node: TCP/IP Networking884153
 Node: Profiling887229
 Node: Persistent Memory896535
-Ref: Persistent Memory-Footnote-1902637
-Node: Extension Philosophy902764
-Node: Advanced Features Summary904251
-Node: Internationalization906423
-Node: I18N and L10N908097
-Node: Explaining gettext908784
-Ref: Explaining gettext-Footnote-1914676
-Ref: Explaining gettext-Footnote-2914861
-Node: Programmer i18n915026
-Ref: Programmer i18n-Footnote-1919975
-Node: Translator i18n920024
-Node: String Extraction920818
-Ref: String Extraction-Footnote-1921950
-Node: Printf Ordering922036
-Ref: Printf Ordering-Footnote-1924822
-Node: I18N Portability924886
-Ref: I18N Portability-Footnote-1927342
-Node: I18N Example927405
-Ref: I18N Example-Footnote-1930680
-Ref: I18N Example-Footnote-2930753
-Node: Gawk I18N930862
-Node: I18N Summary931484
-Node: Debugger932825
-Node: Debugging933825
-Node: Debugging Concepts934266
-Node: Debugging Terms936075
-Node: Awk Debugging938650
-Ref: Awk Debugging-Footnote-1939595
-Node: Sample Debugging Session939727
-Node: Debugger Invocation940261
-Node: Finding The Bug941647
-Node: List of Debugger Commands948121
-Node: Breakpoint Control949454
-Node: Debugger Execution Control953148
-Node: Viewing And Changing Data956510
-Node: Execution Stack960051
-Node: Debugger Info961688
-Node: Miscellaneous Debugger Commands965759
-Node: Readline Support970821
-Node: Limitations971717
-Node: Debugging Summary974271
-Node: Namespaces975550
-Node: Global Namespace976661
-Node: Qualified Names978059
-Node: Default Namespace979058
-Node: Changing The Namespace979799
-Node: Naming Rules981413
-Node: Internal Name Management983261
-Node: Namespace Example984303
-Node: Namespace And Features986865
-Node: Namespace Summary988300
-Node: Arbitrary Precision Arithmetic989777
-Node: Computer Arithmetic991264
-Ref: table-numeric-ranges995030
-Ref: table-floating-point-ranges995524
-Ref: Computer Arithmetic-Footnote-1996183
-Node: Math Definitions996240
-Ref: table-ieee-formats999216
-Node: MPFR features999784
-Node: MPFR On Parole1000229
-Ref: MPFR On Parole-Footnote-11001058
-Node: MPFR Intro1001213
-Node: FP Math Caution1002852
-Ref: FP Math Caution-Footnote-11003924
-Node: Inexactness of computations1004293
-Node: Inexact representation1005324
-Node: Comparing FP Values1006684
-Node: Errors accumulate1007925
-Node: Strange values1009381
-Ref: Strange values-Footnote-11011969
-Node: Getting Accuracy1012074
-Node: Try To Round1014784
-Node: Setting precision1015683
-Ref: table-predefined-precision-strings1016380
-Node: Setting the rounding mode1018211
-Ref: table-gawk-rounding-modes1018585
-Ref: Setting the rounding mode-Footnote-11022517
-Node: Arbitrary Precision Integers1022696
-Ref: Arbitrary Precision Integers-Footnote-11025871
-Node: Checking for MPFR1026020
-Node: POSIX Floating Point Problems1027494
-Ref: POSIX Floating Point Problems-Footnote-11032147
-Node: Floating point summary1032185
-Node: Dynamic Extensions1034375
-Node: Extension Intro1035928
-Node: Plugin License1037194
-Node: Extension Mechanism Outline1037991
-Ref: figure-load-extension1038430
-Ref: figure-register-new-function1039996
-Ref: figure-call-new-function1041089
-Node: Extension API Description1043152
-Node: Extension API Functions Introduction1044865
-Ref: table-api-std-headers1046701
-Node: General Data Types1050951
-Ref: General Data Types-Footnote-11059657
-Node: Memory Allocation Functions1059956
-Ref: Memory Allocation Functions-Footnote-11064457
-Node: Constructor Functions1064556
-Node: API Ownership of MPFR and GMP Values1068209
-Node: Registration Functions1069742
-Node: Extension Functions1070442
-Node: Exit Callback Functions1075764
-Node: Extension Version String1077014
-Node: Input Parsers1077677
-Node: Output Wrappers1090398
-Node: Two-way processors1094910
-Node: Printing Messages1097175
-Ref: Printing Messages-Footnote-11098346
-Node: Updating ERRNO1098499
-Node: Requesting Values1099238
-Ref: table-value-types-returned1099975
-Node: Accessing Parameters1101084
-Node: Symbol Table Access1102321
-Node: Symbol table by name1102833
-Ref: Symbol table by name-Footnote-11105858
-Node: Symbol table by cookie1105986
-Ref: Symbol table by cookie-Footnote-11110171
-Node: Cached values1110235
-Ref: Cached values-Footnote-11113771
-Node: Array Manipulation1113924
-Ref: Array Manipulation-Footnote-11115015
-Node: Array Data Types1115052
-Ref: Array Data Types-Footnote-11117710
-Node: Array Functions1117802
-Node: Flattening Arrays1122587
-Node: Creating Arrays1129563
-Node: Redirection API1134330
-Node: Extension API Variables1137163
-Node: Extension Versioning1137874
-Ref: gawk-api-version1138303
-Node: Extension GMP/MPFR Versioning1140035
-Node: Extension API Informational Variables1141663
-Node: Extension API Boilerplate1142736
-Node: Changes from API V11146710
-Node: Finding Extensions1148282
-Node: Extension Example1148841
-Node: Internal File Description1149639
-Node: Internal File Ops1153719
-Ref: Internal File Ops-Footnote-11165069
-Node: Using Internal File Ops1165209
-Ref: Using Internal File Ops-Footnote-11167592
-Node: Extension Samples1167866
-Node: Extension Sample File Functions1169395
-Node: Extension Sample Fnmatch1177044
-Node: Extension Sample Fork1178531
-Node: Extension Sample Inplace1179749
-Node: Extension Sample Ord1183375
-Node: Extension Sample Readdir1184211
-Ref: table-readdir-file-types1185100
-Node: Extension Sample Revout1186168
-Node: Extension Sample Rev2way1186757
-Node: Extension Sample Read write array1187497
-Node: Extension Sample Readfile1190662
-Node: Extension Sample Time1191757
-Node: Extension Sample API Tests1193509
-Node: gawkextlib1194001
-Node: Extension summary1196919
-Node: Extension Exercises1200621
-Node: Language History1201863
-Node: V7/SVR3.11203519
-Node: SVR41205671
-Node: POSIX1207105
-Node: BTL1208486
-Node: POSIX/GNU1209215
-Node: Feature History1214993
-Node: Common Extensions1232168
-Node: Ranges and Locales1233451
-Ref: Ranges and Locales-Footnote-11238067
-Ref: Ranges and Locales-Footnote-21238094
-Ref: Ranges and Locales-Footnote-31238329
-Node: Contributors1238552
-Node: History summary1244549
-Node: Installation1245929
-Node: Gawk Distribution1246873
-Node: Getting1247357
-Node: Extracting1248320
-Node: Distribution contents1249958
-Node: Unix Installation1257019
-Node: Quick Installation1257823
-Node: Compiling with MPFR1260243
-Node: Shell Startup Files1260933
-Node: Additional Configuration Options1262022
-Node: Configuration Philosophy1264337
-Node: Compiling from Git1266733
-Node: Building the Documentation1267288
-Node: Non-Unix Installation1268672
-Node: PC Installation1269132
-Node: PC Binary Installation1269970
-Node: PC Compiling1270843
-Node: PC Using1271960
-Node: Cygwin1275513
-Node: MSYS1276737
-Node: VMS Installation1277339
-Node: VMS Compilation1278058
-Ref: VMS Compilation-Footnote-11279287
-Node: VMS Dynamic Extensions1279345
-Node: VMS Installation Details1281030
-Node: VMS Running1283292
-Node: VMS GNV1287571
-Node: Bugs1288285
-Node: Bug definition1289197
-Node: Bug address1292133
-Node: Usenet1295321
-Node: Performance bugs1296510
-Node: Asking for help1299431
-Node: Maintainers1301398
-Node: Other Versions1302592
-Node: Installation summary1310862
-Node: Notes1312226
-Node: Compatibility Mode1313020
-Node: Additions1313802
-Node: Accessing The Source1314727
-Node: Adding Code1316164
-Node: New Ports1322979
-Node: Derived Files1327354
-Ref: Derived Files-Footnote-11333014
-Ref: Derived Files-Footnote-21333049
-Ref: Derived Files-Footnote-31333647
-Node: Future Extensions1333761
-Node: Implementation Limitations1334419
-Node: Extension Design1335629
-Node: Old Extension Problems1336773
-Ref: Old Extension Problems-Footnote-11338291
-Node: Extension New Mechanism Goals1338348
-Ref: Extension New Mechanism Goals-Footnote-11341712
-Node: Extension Other Design Decisions1341901
-Node: Extension Future Growth1344014
-Node: Notes summary1344620
-Node: Basic Concepts1345778
-Node: Basic High Level1346459
-Ref: figure-general-flow1346741
-Ref: figure-process-flow1347427
-Ref: Basic High Level-Footnote-11350729
-Node: Basic Data Typing1350914
-Node: Glossary1354242
-Node: Copying1386129
-Node: GNU Free Documentation License1423672
-Node: Index1448792
+Ref: Persistent Memory-Footnote-1902697
+Node: Extension Philosophy902824
+Node: Advanced Features Summary904311
+Node: Internationalization906483
+Node: I18N and L10N908157
+Node: Explaining gettext908844
+Ref: Explaining gettext-Footnote-1914736
+Ref: Explaining gettext-Footnote-2914921
+Node: Programmer i18n915086
+Ref: Programmer i18n-Footnote-1920035
+Node: Translator i18n920084
+Node: String Extraction920878
+Ref: String Extraction-Footnote-1922010
+Node: Printf Ordering922096
+Ref: Printf Ordering-Footnote-1924882
+Node: I18N Portability924946
+Ref: I18N Portability-Footnote-1927402
+Node: I18N Example927465
+Ref: I18N Example-Footnote-1930740
+Ref: I18N Example-Footnote-2930813
+Node: Gawk I18N930922
+Node: I18N Summary931544
+Node: Debugger932885
+Node: Debugging933885
+Node: Debugging Concepts934326
+Node: Debugging Terms936135
+Node: Awk Debugging938710
+Ref: Awk Debugging-Footnote-1939655
+Node: Sample Debugging Session939787
+Node: Debugger Invocation940321
+Node: Finding The Bug941707
+Node: List of Debugger Commands948181
+Node: Breakpoint Control949514
+Node: Debugger Execution Control953208
+Node: Viewing And Changing Data956570
+Node: Execution Stack960111
+Node: Debugger Info961748
+Node: Miscellaneous Debugger Commands965819
+Node: Readline Support970881
+Node: Limitations971777
+Node: Debugging Summary974331
+Node: Namespaces975610
+Node: Global Namespace976721
+Node: Qualified Names978119
+Node: Default Namespace979118
+Node: Changing The Namespace979859
+Node: Naming Rules981473
+Node: Internal Name Management983321
+Node: Namespace Example984363
+Node: Namespace And Features986925
+Node: Namespace Summary988360
+Node: Arbitrary Precision Arithmetic989837
+Node: Computer Arithmetic991324
+Ref: table-numeric-ranges995090
+Ref: table-floating-point-ranges995584
+Ref: Computer Arithmetic-Footnote-1996243
+Node: Math Definitions996300
+Ref: table-ieee-formats999276
+Node: MPFR features999844
+Node: MPFR On Parole1000289
+Ref: MPFR On Parole-Footnote-11001118
+Node: MPFR Intro1001273
+Node: FP Math Caution1002912
+Ref: FP Math Caution-Footnote-11003984
+Node: Inexactness of computations1004353
+Node: Inexact representation1005384
+Node: Comparing FP Values1006744
+Node: Errors accumulate1007985
+Node: Strange values1009441
+Ref: Strange values-Footnote-11012029
+Node: Getting Accuracy1012134
+Node: Try To Round1014844
+Node: Setting precision1015743
+Ref: table-predefined-precision-strings1016440
+Node: Setting the rounding mode1018271
+Ref: table-gawk-rounding-modes1018645
+Ref: Setting the rounding mode-Footnote-11022577
+Node: Arbitrary Precision Integers1022756
+Ref: Arbitrary Precision Integers-Footnote-11025931
+Node: Checking for MPFR1026080
+Node: POSIX Floating Point Problems1027554
+Ref: POSIX Floating Point Problems-Footnote-11032207
+Node: Floating point summary1032245
+Node: Dynamic Extensions1034435
+Node: Extension Intro1035988
+Node: Plugin License1037254
+Node: Extension Mechanism Outline1038051
+Ref: figure-load-extension1038490
+Ref: figure-register-new-function1040056
+Ref: figure-call-new-function1041149
+Node: Extension API Description1043212
+Node: Extension API Functions Introduction1044925
+Ref: table-api-std-headers1046761
+Node: General Data Types1051011
+Ref: General Data Types-Footnote-11059717
+Node: Memory Allocation Functions1060016
+Ref: Memory Allocation Functions-Footnote-11064517
+Node: Constructor Functions1064616
+Node: API Ownership of MPFR and GMP Values1068269
+Node: Registration Functions1069802
+Node: Extension Functions1070502
+Node: Exit Callback Functions1075824
+Node: Extension Version String1077074
+Node: Input Parsers1077737
+Node: Output Wrappers1090458
+Node: Two-way processors1094970
+Node: Printing Messages1097235
+Ref: Printing Messages-Footnote-11098406
+Node: Updating ERRNO1098559
+Node: Requesting Values1099298
+Ref: table-value-types-returned1100035
+Node: Accessing Parameters1101144
+Node: Symbol Table Access1102381
+Node: Symbol table by name1102893
+Ref: Symbol table by name-Footnote-11105918
+Node: Symbol table by cookie1106046
+Ref: Symbol table by cookie-Footnote-11110231
+Node: Cached values1110295
+Ref: Cached values-Footnote-11113831
+Node: Array Manipulation1113984
+Ref: Array Manipulation-Footnote-11115075
+Node: Array Data Types1115112
+Ref: Array Data Types-Footnote-11117770
+Node: Array Functions1117862
+Node: Flattening Arrays1122647
+Node: Creating Arrays1129623
+Node: Redirection API1134390
+Node: Extension API Variables1137223
+Node: Extension Versioning1137934
+Ref: gawk-api-version1138363
+Node: Extension GMP/MPFR Versioning1140095
+Node: Extension API Informational Variables1141723
+Node: Extension API Boilerplate1142796
+Node: Changes from API V11146770
+Node: Finding Extensions1148342
+Node: Extension Example1148901
+Node: Internal File Description1149699
+Node: Internal File Ops1153779
+Ref: Internal File Ops-Footnote-11165129
+Node: Using Internal File Ops1165269
+Ref: Using Internal File Ops-Footnote-11167652
+Node: Extension Samples1167926
+Node: Extension Sample File Functions1169455
+Node: Extension Sample Fnmatch1177104
+Node: Extension Sample Fork1178591
+Node: Extension Sample Inplace1179809
+Node: Extension Sample Ord1183435
+Node: Extension Sample Readdir1184271
+Ref: table-readdir-file-types1185160
+Node: Extension Sample Revout1186228
+Node: Extension Sample Rev2way1186817
+Node: Extension Sample Read write array1187557
+Node: Extension Sample Readfile1190722
+Node: Extension Sample Time1191817
+Node: Extension Sample API Tests1193569
+Node: gawkextlib1194061
+Node: Extension summary1196979
+Node: Extension Exercises1200681
+Node: Language History1201923
+Node: V7/SVR3.11203579
+Node: SVR41205731
+Node: POSIX1207165
+Node: BTL1208546
+Node: POSIX/GNU1209275
+Node: Feature History1215053
+Node: Common Extensions1232228
+Node: Ranges and Locales1233511
+Ref: Ranges and Locales-Footnote-11238127
+Ref: Ranges and Locales-Footnote-21238154
+Ref: Ranges and Locales-Footnote-31238389
+Node: Contributors1238612
+Node: History summary1244609
+Node: Installation1245989
+Node: Gawk Distribution1246933
+Node: Getting1247417
+Node: Extracting1248380
+Node: Distribution contents1250018
+Node: Unix Installation1257079
+Node: Quick Installation1257883
+Node: Compiling with MPFR1260303
+Node: Shell Startup Files1260993
+Node: Additional Configuration Options1262082
+Node: Configuration Philosophy1264397
+Node: Compiling from Git1266793
+Node: Building the Documentation1267348
+Node: Non-Unix Installation1268732
+Node: PC Installation1269192
+Node: PC Binary Installation1270030
+Node: PC Compiling1270903
+Node: PC Using1272020
+Node: Cygwin1275573
+Node: MSYS1276797
+Node: VMS Installation1277399
+Node: VMS Compilation1278118
+Ref: VMS Compilation-Footnote-11279347
+Node: VMS Dynamic Extensions1279405
+Node: VMS Installation Details1281090
+Node: VMS Running1283352
+Node: VMS GNV1287631
+Node: Bugs1288345
+Node: Bug definition1289257
+Node: Bug address1292193
+Node: Usenet1295381
+Node: Performance bugs1296570
+Node: Asking for help1299491
+Node: Maintainers1301458
+Node: Other Versions1302652
+Node: Installation summary1310922
+Node: Notes1312286
+Node: Compatibility Mode1313080
+Node: Additions1313862
+Node: Accessing The Source1314787
+Node: Adding Code1316224
+Node: New Ports1323039
+Node: Derived Files1327414
+Ref: Derived Files-Footnote-11333074
+Ref: Derived Files-Footnote-21333109
+Ref: Derived Files-Footnote-31333707
+Node: Future Extensions1333821
+Node: Implementation Limitations1334479
+Node: Extension Design1335689
+Node: Old Extension Problems1336833
+Ref: Old Extension Problems-Footnote-11338351
+Node: Extension New Mechanism Goals1338408
+Ref: Extension New Mechanism Goals-Footnote-11341772
+Node: Extension Other Design Decisions1341961
+Node: Extension Future Growth1344074
+Node: Notes summary1344680
+Node: Basic Concepts1345838
+Node: Basic High Level1346519
+Ref: figure-general-flow1346801
+Ref: figure-process-flow1347487
+Ref: Basic High Level-Footnote-11350789
+Node: Basic Data Typing1350974
+Node: Glossary1354302
+Node: Copying1386189
+Node: GNU Free Documentation License1423732
+Node: Index1448852
 
 End Tag Table
 
diff --git a/doc/gawk.texi b/doc/gawk.texi
index 3ef75120..cc4bab53 100644
--- a/doc/gawk.texi
+++ b/doc/gawk.texi
@@ -31033,7 +31033,8 @@ and arrays, not the totality of @command{gawk}'s 
internal state.
 This lets you share data between unrelated programs, eliminating
 the need for scripts to communicate via text files.
 
-Terence Kelly provides the following advice about the backing file:
+Terence Kelly, the author of the persistent memory allocator
+@command{gawk} uses, provides the following advice about the backing file:
 
 @quotation
 Regarding backing file size, I recommend making it far larger  
@@ -31058,8 +31059,8 @@ encryption.  Not sure if we need to say that here.
 @end quotation
 
 You can disable the use of the persistent memory allocator in
-@command{gawk} with the @option{--disable-pma} to the @command{configure}
-command at the time that you are building @command{gawk} (@pxref{Unix
+@command{gawk} with the @option{--disable-pma} option to the 
@command{configure}
+command at the time that you build @command{gawk} (@pxref{Unix
 Installation}).
 
 Here are articles and web links that provide more information about
diff --git a/doc/gawktexi.in b/doc/gawktexi.in
index ce35dbf9..1728eb44 100644
--- a/doc/gawktexi.in
+++ b/doc/gawktexi.in
@@ -29915,7 +29915,8 @@ and arrays, not the totality of @command{gawk}'s 
internal state.
 This lets you share data between unrelated programs, eliminating
 the need for scripts to communicate via text files.
 
-Terence Kelly provides the following advice about the backing file:
+Terence Kelly, the author of the persistent memory allocator
+@command{gawk} uses, provides the following advice about the backing file:
 
 @quotation
 Regarding backing file size, I recommend making it far larger  
@@ -29940,8 +29941,8 @@ encryption.  Not sure if we need to say that here.
 @end quotation
 
 You can disable the use of the persistent memory allocator in
-@command{gawk} with the @option{--disable-pma} to the @command{configure}
-command at the time that you are building @command{gawk} (@pxref{Unix
+@command{gawk} with the @option{--disable-pma} option to the 
@command{configure}
+command at the time that you build @command{gawk} (@pxref{Unix
 Installation}).
 
 Here are articles and web links that provide more information about

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

Summary of changes:
 doc/gawk.info   | 483 ++++++++++++++++++++++++++++----------------------------
 doc/gawk.texi   |   7 +-
 doc/gawktexi.in |   7 +-
 3 files changed, 250 insertions(+), 247 deletions(-)


hooks/post-receive
-- 
gawk