NAME
shtool subst - GNU shtool sed(1) substitution operations
SYNOPSIS
shtool subst
[-v|--verbose]
[-t|--trace]
[-n|--nop]
[-w|--warning]
[-q|--quiet]
[-s|--stealth]
[-i|--interactive]
[-b|--backup ext]
[-e|--exec cmd]
[-f|--file cmd-file]
[file] [file ...]
DESCRIPTION
This command applies one or more sed(1) substitution operations to
stdin or any number of files.
OPTIONS
The following command line options are available.
"-v,
Display some processing information.
"-t,
Enable the output of the essential shell commands which are executed.
"-n,
No operation mode. Actual execution of the essential shell commands
which would be executed is suppressed.
"-w,
Show warning on substitution operation resulting in no content change
on every file. The default is to show a warning on substitution
operations resulted in no content change on all files.
"-q,
Suppress warning on substitution operation resulting in no content change.
"-s,
Stealth operation. Preserve timestamp on file.
"-i,
Enter interactive mode where the user has to approve each operation.
"-b,
Preserve backup of original file using file name extension ext .
Default is to overwrite the original file .
"-e,
Specify sed(1) command directly.
"-f,
Read sed(1) command from file.
EXAMPLE
# shell script
shtool subst -i -e 's;(c) \([0-9]*\)-2000;(c) \1-2001;' *.[ch]
# RPM spec-file
%install
shtool subst -v -n -e 's;^\(prefix=\).*;\1 $RPM_BUILD_ROOT%{_prefix};g' -e 's;^\(sysconfdir=\).*;\1 $RPM_BUILD_ROOT%{_prefix}/etc;g' `find . -name Makefile -print`
make install
HISTORY
The \s-1GNU\s0 shtool subst command was originally written by Ralf S.
Engelschall <rse@engelschall.com> in 2001 for \s-1GNU\s0 shtool.
It was prompted by the need to have a uniform and convenient patching
frontend to sed(1) operations in the OpenPKG package specifications.
SEE ALSO
shtool(1), sed(1).
