Unix/Linux Go Back    


Linux 2.6 - man page for shtool-subst (linux section 1)

Linux & Unix Commands - Search Man Pages
Man Page or Keyword Search:   man
Select Man Page Set:       apropos Keyword Search (sections above)


SHTOOL-SUBST.TMP(1)		     GNU Portable Shell Tool		      SHTOOL-SUBST.TMP(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 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).

18-Jul-2008				   shtool 2.0.8 		      SHTOOL-SUBST.TMP(1)
Unix & Linux Commands & Man Pages : ©2000 - 2018 Unix and Linux Forums


All times are GMT -4. The time now is 12:33 AM.