Added: ant/ivy/site/target/history/2.2.0/settings/namespace.html URL: http://svn.apache.org/viewvc/ant/ivy/site/target/history/2.2.0/settings/namespace.html?rev=1005260&view=auto ============================================================================== --- ant/ivy/site/target/history/2.2.0/settings/namespace.html (added) +++ ant/ivy/site/target/history/2.2.0/settings/namespace.html Wed Oct 6 21:25:29 2010 @@ -0,0 +1,163 @@ + + + + + + + +namespace | Apache Ivy + + + + + + + + + + +
+ + + + + + + + + + + + + +
+ +
+ +
+ + + + +
+ + +
+ + +
+ + + + + + + +
+
+ +

namespace

+
Tag: namespace

Defines a new namespace. A namespace is identified by a name, which can be referenced by one of the resolvers. + +An overview of Namespaces is given in the namespaces documentation.

A namespace mainly consists of a list of rules, each rule defining a translation between a system namespace and the defined namespace, and vice versa.

There are two main possibilities for using these rules. By default, a namespace iterates through the rules, and when it finds one that translates the given name, it returns the translated name. But the namespace can be configured to use the list as a translator chain: in this case, all rules are applied in order, the result of the first rule translation being passed to the second, and so on.

Attributes

+ + + + + + + + + + +
AttributeDescriptionRequired
namethe namespace nameYes
chainrulestrue to indicate that namespaces rules should be chained, false otherwiseNo, defaults to false
+

Child elements

+ + + + + + + + +
ElementDescriptionCardinality
ruledefines a new namespace rule0..n
+

Example

+
+<namespace name="test">
<rule>
<fromsystem>
<src org="systemorg"/>
<dest org="A"/>
</fromsystem>
<tosystem>
<src org="A"/>
<dest org="systemorg"/>
</tosystem>
</rule>
</namespace> +
+ +
+<namespace name="test">
<rule>
<fromsystem>
<src org="systemorg2" module="system\-(.+)"/>
<dest org="B" module="$m1"/>
</fromsystem>
<tosystem>
<src org="B" module=".+"/>
<dest org="systemorg2" module="system-$m0"/>
</tosystem>
</rule>
</namespace> +
+ +
+<namespace name="test" chainrules="true">
<rule>
<fromsystem>
<src org="systemorg"/>
<dest org="A"/>
</fromsystem>
<tosystem>
<src org="A"/>
<dest org="systemorg"/>
</tosystem>
</rule>
<rule>
<fromsystem>
<src module="systemmod"/>
<dest module="A"/>
</fromsystem>
<tosystem>
<src module="A"/>
<dest module="systemmod"/>
</tosystem>
</rule>
<rule>
<fromsystem>
<src module="systemmod2"/>
<dest module="B"/>
</fromsystem>
<tosystem>
<src module="B"/>
<dest module="systemmod2"/>
</tosystem>
</rule>
</namespace> +
+ + +
+
+ + + + + + + + + + + + +
+ + Added: ant/ivy/site/target/history/2.2.0/settings/namespace/dest.html URL: http://svn.apache.org/viewvc/ant/ivy/site/target/history/2.2.0/settings/namespace/dest.html?rev=1005260&view=auto ============================================================================== --- ant/ivy/site/target/history/2.2.0/settings/namespace/dest.html (added) +++ ant/ivy/site/target/history/2.2.0/settings/namespace/dest.html Wed Oct 6 21:25:29 2010 @@ -0,0 +1,146 @@ + + + + + + + +dest | Apache Ivy + + + + + + + + + + +
+ + + + + + + + + + + + + +
+ +
+ +
+ + + + +
+ + +
+ + +
+ + + + + + + +
+
+ +

dest

+
Tag: dest

Defines the translation part of a translation rule. If a name has matched a corresponding src, it will be translated using this dest part. + +The new names can contain references to groups of the matched name, using a slightly modified regexp syntax. Indeed, referenced groups can be part of either the organisation, module or revision part of the original name. So, to reference the groups, you just have to add a letter identifying the part in which the group should be selected: o for organisation, m for module, and r for revision.

For instance, $o0 matches the whole matched organisation, and $m0 the whole matched module name. $o1 matches the first group of the matched organisation.

For details about regexp and groups, see the Pattern class documentation in the jdk.

Attributes

+ + + + + + + + + + + + +
AttributeDescriptionRequired
orgthe new organisation nameNo, defaults to $o0
modulethe new module nameNo, defaults to $m0
revthe new revisionNo, defaults to $r0
+

Examples

+
+    <fromsystem>
<src org="systemorg2" module="system\-(.+)"/>
<dest org="B" module="$m1"/>
</fromsystem> +
+Matches modules from systemorg2 which have a name beginning with system followed by a minus and anything else, and translate it to organisation B and module the part following
system-
of the original name.

+
+
+ + + + + + + + + + + + +
+ + Added: ant/ivy/site/target/history/2.2.0/settings/namespace/fromtosystem.html URL: http://svn.apache.org/viewvc/ant/ivy/site/target/history/2.2.0/settings/namespace/fromtosystem.html?rev=1005260&view=auto ============================================================================== --- ant/ivy/site/target/history/2.2.0/settings/namespace/fromtosystem.html (added) +++ ant/ivy/site/target/history/2.2.0/settings/namespace/fromtosystem.html Wed Oct 6 21:25:29 2010 @@ -0,0 +1,140 @@ + + + + + + + +fromsystem / tosystem | Apache Ivy + + + + + + + + + + +
+ + + + + + + + + + + + + +
+ +
+ +
+ + + + +
+ + +
+ + +
+ + + + + + + +
+
+ +

fromsystem / tosystem

+
Tag: fromsystem / tosystem

Defines a one way translation rule, i.e. a translation from system namespace to the defined namespace or vice versa. +

Child elements

+ + + + + + + + + + +
ElementDescriptionCardinality
srcdefines a source name which can be accepted1..n
destdefines the translation to apply when a name is accepted by an src pattern1
+ + +
+
+ + + + + + + + + + + + +
+ + Added: ant/ivy/site/target/history/2.2.0/settings/namespace/rule.html URL: http://svn.apache.org/viewvc/ant/ivy/site/target/history/2.2.0/settings/namespace/rule.html?rev=1005260&view=auto ============================================================================== --- ant/ivy/site/target/history/2.2.0/settings/namespace/rule.html (added) +++ ant/ivy/site/target/history/2.2.0/settings/namespace/rule.html Wed Oct 6 21:25:29 2010 @@ -0,0 +1,140 @@ + + + + + + + +rule | Apache Ivy + + + + + + + + + + +
+ + + + + + + + + + + + + +
+ +
+ +
+ + + + +
+ + +
+ + +
+ + + + + + + +
+
+ +

rule

+
Tag: rule

Defines a new namespace rule. A rule defines a translation between system namespace and the defined namespace, and vice versa. + +See the namespace doc for details.

Child elements

+ + + + + + + + + + +
ElementDescriptionCardinality
fromsystemdefines the translation to apply from the system namespace to the defined namespace1
tosystemdefines the translation to apply from the defined namespace to the system namespace1
+ +
+
+ + + + + + + + + + + + +
+ +