asmclean

Description

Cleans all the Assembler build artefacts created by the asm task.

Parameters

Attribute Description Required
binarydir The name of the directory containing the build artefacts to be cleaned. Yes
failonerror If true, stops the build process if the task exits with a return-code other than 0. Defaults to false. No
verbose If true, causes additional informational messages to be displayed by the task. Defaults to false. No

Parameters specified as nested elements

fileset
Use nested <fileset> elements to specify the source file name(s) whose artefacts should be cleaned.
mffilelist
Use nested <mffilelist> elements to specify the source file name(s). See mffilelist.
mfdestfilelist
Use nested <mfdestfilelist> elements to specify any additional build artefact(s) that need to be cleaned. See mfdestfilelist.

Errors and return codes

By default, the return code of an <asmclean> task is ignored. When you set failonerror="true", any non-zero response is treated as an error and means the build exits.

Examples

Remove all Assembler build artefacts for a referenced mffilelist element:

<mffilelist id="asm_program_file_set_1" srcdir="${basedir}" type="srcfile">
    <file name="Asm1.mlc"/>
    <file name="Asm2.mlc"/>
    <file name="Asm3.mlc"/>
</mffilelist>

<asmclean binarydir="${basedir}/outputDir" failonerror="false" verbose="false">
    <mffilelist refid="asm_program_file_set_1"/>
</asmclean>

Remove all Assembler build artefacts for a nested mffilelist element and additional build artefacts using a nested mfdestfilelist element:

<asmclean binarydir="${basedir}/outputDir" failonerror="false" verbose="false">
    <mffilelist srcdir="${basedir}" type="srcfile">
        <file name="Asm1.mlc"/>
        <file name="Asm2.mlc"/>
        <file name="Asm3.mlc"/>
    </mffilelist>
    <mfdestfilelist>
        <file name="${basedir}/outputDir/Link1.390"/>
    </mfdestfilelist>
</asmclean>