BJam Post-Processor

The bjam post-processor is used to detect errors in the output of the bjam command. It has been designed to work with the output of Boost Jam, although it may work with other variants of jam. BJam post-processors search for the error messages produced by bjam and capture them with a small amount of leading and trailing context. By default, errors detected in this way will not cause the build to fail: the exit code of bjam is the preferred way to determine this.

The bjam post-processor is a subclass of the regular expression post-processor. All attributes and child elements available for regular expression post-processors are also available for bjam post-processors.

BJam post-processors are applied by default when using the bjam command.

Attributes

See also regex.pp.

Child Elements

See regex.pp.

Examples

Apply a bjam post-processor to an executable command (e.g. a script that calls bjam):

<bjam.pp name="bjam.pp"/>

<recipe name="default">
    <executable name="build" exe="build-it.sh">
        <process processor="${bjam.pp}"/>
    </executable>
</recipe>