Merge branch 'gawk-4.1-stable'

6 files changed, 117 insertions, 88 deletions

diff --git a/doc/ChangeLog b/doc/ChangeLog
index 41766ad0..ca1f2bc1 100644
--- a/doc/ChangeLog
+++ b/doc/ChangeLog
@@ -1,5 +1,10 @@
 2015-06-17         Andrew J. Schorr     <aschorr@telemetry-investments.com>
 
+	* gawktexi.in: Document inplace shortcomings -- it does not preserve
+	ACLs, and it may leave temporary files behind if killed by a signal.
+
+2015-06-17         Andrew J. Schorr     <aschorr@telemetry-investments.com>
+
 	* gawktexi.in: Document new inplace variable to control whether
 	inplace editing is active.
 
diff --git a/doc/gawk.info b/doc/gawk.info
index d3dc7d3d..db3250a4 100644
--- a/doc/gawk.info
+++ b/doc/gawk.info
@@ -25895,6 +25895,13 @@ processing immediately without damaging the original file.
      $ gawk -i inplace -v INPLACE_SUFFIX=.bak '{ gsub(/foo/, "bar") }
      > { print }' file1 file2 file3
 
+   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.
+
 
 File: gawk.info,  Node: Extension Sample Ord,  Next: Extension Sample Readdir,  Prev: Extension Sample Inplace,  Up: Extension Samples
 
@@ -35349,92 +35356,92 @@ Node: Extension Sample File Functions1035812
 Node: Extension Sample Fnmatch1043461
 Node: Extension Sample Fork1044948
 Node: Extension Sample Inplace1046166
-Node: Extension Sample Ord1049095
-Node: Extension Sample Readdir1049931
-Ref: table-readdir-file-types1050820
-Node: Extension Sample Revout1051625
-Node: Extension Sample Rev2way1052214
-Node: Extension Sample Read write array1052954
-Node: Extension Sample Readfile1054896
-Node: Extension Sample Time1055991
-Node: Extension Sample API Tests1057339
-Node: gawkextlib1057831
-Node: Extension summary1060278
-Node: Extension Exercises1063970
-Node: Language History1065467
-Node: V7/SVR3.11067123
-Node: SVR41069276
-Node: POSIX1070710
-Node: BTL1072090
-Node: POSIX/GNU1072820
-Node: Feature History1078659
-Node: Common Extensions1092978
-Node: Ranges and Locales1094261
-Ref: Ranges and Locales-Footnote-11098877
-Ref: Ranges and Locales-Footnote-21098904
-Ref: Ranges and Locales-Footnote-31099139
-Node: Contributors1099360
-Node: History summary1104929
-Node: Installation1106309
-Node: Gawk Distribution1107254
-Node: Getting1107738
-Node: Extracting1108561
-Node: Distribution contents1110199
-Node: Unix Installation1116295
-Node: Quick Installation1116977
-Node: Shell Startup Files1119391
-Node: Additional Configuration Options1120469
-Node: Configuration Philosophy1122274
-Node: Non-Unix Installation1124644
-Node: PC Installation1125102
-Node: PC Binary Installation1126422
-Node: PC Compiling1128274
-Ref: PC Compiling-Footnote-11131298
-Node: PC Testing1131407
-Node: PC Using1132587
-Node: Cygwin1136701
-Node: MSYS1137471
-Node: VMS Installation1137972
-Node: VMS Compilation1138763
-Ref: VMS Compilation-Footnote-11139993
-Node: VMS Dynamic Extensions1140051
-Node: VMS Installation Details1141736
-Node: VMS Running1143989
-Node: VMS GNV1146830
-Node: VMS Old Gawk1147565
-Node: Bugs1148036
-Node: Other Versions1152150
-Node: Installation summary1158624
-Node: Notes1159682
-Node: Compatibility Mode1160547
-Node: Additions1161329
-Node: Accessing The Source1162254
-Node: Adding Code1163690
-Node: New Ports1169845
-Node: Derived Files1174333
-Ref: Derived Files-Footnote-11179818
-Ref: Derived Files-Footnote-21179853
-Ref: Derived Files-Footnote-31180451
-Node: Future Extensions1180565
-Node: Implementation Limitations1181223
-Node: Extension Design1182406
-Node: Old Extension Problems1183560
-Ref: Old Extension Problems-Footnote-11185078
-Node: Extension New Mechanism Goals1185135
-Ref: Extension New Mechanism Goals-Footnote-11188499
-Node: Extension Other Design Decisions1188688
-Node: Extension Future Growth1190801
-Node: Old Extension Mechanism1191637
-Node: Notes summary1193400
-Node: Basic Concepts1194582
-Node: Basic High Level1195263
-Ref: figure-general-flow1195545
-Ref: figure-process-flow1196230
-Ref: Basic High Level-Footnote-11199531
-Node: Basic Data Typing1199716
-Node: Glossary1203044
-Node: Copying1234990
-Node: GNU Free Documentation License1272529
-Node: Index1297647
+Node: Extension Sample Ord1049376
+Node: Extension Sample Readdir1050212
+Ref: table-readdir-file-types1051101
+Node: Extension Sample Revout1051906
+Node: Extension Sample Rev2way1052495
+Node: Extension Sample Read write array1053235
+Node: Extension Sample Readfile1055177
+Node: Extension Sample Time1056272
+Node: Extension Sample API Tests1057620
+Node: gawkextlib1058112
+Node: Extension summary1060559
+Node: Extension Exercises1064251
+Node: Language History1065748
+Node: V7/SVR3.11067404
+Node: SVR41069557
+Node: POSIX1070991
+Node: BTL1072371
+Node: POSIX/GNU1073101
+Node: Feature History1078940
+Node: Common Extensions1093259
+Node: Ranges and Locales1094542
+Ref: Ranges and Locales-Footnote-11099158
+Ref: Ranges and Locales-Footnote-21099185
+Ref: Ranges and Locales-Footnote-31099420
+Node: Contributors1099641
+Node: History summary1105210
+Node: Installation1106590
+Node: Gawk Distribution1107535
+Node: Getting1108019
+Node: Extracting1108842
+Node: Distribution contents1110480
+Node: Unix Installation1116576
+Node: Quick Installation1117258
+Node: Shell Startup Files1119672
+Node: Additional Configuration Options1120750
+Node: Configuration Philosophy1122555
+Node: Non-Unix Installation1124925
+Node: PC Installation1125383
+Node: PC Binary Installation1126703
+Node: PC Compiling1128555
+Ref: PC Compiling-Footnote-11131579
+Node: PC Testing1131688
+Node: PC Using1132868
+Node: Cygwin1136982
+Node: MSYS1137752
+Node: VMS Installation1138253
+Node: VMS Compilation1139044
+Ref: VMS Compilation-Footnote-11140274
+Node: VMS Dynamic Extensions1140332
+Node: VMS Installation Details1142017
+Node: VMS Running1144270
+Node: VMS GNV1147111
+Node: VMS Old Gawk1147846
+Node: Bugs1148317
+Node: Other Versions1152431
+Node: Installation summary1158905
+Node: Notes1159963
+Node: Compatibility Mode1160828
+Node: Additions1161610
+Node: Accessing The Source1162535
+Node: Adding Code1163971
+Node: New Ports1170126
+Node: Derived Files1174614
+Ref: Derived Files-Footnote-11180099
+Ref: Derived Files-Footnote-21180134
+Ref: Derived Files-Footnote-31180732
+Node: Future Extensions1180846
+Node: Implementation Limitations1181504
+Node: Extension Design1182687
+Node: Old Extension Problems1183841
+Ref: Old Extension Problems-Footnote-11185359
+Node: Extension New Mechanism Goals1185416
+Ref: Extension New Mechanism Goals-Footnote-11188780
+Node: Extension Other Design Decisions1188969
+Node: Extension Future Growth1191082
+Node: Old Extension Mechanism1191918
+Node: Notes summary1193681
+Node: Basic Concepts1194863
+Node: Basic High Level1195544
+Ref: figure-general-flow1195826
+Ref: figure-process-flow1196511
+Ref: Basic High Level-Footnote-11199812
+Node: Basic Data Typing1199997
+Node: Glossary1203325
+Node: Copying1235271
+Node: GNU Free Documentation License1272810
+Node: Index1297928
 
 End Tag Table
