diff --git a/docs/manual/Tasks/bindtargets.html b/docs/manual/Tasks/bindtargets.html index fdd7c5dae..1aa6d7393 100644 --- a/docs/manual/Tasks/bindtargets.html +++ b/docs/manual/Tasks/bindtargets.html @@ -31,8 +31,29 @@ extension point. It will make the list of targets dependencies of the extension point.

+

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. +

+ +

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: +

+
<bindtargets targets="jar,javadoc" extensionPoint="dist" />
+is quite equivalent to: +
<target name="bind-to-dist" depends="jar,javadoc" extensionOf="dist" />
+

+This task basically avoid the creation of a target. +

+

The bindtargets task may only be used as a top-level task. This means that -it may not be used in a target.

+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.

Since Ant 1.8.2

@@ -64,7 +85,7 @@ it may not be used in a target.

Examples

-<bindtargets targets="build-jar,build-src-jar" extensionPoint="dist"/>
+<bindtargets targets="build-jar,build-src-jar" extensionPoint="dist" />