aboutsummaryrefslogtreecommitdiffstats
path: root/extension
diff options
context:
space:
mode:
Diffstat (limited to 'extension')
-rw-r--r--extension/ChangeLog11
-rw-r--r--extension/inplace.3am14
2 files changed, 23 insertions, 2 deletions
diff --git a/extension/ChangeLog b/extension/ChangeLog
index 3188c1e1..bbdd57fb 100644
--- a/extension/ChangeLog
+++ b/extension/ChangeLog
@@ -1,3 +1,14 @@
+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.
+
2015-05-19 Arnold D. Robbins <arnold@skeeve.com>
* 4.1.3: Release tar ball made.
diff --git a/extension/inplace.3am b/extension/inplace.3am
index 64aec91c..a045fe6c 100644
--- a/extension/inplace.3am
+++ b/extension/inplace.3am
@@ -1,4 +1,4 @@
-.TH INPLACE 3am "Apr 08 2015" "Free Software Foundation" "GNU Awk Extension Modules"
+.TH INPLACE 3am "Jun 17 2015" "Free Software Foundation" "GNU Awk Extension Modules"
.SH NAME
inplace \- emulate sed/perl/ruby in-place editing
.SH SYNOPSIS
@@ -32,8 +32,18 @@ rule or on the command line, then the
extension concatenates that suffix onto the original
filename and uses the result as a filename for renaming
the original.
+.PP
+One can disable inplace editing selectively by placing
+.B inplace=0
+on the command line prior to files that should be processed normally.
+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