Module Subst

Create a dictionary for substitution of special
construction variables.

This translates the following special arguments:

target - the target (object or array of objects),
         used to generate the TARGET and TARGETS
         construction variables

source - the source (object or array of objects),
         used to generate the SOURCES and SOURCE
         construction variables

Expand a string or list containing construction variable
substitutions.

This is the work-horse function for substitutions in file names
and the like.  The companion scons_subst_list() function (below)
handles separating command lines into lists of arguments, so see
that function if that's what you're looking for.

Substitute construction variables in a string (or list or other
object) and separate the arguments into a command list.

The companion scons_subst() function (above) handles basic
substitutions within strings, so see that function instead
if that's what you're looking for.

Perform single (non-recursive) substitution of a single
construction variable keyword.

This is used when setting a variable when copying or overriding values
in an Environment.  We want to capture (expand) the old value before
we override it, so people can do things like:

    env2 = env.Clone(CCFLAGS = '$CCFLAGS -g')

We do this with some straightforward, brute-force code here...

__revision__

Value:

'src/engine/SCons/Subst.py 5023 2010/06/14 22:05:46 scons'

AllowableExceptions

Value:

(<type 'exceptions.IndexError'>, <type 'exceptions.NameError'>)