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

  
 
  

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 opera-
	 tions 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.  De-
	 fault 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.1.quarterly>

home | help