diff --git a/docs/manual/using.html b/docs/manual/using.html index 7ee89fdb9..d10f56b64 100644 --- a/docs/manual/using.html +++ b/docs/manual/using.html @@ -642,6 +642,27 @@ implementation of the element upon which it is specified. Some tasks (the deliberately assign a different meaning to refid.

+

Getting the value of a Reference with ${toString:}

+

+Any Ant type which has been declared with a reference can also its string +value extracted by using the ${toString:} operation, +with the name of the reference listed after the toString: text. +The toString() method of the Java class instance that is +referenced is invoked -all built in types strive to produce useful and relevant +output in such an instance. +

+

+For example, here is how to get a listing of the files in a fileset, +

+

+<fileset id="sourcefiles" dir="src" includes="**/*.java" />
+<echo> sourcefiles = ${toString:sourcefiles} </echo>
+
+

+There is no guarantee that external types provide meaningful information in such +a situation

+ +

Use of external tasks

Ant supports a plugin mechanism for using third party tasks. For using them you have to do two steps: