[SCM] gawk branch, gawk-5.3-stable, updated. gawk-4.1.0-5455-ga71c87ff

[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  a71c87ff2a47a85a2d1b0342b0ddae6e4d1b68f8 (commit)
      from  1aa1656ee3939e51138fe1842fa8d964f9a138ba (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=a71c87ff2a47a85a2d1b0342b0ddae6e4d1b68f8

commit a71c87ff2a47a85a2d1b0342b0ddae6e4d1b68f8
Author: Arnold D. Robbins <arnold@skeeve.com>
Date:   Mon Feb 12 11:56:30 2024 +0200

    Doc update on inplace extension.

diff --git a/doc/ChangeLog b/doc/ChangeLog
index 26b9fef1..67baf98c 100644
--- a/doc/ChangeLog
+++ b/doc/ChangeLog
@@ -1,3 +1,8 @@
+2024-02-12         Tim Rice              <trice@posteo.net>
+
+       * gawk.texi (Extension Sample Inplace): Add a note that
+       symbolic and hard links are replaced with a new file.
+
 2024-01-28         Arnold D. Robbins     <arnold@skeeve.com>
 
        * gawk.texi (Time Functions): Add a note that some versions of
diff --git a/doc/gawk.info b/doc/gawk.info
index 31767c31..2d681edd 100644
--- a/doc/gawk.info
+++ b/doc/gawk.info
@@ -29690,7 +29690,10 @@ File: gawk.info,  Node: Extension Sample Inplace,  
Next: Extension Sample Ord,
 -------------------------------------
 
 The ‘inplace’ extension emulates GNU ‘sed’'s ‘-i’ option, which 
performs
-"in-place" editing of each input file.  It uses the bundled
+"in-place" editing of each input file.  Like GNU ‘sed’, the ‘inplace’
+extension replaces links (both hard and symbolic) with new files.  If
+you wish to affect the target, you must dereference it first, for
+example using ‘realpath’ from GNU Coreutils.  It uses the bundled
 ‘inplace.awk’ include file to invoke the extension properly.  This
 extension makes use of the namespace facility to place all the variables
 and functions in the ‘inplace’ namespace (*note Namespaces::):
@@ -40347,98 +40350,98 @@ Node: Extension Sample File Functions1233224
 Node: Extension Sample Fnmatch1241349
 Node: Extension Sample Fork1242944
 Node: Extension Sample Inplace1244220
-Node: Extension Sample Ord1247886
-Node: Extension Sample Readdir1248762
-Ref: table-readdir-file-types1249551
-Node: Extension Sample Revout1250907
-Node: Extension Sample Rev2way1251504
-Node: Extension Sample Read write array1252256
-Node: Extension Sample Readfile1255530
-Node: Extension Sample Time1256661
-Node: Extension Sample API Tests1258661
-Node: gawkextlib1259169
-Node: Extension summary1262201
-Node: Extension Exercises1266049
-Node: Language History1267319
-Node: V7/SVR3.11269031
-Node: SVR41271381
-Node: POSIX1272913
-Node: BTL1274338
-Node: POSIX/GNU1275105
-Node: Feature History1281760
-Node: Common Extensions1301562
-Node: Ranges and Locales1303037
-Ref: Ranges and Locales-Footnote-11307822
-Ref: Ranges and Locales-Footnote-21307849
-Ref: Ranges and Locales-Footnote-31308084
-Node: Contributors1308307
-Node: History summary1314498
-Node: Installation1315940
-Node: Gawk Distribution1316904
-Node: Getting1317396
-Node: Extracting1318395
-Node: Distribution contents1320101
-Node: Unix Installation1327991
-Node: Quick Installation1328811
-Node: Compiling with MPFR1331351
-Node: Shell Startup Files1332057
-Node: Additional Configuration Options1333214
-Node: Configuration Philosophy1335597
-Node: Compiling from Git1338097
-Node: Building the Documentation1338656
-Node: Non-Unix Installation1340068
-Node: PC Installation1340544
-Node: PC Binary Installation1341413
-Node: PC Compiling1342306
-Node: PC Using1343484
-Node: Cygwin1347200
-Node: MSYS1348452
-Node: OpenVMS Installation1349078
-Node: OpenVMS Compilation1349759
-Ref: OpenVMS Compilation-Footnote-11351242
-Node: OpenVMS Dynamic Extensions1351300
-Node: OpenVMS Installation Details1352936
-Node: OpenVMS Running1355367
-Node: OpenVMS GNV1359504
-Node: Bugs1360259
-Node: Bug definition1361179
-Node: Bug address1364780
-Node: Usenet1368349
-Node: Performance bugs1369562
-Node: Asking for help1372578
-Node: Maintainers1374565
-Node: Other Versions1375592
-Node: Installation summary1385196
-Node: Notes1386578
-Node: Compatibility Mode1387388
-Node: Additions1388210
-Node: Accessing The Source1389155
-Node: Adding Code1390686
-Node: New Ports1397797
-Node: Derived Files1402300
-Ref: Derived Files-Footnote-11408111
-Ref: Derived Files-Footnote-21408146
-Ref: Derived Files-Footnote-31408757
-Node: Future Extensions1408871
-Node: Implementation Limitations1409541
-Node: Extension Design1410783
-Node: Old Extension Problems1411943
-Ref: Old Extension Problems-Footnote-11413515
-Node: Extension New Mechanism Goals1413576
-Ref: Extension New Mechanism Goals-Footnote-11417046
-Node: Extension Other Design Decisions1417247
-Node: Extension Future Growth1419444
-Node: Notes summary1420064
-Node: Basic Concepts1421274
-Node: Basic High Level1421959
-Ref: figure-general-flow1422241
-Ref: figure-process-flow1422943
-Ref: Basic High Level-Footnote-11426313
-Node: Basic Data Typing1426502
-Node: Glossary1429910
-Node: Copying1462789
-Node: GNU Free Documentation License1500347
-Node: Index1525470
+Node: Extension Sample Ord1248110
+Node: Extension Sample Readdir1248986
+Ref: table-readdir-file-types1249775
+Node: Extension Sample Revout1251131
+Node: Extension Sample Rev2way1251728
+Node: Extension Sample Read write array1252480
+Node: Extension Sample Readfile1255754
+Node: Extension Sample Time1256885
+Node: Extension Sample API Tests1258885
+Node: gawkextlib1259393
+Node: Extension summary1262425
+Node: Extension Exercises1266273
+Node: Language History1267543
+Node: V7/SVR3.11269255
+Node: SVR41271605
+Node: POSIX1273137
+Node: BTL1274562
+Node: POSIX/GNU1275329
+Node: Feature History1281984
+Node: Common Extensions1301786
+Node: Ranges and Locales1303261
+Ref: Ranges and Locales-Footnote-11308046
+Ref: Ranges and Locales-Footnote-21308073
+Ref: Ranges and Locales-Footnote-31308308
+Node: Contributors1308531
+Node: History summary1314722
+Node: Installation1316164
+Node: Gawk Distribution1317128
+Node: Getting1317620
+Node: Extracting1318619
+Node: Distribution contents1320325
+Node: Unix Installation1328215
+Node: Quick Installation1329035
+Node: Compiling with MPFR1331575
+Node: Shell Startup Files1332281
+Node: Additional Configuration Options1333438
+Node: Configuration Philosophy1335821
+Node: Compiling from Git1338321
+Node: Building the Documentation1338880
+Node: Non-Unix Installation1340292
+Node: PC Installation1340768
+Node: PC Binary Installation1341637
+Node: PC Compiling1342530
+Node: PC Using1343708
+Node: Cygwin1347424
+Node: MSYS1348676
+Node: OpenVMS Installation1349302
+Node: OpenVMS Compilation1349983
+Ref: OpenVMS Compilation-Footnote-11351466
+Node: OpenVMS Dynamic Extensions1351524
+Node: OpenVMS Installation Details1353160
+Node: OpenVMS Running1355591
+Node: OpenVMS GNV1359728
+Node: Bugs1360483
+Node: Bug definition1361403
+Node: Bug address1365004
+Node: Usenet1368573
+Node: Performance bugs1369786
+Node: Asking for help1372802
+Node: Maintainers1374789
+Node: Other Versions1375816
+Node: Installation summary1385420
+Node: Notes1386802
+Node: Compatibility Mode1387612
+Node: Additions1388434
+Node: Accessing The Source1389379
+Node: Adding Code1390910
+Node: New Ports1398021
+Node: Derived Files1402524
+Ref: Derived Files-Footnote-11408335
+Ref: Derived Files-Footnote-21408370
+Ref: Derived Files-Footnote-31408981
+Node: Future Extensions1409095
+Node: Implementation Limitations1409765
+Node: Extension Design1411007
+Node: Old Extension Problems1412167
+Ref: Old Extension Problems-Footnote-11413739
+Node: Extension New Mechanism Goals1413800
+Ref: Extension New Mechanism Goals-Footnote-11417270
+Node: Extension Other Design Decisions1417471
+Node: Extension Future Growth1419668
+Node: Notes summary1420288
+Node: Basic Concepts1421498
+Node: Basic High Level1422183
+Ref: figure-general-flow1422465
+Ref: figure-process-flow1423167
+Ref: Basic High Level-Footnote-11426537
+Node: Basic Data Typing1426726
+Node: Glossary1430134
+Node: Copying1463013
+Node: GNU Free Documentation License1500571
+Node: Index1525694
 
 End Tag Table
 
diff --git a/doc/gawk.texi b/doc/gawk.texi
index e4da785f..1109b69b 100644
--- a/doc/gawk.texi
+++ b/doc/gawk.texi
@@ -39396,7 +39396,10 @@ else
 
 @cindex @code{inplace} extension
 The @code{inplace} extension emulates GNU @command{sed}'s @option{-i} option,
-which performs ``in-place'' editing of each input file.
+which performs ``in-place'' editing of each input file.  Like GNU 
@command{sed},
+the @code{inplace} extension replaces links (both hard and symbolic) with new
+files.  If you wish to affect the target, you must dereference it first, for
+example using @command{realpath} from GNU Coreutils.
 It uses the bundled @file{inplace.awk} include file to invoke the extension
 properly.  This extension makes use of the namespace facility to place
 all the variables and functions in the @code{inplace} namespace
diff --git a/extension/ChangeLog b/extension/ChangeLog
index c84ae1c7..6a8ad195 100644
--- a/extension/ChangeLog
+++ b/extension/ChangeLog
@@ -1,3 +1,8 @@
+2024-02-12         Tim Rice              <trice@posteo.net>
+
+       * inplace.3am: Add a note that symbolic and hard links are
+       replaced with a new file.
+
 2024-01-20         Arnold D. Robbins     <arnold@skeeve.com>
 
        * configure.ac: MPFR on 32 bit Power PC is back
diff --git a/extension/inplace.3am b/extension/inplace.3am
index 66047442..11806cfb 100644
--- a/extension/inplace.3am
+++ b/extension/inplace.3am
@@ -23,6 +23,15 @@ is.
 By default, each named file on the command line is
 replaced with a new file of the same name whose contents
 are the results of running the AWK program.
+Since a new file is created, if the file is a link (whether hard
+or symbolic), the link will be broken.
+This behavior is consistent with GNU
+.I sed
+which also breaks links when the
+.B \-i
+or
+.B \-\^\-in\-place
+flag is used.
 If the user supplies an AWK variable named
 .B inplace::suffix
 in a

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

Summary of changes:
 doc/ChangeLog         |   5 ++
 doc/gawk.info         | 189 +++++++++++++++++++++++++-------------------------
 doc/gawk.texi         |   5 +-
 extension/ChangeLog   |   5 ++
 extension/inplace.3am |   9 +++
 5 files changed, 119 insertions(+), 94 deletions(-)


hooks/post-receive
-- 
gawk