From notifications-return-13847-apmail-ant-notifications-archive=ant.apache.org@ant.apache.org Wed Oct 06 21:26:57 2010 Return-Path: Delivered-To: apmail-ant-notifications-archive@minotaur.apache.org Received: (qmail 10329 invoked from network); 6 Oct 2010 21:26:56 -0000 Received: from unknown (HELO mail.apache.org) (140.211.11.3) by 140.211.11.9 with SMTP; 6 Oct 2010 21:26:56 -0000 Received: (qmail 50570 invoked by uid 500); 6 Oct 2010 21:26:56 -0000 Delivered-To: apmail-ant-notifications-archive@ant.apache.org Received: (qmail 50480 invoked by uid 500); 6 Oct 2010 21:26:56 -0000 Mailing-List: contact notifications-help@ant.apache.org; run by ezmlm Precedence: bulk List-Help: List-Unsubscribe: List-Post: List-Id: Reply-To: dev@ant.apache.org Delivered-To: mailing list notifications@ant.apache.org Received: (qmail 50470 invoked by uid 99); 6 Oct 2010 21:26:56 -0000 Received: from athena.apache.org (HELO athena.apache.org) (140.211.11.136) by apache.org (qpsmtpd/0.29) with ESMTP; Wed, 06 Oct 2010 21:26:56 +0000 X-ASF-Spam-Status: No, hits=-2000.0 required=10.0 tests=ALL_TRUSTED X-Spam-Check-By: apache.org Received: from [140.211.11.4] (HELO eris.apache.org) (140.211.11.4) by apache.org (qpsmtpd/0.29) with ESMTP; Wed, 06 Oct 2010 21:26:51 +0000 Received: by eris.apache.org (Postfix, from userid 65534) id 785A82388C92; Wed, 6 Oct 2010 21:25:38 +0000 (UTC) Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit Subject: svn commit: r1005260 [28/45] - in /ant/ivy/site/target/history/2.2.0: ./ configuration/ configuration/caches/ configuration/macrodef/ configuration/namespace/ dev/ images/ ivyfile/ js/ resolver/ samples/ settings/ settings/caches/ settings/macrodef/ se... Date: Wed, 06 Oct 2010 21:25:35 -0000 To: notifications@ant.apache.org From: maartenc@apache.org X-Mailer: svnmailer-1.0.8 Message-Id: <20101006212538.785A82388C92@eris.apache.org> 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
+ +
+
+ + + + + + + + + + + + +
+ +