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, --verbose
- Display some processing information.
- -t, --trace
- Enable the output of the essential shell commands which are executed.
- -n, --nop
- No operation mode. Actual execution of the essential shell commands which
would be executed is suppressed.
- -w, --warning
- 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, --quiet
- Suppress warning on substitution operation resulting in no content
change.
- -s, --stealth
- Stealth operation. Preserve timestamp on file.
- -i, --interactive
- Enter interactive mode where the user has to approve each operation.
- -b, --backup ext
- Preserve backup of original file using file name extension ext.
Default is to overwrite the original file.
- -e, --exec cmd
- Specify sed(1) command directly.
- -f, --file cmd-file
- 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
GNU shtool subst command was originally written by Ralf S.
Engelschall <rse@engelschall.com> in 2001 for
GNU 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).