ant-notifications mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From hi...@apache.org
Subject svn commit: r1033630 - /ant/core/trunk/docs/manual/Tasks/bindtargets.html
Date Wed, 10 Nov 2010 18:23:55 GMT
Author: hibou
Date: Wed Nov 10 18:23:55 2010
New Revision: 1033630

URL: http://svn.apache.org/viewvc?rev=1033630&view=rev
Log:
Try to explain the rationale of the task bindtargets and highlights some point raised on the
ant-dev mailing list

Modified:
    ant/core/trunk/docs/manual/Tasks/bindtargets.html

Modified: ant/core/trunk/docs/manual/Tasks/bindtargets.html
URL: http://svn.apache.org/viewvc/ant/core/trunk/docs/manual/Tasks/bindtargets.html?rev=1033630&r1=1033629&r2=1033630&view=diff
==============================================================================
--- ant/core/trunk/docs/manual/Tasks/bindtargets.html (original)
+++ ant/core/trunk/docs/manual/Tasks/bindtargets.html Wed Nov 10 18:23:55 2010
@@ -31,8 +31,29 @@
 <a href="../targets.html#extension-points">extension point</a>. It will make
the
 list of targets dependencies of the extension point.</p>
 
+<p>This target is useful when you want to have a target participate to another
+build workflow, build workflow which explicitly expose an extension point for
+that kind of insertion. But the target to bind and the extension point to
+bind to are both declared in some imported build files. Modifying directly the
+target dependency graph of these external build files may have a side effect
+on some other project which import them. This task helps then to modify the
+target dependencies but only in your context.
+</p>
+
+<p>Note: this task is quite equivalent to the definition of an intermediate
+target which will be the bridge between the target to bind and the extension
+point. For instance:
+</p>
+<blockquote><pre>&lt;bindtargets targets="jar,javadoc" extensionPoint="dist"
/&gt;</pre></blockquote>
+is quite equivalent to:
+<blockquote><pre>&lt;target name="bind-to-dist" depends="jar,javadoc" extensionOf="dist"
/&gt;</pre></blockquote>
+<p>
+This task basically avoid the creation of a target.
+</p>
+
 <p>The bindtargets task may only be used as a top-level task. This means that
-it may not be used in a target.</p>
+it may not be used in a target. This is making the target dependency graph static
+and predictable as soon as every build file is loaded.</p>
 
 <p><b>Since Ant 1.8.2</b></p>
 
@@ -64,7 +85,7 @@ it may not be used in a target.</p>
 
 <h3>Examples</h3>
 <blockquote><pre>
-&lt;bindtargets targets=&quot;build-jar,build-src-jar&quot; extensionPoint=&quot;dist&quot;/&gt;
+&lt;bindtargets targets=&quot;build-jar,build-src-jar&quot; extensionPoint=&quot;dist&quot;
/&gt;
 </pre></blockquote>
 
 </body>



Mime
View raw message