aboutsummaryrefslogtreecommitdiffstats
path: root/extension/inplace.3am
diff options
context:
space:
mode:
Diffstat (limited to 'extension/inplace.3am')
-rw-r--r--extension/inplace.3am14
1 files changed, 12 insertions, 2 deletions
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