[SCM] gawk branch, gawk-5.2-stable, updated. gawk-4.1.0-4974-gd491e66c

[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.2-stable has been updated
       via  d491e66ce8656c6b542ee8b2d6ebf30a716d9806 (commit)
      from  18dbd50d0c6a00a051e3b1b9e73b2d100a121e85 (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=d491e66ce8656c6b542ee8b2d6ebf30a716d9806

commit d491e66ce8656c6b542ee8b2d6ebf30a716d9806
Author: Arnold D. Robbins <arnold@skeeve.com>
Date:   Wed Dec 21 22:42:01 2022 +0200

    Small doc improvement.

diff --git a/doc/ChangeLog b/doc/ChangeLog
index 91e693c8..779319f4 100644
--- a/doc/ChangeLog
+++ b/doc/ChangeLog
@@ -1,3 +1,9 @@
+2022-12-21         Arnold D. Robbins     <arnold@skeeve.com>
+
+       * gawktexi.in (Sample Debugging Session): End gawk invocation
+       with `--' and add some explanatory prose. Thanks to
+       Greg Minshall <minshall@umich.edu> for the suggestion.
+
 2022-12-18         Arnold D. Robbins     <arnold@skeeve.com>
 
        * gawktexi.in: Switch git:// URLs to https:// URLs for Github.
diff --git a/doc/gawk.info b/doc/gawk.info
index d7af1ee4..f2f91ef6 100644
--- a/doc/gawk.info
+++ b/doc/gawk.info
@@ -23269,14 +23269,17 @@ one or more '-f' options.  ('gawk' is not designed to 
debug command-line
 programs, only programs contained in files.)  In our case, we invoke the
 debugger like this:
 
-     $ gawk -D -f getopt.awk -f join.awk -f uniq.awk -1 inputfile
+     $ gawk -D -f getopt.awk -f join.awk -f uniq.awk -- -1 inputfile
 
 where both 'getopt.awk' and 'uniq.awk' are in '$AWKPATH'.  (Experienced
 users of GDB or similar debuggers should note that this syntax is
 slightly different from what you are used to.  With the 'gawk' debugger,
 you give the arguments for running the program in the command line to
 the debugger rather than as part of the 'run' command at the debugger
-prompt.)  The '-1' is an option to 'uniq.awk'.
+prompt.)  The '--' ends 'gawk''s command line options.  It's not
+strictly necessary here, but it is needed if an option to the 'awk'
+program conflicts with a 'gawk' option.  The '-1' is an option to
+'uniq.awk'.
 
    Instead of immediately running the program on 'inputfile', as 'gawk'
 would ordinarily do, the debugger merely loads all the program source
@@ -36696,7 +36699,7 @@ Index
 * debugger, capabilities:                Debugging Concepts.  (line  16)
 * debugger, concepts:                    Debugging Terms.     (line   6)
 * debugger, how to start:                Debugger Invocation. (line   6)
-* debugger, prompt:                      Debugger Invocation. (line  23)
+* debugger, prompt:                      Debugger Invocation. (line  26)
 * debugger, setting a breakpoint:        Finding The Bug.     (line  32)
 * debugger, commands, breakpoint:        Finding The Bug.     (line  32)
 * debugger, commands, break:             Finding The Bug.     (line  32)
@@ -39668,214 +39671,214 @@ Node: Awk Debugging942021
 Ref: Awk Debugging-Footnote-1942966
 Node: Sample Debugging Session943098
 Node: Debugger Invocation943632
-Node: Finding The Bug945018
-Node: List of Debugger Commands951492
-Node: Breakpoint Control952825
-Node: Debugger Execution Control956519
-Node: Viewing And Changing Data959881
-Node: Execution Stack963422
-Node: Debugger Info965059
-Node: Miscellaneous Debugger Commands969130
-Node: Readline Support974192
-Node: Limitations975088
-Node: Debugging Summary977642
-Node: Namespaces978921
-Node: Global Namespace980032
-Node: Qualified Names981430
-Node: Default Namespace982429
-Node: Changing The Namespace983170
-Node: Naming Rules984784
-Node: Internal Name Management986632
-Node: Namespace Example987674
-Node: Namespace And Features990236
-Node: Namespace Summary991671
-Node: Arbitrary Precision Arithmetic993148
-Node: Computer Arithmetic994635
-Ref: table-numeric-ranges998401
-Ref: table-floating-point-ranges998895
-Ref: Computer Arithmetic-Footnote-1999554
-Node: Math Definitions999611
-Ref: table-ieee-formats1002587
-Node: MPFR features1003155
-Node: MPFR On Parole1003600
-Ref: MPFR On Parole-Footnote-11004429
-Node: MPFR Intro1004584
-Node: FP Math Caution1006238
-Ref: FP Math Caution-Footnote-11007310
-Node: Inexactness of computations1007679
-Node: Inexact representation1008710
-Node: Comparing FP Values1010070
-Node: Errors accumulate1011311
-Node: Strange values1012767
-Ref: Strange values-Footnote-11015355
-Node: Getting Accuracy1015460
-Node: Try To Round1018170
-Node: Setting precision1019069
-Ref: table-predefined-precision-strings1019766
-Node: Setting the rounding mode1021597
-Ref: table-gawk-rounding-modes1021971
-Ref: Setting the rounding mode-Footnote-11025903
-Node: Arbitrary Precision Integers1026082
-Ref: Arbitrary Precision Integers-Footnote-11029257
-Node: Checking for MPFR1029406
-Node: POSIX Floating Point Problems1030880
-Ref: POSIX Floating Point Problems-Footnote-11035533
-Node: Floating point summary1035571
-Node: Dynamic Extensions1037761
-Node: Extension Intro1039314
-Node: Plugin License1040580
-Node: Extension Mechanism Outline1041377
-Ref: figure-load-extension1041816
-Ref: figure-register-new-function1043382
-Ref: figure-call-new-function1044475
-Node: Extension API Description1046538
-Node: Extension API Functions Introduction1048251
-Ref: table-api-std-headers1050087
-Node: General Data Types1054337
-Ref: General Data Types-Footnote-11063043
-Node: Memory Allocation Functions1063342
-Ref: Memory Allocation Functions-Footnote-11067843
-Node: Constructor Functions1067942
-Node: API Ownership of MPFR and GMP Values1071595
-Node: Registration Functions1073128
-Node: Extension Functions1073828
-Node: Exit Callback Functions1079150
-Node: Extension Version String1080400
-Node: Input Parsers1081063
-Node: Output Wrappers1093784
-Node: Two-way processors1098296
-Node: Printing Messages1100561
-Ref: Printing Messages-Footnote-11101732
-Node: Updating ERRNO1101885
-Node: Requesting Values1102624
-Ref: table-value-types-returned1103361
-Node: Accessing Parameters1104470
-Node: Symbol Table Access1105707
-Node: Symbol table by name1106219
-Ref: Symbol table by name-Footnote-11109244
-Node: Symbol table by cookie1109372
-Ref: Symbol table by cookie-Footnote-11113557
-Node: Cached values1113621
-Ref: Cached values-Footnote-11117157
-Node: Array Manipulation1117310
-Ref: Array Manipulation-Footnote-11118401
-Node: Array Data Types1118438
-Ref: Array Data Types-Footnote-11121096
-Node: Array Functions1121188
-Node: Flattening Arrays1125973
-Node: Creating Arrays1132949
-Node: Redirection API1137716
-Node: Extension API Variables1140549
-Node: Extension Versioning1141260
-Ref: gawk-api-version1141689
-Node: Extension GMP/MPFR Versioning1143421
-Node: Extension API Informational Variables1145049
-Node: Extension API Boilerplate1146122
-Node: Changes from API V11150096
-Node: Finding Extensions1151668
-Node: Extension Example1152227
-Node: Internal File Description1153025
-Node: Internal File Ops1157105
-Ref: Internal File Ops-Footnote-11168455
-Node: Using Internal File Ops1168595
-Ref: Using Internal File Ops-Footnote-11170978
-Node: Extension Samples1171252
-Node: Extension Sample File Functions1172781
-Node: Extension Sample Fnmatch1180430
-Node: Extension Sample Fork1181917
-Node: Extension Sample Inplace1183135
-Node: Extension Sample Ord1186761
-Node: Extension Sample Readdir1187597
-Ref: table-readdir-file-types1188486
-Node: Extension Sample Revout1189554
-Node: Extension Sample Rev2way1190143
-Node: Extension Sample Read write array1190883
-Node: Extension Sample Readfile1194069
-Node: Extension Sample Time1195164
-Node: Extension Sample API Tests1196916
-Node: gawkextlib1197408
-Node: Extension summary1200326
-Node: Extension Exercises1204028
-Node: Language History1205270
-Node: V7/SVR3.11206926
-Node: SVR41209078
-Node: POSIX1210512
-Node: BTL1211893
-Node: POSIX/GNU1212622
-Node: Feature History1218539
-Node: Common Extensions1236370
-Node: Ranges and Locales1237653
-Ref: Ranges and Locales-Footnote-11242269
-Ref: Ranges and Locales-Footnote-21242296
-Ref: Ranges and Locales-Footnote-31242531
-Node: Contributors1242754
-Node: History summary1248751
-Node: Installation1250131
-Node: Gawk Distribution1251075
-Node: Getting1251559
-Node: Extracting1252522
-Node: Distribution contents1254160
-Node: Unix Installation1261658
-Node: Quick Installation1262462
-Node: Compiling with MPFR1264882
-Node: Shell Startup Files1265572
-Node: Additional Configuration Options1266661
-Node: Configuration Philosophy1268976
-Node: Compiling from Git1271372
-Node: Building the Documentation1271927
-Node: Non-Unix Installation1273311
-Node: PC Installation1273775
-Node: PC Binary Installation1274620
-Node: PC Compiling1275493
-Node: PC Using1276599
-Node: Cygwin1280095
-Node: MSYS1281319
-Node: OpenVMS Installation1281921
-Node: OpenVMS Compilation1282582
-Ref: OpenVMS Compilation-Footnote-11284005
-Node: OpenVMS Dynamic Extensions1284063
-Node: OpenVMS Installation Details1285675
-Node: OpenVMS Running1287970
-Node: OpenVMS GNV1291971
-Node: Bugs1292714
-Node: Bug definition1293626
-Node: Bug address1297128
-Node: Usenet1300647
-Node: Performance bugs1301836
-Node: Asking for help1304757
-Node: Maintainers1306724
-Node: Other Versions1307731
-Node: Installation summary1316314
-Node: Notes1317654
-Node: Compatibility Mode1318448
-Node: Additions1319230
-Node: Accessing The Source1320155
-Node: Adding Code1321650
-Node: New Ports1328465
-Node: Derived Files1332840
-Ref: Derived Files-Footnote-11338499
-Ref: Derived Files-Footnote-21338534
-Ref: Derived Files-Footnote-31339129
-Node: Future Extensions1339243
-Node: Implementation Limitations1339901
-Node: Extension Design1341111
-Node: Old Extension Problems1342255
-Ref: Old Extension Problems-Footnote-11343773
-Node: Extension New Mechanism Goals1343830
-Ref: Extension New Mechanism Goals-Footnote-11347194
-Node: Extension Other Design Decisions1347383
-Node: Extension Future Growth1349496
-Node: Notes summary1350102
-Node: Basic Concepts1351260
-Node: Basic High Level1351941
-Ref: figure-general-flow1352223
-Ref: figure-process-flow1352909
-Ref: Basic High Level-Footnote-11356211
-Node: Basic Data Typing1356396
-Node: Glossary1359724
-Node: Copying1391611
-Node: GNU Free Documentation License1429154
-Node: Index1454274
+Node: Finding The Bug945185
+Node: List of Debugger Commands951659
+Node: Breakpoint Control952992
+Node: Debugger Execution Control956686
+Node: Viewing And Changing Data960048
+Node: Execution Stack963589
+Node: Debugger Info965226
+Node: Miscellaneous Debugger Commands969297
+Node: Readline Support974359
+Node: Limitations975255
+Node: Debugging Summary977809
+Node: Namespaces979088
+Node: Global Namespace980199
+Node: Qualified Names981597
+Node: Default Namespace982596
+Node: Changing The Namespace983337
+Node: Naming Rules984951
+Node: Internal Name Management986799
+Node: Namespace Example987841
+Node: Namespace And Features990403
+Node: Namespace Summary991838
+Node: Arbitrary Precision Arithmetic993315
+Node: Computer Arithmetic994802
+Ref: table-numeric-ranges998568
+Ref: table-floating-point-ranges999062
+Ref: Computer Arithmetic-Footnote-1999721
+Node: Math Definitions999778
+Ref: table-ieee-formats1002754
+Node: MPFR features1003322
+Node: MPFR On Parole1003767
+Ref: MPFR On Parole-Footnote-11004596
+Node: MPFR Intro1004751
+Node: FP Math Caution1006405
+Ref: FP Math Caution-Footnote-11007477
+Node: Inexactness of computations1007846
+Node: Inexact representation1008877
+Node: Comparing FP Values1010237
+Node: Errors accumulate1011478
+Node: Strange values1012934
+Ref: Strange values-Footnote-11015522
+Node: Getting Accuracy1015627
+Node: Try To Round1018337
+Node: Setting precision1019236
+Ref: table-predefined-precision-strings1019933
+Node: Setting the rounding mode1021764
+Ref: table-gawk-rounding-modes1022138
+Ref: Setting the rounding mode-Footnote-11026070
+Node: Arbitrary Precision Integers1026249
+Ref: Arbitrary Precision Integers-Footnote-11029424
+Node: Checking for MPFR1029573
+Node: POSIX Floating Point Problems1031047
+Ref: POSIX Floating Point Problems-Footnote-11035700
+Node: Floating point summary1035738
+Node: Dynamic Extensions1037928
+Node: Extension Intro1039481
+Node: Plugin License1040747
+Node: Extension Mechanism Outline1041544
+Ref: figure-load-extension1041983
+Ref: figure-register-new-function1043549
+Ref: figure-call-new-function1044642
+Node: Extension API Description1046705
+Node: Extension API Functions Introduction1048418
+Ref: table-api-std-headers1050254
+Node: General Data Types1054504
+Ref: General Data Types-Footnote-11063210
+Node: Memory Allocation Functions1063509
+Ref: Memory Allocation Functions-Footnote-11068010
+Node: Constructor Functions1068109
+Node: API Ownership of MPFR and GMP Values1071762
+Node: Registration Functions1073295
+Node: Extension Functions1073995
+Node: Exit Callback Functions1079317
+Node: Extension Version String1080567
+Node: Input Parsers1081230
+Node: Output Wrappers1093951
+Node: Two-way processors1098463
+Node: Printing Messages1100728
+Ref: Printing Messages-Footnote-11101899
+Node: Updating ERRNO1102052
+Node: Requesting Values1102791
+Ref: table-value-types-returned1103528
+Node: Accessing Parameters1104637
+Node: Symbol Table Access1105874
+Node: Symbol table by name1106386
+Ref: Symbol table by name-Footnote-11109411
+Node: Symbol table by cookie1109539
+Ref: Symbol table by cookie-Footnote-11113724
+Node: Cached values1113788
+Ref: Cached values-Footnote-11117324
+Node: Array Manipulation1117477
+Ref: Array Manipulation-Footnote-11118568
+Node: Array Data Types1118605
+Ref: Array Data Types-Footnote-11121263
+Node: Array Functions1121355
+Node: Flattening Arrays1126140
+Node: Creating Arrays1133116
+Node: Redirection API1137883
+Node: Extension API Variables1140716
+Node: Extension Versioning1141427
+Ref: gawk-api-version1141856
+Node: Extension GMP/MPFR Versioning1143588
+Node: Extension API Informational Variables1145216
+Node: Extension API Boilerplate1146289
+Node: Changes from API V11150263
+Node: Finding Extensions1151835
+Node: Extension Example1152394
+Node: Internal File Description1153192
+Node: Internal File Ops1157272
+Ref: Internal File Ops-Footnote-11168622
+Node: Using Internal File Ops1168762
+Ref: Using Internal File Ops-Footnote-11171145
+Node: Extension Samples1171419
+Node: Extension Sample File Functions1172948
+Node: Extension Sample Fnmatch1180597
+Node: Extension Sample Fork1182084
+Node: Extension Sample Inplace1183302
+Node: Extension Sample Ord1186928
+Node: Extension Sample Readdir1187764
+Ref: table-readdir-file-types1188653
+Node: Extension Sample Revout1189721
+Node: Extension Sample Rev2way1190310
+Node: Extension Sample Read write array1191050
+Node: Extension Sample Readfile1194236
+Node: Extension Sample Time1195331
+Node: Extension Sample API Tests1197083
+Node: gawkextlib1197575
+Node: Extension summary1200493
+Node: Extension Exercises1204195
+Node: Language History1205437
+Node: V7/SVR3.11207093
+Node: SVR41209245
+Node: POSIX1210679
+Node: BTL1212060
+Node: POSIX/GNU1212789
+Node: Feature History1218706
+Node: Common Extensions1236537
+Node: Ranges and Locales1237820
+Ref: Ranges and Locales-Footnote-11242436
+Ref: Ranges and Locales-Footnote-21242463
+Ref: Ranges and Locales-Footnote-31242698
+Node: Contributors1242921
+Node: History summary1248918
+Node: Installation1250298
+Node: Gawk Distribution1251242
+Node: Getting1251726
+Node: Extracting1252689
+Node: Distribution contents1254327
+Node: Unix Installation1261825
+Node: Quick Installation1262629
+Node: Compiling with MPFR1265049
+Node: Shell Startup Files1265739
+Node: Additional Configuration Options1266828
+Node: Configuration Philosophy1269143
+Node: Compiling from Git1271539
+Node: Building the Documentation1272094
+Node: Non-Unix Installation1273478
+Node: PC Installation1273942
+Node: PC Binary Installation1274787
+Node: PC Compiling1275660
+Node: PC Using1276766
+Node: Cygwin1280262
+Node: MSYS1281486
+Node: OpenVMS Installation1282088
+Node: OpenVMS Compilation1282749
+Ref: OpenVMS Compilation-Footnote-11284172
+Node: OpenVMS Dynamic Extensions1284230
+Node: OpenVMS Installation Details1285842
+Node: OpenVMS Running1288137
+Node: OpenVMS GNV1292138
+Node: Bugs1292881
+Node: Bug definition1293793
+Node: Bug address1297295
+Node: Usenet1300814
+Node: Performance bugs1302003
+Node: Asking for help1304924
+Node: Maintainers1306891
+Node: Other Versions1307898
+Node: Installation summary1316481
+Node: Notes1317821
+Node: Compatibility Mode1318615
+Node: Additions1319397
+Node: Accessing The Source1320322
+Node: Adding Code1321817
+Node: New Ports1328632
+Node: Derived Files1333007
+Ref: Derived Files-Footnote-11338666
+Ref: Derived Files-Footnote-21338701
+Ref: Derived Files-Footnote-31339296
+Node: Future Extensions1339410
+Node: Implementation Limitations1340068
+Node: Extension Design1341278
+Node: Old Extension Problems1342422
+Ref: Old Extension Problems-Footnote-11343940
+Node: Extension New Mechanism Goals1343997
+Ref: Extension New Mechanism Goals-Footnote-11347361
+Node: Extension Other Design Decisions1347550
+Node: Extension Future Growth1349663
+Node: Notes summary1350269
+Node: Basic Concepts1351427
+Node: Basic High Level1352108
+Ref: figure-general-flow1352390
+Ref: figure-process-flow1353076
+Ref: Basic High Level-Footnote-11356378
+Node: Basic Data Typing1356563
+Node: Glossary1359891
+Node: Copying1391778
+Node: GNU Free Documentation License1429321
+Node: Index1454441
 
 End Tag Table
 
diff --git a/doc/gawk.texi b/doc/gawk.texi
index c359e8e9..4b5a8545 100644
--- a/doc/gawk.texi
+++ b/doc/gawk.texi
@@ -32474,7 +32474,7 @@ to debug command-line programs, only programs contained 
in files.)
 In our case, we invoke the debugger like this:
 
 @example
-$ @kbd{gawk -D -f getopt.awk -f join.awk -f uniq.awk -1 inputfile}
+$ @kbd{gawk -D -f getopt.awk -f join.awk -f uniq.awk -- -1 inputfile}
 @end example
 
 @cindex @env{AWKPATH} environment variable
@@ -32486,6 +32486,9 @@ this syntax is slightly different from what you are 
used to.
 With the @command{gawk} debugger, you give the arguments for running the 
program
 in the command line to the debugger rather than as part of the @code{run}
 command at the debugger prompt.)
+The @option{--} ends @command{gawk}'s command line options. It's not
+strictly necessary here, but it is needed if an option to the @command{awk}
+program conflicts with a @command{gawk} option.
 The @option{-1} is an option to @file{uniq.awk}.
 
 @cindex debugger @subentry prompt
diff --git a/doc/gawktexi.in b/doc/gawktexi.in
index 2c7e47fa..6d28e031 100644
--- a/doc/gawktexi.in
+++ b/doc/gawktexi.in
@@ -31356,7 +31356,7 @@ to debug command-line programs, only programs contained 
in files.)
 In our case, we invoke the debugger like this:
 
 @example
-$ @kbd{gawk -D -f getopt.awk -f join.awk -f uniq.awk -1 inputfile}
+$ @kbd{gawk -D -f getopt.awk -f join.awk -f uniq.awk -- -1 inputfile}
 @end example
 
 @cindex @env{AWKPATH} environment variable
@@ -31368,6 +31368,9 @@ this syntax is slightly different from what you are 
used to.
 With the @command{gawk} debugger, you give the arguments for running the 
program
 in the command line to the debugger rather than as part of the @code{run}
 command at the debugger prompt.)
+The @option{--} ends @command{gawk}'s command line options. It's not
+strictly necessary here, but it is needed if an option to the @command{awk}
+program conflicts with a @command{gawk} option.
 The @option{-1} is an option to @file{uniq.awk}.
 
 @cindex debugger @subentry prompt

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

Summary of changes:
 doc/ChangeLog   |   6 +
 doc/gawk.info   | 425 ++++++++++++++++++++++++++++----------------------------
 doc/gawk.texi   |   5 +-
 doc/gawktexi.in |   5 +-
 4 files changed, 228 insertions(+), 213 deletions(-)


hooks/post-receive
-- 
gawk