|
|
@@ -198,72 +198,72 @@ details:</p> |
|
|
|
</table> |
|
|
|
|
|
|
|
<h3>Examples</h3> |
|
|
|
<pre> |
|
|
|
<ant antfile="subproject/subbuild.xml" dir="subproject" target="compile"/> |
|
|
|
<blockquote><pre> |
|
|
|
<ant antfile="subproject/subbuild.xml" |
|
|
|
dir="subproject" target="compile"/> |
|
|
|
|
|
|
|
<ant dir="subproject"/> |
|
|
|
<ant dir="subproject"/> |
|
|
|
|
|
|
|
<ant antfile="subproject/property_based_subbuild.xml"> |
|
|
|
<property name="param1" value="version 1.x"/> |
|
|
|
<property file="config/subproject/default.properties"/> |
|
|
|
</ant> |
|
|
|
|
|
|
|
<ant inheritAll="false" antfile="subproject/subbuild.xml"> |
|
|
|
<property name="output.type" value="html"/> |
|
|
|
</ant> |
|
|
|
</pre> |
|
|
|
<ant antfile="subproject/property_based_subbuild.xml"> |
|
|
|
<property name="param1" value="version 1.x"/> |
|
|
|
<property file="config/subproject/default.properties"/> |
|
|
|
</ant> |
|
|
|
|
|
|
|
<ant inheritAll="false" antfile="subproject/subbuild.xml"> |
|
|
|
<property name="output.type" value="html"/> |
|
|
|
</ant> |
|
|
|
</pre></blockquote> |
|
|
|
<p>The build file of the calling project defines some |
|
|
|
<code><path></code> elements like this:</p> |
|
|
|
|
|
|
|
<pre> |
|
|
|
<path id="path1"> |
|
|
|
<blockquote><pre> |
|
|
|
<path id="path1"> |
|
|
|
... |
|
|
|
</path> |
|
|
|
<path id="path2"> |
|
|
|
</path> |
|
|
|
<path id="path2"> |
|
|
|
... |
|
|
|
</path> |
|
|
|
</pre> |
|
|
|
</path> |
|
|
|
</pre></blockquote> |
|
|
|
|
|
|
|
<p>and the called build file (<code>subbuild.xml</code>) also defines |
|
|
|
a <code><path></code> with the id <code>path1</code>, but |
|
|
|
<code>path2</code> is not defined:</p> |
|
|
|
|
|
|
|
<pre> |
|
|
|
<ant antfile="subbuild.xml" inheritrefs="true"/> |
|
|
|
</pre> |
|
|
|
<blockquote><pre> |
|
|
|
<ant antfile="subbuild.xml" inheritrefs="true"/> |
|
|
|
</pre></blockquote> |
|
|
|
|
|
|
|
<p>will not override <code>subbuild</code>'s definition of |
|
|
|
<code>path1</code>, but make the parent's definition of |
|
|
|
<code>path2</code> available in the subbuild.</p> |
|
|
|
|
|
|
|
<pre> |
|
|
|
<ant antfile="subbuild.xml"/> |
|
|
|
</pre> |
|
|
|
<blockquote><pre> |
|
|
|
<ant antfile="subbuild.xml"/> |
|
|
|
</pre></blockquote> |
|
|
|
|
|
|
|
<p>as well as</p> |
|
|
|
|
|
|
|
<pre> |
|
|
|
<ant antfile="subbuild.xml" inheritrefs="false"/> |
|
|
|
</pre> |
|
|
|
<blockquote><pre> |
|
|
|
<ant antfile="subbuild.xml" inheritrefs="false"/> |
|
|
|
</pre></blockquote> |
|
|
|
|
|
|
|
<p>will neither override <code>path1</code> nor copy |
|
|
|
<code>path2</code>.</p> |
|
|
|
|
|
|
|
<pre> |
|
|
|
<ant antfile="subbuild.xml" inheritrefs="false"> |
|
|
|
<reference refid="path1"/> |
|
|
|
</ant> |
|
|
|
</pre> |
|
|
|
<blockquote><pre> |
|
|
|
<ant antfile="subbuild.xml" inheritrefs="false"> |
|
|
|
<reference refid="path1"/> |
|
|
|
</ant> |
|
|
|
</pre></blockquote> |
|
|
|
|
|
|
|
<p>will override <code>subbuild</code>'s definition of |
|
|
|
<code>path1</code>.</p> |
|
|
|
|
|
|
|
<pre> |
|
|
|
<ant antfile="subbuild.xml" inheritrefs="false"> |
|
|
|
<reference refid="path1" torefid="path2"/> |
|
|
|
</ant> |
|
|
|
</pre> |
|
|
|
<blockquote><pre> |
|
|
|
<ant antfile="subbuild.xml" inheritrefs="false"> |
|
|
|
<reference refid="path1" torefid="path2"/> |
|
|
|
</ant> |
|
|
|
</pre></blockquote> |
|
|
|
|
|
|
|
<p>will copy the parent's definition of <code>path1</code> into the |
|
|
|
new project using the id <code>path2</code>.</p> |
|
|
|