[SCM] gawk branch, gawk-5.3-stable, updated. gawk-4.1.0-5461-gc01c1d0b

[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.3-stable has been updated
       via  c01c1d0ba90038a47a96c34df10a01959d7e6841 (commit)
      from  12ceb334259f4df8ac08eb06fc70a6f7d919d464 (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=c01c1d0ba90038a47a96c34df10a01959d7e6841

commit c01c1d0ba90038a47a96c34df10a01959d7e6841
Author: Arnold D. Robbins <arnold@skeeve.com>
Date:   Sun Mar 3 20:50:08 2024 +0200

    Doc update for inplace extension.

diff --git a/doc/ChangeLog b/doc/ChangeLog
index 5ad7111c..af9df498 100644
--- a/doc/ChangeLog
+++ b/doc/ChangeLog
@@ -1,3 +1,9 @@
+2024-03-03         Arnold D. Robbins     <arnold@skeeve.com>
+
+       * gawk.texi (Extension Sample Inplace): Document that it
+       helps to redirect stdout in order to get block buffering.
+       Thanks to Ed Morton for pointing this out.
+
 2024-02-26         Arnold D. Robbins     <arnold@skeeve.com>
 
        * gawk.texi: Fix a typo.
diff --git a/doc/gawk.info b/doc/gawk.info
index d6ae2091..fcce95d9 100644
--- a/doc/gawk.info
+++ b/doc/gawk.info
@@ -29742,10 +29742,14 @@ and functions in the ‘inplace’ namespace (*note 
Namespaces::):
    For each regular file that is processed, the extension redirects
 standard output to a temporary file configured to have the same owner
 and permissions as the original.  After the file has been processed, the
-extension restores standard output to its original destination.  If
-‘inplace::suffix’ is not an empty string, the original file is linked to
-a backup file name created by appending that suffix.  Finally, the
-temporary file is renamed to the original file name.
+extension restores standard output to its original destination.  (Due to
+this implementation, it helps to redirect ‘gawk’'s standard output to
+‘/dev/null’, instead of leaving it set to your terminal, so that output
+will be block-buffered instead of line-buffered.)
+
+   If ‘inplace::suffix’ is not an empty string, the original file is
+linked to a backup file name created by appending that suffix.  Finally,
+the temporary file is renamed to the original file name.
 
    Note that the use of this feature can be controlled by placing
 ‘inplace::enable=0’ on the command-line prior to listing files that
@@ -40350,98 +40354,98 @@ Node: Extension Sample File Functions1233225
 Node: Extension Sample Fnmatch1241350
 Node: Extension Sample Fork1242945
 Node: Extension Sample Inplace1244221
-Node: Extension Sample Ord1248111
-Node: Extension Sample Readdir1248987
-Ref: table-readdir-file-types1249776
-Node: Extension Sample Revout1251132
-Node: Extension Sample Rev2way1251729
-Node: Extension Sample Read write array1252481
-Node: Extension Sample Readfile1255755
-Node: Extension Sample Time1256886
-Node: Extension Sample API Tests1258886
-Node: gawkextlib1259394
-Node: Extension summary1262426
-Node: Extension Exercises1266274
-Node: Language History1267544
-Node: V7/SVR3.11269256
-Node: SVR41271606
-Node: POSIX1273138
-Node: BTL1274563
-Node: POSIX/GNU1275330
-Node: Feature History1281985
-Node: Common Extensions1301787
-Node: Ranges and Locales1303262
-Ref: Ranges and Locales-Footnote-11308047
-Ref: Ranges and Locales-Footnote-21308074
-Ref: Ranges and Locales-Footnote-31308309
-Node: Contributors1308532
-Node: History summary1314723
-Node: Installation1316165
-Node: Gawk Distribution1317129
-Node: Getting1317621
-Node: Extracting1318620
-Node: Distribution contents1320326
-Node: Unix Installation1328216
-Node: Quick Installation1329036
-Node: Compiling with MPFR1331576
-Node: Shell Startup Files1332282
-Node: Additional Configuration Options1333439
-Node: Configuration Philosophy1335822
-Node: Compiling from Git1338322
-Node: Building the Documentation1338881
-Node: Non-Unix Installation1340293
-Node: PC Installation1340769
-Node: PC Binary Installation1341638
-Node: PC Compiling1342531
-Node: PC Using1343709
-Node: Cygwin1347425
-Node: MSYS1348677
-Node: OpenVMS Installation1349303
-Node: OpenVMS Compilation1349984
-Ref: OpenVMS Compilation-Footnote-11351467
-Node: OpenVMS Dynamic Extensions1351525
-Node: OpenVMS Installation Details1353161
-Node: OpenVMS Running1355592
-Node: OpenVMS GNV1359729
-Node: Bugs1360484
-Node: Bug definition1361404
-Node: Bug address1365005
-Node: Usenet1368574
-Node: Performance bugs1369787
-Node: Asking for help1372803
-Node: Maintainers1374790
-Node: Other Versions1375817
-Node: Installation summary1385421
-Node: Notes1386803
-Node: Compatibility Mode1387613
-Node: Additions1388435
-Node: Accessing The Source1389380
-Node: Adding Code1390911
-Node: New Ports1398022
-Node: Derived Files1402525
-Ref: Derived Files-Footnote-11408336
-Ref: Derived Files-Footnote-21408371
-Ref: Derived Files-Footnote-31408982
-Node: Future Extensions1409096
-Node: Implementation Limitations1409766
-Node: Extension Design1411008
-Node: Old Extension Problems1412168
-Ref: Old Extension Problems-Footnote-11413740
-Node: Extension New Mechanism Goals1413801
-Ref: Extension New Mechanism Goals-Footnote-11417271
-Node: Extension Other Design Decisions1417472
-Node: Extension Future Growth1419669
-Node: Notes summary1420289
-Node: Basic Concepts1421499
-Node: Basic High Level1422184
-Ref: figure-general-flow1422466
-Ref: figure-process-flow1423168
-Ref: Basic High Level-Footnote-11426538
-Node: Basic Data Typing1426727
-Node: Glossary1430135
-Node: Copying1463014
-Node: GNU Free Documentation License1500572
-Node: Index1525695
+Node: Extension Sample Ord1248323
+Node: Extension Sample Readdir1249199
+Ref: table-readdir-file-types1249988
+Node: Extension Sample Revout1251344
+Node: Extension Sample Rev2way1251941
+Node: Extension Sample Read write array1252693
+Node: Extension Sample Readfile1255967
+Node: Extension Sample Time1257098
+Node: Extension Sample API Tests1259098
+Node: gawkextlib1259606
+Node: Extension summary1262638
+Node: Extension Exercises1266486
+Node: Language History1267756
+Node: V7/SVR3.11269468
+Node: SVR41271818
+Node: POSIX1273350
+Node: BTL1274775
+Node: POSIX/GNU1275542
+Node: Feature History1282197
+Node: Common Extensions1301999
+Node: Ranges and Locales1303474
+Ref: Ranges and Locales-Footnote-11308259
+Ref: Ranges and Locales-Footnote-21308286
+Ref: Ranges and Locales-Footnote-31308521
+Node: Contributors1308744
+Node: History summary1314935
+Node: Installation1316377
+Node: Gawk Distribution1317341
+Node: Getting1317833
+Node: Extracting1318832
+Node: Distribution contents1320538
+Node: Unix Installation1328428
+Node: Quick Installation1329248
+Node: Compiling with MPFR1331788
+Node: Shell Startup Files1332494
+Node: Additional Configuration Options1333651
+Node: Configuration Philosophy1336034
+Node: Compiling from Git1338534
+Node: Building the Documentation1339093
+Node: Non-Unix Installation1340505
+Node: PC Installation1340981
+Node: PC Binary Installation1341850
+Node: PC Compiling1342743
+Node: PC Using1343921
+Node: Cygwin1347637
+Node: MSYS1348889
+Node: OpenVMS Installation1349515
+Node: OpenVMS Compilation1350196
+Ref: OpenVMS Compilation-Footnote-11351679
+Node: OpenVMS Dynamic Extensions1351737
+Node: OpenVMS Installation Details1353373
+Node: OpenVMS Running1355804
+Node: OpenVMS GNV1359941
+Node: Bugs1360696
+Node: Bug definition1361616
+Node: Bug address1365217
+Node: Usenet1368786
+Node: Performance bugs1369999
+Node: Asking for help1373015
+Node: Maintainers1375002
+Node: Other Versions1376029
+Node: Installation summary1385633
+Node: Notes1387015
+Node: Compatibility Mode1387825
+Node: Additions1388647
+Node: Accessing The Source1389592
+Node: Adding Code1391123
+Node: New Ports1398234
+Node: Derived Files1402737
+Ref: Derived Files-Footnote-11408548
+Ref: Derived Files-Footnote-21408583
+Ref: Derived Files-Footnote-31409194
+Node: Future Extensions1409308
+Node: Implementation Limitations1409978
+Node: Extension Design1411220
+Node: Old Extension Problems1412380
+Ref: Old Extension Problems-Footnote-11413952
+Node: Extension New Mechanism Goals1414013
+Ref: Extension New Mechanism Goals-Footnote-11417483
+Node: Extension Other Design Decisions1417684
+Node: Extension Future Growth1419881
+Node: Notes summary1420501
+Node: Basic Concepts1421711
+Node: Basic High Level1422396
+Ref: figure-general-flow1422678
+Ref: figure-process-flow1423380
+Ref: Basic High Level-Footnote-11426750
+Node: Basic Data Typing1426939
+Node: Glossary1430347
+Node: Copying1463226
+Node: GNU Free Documentation License1500784
+Node: Index1525907
 
 End Tag Table
 
diff --git a/doc/gawk.texi b/doc/gawk.texi
index a093cb08..769c82c5 100644
--- a/doc/gawk.texi
+++ b/doc/gawk.texi
@@ -39495,6 +39495,11 @@ For each regular file that is processed, the extension 
redirects
 standard output to a temporary file configured to have the same owner
 and permissions as the original.  After the file has been processed,
 the extension restores standard output to its original destination.
+(Due to this implementation, it helps to redirect @command{gawk}'s
+standard output to @file{/dev/null}, instead of leaving it set to
+your terminal, so that output will be block-buffered instead of
+line-buffered.)
+
 If @code{inplace::suffix} is not an empty string, the original file is
 linked to a backup @value{FN} created by appending that suffix.  Finally,
 the temporary file is renamed to the original @value{FN}.
@@ -39525,9 +39530,12 @@ $ @kbd{gawk -i inplace -v inplace::suffix=.bak '@{ 
gsub(/foo/, "bar") @}}
 > @kbd{@{ print @}' file1 file2 file3}
 @end example
 
-Please note that, while the extension does attempt to preserve ownership and 
permissions, it makes no attempt to copy the ACLs from the original file.
+Please note that, while the extension does attempt to preserve ownership
+and permissions, it makes no attempt to copy the ACLs from the original
+file.
 
-If the program dies prematurely, as might happen if an unhandled signal is 
received, a temporary file may be left behind.
+If the program dies prematurely, as might happen if an unhandled signal
+is received, a temporary file may be left behind.
 
 @node Extension Sample Ord
 @subsection Character and Numeric values: @code{ord()} and @code{chr()}

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

Summary of changes:
 doc/ChangeLog |   6 ++
 doc/gawk.info | 196 ++++++++++++++++++++++++++++++----------------------------
 doc/gawk.texi |  12 +++-
 3 files changed, 116 insertions(+), 98 deletions(-)


hooks/post-receive
-- 
gawk