diff --git a/docs/manual/Tasks/bindtargets.html b/docs/manual/Tasks/bindtargets.html index 9fb81b442..d8374a49c 100644 --- a/docs/manual/Tasks/bindtargets.html +++ b/docs/manual/Tasks/bindtargets.html @@ -1,92 +1,92 @@ - - - - - - -Bindtargets Task - - - - -

Bindtargets

-

Description

- -

Make some target the extension of some defined -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. This is making the target dependency graph static -and predictable as soon as every build file is loaded.

- -

Since Apache Ant 1.8.2

- -

Parameters

- - - - - - - - - - - - - - - - - - - - - -
AttributeDescriptionRequired
targetsa comma separated list of target names to bind.Yes
extensionPointthe name of the extension point to bind the targets to.Yes
onMissingExtensionPointWhat to do if this target tries to extend a missing - extension-point. ("fail", - "warn", "ignore").No. Defaults to fail
- -

Examples

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

Bindtargets

+

Description

+ +

Make some target the extension of some defined +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. This is making the target dependency graph static +and predictable as soon as every build file is loaded.

+ +

Since Apache Ant 1.8.2

+ +

Parameters

+ + + + + + + + + + + + + + + + + + + + + +
AttributeDescriptionRequired
targetsa comma separated list of target names to bind.Yes
extensionPointthe name of the extension point to bind the targets to.Yes
onMissingExtensionPointWhat to do if this target tries to extend a missing + extension-point. ("fail", + "warn", "ignore").No. Defaults to fail
+ +

Examples

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