SUBTOOL(1)               USER COMMANDS                 SUBTOOL(1)



NAME
     subtool - Perform substitutions on  variables  in  an  ascii
     text file.

SYNOPSIS
     subtool file_name substitution_file

AVAILABILITY
     The tool in available under Unix from the EPICS  application
     directory provided by getrel in release 3.11 or greater.

DESCRIPTION
     This  tool  applies  variable  substitutions  to   file_name
     according  to  rules  in  the substitution_file to produce a
     file at  standard  out.   See  templatefile(5)  for  a  full
     description of the substitution file.

EXAMPLE
     Running  the  command  "subtool  file_name  sub_file"   with
     sub_file contents of

     { a=test1,b=one }
     { a=test2,b=two }

     and file_name contents of

     This is var a: $(a), this is var b: $(b)
     This is another var a: $(a), this is another var b: $(b)

     writes to standard out the following:

     This is var a: test1, this is var b: one
     This is another var a: test1, this is another var b: one
     This is var a: test2, this is var b: two
     This is another var a: test2, this is another var b: two


NOTES
     This tool will use all type of templatefile(5)  definitions.
     If  an  IOC type is used by the tool, the dbfile(5) informa-
     tion will be ignored and the file_name will be used.

SEE ALSO
     templatefile(5)











Sun Release 4.1     Last change: 04 Nov 1993                    1