diff --git a/doc/gawk.texi b/doc/gawk.texi
index c781d372..df10570f 100644
--- a/doc/gawk.texi
+++ b/doc/gawk.texi
@@ -35038,6 +35038,10 @@ $ @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.
+
+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()}
 
diff --git a/doc/gawktexi.in b/doc/gawktexi.in
index 7ca02a05..23c44a94 100644
--- a/doc/gawktexi.in
+++ b/doc/gawktexi.in
@@ -34129,6 +34129,10 @@ $ @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.
+
+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()}
 
diff --git a/extension/ChangeLog b/extension/ChangeLog
index 9ff809da..bbdd57fb 100644
--- a/extension/ChangeLog
+++ b/extension/ChangeLog
@@ -1,5 +1,11 @@
 2015-06-17         Andrew J. Schorr     <aschorr@telemetry-investments.com>
 
+	* inplace.3am (BUGS): Document that ACLs are not preserved, and
+	a temporary file may be left behind if the program is killed by
+	a signal.
+
+2015-06-17         Andrew J. Schorr     <aschorr@telemetry-investments.com>
+
 	* inplace.3am: Document new inplace variable to control whether
 	inplace editing is active.
 
diff --git a/extension/inplace.3am b/extension/inplace.3am
index b1682e22..a045fe6c 100644
--- a/extension/inplace.3am
+++ b/extension/inplace.3am
@@ -40,7 +40,10 @@ One can reenable inplace editing by placing
 .B inplace=1
 prior to files that should be subject to inplace editing.
 ... .SH NOTES
-... .SH BUGS
+.SH BUGS
+While the extension does attempt to preserve ownership and permissions, it makes no attempt to copy the ACLs from the original file.
+.PP
+If the program dies prematurely, as might happen if an unhandled signal is received, a temporary file may be left behind.
 .SH EXAMPLE
 .ft CW
 .nf