ant-notifications mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
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

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
--- 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
 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>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:
+<blockquote><pre>&lt;bindtargets targets="jar,javadoc" extensionPoint="dist"
+is quite equivalent to:
+<blockquote><pre>&lt;target name="bind-to-dist" depends="jar,javadoc" extensionOf="dist"
+This task basically avoid the creation of a target.
 <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>
-&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;

View raw message