"Fossies" - the Fresh Open Source Software Archive  

Source code changes of the file "extension/inplace.3am" between
gawk-5.0.1.tar.xz and gawk-5.1.0.tar.xz

About: GNU awk - pattern scanning and processing language.

inplace.3am  (gawk-5.0.1.tar.xz):inplace.3am  (gawk-5.1.0.tar.xz)
.TH INPLACE 3am "Feb 02 2018" "Free Software Foundation" "GNU Awk Extension Modu les" .TH INPLACE 3am "Jun 26 2018" "Free Software Foundation" "GNU Awk Extension Modu les"
.SH NAME .SH NAME
inplace \- emulate sed/perl/ruby in-place editing inplace \- emulate sed/perl/ruby in-place editing
.SH SYNOPSIS .SH SYNOPSIS
.ft CW .ft CW
.nf .nf
gawk -i inplace ... gawk -i inplace ...
.fi .fi
.ft R .ft R
.SH DESCRIPTION .SH DESCRIPTION
The The
skipping to change at line 27 skipping to change at line 27
These functions are meant to be invoked from the These functions are meant to be invoked from the
.I inplace.awk .I inplace.awk
wrapper which is installed when wrapper which is installed when
.I gawk .I gawk
is. is.
.PP .PP
By default, each named file on the command line is By default, each named file on the command line is
replaced with a new file of the same name whose contents replaced with a new file of the same name whose contents
are the results of running the AWK program. are the results of running the AWK program.
If the user supplies an AWK variable named If the user supplies an AWK variable named
.B INPLACE_SUFFIX .B inplace::suffix
in a in a
.B BEGIN .B BEGIN
rule or on the command line, then the rule or on the command line, then the
.I inplace .I inplace
extension concatenates that suffix onto the original extension concatenates that suffix onto the original
filename and uses the result as a filename for renaming filename and uses the result as a filename for renaming
the original. the original.
.PP .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 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. on the command line prior to files that should be processed normally.
One can reenable inplace editing by placing One can reenable inplace editing by placing
.B inplace=1 .B inplace::enable=1
prior to files that should be subject to inplace editing. prior to files that should be subject to inplace editing.
.\" .SH NOTES .\" .SH NOTES
.SH BUGS .SH BUGS
While the extension does attempt to preserve ownership and permissions, it makes While the extension does attempt to preserve ownership and permissions,
no attempt to copy the ACLs from the original file. it makes no attempt to copy the ACLs from the original file.
.PP .PP
If the program dies prematurely, as might happen if an unhandled signal is recei If the program dies prematurely, as might happen if an unhandled signal
ved, a temporary file may be left behind. is received, a temporary file may be left behind.
.SH EXAMPLE .SH EXAMPLE
.ft CW .ft CW
.nf .nf
gawk -i inplace '\f(CIscript\fP' files ... gawk -i inplace '\f(CIscript\fP' files ...
.br .br
gawk -i inplace -f \f(CIscriptfile\fP files ... gawk -i inplace -f \f(CIscriptfile\fP files ...
.fi .fi
.ft R .ft R
.SH "SEE ALSO" .SH "SEE ALSO"
.IR "GAWK: Effective AWK Programming" , .IR "GAWK: Effective AWK Programming" ,
skipping to change at line 69 skipping to change at line 79
.IR fork (3am), .IR fork (3am),
.IR ordchr (3am), .IR ordchr (3am),
.IR readdir (3am), .IR readdir (3am),
.IR readfile (3am), .IR readfile (3am),
.IR revoutput (3am), .IR revoutput (3am),
.IR rwarray (3am). .IR rwarray (3am).
.SH AUTHOR .SH AUTHOR
Andrew Schorr, Andrew Schorr,
.BR schorr@telemetry-investments.com . .BR schorr@telemetry-investments.com .
.SH COPYING PERMISSIONS .SH COPYING PERMISSIONS
Copyright \(co 2012, 2013, 2015, 2018, Copyright \(co 2012, 2013, 2015, 2018, 2019,
Free Software Foundation, Inc. Free Software Foundation, Inc.
.PP .PP
Permission is granted to make and distribute verbatim copies of Permission is granted to make and distribute verbatim copies of
this manual page provided the copyright notice and this permission this manual page provided the copyright notice and this permission
notice are preserved on all copies. notice are preserved on all copies.
.ig .ig
Permission is granted to process this file through troff and print the Permission is granted to process this file through troff and print the
results, provided the printed document carries copying permission results, provided the printed document carries copying permission
notice identical to this one except for the removal of this paragraph notice identical to this one except for the removal of this paragraph
(this paragraph not being relevant to the printed manual page). (this paragraph not being relevant to the printed manual page).
 End of changes. 8 change blocks. 
9 lines changed or deleted 17 lines changed or added

Home  |  About  |  Features  |  All  |  Newest  |  Dox  |  Diffs  |  RSS Feeds  |  Screenshots  |  Comments  |  Imprint  |  Privacy  |  HTTP(S)