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
idStringThe 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.