B.6 Augment

Modify an existing reference by adding nested elements or (re-)assigning properties mapped as XML attributes. This is an unusual task that makes use of Phing's internal processing mechanisms to reload a previously declared reference by means of the id attribute, then treats the declared augment element as though it were the original element.

Table B.8: Attributes

id String The id of the reference to augment. If no such reference has been declared a BuildException is thrown. n/aYes

B.6.1 Examples


<fileset id="input-fs" dir="${project.basedir}"/>


<augment id="input-fs" excludes="foo"/>

modifies the excludes attribute of input-fs, whereas

<augment id="input-fs">
    <filename name="bar"/>

adds a filename selector to input-fs.