Sure. You probably also should add an example taking advantage of the new <propertyset>, and explain that the property is passed to the sub-builds only if defined (adding the user properties specified on the command line are always passed, which was not obvious to me). ---DD
> -----Original Message----- > From: Antoine Levy-Lambert [mailto:[EMAIL PROTECTED] > Sent: Wednesday, May 14, 2003 10:06 AM > To: Ant Developers List > Subject: Re: cvs commit: ant/docs/manual/CoreTasks subant.html > > fixed in CVS > Thanks for the feedback. > Antoine > ----- Original Message ----- > From: "Dominique Devienne" <[EMAIL PROTECTED]> > To: "'Ant Developers List'" <[EMAIL PROTECTED]>; <[EMAIL PROTECTED]> > Sent: Wednesday, May 14, 2003 4:02 PM > Subject: RE: cvs commit: ant/docs/manual/CoreTasks subant.html > > > > This is incorrect, at least with my version. It will attempt to find a > > build.xml in all the directories, and FAIL if one cannot be found. To > > achieve what you describe, use a fileset: > > > > <subant target=""> > > <property name="build.dir" value="subant1.build"/> > > <property name="not.overloaded" value="not.overloaded"/> > > <fileset dir="." includes="*/build.xml"/> > > </subant> > > > > I understand you had failonerror="true", but then a build failure in any > of > > the build actually found would be ignored, so it's not a good example > IMHO. > > > > Regards, --DD > > > > > -----Original Message----- > > > From: [EMAIL PROTECTED] [mailto:[EMAIL PROTECTED] > > > Sent: Wednesday, May 14, 2003 4:58 AM > > > To: [EMAIL PROTECTED] > > > Subject: cvs commit: ant/docs/manual/CoreTasks subant.html > > > > > > antoine 2003/05/14 02:57:38 > > > > > > Modified: docs/manual/CoreTasks subant.html > > > Added: proposal/xdocs/src/org/apache/tools/ant/taskdefs > SubAnt.xml > > > Log: > > > added a merge point in xdocs for SubAnt and regenerated > corresponding > > > manual page > > > PR:19181 docs of subant task > > > > > > Revision Changes Path > > > 1.1 > > > ant/proposal/xdocs/src/org/apache/tools/ant/taskdefs/SubAnt.xml > > > > > > Index: SubAnt.xml > > > =================================================================== > > > <external> > > > <description> > > > <p> > > > <i>EXPERIMENTAL:</i> This task is experimental and may > be > > > under continual > > > change till Ant1.6 ships; it may even be omitted from > the > > > product. > > > </p> > > > <p> > > > Calls a given target for all defined sub-builds. This is an > > > extension > > > of ant for bulk project execution. > > > </p> > > > </description> > > > <section anchor="examples" name="Example"> > > > <pre> > > > <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> > > > </pre> > > > <p> > > > this snippet build file will run ant in each > subdirectory > of > > > the project directory, > > > where a file called build.xml can be found. > > > </p> > > > </section> > > > </external> > > > > > > > > > 1.2 +89 -39 ant/docs/manual/CoreTasks/subant.html > > > > > > Index: subant.html > > > =================================================================== > > > RCS file: /home/cvs/ant/docs/manual/CoreTasks/subant.html,v > > > retrieving revision 1.1 > > > retrieving revision 1.2 > > > diff -u -r1.1 -r1.2 > > > --- subant.html 26 Mar 2003 17:55:37 -0000 1.1 > > > +++ subant.html 14 May 2003 09:57:38 -0000 1.2 > > > @@ -34,7 +34,7 @@ > > > <tr> > > > <td valign="top" align="left"> > > > > > > - <!-- Applying task/long-description --> > > > + <!-- Applying task/description --> > > > <!-- Start Description --> > > > <table border="0" cellspacing="0" cellpadding="2" width="100%"> > > > <tr><td> </td></tr> > > > @@ -46,7 +46,15 @@ > > > </td></tr> > > > > > > <tr><td><blockquote> > > > - <i>EXPERIMENTAL:</i> This task is experimental and may be > under > > > continual change till Ant1.6 ships; it may even be omitted from the > > > product. <p> Calls a given target for all defined sub-builds. This is > an > > > extension of ant for bulk project execution. > > > +<p> > > > + <i>EXPERIMENTAL:</i> This task is experimental and may > be > > > under continual > > > + change till Ant1.6 ships; it may even be omitted from > the > > > product. > > > + </p> > > > +<p> > > > + Calls a given target for all defined sub-builds. This is an > > > extension > > > + of ant for bulk project execution. > > > + </p> > > > + > > > </blockquote></td></tr> > > > > > > </table> > > > @@ -55,13 +63,11 @@ > > > <!-- Start Attributes --> > > > <table border="0" cellspacing="0" cellpadding="2" width="100%"> > > > <tr><td> </td></tr> > > > - > > > <tr><td bgcolor="#525D76"> > > > <font color="#ffffff" face="arial,helvetica.sanserif"> > > > <a name="attributes"> > > > <strong>Parameters</strong></a></font> > > > </td></tr> > > > - > > > <tr><td><blockquote> > > > <table> > > > <tr> > > > @@ -74,20 +80,27 @@ > > > <td bgcolor="#cccccc" valign="top" align="left"> > > > <font color="#000000" size="-1" > > > face="arial,helvetica,sanserif"><b>Type</b></font> > > > </td> > > > + <td bgcolor="#cccccc" valign="top" align="left"> > > > + <font color="#000000" size="-1" > > > face="arial,helvetica,sanserif"><b>Requirement</b></font> > > > + </td> > > > </tr> > > > - <!-- Attribute --> > > > + <!-- Attribute Group --> > > > + > > > + <!-- Attribute Group --> > > > + <!-- Attribute --> > > > <tr> > > > <td bgcolor="#eeeeee" valign="top" align="left"> > > > <font color="#000000" size="-1" > > > face="arial,helvetica,sanserif">antfile</font> > > > </td> > > > <td bgcolor="#eeeeee" valign="top" align="left"> > > > - <font color="#000000" size="-1" > > > face="arial,helvetica,sanserif"> > > > - Sets the default build file name to append to directory > names > > > found in the build path -default "build.xml" > > > - </font> > > > + <font color="#000000" size="-1" > > > face="arial,helvetica,sanserif">Sets the default build file name to > append > > > to directory names found in the build path -default "build.xml"</font> > > > </td> > > > <td bgcolor="#eeeeee" valign="top" align="left"> > > > <font color="#000000" size="-1" > > > face="arial,helvetica,sanserif">String</font> > > > </td> > > > + <td bgcolor="#eeeeee" valign="top" align="left" > rowspan="7"> > > > + <font color="#000000" size="-1" > > > face="arial,helvetica,sanserif">Optional</font> > > > + </td> > > > </tr> > > > <!-- Attribute --> > > > <tr> > > > @@ -95,9 +108,7 @@ > > > <font color="#000000" size="-1" > > > face="arial,helvetica,sanserif">buildpath</font> > > > </td> > > > <td bgcolor="#eeeeee" valign="top" align="left"> > > > - <font color="#000000" size="-1" > > > face="arial,helvetica,sanserif"> > > > - Set the buildpath to be used to find sub-projects. > > > - </font> > > > + <font color="#000000" size="-1" > > > face="arial,helvetica,sanserif">Set the buildpath to be used to find > sub- > > > projects.</font> > > > </td> > > > <td bgcolor="#eeeeee" valign="top" align="left"> > > > <font color="#000000" size="-1" > > > face="arial,helvetica,sanserif">Path</font> > > > @@ -109,9 +120,7 @@ > > > <font color="#000000" size="-1" > > > face="arial,helvetica,sanserif">buildpathref</font> > > > </td> > > > <td bgcolor="#eeeeee" valign="top" align="left"> > > > - <font color="#000000" size="-1" > > > face="arial,helvetica,sanserif"> > > > - Buildpath to use, by reference. > > > - </font> > > > + <font color="#000000" size="-1" > > > face="arial,helvetica,sanserif">Buildpath to use, by reference.</font> > > > </td> > > > <td bgcolor="#eeeeee" valign="top" align="left"> > > > <font color="#000000" size="-1" > > > face="arial,helvetica,sanserif">Reference</font> > > > @@ -123,9 +132,7 @@ > > > <font color="#000000" size="-1" > > > face="arial,helvetica,sanserif">failonerror</font> > > > </td> > > > <td bgcolor="#eeeeee" valign="top" align="left"> > > > - <font color="#000000" size="-1" > > > face="arial,helvetica,sanserif"> > > > - Sets whether to fail with a build exception on error, or > go > > > on. > > > - </font> > > > + <font color="#000000" size="-1" > > > face="arial,helvetica,sanserif">Sets whether to fail with a build > > > exception on error, or go on.</font> > > > </td> > > > <td bgcolor="#eeeeee" valign="top" align="left"> > > > <font color="#000000" size="-1" > > > face="arial,helvetica,sanserif">boolean</font> > > > @@ -137,9 +144,7 @@ > > > <font color="#000000" size="-1" > > > face="arial,helvetica,sanserif">inheritall</font> > > > </td> > > > <td bgcolor="#eeeeee" valign="top" align="left"> > > > - <font color="#000000" size="-1" > > > face="arial,helvetica,sanserif"> > > > - Corresponds to <code><ant></code>'s > > > <code>inheritall</code> attribute. > > > - </font> > > > + <font color="#000000" size="-1" > > > face="arial,helvetica,sanserif">Corresponds to > <code><ant></code>'s > > > <code>inheritall</code> attribute.</font> > > > </td> > > > <td bgcolor="#eeeeee" valign="top" align="left"> > > > <font color="#000000" size="-1" > > > face="arial,helvetica,sanserif">boolean</font> > > > @@ -151,9 +156,7 @@ > > > <font color="#000000" size="-1" > > > face="arial,helvetica,sanserif">inheritrefs</font> > > > </td> > > > <td bgcolor="#eeeeee" valign="top" align="left"> > > > - <font color="#000000" size="-1" > > > face="arial,helvetica,sanserif"> > > > - Corresponds to <code><ant></code>'s > > > <code>inheritrefs</code> attribute. > > > - </font> > > > + <font color="#000000" size="-1" > > > face="arial,helvetica,sanserif">Corresponds to > <code><ant></code>'s > > > <code>inheritrefs</code> attribute.</font> > > > </td> > > > <td bgcolor="#eeeeee" valign="top" align="left"> > > > <font color="#000000" size="-1" > > > face="arial,helvetica,sanserif">boolean</font> > > > @@ -165,14 +168,14 @@ > > > <font color="#000000" size="-1" > > > face="arial,helvetica,sanserif">target</font> > > > </td> > > > <td bgcolor="#eeeeee" valign="top" align="left"> > > > - <font color="#000000" size="-1" > > > face="arial,helvetica,sanserif"> > > > - </font> > > > + <font color="#000000" size="-1" > > > face="arial,helvetica,sanserif"></font> > > > </td> > > > <td bgcolor="#eeeeee" valign="top" align="left"> > > > <font color="#000000" size="-1" > > > face="arial,helvetica,sanserif">String</font> > > > </td> > > > </tr> > > > > > > + > > > </table> > > > </blockquote></td></tr> > > > > > > @@ -201,8 +204,8 @@ > > > Adds a directory set to the implicit build path. <p> > <em>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!</em> > > > <short-description><![CDATA[Adds a directory set to the implicit > build > > > path.]]></short-description> > > > <description> > > > - <![CDATA[Adds a directory set to the implicit build path. > <p> > > > <em>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!</em>]]> > > > - </description> > > > + <![CDATA[Adds a directory set to the implicit build > path. > > > <p> <em>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!</em>]]> > > > + </description> > > > > > > </blockquote></td></tr> > > > </table> > > > @@ -218,8 +221,8 @@ > > > Adds an ordered file list to the implicit build path. <p> > > > <em>Note that contrary to file and directory sets, file lists can > > > reference non-existent files or directories!</em> > > > <short-description><![CDATA[Adds an ordered file list to the > implicit > > > build path.]]></short-description> > > > <description> > > > - <![CDATA[Adds an ordered file list to the implicit build > > > path. <p> <em>Note that contrary to file and directory sets, file > lists > > > can reference non-existen]]><![CDATA[t files or directories!</em>]]> > > > - </description> > > > + <![CDATA[Adds an ordered file list to the implicit > build > > > path. <p> <em>Note that contrary to file and directory sets, file > lists > > > can reference non-existent files or directories!</em>]]> > > > + </description> > > > > > > </blockquote></td></tr> > > > </table> > > > @@ -235,8 +238,8 @@ > > > Adds a file set to the implicit build path. <p> <em>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!</em> > > > <short-description><![CDATA[Adds a file set to the implicit build > > > path.]]></short-description> > > > <description> > > > - <![CDATA[Adds a file set to the implicit build path. <p> > > > <em>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!</em>]]> > > > - </description> > > > + <![CDATA[Adds a file set to the implicit build path. > <p> > > > <em>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!</em>]]> > > > + </description> > > > > > > </blockquote></td></tr> > > > </table> > > > @@ -252,8 +255,25 @@ > > > Corresponds to <code><ant></code>'s nested > > > <code><property></code> element. > > > <short-description><![CDATA[Corresponds to > <code><ant></code>'s > > > nested <code><property></code> element.]]></short-description> > > > <description> > > > - <![CDATA[Corresponds to <code><ant></code>'s nested > > > <code><property></code> element.]]> > > > - </description> > > > + <![CDATA[Corresponds to <code><ant></code>'s > nested > > > <code><property></code> element.]]> > > > + </description> > > > + > > > + </blockquote></td></tr> > > > + </table> > > > + <!-- End Element --> > > > + <!-- Start Element --> > > > + <table border="0" cellspacing="0" cellpadding="2" width="100%"> > > > + <tr><td> </td></tr> > > > + <tr><td bgcolor="#828DA6"> > > > + <font color="#ffffff" face="arial,helvetica.sanserif" > size="- > > > 1"> > > > + <strong>propertyset</strong> > > > (org.apache.tools.ant.types.PropertySet)</font> > > > + </td></tr> > > > + <tr><td><blockquote> > > > + Corresponds to <code><ant></code>'s nested > > > <code><propertyset></code> element. > > > +<short-description><![CDATA[Corresponds to > <code><ant></code>'s > > > nested <code><propertyset></code> element.]]></short- > description> > > > +<description> > > > + <![CDATA[Corresponds to <code><ant></code>'s > nested > > > <code><propertyset></code> element.]]> > > > + </description> > > > > > > </blockquote></td></tr> > > > </table> > > > @@ -269,8 +289,8 @@ > > > Corresponds to <code><ant></code>'s nested > > > <code><reference></code> element. > > > <short-description><![CDATA[Corresponds to > <code><ant></code>'s > > > nested <code><reference></code> element.]]></short-description> > > > <description> > > > - <![CDATA[Corresponds to <code><ant></code>'s nested > > > <code><reference></code> element.]]> > > > - </description> > > > + <![CDATA[Corresponds to <code><ant></code>'s > nested > > > <code><reference></code> element.]]> > > > + </description> > > > > > > </blockquote></td></tr> > > > </table> > > > @@ -286,8 +306,8 @@ > > > Creates a nested build path, and add it to the implicit > build > > > path. > > > <short-description><![CDATA[Creates a nested build path, and add it > to > > > the implicit build path.]]></short-description> > > > <description> > > > - <![CDATA[Creates a nested build path, and add it to the > > > implicit build path.]]> > > > - </description> > > > + <![CDATA[Creates a nested build path, and add it to the > > > implicit build path.]]> > > > + </description> > > > > > > </blockquote></td></tr> > > > </table> > > > @@ -303,8 +323,8 @@ > > > Creates a nested <code><buildpathelement></code>, and > add > > > it to the implicit build path. > > > <short-description><![CDATA[Creates a nested > > > <code><buildpathelement></code>, and add it to the implicit > build > > > path.]]></short-description> > > > <description> > > > - <![CDATA[Creates a nested > > > <code><buildpathelement></code>, and add it to the implicit > build > > > path.]]> > > > - </description> > > > + <![CDATA[Creates a nested > > > <code><buildpathelement></code>, and add it to the implicit > build > > > path.]]> > > > + </description> > > > > > > </blockquote></td></tr> > > > </table> > > > @@ -315,6 +335,36 @@ > > > </table> > > > <!-- End Elements --> > > > > > > + <table border="0" cellspacing="0" cellpadding="2" width="100%"> > > > + <tr><td> </td></tr> > > > + > > > + <tr><td bgcolor="#525D76"> > > > + <font color="#ffffff" face="arial,helvetica.sanserif"> > > > + <a name="examples"> > > > + <strong>Example</strong></a></font> > > > + </td></tr> > > > + > > > + <tr><td><blockquote> > > > + <pre> > > > + <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> > > > + </pre> > > > +<p> > > > + this snippet build file will run ant in each > subdirectory > > > of the project directory, > > > + where a file called build.xml can be found. > > > + </p> > > > + > > > + </blockquote></td></tr> > > > + > > > + </table> > > > > > > </td> > > > </tr> > > > > > > > > > > > > > > > --------------------------------------------------------------------- > > > To unsubscribe, e-mail: [EMAIL PROTECTED] > > > For additional commands, e-mail: [EMAIL PROTECTED] > > > > --------------------------------------------------------------------- > > To unsubscribe, e-mail: [EMAIL PROTECTED] > > For additional commands, e-mail: [EMAIL PROTECTED] > > > > > --------------------------------------------------------------------- > To unsubscribe, e-mail: [EMAIL PROTECTED] > For additional commands, e-mail: [EMAIL PROTECTED]
