B.6 Augment
Prev Appendix B. Core tasks Next

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

NameTypeDescriptionDefaultRequired
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

Given

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

invocation

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

modifies the excludes attribute of input-fs, whereas 

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

adds a filename selector to input-fs.

Prev Up Next
B.5 AttribTask Home B.7 AutoloaderTask