diff --git a/docs/manual/CoreTasks/subant.html b/docs/manual/CoreTasks/subant.html index 8461c9df7..b595d54e0 100644 --- a/docs/manual/CoreTasks/subant.html +++ b/docs/manual/CoreTasks/subant.html @@ -34,7 +34,7 @@ - + @@ -46,7 +46,15 @@
 
- EXPERIMENTAL: This task is experimental and may be under continual change till Ant1.6 ships; it may even be omitted from the product.

Calls a given target for all defined sub-builds. This is an extension of ant for bulk project execution. +

+ EXPERIMENTAL: This task is experimental and may be under continual + change till Ant1.6 ships; it may even be omitted from the product. +

+

+ Calls a given target for all defined sub-builds. This is an extension + of ant for bulk project execution. +

+
@@ -55,13 +63,11 @@ - - @@ -201,8 +204,8 @@ Adds a directory set to the implicit build path.

Note that the directories will be added to the build path in no particular order, so if order is significant, one should use a file list instead! - Note that the directories will be added to the build path in no particular order, so if order is significant, one should use a file list instead!]]> - + Note that the directories will be added to the build path in no particular order, so if order is significant, one should use a file list instead!]]> +

 
Parameters
@@ -73,21 +79,28 @@ + - + + + + + @@ -95,9 +108,7 @@ buildpath +
Type + + Requirement
antfile - - Sets the default build file name to append to directory names found in the build path -default "build.xml" - + Sets the default build file name to append to directory names found in the build path -default "build.xml" String + Optional +
- - Set the buildpath to be used to find sub-projects. - + Set the buildpath to be used to find sub-projects. Path @@ -109,9 +120,7 @@ buildpathref - - Buildpath to use, by reference. - + Buildpath to use, by reference. Reference @@ -123,9 +132,7 @@ failonerror - - Sets whether to fail with a build exception on error, or go on. - + Sets whether to fail with a build exception on error, or go on. boolean @@ -137,9 +144,7 @@ inheritall - - Corresponds to <ant>'s inheritall attribute. - + Corresponds to <ant>'s inheritall attribute. boolean @@ -151,9 +156,7 @@ inheritrefs - - Corresponds to <ant>'s inheritrefs attribute. - + Corresponds to <ant>'s inheritrefs attribute. boolean @@ -165,14 +168,14 @@ target - - + String
@@ -218,8 +221,8 @@ Adds an ordered file list to the implicit build path.

Note that contrary to file and directory sets, file lists can reference non-existent files or directories! - Note that contrary to file and directory sets, file lists can reference non-existen]]>]]> - + Note that contrary to file and directory sets, file lists can reference non-existent files or directories!]]> + @@ -235,8 +238,8 @@ Adds a file set to the implicit build path.

Note that the directories will be added to the build path in no particular order, so if order is significant, one should use a file list instead! - Note that the directories will be added to the build path in no particular order, so if order is significant, one should use a file list instead!]]> - + Note that the directories will be added to the build path in no particular order, so if order is significant, one should use a file list instead!]]> + @@ -252,8 +255,25 @@ Corresponds to <ant>'s nested <property> element. <ant>'s nested <property> element.]]> - <ant>'s nested <property> element.]]> - + <ant>'s nested <property> element.]]> + + + + + + + + + +
 
+ + propertyset (org.apache.tools.ant.types.PropertySet) +
+ Corresponds to <ant>'s nested <propertyset> element. +<ant>'s nested <propertyset> element.]]> + + <ant>'s nested <propertyset> element.]]> +
@@ -269,8 +289,8 @@ Corresponds to <ant>'s nested <reference> element. <ant>'s nested <reference> element.]]> - <ant>'s nested <reference> element.]]> - + <ant>'s nested <reference> element.]]> + @@ -286,8 +306,8 @@ Creates a nested build path, and add it to the implicit build path. - - + + @@ -303,8 +323,8 @@ Creates a nested <buildpathelement>, and add it to the implicit build path. <buildpathelement>, and add it to the implicit build path.]]> - <buildpathelement>, and add it to the implicit build path.]]> - + <buildpathelement>, and add it to the implicit build path.]]> + @@ -315,6 +335,36 @@ + + + + + + + +
 
+ + + Example +
+ 
+        <project name="subant" default="subant1">
+        <property name="build.dir" value="subant.build"/>
+        <target name="subant1">
+              <subant failonerror="false" target="">
+                  <property name="build.dir" value="subant1.build"/>
+                  <property name="not.overloaded" value="not.overloaded"/>
+                  <dirset dir="." includes="*"/>
+              </subant>
+        </target>
+        </project>
+
+

+ this snippet build file will run ant in each subdirectory of the project directory, + where a file called build.xml can be found. +

+ +
diff --git a/proposal/xdocs/src/org/apache/tools/ant/taskdefs/SubAnt.xml b/proposal/xdocs/src/org/apache/tools/ant/taskdefs/SubAnt.xml new file mode 100644 index 000000000..dd511c3b4 --- /dev/null +++ b/proposal/xdocs/src/org/apache/tools/ant/taskdefs/SubAnt.xml @@ -0,0 +1,30 @@ + + +

+ EXPERIMENTAL: This task is experimental and may be under continual + change till Ant1.6 ships; it may even be omitted from the product. +

+

+ Calls a given target for all defined sub-builds. This is an extension + of ant for bulk project execution. +

+ +
+ 
+        <project name="subant" default="subant1">
+        <property name="build.dir" value="subant.build"/>
+        <target name="subant1">
+              <subant failonerror="false" target="">
+                  <property name="build.dir" value="subant1.build"/>
+                  <property name="not.overloaded" value="not.overloaded"/>
+                  <dirset dir="." includes="*"/>
+              </subant>
+        </target>
+        </project>
+
+

+ this snippet build file will run ant in each subdirectory of the project directory, + where a file called build.xml can be found. +

+
+ \ No newline at end of file