shtool-subst (1)

Leading comments

Automatically generated by Pod::Man 4.07 (Pod::Simple 3.32)

Standard preamble:
========================================================================

(The comments found at the beginning of the groff file "man1/shtool-subst.1".)

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 shtool subst command was originally written by Ralf S. Engelschall <rse@engelschall.com> in 2001 for 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).