SCons / src / engine / SCons / Subst.xml

<?xml version="1.0" encoding="UTF-8"?>

This file is processed by the bin/ module.
See its __doc__ string for a discussion of the format.

<!DOCTYPE sconsdoc [
<!ENTITY % scons SYSTEM '../../../doc/scons.mod'>
<!ENTITY % builders-mod SYSTEM '../../../doc/generated/builders.mod'>
<!ENTITY % functions-mod SYSTEM '../../../doc/generated/functions.mod'>
<!ENTITY % tools-mod SYSTEM '../../../doc/generated/tools.mod'>
<!ENTITY % variables-mod SYSTEM '../../../doc/generated/variables.mod'>

<sconsdoc xmlns=""
          xsi:schemaLocation=" scons.xsd">

<scons_function name="AllowSubstExceptions">
<arguments signature="global">
([exception, ...])
Specifies the exceptions that will be allowed
when expanding construction variables.
By default,
any construction variable expansions that generate a
exception will expand to a
(a null string) and not cause scons to fail.
All exceptions not in the specified list
will generate an error message
and terminate processing.

is called multiple times,
each call completely overwrites the previous list
of allowed exceptions.


# Requires that all construction variable names exist.
# (You may wish to do this if you want to enforce strictly
# that all construction variables must be defined before use.)

# Also allow a string containing a zero-division expansion
# like '${1 / 0}' to evalute to ''.
AllowSubstExceptions(IndexError, NameError, ZeroDivisionError)