Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help 
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)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=shtool-subst&sektion=1&manpath=FreeBSD+Ports+15.0>

home | help