[SCM] gawk branch, gawk-5.3-stable, updated. gawk-4.1.0-5494-g3d1aa83d

[Andrew J. Schorr]

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.3-stable has been updated
       via  3d1aa83d7bc89370faa8b6fc9cbfffecdb113d3a (commit)
      from  84d2a184dd407cf68f554ee628232c47c44ae09e (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=3d1aa83d7bc89370faa8b6fc9cbfffecdb113d3a

commit 3d1aa83d7bc89370faa8b6fc9cbfffecdb113d3a
Author: Andrew J. Schorr <aschorr@telemetry-investments.com>
Date:   Tue Jul 30 11:11:53 2024 -0400

    Patch gawk.texi to include typeof and mkbool in list of gawk-only
    functions, and add a reference to that section in the namespace naming
    rules.

diff --git a/doc/ChangeLog b/doc/ChangeLog
index f6336d2b..f0fc4d88 100644
--- a/doc/ChangeLog
+++ b/doc/ChangeLog
@@ -1,3 +1,11 @@
+2024-07-29         Andrew J. Schorr      <aschorr@telemetry-investments.com>
+       
+       * gawk.texi (Extensions in gawk Not in POSIX awk): Note that
+       typeof and mkbool are also functions unique to gawk.
+       (Naming Rules): Include a reference to the POSIX/GNU node
+       so it's easier to see which gawk extension functions won't work
+       in namespaces without the awk:: scoping.
+
 2024-07-28         Arnold D. Robbins     <arnold@skeeve.com>
 
        * gawk.texi (Computer Arithmetic): Add a relevant quote.
diff --git a/doc/gawk.info b/doc/gawk.info
index bc8d09bc..41f1d360 100644
--- a/doc/gawk.info
+++ b/doc/gawk.info
@@ -24829,8 +24829,9 @@ follows.
 
    • Outside the ‘awk’ namespace, the names of the additional ‘gawk’
      built-in functions (such as ‘gensub()’ or ‘strftime()’) _may_ be
-     used as component names.  The same set of names may be used as
-     namespace names, although this has the potential to be confusing.
+     used as component names (*note Gawk Extension Functions::).  The
+     same set of names may be used as namespace names, although this has
+     the potential to be confusing.
 
    • The additional ‘gawk’ built-in functions may still be called from
      outside the ‘awk’ namespace by qualifying them.  For example,
@@ -30609,8 +30610,12 @@ current version of ‘gawk’.
           ‘xor()’ functions for bit manipulation (*note Bitwise
           Functions::)
 
-        − The ‘isarray()’ function to check if a variable is an array or
-          not (*note Type Functions::)
+        − The ‘isarray()’ function to check whether a variable is an
+          array, and the more general ‘typeof()’ function (*note Type
+          Functions::)
+
+        − The ‘mkbool()’ function to create a Boolean value (*note
+          Boolean Functions::)
 
         − The ‘bindtextdomain()’, ‘dcgettext()’, and 
‘dcngettext()’
           functions for internationalization (*note Programmer i18n::)
@@ -36765,7 +36770,7 @@ Index
 * AWKLIBPATH environment variable <4>:   Creating Arrays.     (line 129)
 * AWKLIBPATH environment variable <5>:   Using Internal File Ops.
                                                               (line  44)
-* AWKLIBPATH environment variable <6>:   POSIX/GNU.           (line 111)
+* AWKLIBPATH environment variable <6>:   POSIX/GNU.           (line 115)
 * AWKLIBPATH environment variable <7>:   Distribution contents.
                                                               (line 186)
 * AWKLIBPATH environment variable <8>:   Shell Startup Files. (line   6)
@@ -36775,7 +36780,7 @@ Index
 * AWKPATH environment variable <3>:      Igawk Program.       (line  12)
 * AWKPATH environment variable <4>:      Igawk Program.       (line 211)
 * AWKPATH environment variable <5>:      Debugger Invocation. (line  16)
-* AWKPATH environment variable <6>:      POSIX/GNU.           (line 108)
+* AWKPATH environment variable <6>:      POSIX/GNU.           (line 112)
 * AWKPATH environment variable <7>:      Feature History.     (line  11)
 * AWKPATH environment variable <8>:      Distribution contents.
                                                               (line 186)
@@ -37641,7 +37646,7 @@ Index
 * environment variables, AWKLIBPATH <4>: Creating Arrays.     (line 129)
 * environment variables, AWKLIBPATH <5>: Using Internal File Ops.
                                                               (line  44)
-* environment variables, AWKLIBPATH <6>: POSIX/GNU.           (line 111)
+* environment variables, AWKLIBPATH <6>: POSIX/GNU.           (line 115)
 * environment variables, AWKLIBPATH <7>: Distribution contents.
                                                               (line 186)
 * environment variables, AWKLIBPATH <8>: Shell Startup Files. (line   6)
@@ -37651,7 +37656,7 @@ Index
 * environment variables, AWKPATH <3>:    Igawk Program.       (line  12)
 * environment variables, AWKPATH <4>:    Igawk Program.       (line 211)
 * environment variables, AWKPATH <5>:    Debugger Invocation. (line  16)
-* environment variables, AWKPATH <6>:    POSIX/GNU.           (line 108)
+* environment variables, AWKPATH <6>:    POSIX/GNU.           (line 112)
 * environment variables, AWKPATH <7>:    Feature History.     (line  11)
 * environment variables, AWKPATH <8>:    Distribution contents.
                                                               (line 186)
@@ -40317,197 +40322,198 @@ Node: Qualified Names1035766
 Node: Default Namespace1036801
 Node: Changing The Namespace1037574
 Node: Naming Rules1039256
-Node: Internal Name Management1041171
-Node: Namespace Example1042241
-Node: Namespace And Features1044818
-Node: Namespace Summary1046273
-Node: Arbitrary Precision Arithmetic1047784
-Node: Computer Arithmetic1049303
-Ref: table-numeric-ranges1053228
-Ref: table-floating-point-ranges1053725
-Ref: Computer Arithmetic-Footnote-11054383
-Node: Math Definitions1054440
-Ref: table-ieee-formats1057472
-Node: MPFR features1058045
-Node: MPFR On Parole1058498
-Ref: MPFR On Parole-Footnote-11059339
-Node: MPFR Intro1059498
-Node: FP Math Caution1061182
-Ref: FP Math Caution-Footnote-11062254
-Node: Inexactness of computations1062627
-Node: Inexact representation1063658
-Node: Comparing FP Values1065039
-Node: Errors accumulate1066297
-Node: Strange values1067762
-Ref: Strange values-Footnote-11070416
-Node: Getting Accuracy1070521
-Node: Try To Round1073258
-Node: Setting precision1074165
-Ref: table-predefined-precision-strings1074870
-Node: Setting the rounding mode1076754
-Ref: table-gawk-rounding-modes1077136
-Ref: Setting the rounding mode-Footnote-11081188
-Node: Arbitrary Precision Integers1081371
-Ref: Arbitrary Precision Integers-Footnote-11084581
-Node: Checking for MPFR1084734
-Node: POSIX Floating Point Problems1086224
-Ref: POSIX Floating Point Problems-Footnote-11091044
-Node: Floating point summary1091082
-Node: Dynamic Extensions1093338
-Node: Extension Intro1094935
-Node: Plugin License1096237
-Node: Extension Mechanism Outline1097050
-Ref: figure-load-extension1097501
-Ref: figure-register-new-function1099079
-Ref: figure-call-new-function1100188
-Node: Extension API Description1102303
-Node: Extension API Functions Introduction1104032
-Ref: table-api-std-headers1105926
-Node: General Data Types1110367
-Ref: General Data Types-Footnote-11119513
-Node: Memory Allocation Functions1119816
-Ref: Memory Allocation Functions-Footnote-11124533
-Node: Constructor Functions1124632
-Node: API Ownership of MPFR and GMP Values1128533
-Node: Registration Functions1130086
-Node: Extension Functions1130790
-Node: Exit Callback Functions1136364
-Node: Extension Version String1137678
-Node: Input Parsers1138373
-Node: Output Wrappers1152992
-Node: Two-way processors1157834
-Node: Printing Messages1160187
-Ref: Printing Messages-Footnote-11161398
-Node: Updating ERRNO1161551
-Node: Requesting Values1162350
-Ref: table-value-types-returned1163103
-Node: Accessing Parameters1165162
-Node: Symbol Table Access1166443
-Node: Symbol table by name1166955
-Ref: Symbol table by name-Footnote-11170156
-Node: Symbol table by cookie1170288
-Ref: Symbol table by cookie-Footnote-11174557
-Node: Cached values1174621
-Ref: Cached values-Footnote-11178253
-Node: Array Manipulation1178410
-Ref: Array Manipulation-Footnote-11179509
-Node: Array Data Types1179546
-Ref: Array Data Types-Footnote-11182364
-Node: Array Functions1182460
-Node: Flattening Arrays1187489
-Node: Creating Arrays1194537
-Node: Redirection API1199379
-Node: Extension API Variables1202396
-Node: Extension Versioning1203119
-Ref: gawk-api-version1203548
-Node: Extension GMP/MPFR Versioning1205335
-Node: Extension API Informational Variables1207039
-Node: Extension API Boilerplate1208292
-Node: Changes from API V11212422
-Node: Finding Extensions1214054
-Node: Extension Example1214629
-Node: Internal File Description1215451
-Node: Internal File Ops1219743
-Ref: Internal File Ops-Footnote-11231293
-Node: Using Internal File Ops1231441
-Ref: Using Internal File Ops-Footnote-11233872
-Node: Extension Samples1234150
-Node: Extension Sample File Functions1235719
-Node: Extension Sample Fnmatch1243844
-Node: Extension Sample Fork1245439
-Node: Extension Sample Inplace1246715
-Node: Extension Sample Ord1250817
-Node: Extension Sample Readdir1251693
-Ref: table-readdir-file-types1252482
-Node: Extension Sample Revout1253838
-Node: Extension Sample Rev2way1254435
-Node: Extension Sample Read write array1255187
-Node: Extension Sample Readfile1258461
-Node: Extension Sample Time1259592
-Node: Extension Sample API Tests1261592
-Node: gawkextlib1262100
-Node: Extension summary1265132
-Node: Extension Exercises1268980
-Node: Language History1270250
-Node: V7/SVR3.11271962
-Node: SVR41274312
-Node: POSIX1275844
-Node: BTL1277269
-Node: POSIX/GNU1278036
-Node: Feature History1284691
-Node: Common Extensions1304532
-Node: Ranges and Locales1306007
-Ref: Ranges and Locales-Footnote-11310792
-Ref: Ranges and Locales-Footnote-21310819
-Ref: Ranges and Locales-Footnote-31311054
-Node: Contributors1311277
-Node: History summary1317468
-Node: Installation1318910
-Node: Gawk Distribution1319874
-Node: Getting1320366
-Node: Extracting1321365
-Node: Distribution contents1323071
-Node: Unix Installation1330961
-Node: Quick Installation1331781
-Node: Compiling with MPFR1334321
-Node: Shell Startup Files1335027
-Node: Additional Configuration Options1336184
-Node: Configuration Philosophy1338567
-Node: Compiling from Git1341067
-Node: Building the Documentation1341626
-Node: Non-Unix Installation1343038
-Node: PC Installation1343514
-Node: PC Binary Installation1344383
-Node: PC Compiling1345276
-Node: PC Using1346454
-Node: Cygwin1350170
-Node: MSYS1351422
-Node: OpenVMS Installation1352048
-Node: OpenVMS Compilation1352729
-Ref: OpenVMS Compilation-Footnote-11354212
-Node: OpenVMS Dynamic Extensions1354270
-Node: OpenVMS Installation Details1355906
-Node: OpenVMS Running1358337
-Node: OpenVMS GNV1362474
-Node: Bugs1363229
-Node: Bug definition1364149
-Node: Bug address1367750
-Node: Usenet1371319
-Node: Performance bugs1372532
-Node: Asking for help1375548
-Node: Maintainers1377535
-Node: Other Versions1378562
-Node: Installation summary1388166
-Node: Notes1389548
-Node: Compatibility Mode1390358
-Node: Additions1391180
-Node: Accessing The Source1392125
-Node: Adding Code1393656
-Node: New Ports1400767
-Node: Derived Files1405270
-Ref: Derived Files-Footnote-11411081
-Ref: Derived Files-Footnote-21411116
-Ref: Derived Files-Footnote-31411727
-Node: Future Extensions1411841
-Node: Implementation Limitations1412511
-Node: Extension Design1413753
-Node: Old Extension Problems1414913
-Ref: Old Extension Problems-Footnote-11416485
-Node: Extension New Mechanism Goals1416546
-Ref: Extension New Mechanism Goals-Footnote-11420016
-Node: Extension Other Design Decisions1420217
-Node: Extension Future Growth1422414
-Node: Notes summary1423034
-Node: Basic Concepts1424244
-Node: Basic High Level1424929
-Ref: figure-general-flow1425211
-Ref: figure-process-flow1425913
-Ref: Basic High Level-Footnote-11429283
-Node: Basic Data Typing1429472
-Node: Glossary1432880
-Node: Copying1465758
-Node: GNU Free Documentation License1503316
-Node: Index1528439
+Node: Internal Name Management1041211
+Node: Namespace Example1042281
+Node: Namespace And Features1044858
+Node: Namespace Summary1046313
+Node: Arbitrary Precision Arithmetic1047824
+Node: Computer Arithmetic1049343
+Ref: table-numeric-ranges1053268
+Ref: table-floating-point-ranges1053765
+Ref: Computer Arithmetic-Footnote-11054423
+Node: Math Definitions1054480
+Ref: table-ieee-formats1057512
+Node: MPFR features1058085
+Node: MPFR On Parole1058538
+Ref: MPFR On Parole-Footnote-11059379
+Node: MPFR Intro1059538
+Node: FP Math Caution1061222
+Ref: FP Math Caution-Footnote-11062294
+Node: Inexactness of computations1062667
+Node: Inexact representation1063698
+Node: Comparing FP Values1065079
+Node: Errors accumulate1066337
+Node: Strange values1067802
+Ref: Strange values-Footnote-11070456
+Node: Getting Accuracy1070561
+Node: Try To Round1073298
+Node: Setting precision1074205
+Ref: table-predefined-precision-strings1074910
+Node: Setting the rounding mode1076794
+Ref: table-gawk-rounding-modes1077176
+Ref: Setting the rounding mode-Footnote-11081228
+Node: Arbitrary Precision Integers1081411
+Ref: Arbitrary Precision Integers-Footnote-11084621
+Node: Checking for MPFR1084774
+Node: POSIX Floating Point Problems1086264
+Ref: POSIX Floating Point Problems-Footnote-11091084
+Node: Floating point summary1091122
+Node: Dynamic Extensions1093378
+Node: Extension Intro1094975
+Node: Plugin License1096277
+Node: Extension Mechanism Outline1097090
+Ref: figure-load-extension1097541
+Ref: figure-register-new-function1099119
+Ref: figure-call-new-function1100228
+Node: Extension API Description1102343
+Node: Extension API Functions Introduction1104072
+Ref: table-api-std-headers1105966
+Node: General Data Types1110407
+Ref: General Data Types-Footnote-11119553
+Node: Memory Allocation Functions1119856
+Ref: Memory Allocation Functions-Footnote-11124573
+Node: Constructor Functions1124672
+Node: API Ownership of MPFR and GMP Values1128573
+Node: Registration Functions1130126
+Node: Extension Functions1130830
+Node: Exit Callback Functions1136404
+Node: Extension Version String1137718
+Node: Input Parsers1138413
+Node: Output Wrappers1153032
+Node: Two-way processors1157874
+Node: Printing Messages1160227
+Ref: Printing Messages-Footnote-11161438
+Node: Updating ERRNO1161591
+Node: Requesting Values1162390
+Ref: table-value-types-returned1163143
+Node: Accessing Parameters1165202
+Node: Symbol Table Access1166483
+Node: Symbol table by name1166995
+Ref: Symbol table by name-Footnote-11170196
+Node: Symbol table by cookie1170328
+Ref: Symbol table by cookie-Footnote-11174597
+Node: Cached values1174661
+Ref: Cached values-Footnote-11178293
+Node: Array Manipulation1178450
+Ref: Array Manipulation-Footnote-11179549
+Node: Array Data Types1179586
+Ref: Array Data Types-Footnote-11182404
+Node: Array Functions1182500
+Node: Flattening Arrays1187529
+Node: Creating Arrays1194577
+Node: Redirection API1199419
+Node: Extension API Variables1202436
+Node: Extension Versioning1203159
+Ref: gawk-api-version1203588
+Node: Extension GMP/MPFR Versioning1205375
+Node: Extension API Informational Variables1207079
+Node: Extension API Boilerplate1208332
+Node: Changes from API V11212462
+Node: Finding Extensions1214094
+Node: Extension Example1214669
+Node: Internal File Description1215491
+Node: Internal File Ops1219783
+Ref: Internal File Ops-Footnote-11231333
+Node: Using Internal File Ops1231481
+Ref: Using Internal File Ops-Footnote-11233912
+Node: Extension Samples1234190
+Node: Extension Sample File Functions1235759
+Node: Extension Sample Fnmatch1243884
+Node: Extension Sample Fork1245479
+Node: Extension Sample Inplace1246755
+Node: Extension Sample Ord1250857
+Node: Extension Sample Readdir1251733
+Ref: table-readdir-file-types1252522
+Node: Extension Sample Revout1253878
+Node: Extension Sample Rev2way1254475
+Node: Extension Sample Read write array1255227
+Node: Extension Sample Readfile1258501
+Node: Extension Sample Time1259632
+Node: Extension Sample API Tests1261632
+Node: gawkextlib1262140
+Node: Extension summary1265172
+Node: Extension Exercises1269020
+Node: Language History1270290
+Node: V7/SVR3.11272002
+Node: SVR41274352
+Node: POSIX1275884
+Node: BTL1277309
+Node: POSIX/GNU1278076
+Ref: Gawk Extension Functions1281473
+Node: Feature History1284890
+Node: Common Extensions1304731
+Node: Ranges and Locales1306206
+Ref: Ranges and Locales-Footnote-11310991
+Ref: Ranges and Locales-Footnote-21311018
+Ref: Ranges and Locales-Footnote-31311253
+Node: Contributors1311476
+Node: History summary1317667
+Node: Installation1319109
+Node: Gawk Distribution1320073
+Node: Getting1320565
+Node: Extracting1321564
+Node: Distribution contents1323270
+Node: Unix Installation1331160
+Node: Quick Installation1331980
+Node: Compiling with MPFR1334520
+Node: Shell Startup Files1335226
+Node: Additional Configuration Options1336383
+Node: Configuration Philosophy1338766
+Node: Compiling from Git1341266
+Node: Building the Documentation1341825
+Node: Non-Unix Installation1343237
+Node: PC Installation1343713
+Node: PC Binary Installation1344582
+Node: PC Compiling1345475
+Node: PC Using1346653
+Node: Cygwin1350369
+Node: MSYS1351621
+Node: OpenVMS Installation1352247
+Node: OpenVMS Compilation1352928
+Ref: OpenVMS Compilation-Footnote-11354411
+Node: OpenVMS Dynamic Extensions1354469
+Node: OpenVMS Installation Details1356105
+Node: OpenVMS Running1358536
+Node: OpenVMS GNV1362673
+Node: Bugs1363428
+Node: Bug definition1364348
+Node: Bug address1367949
+Node: Usenet1371518
+Node: Performance bugs1372731
+Node: Asking for help1375747
+Node: Maintainers1377734
+Node: Other Versions1378761
+Node: Installation summary1388365
+Node: Notes1389747
+Node: Compatibility Mode1390557
+Node: Additions1391379
+Node: Accessing The Source1392324
+Node: Adding Code1393855
+Node: New Ports1400966
+Node: Derived Files1405469
+Ref: Derived Files-Footnote-11411280
+Ref: Derived Files-Footnote-21411315
+Ref: Derived Files-Footnote-31411926
+Node: Future Extensions1412040
+Node: Implementation Limitations1412710
+Node: Extension Design1413952
+Node: Old Extension Problems1415112
+Ref: Old Extension Problems-Footnote-11416684
+Node: Extension New Mechanism Goals1416745
+Ref: Extension New Mechanism Goals-Footnote-11420215
+Node: Extension Other Design Decisions1420416
+Node: Extension Future Growth1422613
+Node: Notes summary1423233
+Node: Basic Concepts1424443
+Node: Basic High Level1425128
+Ref: figure-general-flow1425410
+Ref: figure-process-flow1426112
+Ref: Basic High Level-Footnote-11429482
+Node: Basic Data Typing1429671
+Node: Glossary1433079
+Node: Copying1465957
+Node: GNU Free Documentation License1503515
+Node: Index1528638
 
 End Tag Table
 
diff --git a/doc/gawk.texi b/doc/gawk.texi
index a5089518..9583dc8c 100644
--- a/doc/gawk.texi
+++ b/doc/gawk.texi
@@ -33494,7 +33494,8 @@ function gsub(str, pat, result) @{ @dots{} @}
 @item
 Outside the @code{awk} namespace, the names of the additional @command{gawk}
 built-in functions (such as @code{gensub()} or @code{strftime()}) @emph{may}
-be used as component names.  The same set of names may be used as namespace
+be used as component names (@pxref {Gawk Extension Functions}).
+The same set of names may be used as namespace
 names, although this has the potential to be confusing.
 
 @item
@@ -40615,7 +40616,7 @@ argument, which is an array to hold the text of the 
field separators
 @end itemize
 
 @item
-Additional functions only in @command{gawk}:
+@anchor{Gawk Extension Functions}Additional functions only in @command{gawk}:
 
 @itemize @value{MINUS}
 @item
@@ -40646,9 +40647,14 @@ functions for bit manipulation
 @c In 4.1, and(), or() and xor() grew the ability to take > 2 arguments
 
 @item
-The @code{isarray()} function to check if a variable is an array or not
+The @code{isarray()} function to check whether a variable is an array, and
+the more general @code{typeof()} function
 (@pxref{Type Functions})
 
+@item
+The @code{mkbool()} function to create a Boolean value
+(@pxref{Boolean Functions})
+
 @item
 The @code{bindtextdomain()}, @code{dcgettext()}, and @code{dcngettext()}
 functions for internationalization

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

Summary of changes:
 doc/ChangeLog |   8 ++
 doc/gawk.info | 404 +++++++++++++++++++++++++++++-----------------------------
 doc/gawk.texi |  12 +-
 3 files changed, 222 insertions(+), 202 deletions(-)


hooks/post-receive
-- 
gawk