diff options
Diffstat (limited to 'extension')
| -rw-r--r-- | extension/ChangeLog | 4 | ||||
| -rw-r--r-- | extension/inplace.3am | 24 |
2 files changed, 21 insertions, 7 deletions
diff --git a/extension/ChangeLog b/extension/ChangeLog index 3d83f77e..22d73d09 100644 --- a/extension/ChangeLog +++ b/extension/ChangeLog @@ -1,3 +1,7 @@ +2019-06-26 Arnold D. Robbins <arnold@skeeve.com> + + * inplace.3am: Update to match current code's behavior. + 2019-06-18 Arnold D. Robbins <arnold@skeeve.com> * 5.0.1: Release tar ball made. diff --git a/extension/inplace.3am b/extension/inplace.3am index 48fac54a..66047442 100644 --- a/extension/inplace.3am +++ b/extension/inplace.3am @@ -1,4 +1,4 @@ -.TH INPLACE 3am "Feb 02 2018" "Free Software Foundation" "GNU Awk Extension Modules" +.TH INPLACE 3am "Jun 26 2018" "Free Software Foundation" "GNU Awk Extension Modules" .SH NAME inplace \- emulate sed/perl/ruby in-place editing .SH SYNOPSIS @@ -24,7 +24,7 @@ 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. If the user supplies an AWK variable named -.B INPLACE_SUFFIX +.B inplace::suffix in a .B BEGIN rule or on the command line, then the @@ -33,17 +33,27 @@ extension concatenates that suffix onto the original filename and uses the result as a filename for renaming the original. .PP +For backwards compatibility, the variable will also check +.B INPLACE_SUFFIX +(in the +.B awk +namespace) for the suffix to use if +.B inplace::suffix +is not set. +.PP One can disable inplace editing selectively by placing -.B inplace=0 +.B inplace::enable=0 on the command line prior to files that should be processed normally. One can reenable inplace editing by placing -.B inplace=1 +.B inplace::enable=1 prior to files that should be subject to inplace editing. .\" .SH NOTES .SH BUGS -While the extension does attempt to preserve ownership and permissions, it makes no attempt to copy the ACLs from the original file. +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. +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 @@ -66,7 +76,7 @@ gawk -i inplace -f \f(CIscriptfile\fP files ... Andrew Schorr, .BR schorr@telemetry-investments.com . .SH COPYING PERMISSIONS -Copyright \(co 2012, 2013, 2015, 2018, +Copyright \(co 2012, 2013, 2015, 2018, 2019, Free Software Foundation, Inc. .PP Permission is granted to make and distribute verbatim copies of |