ant-notifications mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From maart...@apache.org
Subject svn commit: r1062839 - /ant/ivy/core/trunk/doc/use/retrieve.html
Date Mon, 24 Jan 2011 15:47:40 GMT
Author: maartenc
Date: Mon Jan 24 15:47:40 2011
New Revision: 1062839

URL: http://svn.apache.org/viewvc?rev=1062839&view=rev
Log:
IMPROVEMENT: ivy:retrieve can now convert 'dotted'-organisation names into a directory tree.

Modified:
    ant/ivy/core/trunk/doc/use/retrieve.html

Modified: ant/ivy/core/trunk/doc/use/retrieve.html
URL: http://svn.apache.org/viewvc/ant/ivy/core/trunk/doc/use/retrieve.html?rev=1062839&r1=1062838&r2=1062839&view=diff
==============================================================================
--- ant/ivy/core/trunk/doc/use/retrieve.html (original)
+++ ant/ivy/core/trunk/doc/use/retrieve.html Mon Jan 24 15:47:40 2011
@@ -54,12 +54,18 @@ root: lib
         <td>No. Defaults to false</td></tr>
     <tr><td>type</td><td>comma separated list of accepted artifact
types <span class="since">since 1.4</span></td>
         <td>No. All artifact types are accepted by default.</td></tr>
-    <tr><td>overwriteMode</td><td>option to configure when the destination
file should be overwritten if it exist <span class="since">(since 2.2.0)</span>.
Possible values are:
+    <tr><td>overwriteMode</td><td>option to configure when the destination
file should be overwritten if it exist <span class="since">(since 2.2.0)</span>.
+Possible values are:
 <ul><li><b>newer</b> (default)</li> overwrite the destination
file if a more recent one is available (based on timestamp)
 <li><b>different</b></li> overwrite the destination file if the timestamp
is different
 <li><b>always</b></li> always overwrite the destination file
 <li><b>never</b></li> never overwrite the destination file
 </ul></td><td>No. Defaults to 'newer'.</td></tr>
+    <tr><td>dirMode</td><td>option to configure how the [organisation]
token in the patterns will be replaced <span class="since">(since 2.3.0)</span>.
+Possible values are:
+<ul><li><b>flat</b> (default)</li> don't convert the organisation
name, the token will get exactly the same value as the organisation
+<li><b>tree</b></li> replace the '.' within the organisation name
with '/'
+</ul>See the examples below.</td><td>No. Defaults to 'flat'.</td></tr>
     <tr><td>symlink</td><td>true to create symbolic links, false
to copy the artifacts. The destination of the symbolic links depends on the value of the useOrigin
attribute <span class="since">(since 2.0)</span></td><td>No. Defaults
to false</td></tr>
     <tr><td>settingsRef</td><td>A reference to the ivy settings that
must be used by this task <span class="since">(since 2.0)</span></td><td>No,
'ivy.instance' is taken by default.</td></tr></tbody>
     <tr><td>log</td><td>the log setting to use during the resolve
and retrieve process. <span class="since">(since 2.0)</span><br/>
@@ -129,6 +135,33 @@ lib
     looks-1.1.zip
 </code>
 
+<hr/>
+<code type="xml">
+<ivy:retrieve pattern="${lib.dir}/[organisation]/[artifact]-[revision].[ext]" dirMode="flat"/>
+</code>
+Retrieves all dependencies of the last resolve call to a lib directory. The [organisation]
token will get the unmodified organisation value. The resulting lib dir could look like this:
+<code>
+lib
+  org.apache
+    commons-lang-1.0.jar
+  org.junit
+    junit-4.1.jar
+    junit-4.1.zip
+</code>
+
+<code type="xml">
+<ivy:retrieve pattern="${lib.dir}/[organisation]/[artifact]-[revision].[ext]" dirMode="tree"/>
+</code>
+Retrieves all dependencies of the last resolve call to a lib directory. The [organisation]
token will get a tree structure. The resulting lib dir could look like this:
+<code>
+lib
+  org
+    apache
+      commons-lang-1.0.jar
+    junit
+      junit-4.1.jar
+      junit-4.1.zip
+</code>
 
 <hr/>
 <code type="xml">



Mime
View raw message