You are viewing a plain text version of this content. The canonical link for it is here.
Posted to notifications@ant.apache.org by ja...@apache.org on 2017/06/19 01:58:59 UTC

[16/29] ant-ivy git commit: Initial auto-converted .adoc files from xooki2asciidoc convertor

http://git-wip-us.apache.org/repos/asf/ant-ivy/blob/22bdffb9/asciidoc/resolver/updatesite.adoc
----------------------------------------------------------------------
diff --git a/asciidoc/resolver/updatesite.adoc b/asciidoc/resolver/updatesite.adoc
new file mode 100644
index 0000000..5ebfeaf
--- /dev/null
+++ b/asciidoc/resolver/updatesite.adoc
@@ -0,0 +1,52 @@
+
+
+[]
+|=======
+|Tag|updatesite
+|Handle latest|yes
+|Handle publish|no
+|=======
+
+
+*__since 2.3__*
+
+<span class="tagdoc" id="ivysettings.resolvers.updatesite">This resolver is one of the resolver which supports link:../osgi.html[OSGi&#153;] dependencies.
+It resolves modules (OSGi bundles) which are hosted in an Eclipse&#153; update site.
+
+This resolver supports old style Eclipse updatesite, based on simply a site.xml. It also supports Eclipse P2 repositories.
+
+
+== Attributes
+
+This resolver shares the link:../settings/resolvers.html#common[common attributes] of composite resolvers.
+
+[options="header",cols="15%,50%,35%"]
+|=======
+|Attribute|Description|Required
+|url|the URL of the Eclipse updatesite|Yes
+|requirementStrategy|defines how strict should be the OSGi resolution. Can be one of `first` or `noambiguity`|No, default to `noambiguity`
+|metadataTtl|the time in milliseconds the updatesite metadata are considered up to date|No, default to 3600000 (1 hour)
+|forceMetadataUpdate|force the update of the updatesite metadata without checking their freshness|No, default to false
+|=======
+
+
+The requirement strategy is defining how the resolver should behave in front of several choices. In the OSGi dependency model, an `Import-Package` requirement can be satisfied by several different bundles. So when resolving such requirement, Ivy will first look into the already resolved bundles if one provides that package. If it fails to find one, then two behaviours can occur:
+
+
+* if the requirement strategy is `first`, among the bundles statifying the requirement, it will shoose the first one. A warn will be logged ahout the choice Ivy has to arbitrarily do. +
+
+* if the requirement strategy is `noambiguity`, Ivy will make the resolution fail. +
+
+
+
+== Examples
+
+
+[source]
+----
+
+<updatesite name="ivyde-updatesite" url="http://www.apache.org/dist/ant/ivyde/updatesite" />
+
+----
+
+A simple repository configured to load the Apache IvyDE Eclipse update site.
\ No newline at end of file

http://git-wip-us.apache.org/repos/asf/ant-ivy/blob/22bdffb9/asciidoc/resolver/url.adoc
----------------------------------------------------------------------
diff --git a/asciidoc/resolver/url.adoc b/asciidoc/resolver/url.adoc
new file mode 100644
index 0000000..047391a
--- /dev/null
+++ b/asciidoc/resolver/url.adoc
@@ -0,0 +1,55 @@
+
+
+[]
+|=======
+|Tag|url
+|Handle latest|yes with http urls (and apache server) and with file urls, no with other urls
+|Handle publish|yes with http urls whose destination supports publishing (as of Ivy 2.0)
+|=======
+
+
+
+
+This resolver is one of the most generic. In fact, most of the previous resolvers can be obtained by a particular configuration of this one. Indeed it uses urls to find ivy files and artifacts. The urls it uses are defined through ivy and artifact children, each giving a pattern to find ivy files or artifacts.
+
+*Limitation*: in m2compatible mode, this resolver is not able list available organizations. It means some features like link:../use/repreport.html[repreport] are not available.
+
+
+== Attributes
+
+This resolver shares the link:../settings/resolvers.html#common[common attributes] of standard resolvers.
+
+[options="header",cols="15%,50%,35%"]
+|=======
+|Attribute|Description|Required
+|m2compatible|True if this resolver should be maven2 compatible, false otherwise *__since 1.3__*|No, defaults to false
+|=======
+
+
+== Child elements
+
+
+[options="header"]
+|=======
+|Element|Description|Cardinality
+|ivy|defines a pattern for ivy files, using the pattern attribute|0..n
+|artifact|defines a pattern for artifacts, using the pattern attribute|1..n
+|=======
+
+
+
+== Example
+
+
+[source]
+----
+
+<url name="two-patterns-example">
+  <ivy pattern="http://ivyrep.mycompany.com/[module]/[revision]/ivy-[revision].xml" />
+  <artifact pattern="http://ivyrep.mycompany.com/[module]/[revision]/[artifact]-[revision].[ext]" />
+  <artifact pattern="http://ivyrep.mycompany.com/[module]/[revision]/[artifact].[ext]" />
+</url>
+
+----
+
+Looks for ivy files in one place and for artifacts in two places: with or without revision in name (revision being already in the directory structure).
\ No newline at end of file

http://git-wip-us.apache.org/repos/asf/ant-ivy/blob/22bdffb9/asciidoc/resolver/vfs.adoc
----------------------------------------------------------------------
diff --git a/asciidoc/resolver/vfs.adoc b/asciidoc/resolver/vfs.adoc
new file mode 100644
index 0000000..1044f5c
--- /dev/null
+++ b/asciidoc/resolver/vfs.adoc
@@ -0,0 +1,46 @@
+
+
+[]
+|=======
+|Tag|vfs
+|Handle latest|depend on vfs capacity, usually yes
+|Handle publish|depend on vfs capacity, usually yes
+|=======
+
+
+
+This resolver is certainly the most capable, since it relies on link:http://jakarta.apache.org/commons/vfs/[Apache commons VFS], which gives an uniform access to link:http://jakarta.apache.org/commons/vfs/filesystems.html[a good number of file systems], including ftp, webdav, zip, ... *__since 1.4__*
+
+__Note: commons vfs has not released a stable version yet, hence Ivy relies on a nightly build. Stability should thus be considered carefully before using this resolver in a production environment__
+
+
+== Attributes
+
+This resolver shares the link:../settings/resolvers.html#common[common attributes] of standard resolvers.
+
+== Child elements
+
+
+[options="header"]
+|=======
+|Element|Description|Cardinality
+|ivy|defines a pattern for ivy files, using the pattern attribute|0..n
+|artifact|defines a pattern for artifacts, using the pattern attribute|1..n
+|=======
+
+
+
+== Example
+
+
+[source]
+----
+
+<vfs name="vfs-resolver">
+  <ivy pattern="sftp://username:password@host/[organisation]/[module]/[revision]/ivy.xml" />
+  <artifact pattern="sftp://username:password@host/[organisation]/[module]/[revision]/[artifact].[ext]" />
+</vfs> 
+
+----
+
+Access ivy and artifacts files using sftp.
\ No newline at end of file

http://git-wip-us.apache.org/repos/asf/ant-ivy/blob/22bdffb9/asciidoc/running.adoc
----------------------------------------------------------------------
diff --git a/asciidoc/running.adoc b/asciidoc/running.adoc
new file mode 100644
index 0000000..dd61b8c
--- /dev/null
+++ b/asciidoc/running.adoc
@@ -0,0 +1,11 @@
+
+    Ivy is sending http headers when downloading files.
+    The User-Agent http header can be controlled using a 
+[source]
+----
+http.agent
+----
+
+system property.
+    When this system property is not set, the default value for the User-Agent header is "Apache Ivy/ivyversion"
+    where ivyversion is replaced by the currently running version of ivy.
\ No newline at end of file

http://git-wip-us.apache.org/repos/asf/ant-ivy/blob/22bdffb9/asciidoc/samples/apache-hello-ivy-default.html
----------------------------------------------------------------------
diff --git a/asciidoc/samples/apache-hello-ivy-default.html b/asciidoc/samples/apache-hello-ivy-default.html
new file mode 100644
index 0000000..edb4488
--- /dev/null
+++ b/asciidoc/samples/apache-hello-ivy-default.html
@@ -0,0 +1,371 @@
+<!--
+   Licensed to the Apache Software Foundation (ASF) under one
+   or more contributor license agreements.  See the NOTICE file
+   distributed with this work for additional information
+   regarding copyright ownership.  The ASF licenses this file
+   to you under the Apache License, Version 2.0 (the
+   "License"); you may not use this file except in compliance
+   with the License.  You may obtain a copy of the License at
+
+     http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing,
+   software distributed under the License is distributed on an
+   "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+   KIND, either express or implied.  See the License for the
+   specific language governing permissions and limitations
+   under the License.    
+-->
+<html>
+<head>
+<META http-equiv="Content-Type" content="text/html; charset=UTF-8">
+<title>Ivy report :: hello-ivy by apache :: default</title>
+<meta http-equiv="content-type" content="text/html; charset=ISO-8859-1">
+<meta http-equiv="content-language" content="en">
+<meta name="robots" content="index,follow">
+<link rel="stylesheet" type="text/css" href="ivy-report.css">
+</head>
+<body>
+<div id="logo">
+<a href="http://ant.apache.org/ivy/"><img src="http://ant.apache.org/ivy/images/logo.png"></a>
+</div>
+<h1>
+<a name="apache-hello-ivy"></a><span id="module">hello-ivy</span> 
+        by 
+        <span id="organisation">apache</span>
+</h1>
+<div id="date">
+    resolved on 
+      2007-10-21 17:24:25</div>
+<ul id="confmenu">
+<li>
+<a class="active" href="apache-hello-ivy-default.html">default</a>
+</li>
+</ul>
+<div id="content">
+<h2>Dependencies Stats</h2>
+<table class="header">
+<tr>
+<td class="title">Modules</td><td class="value">3</td>
+</tr>
+<tr>
+<td class="title">Revisions</td><td class="value">4  
+            (0 searched <img src="http://ivy.jayasoft.org/images/searched.gif" alt="searched" title="module revisions which required a search with a dependency resolver to be resolved">,
+            0 downloaded <img src="http://ivy.jayasoft.org/images/downloaded.gif" alt="downloaded" title="module revisions for which ivy file was downloaded by dependency resolver">,
+            1 evicted <img src="http://ivy.jayasoft.org/images/evicted.gif" alt="evicted" title="module revisions which were evicted by others">,
+            0 errors <img src="http://ivy.jayasoft.org/images/error.gif" alt="error" title="module revisions on which error occurred">)</td>
+</tr>
+<tr>
+<td class="title">Artifacts</td><td class="value">3 
+            (0 downloaded,
+            0 failed)</td>
+</tr>
+<tr>
+<td class="title">Artifacts size</td><td class="value">217 kB
+            (0 kB downloaded,
+            217 kB in cache)</td>
+</tr>
+</table>
+<h2>Conflicts</h2>
+<table class="conflicts">
+<thead>
+<tr>
+<th>Module</th><th>Selected</th><th>Evicted</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td><a href="#commons-lang-commons-lang">commons-lang
+             by
+             commons-lang</a></td><td><a href="#commons-lang-commons-lang-2.0">2.0</a> </td><td><a href="#commons-lang-commons-lang-1.0">1.0</a> </td>
+</tr>
+</tbody>
+</table>
+<h2>Dependencies Overview</h2>
+<table class="deps">
+<thead>
+<tr>
+<th>Module</th><th>Revision</th><th>Status</th><th>Resolver</th><th>Default</th><th>Licenses</th><th>Size</th><th></th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td><a href="#commons-cli-commons-cli"> commons-cli
+         by
+         commons-cli</a></td><td><a href="#commons-cli-commons-cli-1.0">1.0</a></td><td align="center">integration</td><td align="center">public</td><td align="center">false</td><td align="center"></td><td align="center">29 kB
+    </td><td align="center"></td>
+</tr>
+<tr>
+<td><a href="#commons-logging-commons-logging">--- commons-logging
+         by
+         commons-logging</a></td><td><a href="#commons-logging-commons-logging-1.0">1.0</a></td><td align="center">integration</td><td align="center">public</td><td align="center">false</td><td align="center"></td><td align="center">21 kB
+    </td><td align="center"></td>
+</tr>
+<tr>
+<td><a href="#commons-lang-commons-lang">--- commons-lang
+         by
+         commons-lang</a></td><td><a href="#commons-lang-commons-lang-1.0">1.0</a></td><td align="center"></td><td align="center"></td><td align="center"></td><td align="center"></td><td align="center">0 kB
+    </td><td align="center"><img src="http://ivy.jayasoft.org/images/evicted.gif" alt="evicted" title="evicted by 2.0"></td>
+</tr>
+<tr>
+<td><a href="#commons-lang-commons-lang">--- commons-lang
+         by
+         commons-lang</a></td><td><a href="#commons-lang-commons-lang-2.0">2.0</a></td><td align="center">integration</td><td align="center">public</td><td align="center">false</td><td align="center"></td><td align="center">166 kB
+    </td><td align="center"></td>
+</tr>
+<tr>
+<td><a href="#commons-lang-commons-lang"> commons-lang
+         by
+         commons-lang</a></td><td><a href="#commons-lang-commons-lang-2.0">2.0</a></td><td align="center">integration</td><td align="center">public</td><td align="center">false</td><td align="center"></td><td align="center">166 kB
+    </td><td align="center"></td>
+</tr>
+</tbody>
+</table>
+<h2>Details</h2>
+<h3>
+<a name="commons-cli-commons-cli"></a>commons-cli by commons-cli<span class="resolved">resolved by <b>default</b></span>
+</h3>
+<h4>
+<a name="commons-cli-commons-cli-1.0"></a>
+           Revision: 1.0<span style="padding-left:15px;"></span>
+</h4>
+<table class="header">
+<tr>
+<td class="title">Status</td><td class="value">integration</td>
+</tr>
+<tr>
+<td class="title">Publication</td><td class="value">20051108231152</td>
+</tr>
+<tr>
+<td class="title">Resolver</td><td class="value">public</td>
+</tr>
+<tr>
+<td class="title">Configurations</td><td class="value">system, default, compile, provided, runtime, master</td>
+</tr>
+<tr>
+<td class="title">Artifacts size</td><td class="value">29 kB
+            (0 kB downloaded,
+            29 kB in cache)</td>
+</tr>
+</table>
+<h5>Required by</h5>
+<table>
+<thead>
+<tr>
+<th>Organisation</th><th>Name</th><th>In Configurations</th><th>Asked Revision</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td>apache</td><td><a href="#apache-hello-ivy">hello-ivy</a></td><td>default</td><td>1.0</td>
+</tr>
+</tbody>
+</table>
+<h5>Dependencies</h5>
+<table class="deps">
+<thead>
+<tr>
+<th>Module</th><th>Revision</th><th>Status</th><th>Resolver</th><th>Default</th><th>Licenses</th><th>Size</th><th></th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td><a href="#commons-logging-commons-logging"> commons-logging
+         by
+         commons-logging</a></td><td><a href="#commons-logging-commons-logging-1.0">1.0</a></td><td align="center">integration</td><td align="center">public</td><td align="center">false</td><td align="center"></td><td align="center">21 kB
+    </td><td align="center"></td>
+</tr>
+<tr>
+<td><a href="#commons-lang-commons-lang"> commons-lang
+         by
+         commons-lang</a></td><td><a href="#commons-lang-commons-lang-1.0">1.0</a></td><td align="center"></td><td align="center"></td><td align="center"></td><td align="center"></td><td align="center">0 kB
+    </td><td align="center"><img src="http://ivy.jayasoft.org/images/evicted.gif" alt="evicted" title="evicted by 2.0"></td>
+</tr>
+<tr>
+<td><a href="#commons-lang-commons-lang"> commons-lang
+         by
+         commons-lang</a></td><td><a href="#commons-lang-commons-lang-2.0">2.0</a></td><td align="center">integration</td><td align="center">public</td><td align="center">false</td><td align="center"></td><td align="center">166 kB
+    </td><td align="center"></td>
+</tr>
+</tbody>
+</table>
+<h5>Artifacts</h5>
+<table>
+<thead>
+<tr>
+<th>Name</th><th>Type</th><th>Ext</th><th>Download</th><th>Size</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td>commons-cli</td><td>jar</td><td>jar</td><td align="center">no</td><td align="center">29 kB</td>
+</tr>
+</tbody>
+</table>
+<h3>
+<a name="commons-logging-commons-logging"></a>commons-logging by commons-logging<span class="resolved">resolved by <b>default</b></span>
+</h3>
+<h4>
+<a name="commons-logging-commons-logging-1.0"></a>
+           Revision: 1.0<span style="padding-left:15px;"></span>
+</h4>
+<table class="header">
+<tr>
+<td class="title">Status</td><td class="value">integration</td>
+</tr>
+<tr>
+<td class="title">Publication</td><td class="value">20051108231641</td>
+</tr>
+<tr>
+<td class="title">Resolver</td><td class="value">public</td>
+</tr>
+<tr>
+<td class="title">Configurations</td><td class="value">compile, runtime, master</td>
+</tr>
+<tr>
+<td class="title">Artifacts size</td><td class="value">21 kB
+            (0 kB downloaded,
+            21 kB in cache)</td>
+</tr>
+</table>
+<h5>Required by</h5>
+<table>
+<thead>
+<tr>
+<th>Organisation</th><th>Name</th><th>In Configurations</th><th>Asked Revision</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td>commons-cli</td><td><a href="#commons-cli-commons-cli">commons-cli</a></td><td>compile, runtime</td><td>1.0</td>
+</tr>
+</tbody>
+</table>
+<h5>Dependencies</h5>
+<table>
+<tr>
+<td>
+    No dependency
+    </td>
+</tr>
+</table>
+<h5>Artifacts</h5>
+<table>
+<thead>
+<tr>
+<th>Name</th><th>Type</th><th>Ext</th><th>Download</th><th>Size</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td>commons-logging</td><td>jar</td><td>jar</td><td align="center">no</td><td align="center">21 kB</td>
+</tr>
+</tbody>
+</table>
+<h3>
+<a name="commons-lang-commons-lang"></a>commons-lang by commons-lang<span class="resolved">resolved by <b>default</b></span>
+</h3>
+<h4>
+<a name="commons-lang-commons-lang-1.0"></a>
+           Revision: 1.0<span style="padding-left:15px;"><img src="http://ivy.jayasoft.org/images/evicted.gif" alt="evicted" title="evicted by 2.0"></span>
+</h4>
+<table class="header">
+<tr>
+<td class="title">Status</td><td class="value"></td>
+</tr>
+<tr>
+<td class="title">Publication</td><td class="value"></td>
+</tr>
+<tr>
+<td class="title">Resolver</td><td class="value"></td>
+</tr>
+<tr>
+<td class="title">Configurations</td><td class="value"></td>
+</tr>
+<tr>
+<td class="title">Artifacts size</td><td class="value">0 kB
+            (0 kB downloaded,
+            0 kB in cache)</td>
+</tr>
+<tr>
+<td class="title">Evicted by</td><td class="value">2.0   
+            in <b>latest-revision</b> conflict manager
+        </td>
+</tr>
+</table>
+<h5>Required by</h5>
+<table>
+<thead>
+<tr>
+<th>Organisation</th><th>Name</th><th>In Configurations</th><th>Asked Revision</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td>commons-cli</td><td><a href="#commons-cli-commons-cli">commons-cli</a></td><td>compile, runtime</td><td>1.0</td>
+</tr>
+</tbody>
+</table>
+<h4>
+<a name="commons-lang-commons-lang-2.0"></a>
+           Revision: 2.0<span style="padding-left:15px;"></span>
+</h4>
+<table class="header">
+<tr>
+<td class="title">Status</td><td class="value">integration</td>
+</tr>
+<tr>
+<td class="title">Publication</td><td class="value">20051124062021</td>
+</tr>
+<tr>
+<td class="title">Resolver</td><td class="value">public</td>
+</tr>
+<tr>
+<td class="title">Configurations</td><td class="value">system, default, compile, provided, runtime, master</td>
+</tr>
+<tr>
+<td class="title">Artifacts size</td><td class="value">166 kB
+            (0 kB downloaded,
+            166 kB in cache)</td>
+</tr>
+</table>
+<h5>Required by</h5>
+<table>
+<thead>
+<tr>
+<th>Organisation</th><th>Name</th><th>In Configurations</th><th>Asked Revision</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td>apache</td><td><a href="#apache-hello-ivy">hello-ivy</a></td><td>default</td><td>2.0</td>
+</tr>
+<tr>
+<td>commons-cli</td><td><a href="#commons-cli-commons-cli">commons-cli</a></td><td>compile, runtime</td><td>1.0</td>
+</tr>
+</tbody>
+</table>
+<h5>Dependencies</h5>
+<table>
+<tr>
+<td>
+    No dependency
+    </td>
+</tr>
+</table>
+<h5>Artifacts</h5>
+<table>
+<thead>
+<tr>
+<th>Name</th><th>Type</th><th>Ext</th><th>Download</th><th>Size</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td>commons-lang</td><td>jar</td><td>jar</td><td align="center">no</td><td align="center">166 kB</td>
+</tr>
+</tbody>
+</table>
+</div>
+</body>
+</html>

http://git-wip-us.apache.org/repos/asf/ant-ivy/blob/22bdffb9/asciidoc/samples/build-install.xml
----------------------------------------------------------------------
diff --git a/asciidoc/samples/build-install.xml b/asciidoc/samples/build-install.xml
new file mode 100644
index 0000000..8f7183a
--- /dev/null
+++ b/asciidoc/samples/build-install.xml
@@ -0,0 +1,72 @@
+<!--
+   Licensed to the Apache Software Foundation (ASF) under one
+   or more contributor license agreements.  See the NOTICE file
+   distributed with this work for additional information
+   regarding copyright ownership.  The ASF licenses this file
+   to you under the Apache License, Version 2.0 (the
+   "License"); you may not use this file except in compliance
+   with the License.  You may obtain a copy of the License at
+
+     http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing,
+   software distributed under the License is distributed on an
+   "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+   KIND, either express or implied.  See the License for the
+   specific language governing permissions and limitations
+   under the License.    
+-->
+
+<!--
+	This build script is used to download dependencies for a freshly downloaded
+	binary distribution of Ivy without dependencies.
+	
+	To use it, you only need to have this script in the directory where you
+	have unzipped your binary distribution of Ivy, and to call it using
+	ant -f build-install.xml
+	
+	If you don't want to download all optional dependencies, you can set
+	the conf attribute value in the ivy:retrieve task, to select only
+	the configuration you want (check the ivy.xml for details about
+	which configurations are available, and what they are useful for).
+-->
+<project name="ivy-bin-install" default="download-deps" 
+		xmlns:ivy="antlib:org.apache.ivy.ant">
+	<target name="init-ivy-settings">
+		<echo file="${basedir}/ivysettings.xml">
+		<![CDATA[
+<ivysettings>
+	<include url="${ivy.default.conf.dir}/ivyconf-local.xml"/>
+	<settings defaultResolver="public" />
+	<resolvers>
+		<!--  
+			we use ivyrep for ivy and some artifacts, and ibiblio for other artifacts
+			The reason for that is that commons vfs is still not released, thus we depend on an integration
+			version only available on ivyrep, but not on ivyrep
+			As soon as vfs will be available on ibiblio, the default configuration could be used again
+			-->
+		<url name="public">
+			<ivy pattern="http://ivyrep.jayasoft.org/[organisation]/[module]/ivy-[revision].xml"/>
+			<artifact pattern="http://ivyrep.jayasoft.org/[organisation]/[module]/[revision]/[artifact].[ext]"/>
+			<artifact pattern="https://repo1.maven.org/maven/[module]/[type]s/[artifact]-[revision].[ext]"/>
+		</url>
+	</resolvers>
+</ivysettings>
+		]]>  
+		</echo>
+	</target>
+	
+	<target name="init-ivy" depends="init-ivy-settings">
+    	<path id="ivy.lib.path">
+    	    <fileset dir="${basedir}" includes="*.jar" excludes="ivy-core-*.jar"/>
+    	</path>
+    	<taskdef resource="org/apache/ivy/ant/antlib.xml"
+    	          uri="antlib:org.apache.ivy.ant" classpathref="ivy.lib.path"/>
+	</target>
+	
+	<target name="download-deps" depends="init-ivy">
+		<ivy:retrieve 
+				conf="*" 
+				pattern="${basedir}/lib/[conf]/[artifact]-[revision].[ext]"/>
+	</target>
+</project>

http://git-wip-us.apache.org/repos/asf/ant-ivy/blob/22bdffb9/asciidoc/samples/build.xml
----------------------------------------------------------------------
diff --git a/asciidoc/samples/build.xml b/asciidoc/samples/build.xml
new file mode 100644
index 0000000..a7dbbcd
--- /dev/null
+++ b/asciidoc/samples/build.xml
@@ -0,0 +1,151 @@
+<!--
+   Licensed to the Apache Software Foundation (ASF) under one
+   or more contributor license agreements.  See the NOTICE file
+   distributed with this work for additional information
+   regarding copyright ownership.  The ASF licenses this file
+   to you under the Apache License, Version 2.0 (the
+   "License"); you may not use this file except in compliance
+   with the License.  You may obtain a copy of the License at
+
+     http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing,
+   software distributed under the License is distributed on an
+   "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+   KIND, either express or implied.  See the License for the
+   specific language governing permissions and limitations
+   under the License.    
+-->
+<project name="go-ivy" default="go" xmlns:ivy="antlib:org.apache.ivy.ant">
+    <!-- 
+        this build file is a self contained project: it doesn't require anything else 
+        that ant 1.6.2 or greater and java 1.4 or greater properly installed.
+        
+        It is used to showcase how easy and straightforward it can be to use Ivy.
+        
+        This is not an example of the best pratice to use in a project, especially
+        for the java source code "generation" :-) (see generate-src target)
+        
+        To run copy this file in an empty directory, open a shell or a command window
+        in this directory and run "ant". It will download ivy and then use it to resolve 
+        the dependency of the class which is itself "contained" in this build script.
+        
+        After a successful build run "ant" again and you will see the build will be
+        much faster.
+        
+        More information can be found at http://ant.apache.org/ivy/
+        -->
+	
+	<!-- here is the version of ivy we will use. change this property to try a newer 
+         version if you want -->
+	<property name="ivy.install.version" value="2.0.0-beta1" />
+	<property name="ivy.jar.dir" value="${basedir}/ivy" />
+	<property name="ivy.jar.file" value="${ivy.jar.dir}/ivy.jar" />
+
+    <property name="build.dir" value="build" />
+    <property name="src.dir" value="src" />
+    
+    
+    <target name="download-ivy" unless="skip.download">
+    	<mkdir dir="${ivy.jar.dir}"/>
+		<!-- download Ivy from web site so that it can be used even without any special installation -->
+		<echo message="installing ivy..."/>
+    	<get src="https://repo1.maven.org/maven2/org/apache/ivy/ivy/${ivy.install.version}/ivy-${ivy.install.version}.jar"
+    		 dest="${ivy.jar.file}" usetimestamp="true"/>
+    </target>
+    
+    <!-- ================================= 
+          target: install-ivy         
+            this target is not necessary if you put ivy.jar in your ant lib directory
+            if you already have ivy in your ant lib, you can simply remove this
+            target and the dependency the 'go' target has on it
+         ================================= -->
+    <target name="install-ivy" depends="download-ivy" description="--> install ivy">
+    	<!-- try to load ivy here from local ivy dir, in case the user has not already dropped
+    	      it into ant's lib dir (note that the latter copy will always take precedence).
+    	      We will not fail as long as local lib dir exists (it may be empty) and
+    	      ivy is in at least one of ant's lib dir or the local lib dir. -->
+    	<path id="ivy.lib.path">
+    	    <fileset dir="${ivy.jar.dir}" includes="*.jar"/>
+    	</path>
+    	<taskdef resource="org/apache/ivy/ant/antlib.xml"
+    	          uri="antlib:org.apache.ivy.ant" classpathref="ivy.lib.path"/>
+    </target>    
+	
+	<!-- ================================= 
+          target: go
+                    Go ivy, go!
+         ================================= -->
+    <target name="go" depends="install-ivy, generate-src" 
+            description="--> resolve dependencies, compile and run the project">
+		<echo message="using ivy to resolve commons-lang 2.1..."/>
+        <!-- here comes the magic line: asks ivy to resolve a dependency on 
+             commons-lang 2.1 and to build an ant path with it from its cache  -->
+        <ivy:cachepath organisation="commons-lang" module="commons-lang" revision="2.1" 
+                       pathid="lib.path.id" inline="true"/>
+        
+		<echo message="compiling..."/>
+        <mkdir dir="${build.dir}" />
+        <javac srcdir="${src.dir}" destdir="${build.dir}" classpathref="lib.path.id" />
+        
+		<echo>
+We are now ready to execute our simple program with its dependency on commons-lang.
+Let's go!
+		</echo>
+        <java classname="example.Hello">
+            <classpath>
+                <path refid="lib.path.id" />
+                <path location="${build.dir}" />
+            </classpath>
+        </java>
+    </target>
+
+	<!-- ================================= 
+          target: generate-src
+            'Generates' the class source. It actually just echo a simple java 
+            source code to a file. In real life this file would already be
+            present on your file system, and this target wouldn't be necessary.
+         ================================= -->
+    <target name="generate-src">
+        <mkdir dir="${src.dir}/example" />
+        <echo file="${src.dir}/example/Hello.java">
+package example;
+
+import org.apache.commons.lang.WordUtils;
+
+public class Hello {
+    public static void main(String[] args) {
+        String  message = "hello ivy !";
+        System.out.println("standard message : " + message);
+        System.out.println("capitalized by " + WordUtils.class.getName() 
+                                + " : " + WordUtils.capitalizeFully(message));
+    }
+}
+        </echo>
+    </target>
+	
+    <!-- ================================= 
+          target: clean              
+         ================================= -->
+    <target name="clean" description="--> clean the project">
+        <delete includeemptydirs="true" quiet="true">
+            <fileset dir="${src.dir}" />
+            <fileset dir="${build.dir}" />
+    	</delete>
+    </target>
+	
+    <!-- ================================= 
+          target: clean-ivy              
+         ================================= -->
+	<target name="clean-ivy" description="--> clean the ivy installation">
+		<delete dir="${ivy.jar.dir}"/>
+	</target>
+	
+    <!-- ================================= 
+          target: clean-cache              
+         ================================= -->
+	<target name="clean-cache" depends="install-ivy" 
+			description="--> clean the ivy cache">
+		<ivy:cleancache />
+	</target>
+</project>

http://git-wip-us.apache.org/repos/asf/ant-ivy/blob/22bdffb9/asciidoc/samples/commons-lang1.0-dep-report-part.jpg
----------------------------------------------------------------------
diff --git a/asciidoc/samples/commons-lang1.0-dep-report-part.jpg b/asciidoc/samples/commons-lang1.0-dep-report-part.jpg
new file mode 100644
index 0000000..5ceb892
Binary files /dev/null and b/asciidoc/samples/commons-lang1.0-dep-report-part.jpg differ

http://git-wip-us.apache.org/repos/asf/ant-ivy/blob/22bdffb9/asciidoc/samples/eclipse-plugin/build.xml
----------------------------------------------------------------------
diff --git a/asciidoc/samples/eclipse-plugin/build.xml b/asciidoc/samples/eclipse-plugin/build.xml
new file mode 100644
index 0000000..93581b8
--- /dev/null
+++ b/asciidoc/samples/eclipse-plugin/build.xml
@@ -0,0 +1,77 @@
+<!--
+   Licensed to the Apache Software Foundation (ASF) under one
+   or more contributor license agreements.  See the NOTICE file
+   distributed with this work for additional information
+   regarding copyright ownership.  The ASF licenses this file
+   to you under the Apache License, Version 2.0 (the
+   "License"); you may not use this file except in compliance
+   with the License.  You may obtain a copy of the License at
+
+     http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing,
+   software distributed under the License is distributed on an
+   "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+   KIND, either express or implied.  See the License for the
+   specific language governing permissions and limitations
+   under the License.    
+-->
+<project name="eclipse-plugin-build" xmlns:ivy="ivy">
+
+    <!-- Load Ivy ant tasks -->
+    <taskdef uri="ivy" resource="org/apache/ivy/ant/antlib.xml" />
+    <!-- If Ivy is not in Ant's classpath, get the jar of Ivy and use the folowing -->
+    <!-- taskdef rather than the above one -->
+    <!--path id="ivy.classpath"> 
+        <fileset dir="${basedir}">
+            <include name="ivy.jar" />
+        </fileset>
+    </path>
+    <taskdef uri="ivy" resource="org/apache/ivy/ant/antlib.xml" classpathref="ivy.classpath" /-->
+
+    <!-- Load the properties where is defined the eclipse home -->
+    <property file="${basedir}/ivysettings.properties" />
+
+    <target name="clean" description="Clean the build directory">
+        <delete dir="${basedir}/target" />
+    </target>
+
+    <target name="buildobr" description="Build the obr index">
+        <!-- build the repo.xml which aggregate every metadata of the Eclipse plugins -->
+        <mkdir dir="${basedir}/target" />
+        <ivy:buildobr baseDir="${eclipse.home}" basePath="${eclipse.home}" out="${basedir}/target/repo-eclipse.xml" indent="true" />
+    </target>
+
+    <target name="ivy:configure">
+        <!-- classical ivy configuration -->
+        <ivy:configure file="ivysettings.xml" />
+    </target>
+
+    <target name="ivy:resolve" depends="ivy:configure">
+        <!-- classical resolve and cache-path -->
+        <ivy:resolve file="ivy.xml" conf="*" />
+        <ivy:cachepath pathid="compile.classpath" conf="compile" useOrigin="true" />
+    </target>
+
+    <target name="compile" depends="ivy:resolve" description="Compile the Eclipse plugin">
+        <mkdir dir="${basedir}/target/classes" />
+        <!-- simple javac (WARNING: contrary to the JDT, javac doesn't understand OSGi's accessibility (private packages)) -->
+        <javac srcdir="${basedir}/src" classpathref="compile.classpath" destdir="${basedir}/target/classes" debug="true" includeAntRuntime="false" />
+        <copy todir="${basedir}/target/classes">
+            <fileset dir="${basedir}/src">
+                <include name="**" />
+                <exclude name="**/*.java" />
+                <exclude name="**/package.html" />
+            </fileset>
+            <fileset dir="${basedir}">
+                <include name="plugin.xml" />
+            </fileset>
+        </copy>
+    </target>
+
+    <target name="build" depends="compile" description="Build the Eclipse plugin">
+        <!-- simple jaring -->
+        <jar basedir="${basedir}/target/classes" destfile="${basedir}/target/${ant.project.name}.jar" manifest="META-INF/MANIFEST.MF" />
+    </target>
+
+</project>

http://git-wip-us.apache.org/repos/asf/ant-ivy/blob/22bdffb9/asciidoc/samples/eclipse-plugin/ivy.xml
----------------------------------------------------------------------
diff --git a/asciidoc/samples/eclipse-plugin/ivy.xml b/asciidoc/samples/eclipse-plugin/ivy.xml
new file mode 100644
index 0000000..cf23e6c
--- /dev/null
+++ b/asciidoc/samples/eclipse-plugin/ivy.xml
@@ -0,0 +1,39 @@
+<?xml version="1.0"?>
+<!--
+   Licensed to the Apache Software Foundation (ASF) under one
+   or more contributor license agreements.  See the NOTICE file
+   distributed with this work for additional information
+   regarding copyright ownership.  The ASF licenses this file
+   to you under the Apache License, Version 2.0 (the
+   "License"); you may not use this file except in compliance
+   with the License.  You may obtain a copy of the License at
+
+     http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing,
+   software distributed under the License is distributed on an
+   "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+   KIND, either express or implied.  See the License for the
+   specific language governing permissions and limitations
+   under the License.    
+-->
+<ivy-module version="2.2" xmlns:o="http://ant.apache.org/ivy/osgi">
+    <info organisation="bundle" module="myplugin">
+        <extends organisation="bundle" module="com.acme.myplugin" revision="1.0.0.qualifier" location="META-INF/MANIFEST.MF" />
+    </info>
+    <configurations>
+        <conf name="compile"  extends="default,embedded" description="Dependencies for the compilation" />
+        <conf name="embedded"                            description="Dependencies embedded into the plugin's jar" />
+        <conf name="win32"    extends="compile"          description="To run on Microsoft Windows" />
+        <conf name="macos"    extends="compile"          description="To run on Mac OS X" />
+        <conf name="linux"    extends="compile"          description="To run on Linux" />
+    </configurations>
+    <dependencies>
+        <!-- example of a dependency that we can't declare in the MANIFEST.MF because we want it to be embedded -->
+        <!--dependency osgi="bundle" org="" module="org.apache.commons.httpcore" rev="4.1.0" conf="embedded->default" /-->
+        <!-- Ivy-Osgi doesn't understand bundle fragment -->
+        <dependency org="bundle" name="org.eclipse.swt.win32.win32.x86" rev="3.+" conf="win32->default" />
+        <dependency org="bundle" name="org.eclipse.swt.cocoa.macosx.x86_64" rev="3.+" conf="macos->default" />
+        <dependency org="bundle" name="org.eclipse.swt.gtk.linux.x86" rev="3.+" conf="linux->default" />
+     </dependencies>
+</ivy-module>

http://git-wip-us.apache.org/repos/asf/ant-ivy/blob/22bdffb9/asciidoc/samples/eclipse-plugin/ivysettings.properties
----------------------------------------------------------------------
diff --git a/asciidoc/samples/eclipse-plugin/ivysettings.properties b/asciidoc/samples/eclipse-plugin/ivysettings.properties
new file mode 100644
index 0000000..b41f191
--- /dev/null
+++ b/asciidoc/samples/eclipse-plugin/ivysettings.properties
@@ -0,0 +1,21 @@
+#	 ***************************************************************
+#	 * Licensed to the Apache Software Foundation (ASF) under one
+#	 * or more contributor license agreements.  See the NOTICE file
+#	 * distributed with this work for additional information
+#	 * regarding copyright ownership.  The ASF licenses this file
+#	 * to you under the Apache License, Version 2.0 (the
+#	 * "License"); you may not use this file except in compliance
+#	 * with the License.  You may obtain a copy of the License at
+#	 * 
+#	 *   http://www.apache.org/licenses/LICENSE-2.0
+#	 * 
+#	 * Unless required by applicable law or agreed to in writing,
+#	 * software distributed under the License is distributed on an
+#	 * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+#	 * KIND, either express or implied.  See the License for the
+#	 * specific language governing permissions and limitations
+#	 * under the License.
+#	 ***************************************************************
+# Unix users, set it to something like: /home/me/tools/eclipse-3.4/plugins/
+# Windows users, it should look like: D:/tools/eclipse-3.4/plugins/  or  D:\\tools\\eclipse-3.4\\plugins\\
+eclipse.home=/home/me/tools/eclipse-3.5/plugins/

http://git-wip-us.apache.org/repos/asf/ant-ivy/blob/22bdffb9/asciidoc/samples/eclipse-plugin/ivysettings.xml
----------------------------------------------------------------------
diff --git a/asciidoc/samples/eclipse-plugin/ivysettings.xml b/asciidoc/samples/eclipse-plugin/ivysettings.xml
new file mode 100644
index 0000000..0be2afc
--- /dev/null
+++ b/asciidoc/samples/eclipse-plugin/ivysettings.xml
@@ -0,0 +1,36 @@
+<!--
+   Licensed to the Apache Software Foundation (ASF) under one
+   or more contributor license agreements.  See the NOTICE file
+   distributed with this work for additional information
+   regarding copyright ownership.  The ASF licenses this file
+   to you under the Apache License, Version 2.0 (the
+   "License"); you may not use this file except in compliance
+   with the License.  You may obtain a copy of the License at
+
+     http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing,
+   software distributed under the License is distributed on an
+   "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+   KIND, either express or implied.  See the License for the
+   specific language governing permissions and limitations
+   under the License.    
+-->
+<ivysettings>
+    <!-- Load the properties where is defined the eclipse location -->
+    <properties file="ivysettings.properties" />
+
+    <!-- We need to define the Ivy Osgi latest strategy as the default one -->
+    <settings defaultResolver="eclipse" defaultLatestStrategy="latest-osgi" />
+
+    <!-- These are usual cache setup -->
+    <caches resolutionCacheDir="${ivy.settings.dir}/cache/resolution" useOrigin="true">
+        <cache name="eclipse" basedir="${ivy.settings.dir}/cache/eclipse" />
+    </caches>
+
+    <!-- We just need to define our Ivy OSGi resolver -->
+    <resolvers>
+        <obr name="eclipse" repoXmlFile="${ivy.settings.dir}/target/repo-eclipse.xml" />
+    </resolvers>
+
+</ivysettings>

http://git-wip-us.apache.org/repos/asf/ant-ivy/blob/22bdffb9/asciidoc/samples/hibernate3.0-dep-report-part.jpg
----------------------------------------------------------------------
diff --git a/asciidoc/samples/hibernate3.0-dep-report-part.jpg b/asciidoc/samples/hibernate3.0-dep-report-part.jpg
new file mode 100644
index 0000000..6ae4cd5
Binary files /dev/null and b/asciidoc/samples/hibernate3.0-dep-report-part.jpg differ

http://git-wip-us.apache.org/repos/asf/ant-ivy/blob/22bdffb9/asciidoc/samples/ivy-doc.xsl
----------------------------------------------------------------------
diff --git a/asciidoc/samples/ivy-doc.xsl b/asciidoc/samples/ivy-doc.xsl
new file mode 100644
index 0000000..1f401ad
--- /dev/null
+++ b/asciidoc/samples/ivy-doc.xsl
@@ -0,0 +1,281 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!--
+   Licensed to the Apache Software Foundation (ASF) under one
+   or more contributor license agreements.  See the NOTICE file
+   distributed with this work for additional information
+   regarding copyright ownership.  The ASF licenses this file
+   to you under the Apache License, Version 2.0 (the
+   "License"); you may not use this file except in compliance
+   with the License.  You may obtain a copy of the License at
+
+     http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing,
+   software distributed under the License is distributed on an
+   "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+   KIND, either express or implied.  See the License for the
+   specific language governing permissions and limitations
+   under the License.    
+-->
+<xsl:stylesheet version="1.0"
+xmlns:xsl="http://www.w3.org/1999/XSL/Transform">
+
+<xsl:template match="/ivy-module">
+    <xsl:variable name="repositories" select="/ivy-module/info/repository"/>
+    <xsl:variable name="ivyauthors" select="/ivy-module/info/ivyauthor"/>
+    <xsl:variable name="licenses" select="/ivy-module/info/license"/>
+    <xsl:variable name="configurations" select="/ivy-module/configurations"/>
+    <xsl:variable name="public.conf" select="$configurations/conf[not(@visibility) and not(@deprecated)] | $configurations/conf[@visibility='public' and not(@deprecated)]"/>
+    <xsl:variable name="deprecated.conf" select="configurations/conf[not(@visibility) and @deprecated] | configurations/conf[@visibility='public' and @deprecated]"/>
+    <xsl:variable name="private.conf" select="configurations/conf[@visibility='private']"/>
+
+    <xsl:variable name="artifacts" select="/ivy-module/publications/artifact"/>
+    <xsl:variable name="dependencies" select="/ivy-module/dependencies/dependency"/>
+
+  <html>
+  <head>
+    <title><xsl:value-of select="info/@module"/> by <xsl:value-of select="info/@organisation"/> :: Ivy description</title>
+    <meta http-equiv="content-type" content="text/html; charset=ISO-8859-1" />
+    <meta http-equiv="content-language" content="en" />
+    <meta name="robots" content="index,follow" />
+    <link rel="stylesheet" type="text/css" href="ivy-style.css" /> 
+  </head>
+  <body>
+    <div id="logo"><a href="http://ant.apache.org/ivy/"><img src="http://ant.apache.org/ivy/images/logo.png"/></a><br/><a id="rep" href="http://www.jayasoft.fr/org/ivyrep/">Ivy Repository</a></div>
+    <h1>
+    <span id="module">
+	        <xsl:element name="a">
+	            <xsl:attribute name="href">http://www.jayasoft.fr/org/ivyrep/<xsl:value-of select="info/@organisation"/>/<xsl:value-of select="info/@module"/>/</xsl:attribute>
+	            <xsl:value-of select="info/@module"/>
+	        </xsl:element>
+    </span> 
+    by 
+    <span id="organisation">
+	        <xsl:element name="a">
+	            <xsl:attribute name="href">http://www.jayasoft.fr/org/ivyrep/<xsl:value-of select="info/@organisation"/>/</xsl:attribute>
+	            <xsl:value-of select="info/@organisation"/>
+	        </xsl:element> 
+    </span></h1>
+    <div id="revision"><span id="revision">Revision: </span><xsl:value-of select="info/@revision"/></div>
+    <table class="header">
+    <tr><td class="title">Status</td><td class="value"><xsl:value-of select="info/@status"/></td></tr>
+    <tr><td class="title">Home Page</td><td class="value">
+    	<xsl:if test="info/description/@homepage">
+	        <xsl:element name="a">
+	            <xsl:attribute name="href"><xsl:value-of select="info/description/@homepage"/></xsl:attribute>
+	            <xsl:value-of select="info/description/@homepage"/>
+	        </xsl:element>
+    	</xsl:if>
+    </td></tr>
+    <tr><td class="title">Licenses</td><td class="value">
+	    <xsl:for-each select="$licenses">
+    	<xsl:if test="@url">
+	        <xsl:element name="a">
+	            <xsl:attribute name="href"><xsl:value-of select="@url"/></xsl:attribute>
+		    	<xsl:value-of select="@name"/>
+	        </xsl:element>
+    	</xsl:if>
+    	<xsl:if test="not(@url)">
+		    	<xsl:value-of select="@name"/>
+    	</xsl:if>
+	    </xsl:for-each>
+    </td></tr>
+    <tr><td class="title">Ivy Authors</td><td class="value">
+	    <xsl:for-each select="$ivyauthors">
+    	<xsl:if test="@url">
+	        <xsl:element name="a">
+	            <xsl:attribute name="href"><xsl:value-of select="@url"/></xsl:attribute>
+		    	<xsl:value-of select="@name"/>
+	        </xsl:element>
+    	</xsl:if>
+    	<xsl:if test="not(@url)">
+		    	<xsl:value-of select="@name"/>
+    	</xsl:if>
+	    </xsl:for-each>
+    </td></tr>
+    <tr><td class="title">Description</td><td class="value"><xsl:copy-of select="info/description"/></td></tr>
+    </table>
+    
+    <xsl:if test="count($repositories) > 0">
+    <div id="repositories">
+    <h2>Public Repositories</h2>
+    <table>
+    <thead>
+    <tr>
+      <th>Name</th>
+      <th>Url</th>
+      <th>Pattern</th>
+      <th>Ivys</th>
+      <th>Artifacts</th>
+    </tr>
+    </thead>
+    <tbody>
+    <xsl:for-each select="$repositories">
+    <tr>
+      <td><xsl:value-of select="@name"/></td>
+      <td>
+        <xsl:element name="a">
+            <xsl:attribute name="href"><xsl:value-of select="@url"/></xsl:attribute>
+	    	<xsl:value-of select="@url"/>
+        </xsl:element>
+      </td>
+      <td><xsl:value-of select="@pattern"/></td>
+      <td><xsl:value-of select="@ivys"/></td>
+      <td><xsl:value-of select="@artifacts"/></td>
+    </tr>
+    </xsl:for-each>
+    </tbody>
+    </table>
+    </div>
+    </xsl:if>
+    
+    <div id="public-confs" class="conf">
+    <h2>Public Configurations</h2>
+    <table>
+    <thead>
+    <tr>
+      <th class="conf-name">Name</th>
+      <th class="conf-desc">Description</th>
+      <th class="conf-extends">Extends</th>
+    </tr>
+    </thead>
+    <tbody>
+    <xsl:for-each select="$public.conf">
+    <tr>
+      <td><xsl:value-of select="@name"/></td>
+      <td><xsl:value-of select="@description"/></td>
+      <td><xsl:value-of select="@extends"/></td>
+    </tr>
+    </xsl:for-each>
+    <xsl:if test="count($public.conf) = 0">
+    <tr>
+      <td>default</td>
+      <td></td>
+      <td></td>
+    </tr>
+    </xsl:if>
+    </tbody>
+    </table>
+    </div>
+    
+    <xsl:if test="count($deprecated.conf) > 0">
+    <div id="deprecated-confs" class="conf">
+    <h2>Deprecated Configurations</h2>
+    <table>
+    <thead>
+    <tr>
+      <th class="conf-name">Name</th>
+      <th class="conf-desc">Description</th>
+      <th class="conf-extends">Extends</th>
+    </tr>
+    </thead>
+    <tbody>
+    <xsl:for-each select="$deprecated.conf">
+    <tr>
+      <td><xsl:value-of select="@name"/></td>
+      <td><xsl:value-of select="@description"/></td>
+      <td><xsl:value-of select="@extends"/></td>
+    </tr>
+    </xsl:for-each>
+    </tbody>
+    </table>
+    </div>
+    </xsl:if>
+    
+    <xsl:if test="count($private.conf) > 0">
+    <div id="deprecated-confs" class="conf">
+    <h2>Private Configurations</h2>
+    <table>
+    <thead>
+    <tr>
+      <th class="conf-name">Name</th>
+      <th class="conf-desc">Description</th>
+      <th class="conf-extends">Extends</th>
+    </tr>
+    </thead>
+    <tbody>
+    <xsl:for-each select="$private.conf">
+    <tr>
+      <td><xsl:value-of select="@name"/></td>
+      <td><xsl:value-of select="@description"/></td>
+      <td><xsl:value-of select="@extends"/></td>
+    </tr>
+    </xsl:for-each>
+    </tbody>
+    </table>
+    </div>
+    </xsl:if>
+    
+    <div id="artifacts">
+    <h2>Published Artifacts</h2>
+    <table>
+    <thead>
+    <tr>
+      <th class="art-name">Name</th>
+      <th class="art-type">Type</th>
+      <th class="art-conf">Configurations</th>
+    </tr>
+    </thead>
+    <tbody>
+    <xsl:for-each select="$artifacts">
+    <tr>
+      <td><xsl:value-of select="@name"/></td>
+      <td><xsl:value-of select="@type"/></td>
+      <td>
+          <xsl:value-of select="@conf"/>
+          <xsl:for-each select="conf">
+            <xsl:if test="position() > 1">, 
+            </xsl:if>
+            <xsl:value-of select="@name"/>
+          </xsl:for-each>
+          <xsl:if test="not(@conf) and count(conf) = 0">
+          <i>all</i>
+          </xsl:if> 
+      </td>
+    </tr>
+    </xsl:for-each>
+    <xsl:if test="count($artifacts) = 0">
+      <td><xsl:value-of select="info/@module"/></td>
+      <td>jar</td>
+      <td><i>all</i></td>
+    </xsl:if>
+    </tbody>
+    </table>
+    </div>
+    
+    <xsl:if test="count($dependencies) > 0">
+    <div id="dependencies">
+    <h2>Dependencies</h2>
+    <table>
+    <thead>
+    <tr>
+      <th class="dep-org">Organisation</th>
+      <th class="dep-name">Name</th>
+      <th class="dep-rev">Revision</th>
+      <th class="dep-conf">Configurations</th>
+    </tr>
+    </thead>
+    <tbody>
+    <xsl:for-each select="$dependencies">
+    <tr>
+      <td><xsl:if test="not(@org)"><xsl:value-of select="/ivy-module/info/@organisation"/></xsl:if><xsl:value-of select="@org"/></td>
+      <td>
+        <xsl:element name="a">
+            <xsl:attribute name="href">http://www.jayasoft.fr/org/ivyrep/<xsl:if test="not(@org)"><xsl:value-of select="/ivy-module/info/@organisation"/></xsl:if><xsl:value-of select="@org"/>/<xsl:value-of select="@name"/>/ivy-<xsl:value-of select="@rev"/>.xml</xsl:attribute>
+		    <xsl:value-of select="@name"/>
+        </xsl:element>
+      </td>
+      <td><xsl:value-of select="@rev"/></td>
+      <td><xsl:value-of select="@conf"/></td>
+    </tr>
+    </xsl:for-each>
+    </tbody>
+    </table>
+    </div>
+    </xsl:if>
+    
+    
+  </body>
+  </html>
+</xsl:template>
+</xsl:stylesheet>

http://git-wip-us.apache.org/repos/asf/ant-ivy/blob/22bdffb9/asciidoc/samples/ivy-report.css
----------------------------------------------------------------------
diff --git a/asciidoc/samples/ivy-report.css b/asciidoc/samples/ivy-report.css
new file mode 100644
index 0000000..c89bd54
--- /dev/null
+++ b/asciidoc/samples/ivy-report.css
@@ -0,0 +1,279 @@
+/*
+ *  Licensed to the Apache Software Foundation (ASF) under one or more
+ *  contributor license agreements.  See the NOTICE file distributed with
+ *  this work for additional information regarding copyright ownership.
+ *  The ASF licenses this file to You under the Apache License, Version 2.0
+ *  (the "License"); you may not use this file except in compliance with
+ *  the License.  You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ *  Unless required by applicable law or agreed to in writing, software
+ *  distributed under the License is distributed on an "AS IS" BASIS,
+ *  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ *  See the License for the specific language governing permissions and
+ *  limitations under the License.
+ *
+ */
+
+body {
+	font-family:"Trebuchet MS",Verdana,Geneva,Arial,Helvetica,sans-serif;
+	font-size:small; 
+}
+
+div#logo {
+    float: right; 
+    padding-left: 10px; 
+    padding-bottom: 10px; 
+    background: white;
+    text-align: center;
+}
+
+#logo img {
+	border: 0;
+}
+
+div#date {
+	font-style:     italic;
+	padding-left:	60px;
+    padding-bottom: 40px; 
+}
+
+
+h1 {
+    margin-bottom:2px;
+    
+	border-color:#7A9437;
+	border-style:solid;
+	border-width:0 0 3px 0;
+}
+
+span#module {
+	color:#7A9437;
+	text-decoration:none;
+}
+
+span#organisation {
+	color:black;
+	text-decoration:none;
+}
+
+#confmenu {
+	color: #000;
+	border-bottom: 2px solid black;
+	margin: 12px 0px 0px 0px;
+	padding: 0px;
+	z-index: 1;
+	padding-left: 10px 
+}
+
+#confmenu li {
+	display: inline;
+	overflow: hidden;
+	list-style-type: none; 
+}
+
+#confmenu a, a.active {
+	color: #DEDECF;
+	background: #898B5E;
+	font: bold 1em "Trebuchet MS", Arial, sans-serif;
+	border: 2px solid black;
+	padding: 2px 5px 0px 5px;
+	text-decoration: none; 
+}
+
+/*
+background: #ABAD85 #CED4BD
+background: #DEE4CD
+ */
+
+#confmenu a.active {
+	color: #7A9437;
+	background: #DEE4CD;
+	border-bottom: 3px solid #DEE4CD;
+}
+
+#confmenu a:hover {
+	color: #fff;
+	background: #ADC09F; 
+}
+
+#confmenu a:visited {
+	color: #DEDECF; 
+}
+
+#confmenu a.active:visited {
+	color: #7A9437; 
+}
+
+#confmenu a.active:hover {
+	background: #DEE4CD;
+	color: #DEDECF; 
+}
+
+#content {
+	background: #DEE4CD;
+	padding: 20px;
+	border: 2px solid black;
+	border-top: none;
+	z-index: 2;	
+}
+
+#content a {
+	text-decoration: none;
+	color: #E8E9BE; 
+}
+
+#content a:hover { 
+  background: #898B5E; 
+}
+
+
+h2 {
+    margin-bottom:2px;
+    font-size:medium;
+    
+    border-color:#7A9437;
+    border-style:solid;
+    border-width:0 0 2px 0;
+}
+
+h3 {
+    margin-top:30px;
+    margin-bottom:2px;
+    padding: 5 5 5 0;
+    font-size: 24px;
+    border-style:solid;
+    border-width:0 0 2px 0;
+}
+
+h4 {
+    margin-bottom:2px;
+    margin-top:2px;
+    font-size:medium;
+    
+    border-color:#7A9437;
+    border-style:dashed;
+    border-width:0 0 1px 0;
+}
+
+h5 {
+    margin-bottom:2px;
+    margin-top:2px;
+    margin-left:20px;
+    font-size:medium;
+}
+
+span.resolved {
+	padding-left: 15px;
+	font-weight: 500;
+	font-size: small;
+}
+
+
+#content table  {
+	border-collapse:collapse;
+	width:90%;
+	margin:auto;
+	margin-top: 5px;
+}
+#content thead {
+	background-color:#CED4BD;
+	border:1px solid #7A9437;
+}
+#content tbody {
+	border-collapse:collapse;
+	background-color:#FFFFFF;
+	border:1px solid #7A9437;
+}
+
+#content th {
+	font-family:monospace;
+	border:1px solid #7A9437;
+	padding:5px;
+}
+
+#content td {
+	border:1px dotted #7A9437;
+	padding:0 3 0 3;
+}
+
+#content table a {
+	color:#7A9437;
+	text-decoration:none;
+}
+
+#content table a:hover {
+	background-color:#CED4BD;
+	color:#7A9437;
+}
+
+
+
+table.deps  {
+	border-collapse:collapse;
+	width:90%;
+	margin:auto;
+	margin-top: 5px;
+}
+
+table.deps thead {
+	background-color:#CED4BD;
+	border:1px solid #7A9437;
+}
+table.deps tbody {
+	border-collapse:collapse;
+	background-color:#FFFFFF;
+	border:1px solid #7A9437;
+}
+
+table.deps th {
+	font-family:monospace;
+	border:1px solid #7A9437;
+	padding:2;
+}
+
+table.deps td {
+	border:1px dotted #7A9437;
+	padding:0 3 0 3;
+}
+
+
+
+
+
+table.header  {
+	border:0;
+	width:90%;
+	margin:auto;
+	margin-top: 5px;
+}
+
+table.header thead {
+	border:0;
+}
+table.header tbody {
+	border:0;
+}
+table.header tr {
+	padding:0px;
+	border:0;
+}
+table.header td {
+	padding:0 3 0 3;
+	border:0;
+}
+
+td.title {
+    width:150px;
+    margin-right:15px;
+
+	font-size:small;
+	font-weight:700;
+}
+
+td.title:first-letter {
+	color:#7A9437;
+	background-color:transparent;
+}
+

http://git-wip-us.apache.org/repos/asf/ant-ivy/blob/22bdffb9/asciidoc/samples/ivy-sample-xslt.xml
----------------------------------------------------------------------
diff --git a/asciidoc/samples/ivy-sample-xslt.xml b/asciidoc/samples/ivy-sample-xslt.xml
new file mode 100644
index 0000000..28f32dd
--- /dev/null
+++ b/asciidoc/samples/ivy-sample-xslt.xml
@@ -0,0 +1,101 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<?xml-stylesheet type="text/xsl" href="ivy-doc.xsl"?>
+<!--
+   Licensed to the Apache Software Foundation (ASF) under one
+   or more contributor license agreements.  See the NOTICE file
+   distributed with this work for additional information
+   regarding copyright ownership.  The ASF licenses this file
+   to you under the Apache License, Version 2.0 (the
+   "License"); you may not use this file except in compliance
+   with the License.  You may obtain a copy of the License at
+
+     http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing,
+   software distributed under the License is distributed on an
+   "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+   KIND, either express or implied.  See the License for the
+   specific language governing permissions and limitations
+   under the License.    
+-->
+<ivy-module version="2.0">
+	<info organisation="myorg"
+	       module="mymodule"
+	       revision="myrev"
+	       status="integration"
+	       publication="20041101110000">
+	       
+		<license name="MyLicense" url="http://www.my.org/mymodule/mylicense.html"/>
+		
+		<ivyauthor name="jayasoft" url="http://www.jayasoft.org/"/>
+		<ivyauthor name="myorg" url="http://www.myorg.org/"/>
+
+		<repository name="ivyrep" url="http://www.jayasoft.fr/org/ivyrep/" pattern="[organisation]/[module]/ivy-[revision].xml" ivys="true" artifacts="false"/>
+
+		<description homepage="http://www.my.org/mymodule/">	       
+	This module is <b>great</b> !<br/>
+	You can use it especially with myconf1 and myconf2, and myconf4 is not too bad too.
+		</description>
+	</info>
+	<configurations>
+		<conf name="myconf1" description="desc 1"/>
+		<conf name="myconf2" description="desc 2" visibility="public"/>
+		<conf name="myconf3" description="desc 3" visibility="private"/>
+		<conf name="myconf4" description="desc 4" extends="myconf1, myconf2"/>		
+		<conf name="myoldconf" description="my old desc" deprecated="20050115"/>
+	</configurations>
+	<publications>
+		<artifact name="myartifact1" type="jar"/>
+		<artifact name="myartifact2" type="jar" conf="myconf1"/>
+		<artifact name="myartifact3" type="jar" conf="myconf1, myconf2, myconf3"/>
+		<artifact name="myartifact4" type="jar">
+			<conf name="myconf1"/>
+			<conf name="myconf3"/>
+		</artifact>
+	</publications>
+	<dependencies>
+		<dependency name="mymodule2" rev="2.0"/>
+		<dependency org="yourorg" name="yourmodule1" rev="1.1" conf="myconf1"/>
+		<dependency org="yourorg" name="yourmodule2" rev="2+" conf="myconf1->yourconf1"/>
+		<dependency org="yourorg" name="yourmodule3" rev="3.1" conf="myconf1->yourconf1, yourconf2"/>
+		<dependency org="yourorg" name="yourmodule4" rev="4.1" conf="myconf1, myconf2->yourconf1, yourconf2"/>
+		<dependency org="yourorg" name="yourmodule5" rev="5.1" conf="myconf1->yourconf1;myconf2->yourconf1, yourconf2"/>
+
+		<dependency org="yourorg" name="yourmodule6" rev="latest.integration">
+			<conf name="myconf1" mapped="yourconf1"/>
+			<conf name="myconf2" mapped="yourconf1, yourconf2"/>
+		</dependency>
+
+		<dependency org="yourorg" name="yourmodule7" rev="7.1">
+			<conf name="myconf1">
+				<mapped name="yourconf1"/>
+			</conf>
+			<conf name="myconf2">
+				<mapped name="yourconf1"/>
+				<mapped name="yourconf2"/>
+			</conf>
+		</dependency>
+
+		<dependency org="yourorg" name="yourmodule8" rev="8.1">
+			<artifact name="yourartifact8-1" type="jar"/>
+			<artifact name="yourartifact8-2" type="jar"/>
+		</dependency>		
+
+		<dependency org="yourorg" name="yourmodule9" rev="9.1" conf="myconf1,myconf2,myconf3->default">
+			<artifact name="yourartifact9-1" type="jar" conf="myconf1,myconf2"/>
+			<artifact name="yourartifact9-2" type="jar">
+				<conf name="myconf2"/>
+				<conf name="myconf3"/>
+			</artifact>
+		</dependency>		
+
+		<dependency org="yourorg" name="yourmodule10" rev="10.1">
+			<include name="your.*" type="jar"/>
+			<include ext="xml"/>
+			<exclude name="toexclude"/>
+		</dependency>
+				
+		<conflict org="yourorg" module=".*" manager="all"/>
+		<conflict org="theirorg" module="theirmodule1" rev="1.0, 1.1"/>
+	</dependencies>
+</ivy-module>

http://git-wip-us.apache.org/repos/asf/ant-ivy/blob/22bdffb9/asciidoc/samples/ivy-sample.xml
----------------------------------------------------------------------
diff --git a/asciidoc/samples/ivy-sample.xml b/asciidoc/samples/ivy-sample.xml
new file mode 100644
index 0000000..62ef74c
--- /dev/null
+++ b/asciidoc/samples/ivy-sample.xml
@@ -0,0 +1,100 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!--
+   Licensed to the Apache Software Foundation (ASF) under one
+   or more contributor license agreements.  See the NOTICE file
+   distributed with this work for additional information
+   regarding copyright ownership.  The ASF licenses this file
+   to you under the Apache License, Version 2.0 (the
+   "License"); you may not use this file except in compliance
+   with the License.  You may obtain a copy of the License at
+
+     http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing,
+   software distributed under the License is distributed on an
+   "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+   KIND, either express or implied.  See the License for the
+   specific language governing permissions and limitations
+   under the License.    
+-->
+<ivy-module version="2.0">
+	<info organisation="myorg"
+	       module="mymodule"
+	       revision="myrev"
+	       status="integration"
+	       publication="20041101110000">
+	       
+		<license name="MyLicense" url="http://www.my.org/mymodule/mylicense.html"/>
+		
+		<ivyauthor name="jayasoft" url="http://www.jayasoft.org/"/>
+		<ivyauthor name="myorg" url="http://www.myorg.org/"/>
+
+		<repository name="ivyrep" url="http://www.jayasoft.fr/org/ivyrep/" pattern="[organisation]/[module]/ivy-[revision].xml" ivys="true" artifacts="false"/>
+
+		<description homepage="http://www.my.org/mymodule/">	       
+	This module is <b>great</b> !<br/>
+	You can use it especially with myconf1 and myconf2, and myconf4 is not too bad too.
+		</description>
+	</info>
+	<configurations>
+		<conf name="myconf1" description="desc 1"/>
+		<conf name="myconf2" description="desc 2" visibility="public"/>
+		<conf name="myconf3" description="desc 3" visibility="private"/>
+		<conf name="myconf4" description="desc 4" extends="myconf1, myconf2"/>		
+		<conf name="myoldconf" description="my old desc" deprecated="20050115"/>
+	</configurations>
+	<publications>
+		<artifact name="myartifact1" type="jar"/>
+		<artifact name="myartifact2" type="jar" conf="myconf1"/>
+		<artifact name="myartifact3" type="jar" conf="myconf1, myconf2, myconf3"/>
+		<artifact name="myartifact4" type="jar">
+			<conf name="myconf1"/>
+			<conf name="myconf3"/>
+		</artifact>
+	</publications>
+	<dependencies>
+		<dependency name="mymodule2" rev="2.0"/>
+		<dependency org="yourorg" name="yourmodule1" rev="1.1" conf="myconf1"/>
+		<dependency org="yourorg" name="yourmodule2" rev="2+" conf="myconf1->yourconf1"/>
+		<dependency org="yourorg" name="yourmodule3" rev="3.1" conf="myconf1->yourconf1, yourconf2"/>
+		<dependency org="yourorg" name="yourmodule4" rev="4.1" conf="myconf1, myconf2->yourconf1, yourconf2"/>
+		<dependency org="yourorg" name="yourmodule5" rev="5.1" conf="myconf1->yourconf1;myconf2->yourconf1, yourconf2"/>
+
+		<dependency org="yourorg" name="yourmodule6" rev="latest.integration">
+			<conf name="myconf1" mapped="yourconf1"/>
+			<conf name="myconf2" mapped="yourconf1, yourconf2"/>
+		</dependency>
+
+		<dependency org="yourorg" name="yourmodule7" rev="7.1">
+			<conf name="myconf1">
+				<mapped name="yourconf1"/>
+			</conf>
+			<conf name="myconf2">
+				<mapped name="yourconf1"/>
+				<mapped name="yourconf2"/>
+			</conf>
+		</dependency>
+
+		<dependency org="yourorg" name="yourmodule8" rev="8.1">
+			<artifact name="yourartifact8-1" type="jar"/>
+			<artifact name="yourartifact8-2" type="jar"/>
+		</dependency>		
+
+		<dependency org="yourorg" name="yourmodule9" rev="9.1" conf="myconf1,myconf2,myconf3->default">
+			<artifact name="yourartifact9-1" type="jar" conf="myconf1,myconf2"/>
+			<artifact name="yourartifact9-2" type="jar">
+				<conf name="myconf2"/>
+				<conf name="myconf3"/>
+			</artifact>
+		</dependency>		
+
+		<dependency org="yourorg" name="yourmodule10" rev="10.1">
+			<include name="your.*" type="jar"/>
+			<include ext="xml"/>
+			<exclude name="toexclude"/>
+		</dependency>		
+		
+		<conflict org="yourorg" module=".*" manager="all"/>
+		<conflict org="theirorg" module="theirmodule1" rev="1.0, 1.1"/>
+	</dependencies>
+</ivy-module>

http://git-wip-us.apache.org/repos/asf/ant-ivy/blob/22bdffb9/asciidoc/samples/ivy-style.css
----------------------------------------------------------------------
diff --git a/asciidoc/samples/ivy-style.css b/asciidoc/samples/ivy-style.css
new file mode 100644
index 0000000..9518ef9
--- /dev/null
+++ b/asciidoc/samples/ivy-style.css
@@ -0,0 +1,160 @@
+/*
+ *  Licensed to the Apache Software Foundation (ASF) under one or more
+ *  contributor license agreements.  See the NOTICE file distributed with
+ *  this work for additional information regarding copyright ownership.
+ *  The ASF licenses this file to You under the Apache License, Version 2.0
+ *  (the "License"); you may not use this file except in compliance with
+ *  the License.  You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ *  Unless required by applicable law or agreed to in writing, software
+ *  distributed under the License is distributed on an "AS IS" BASIS,
+ *  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ *  See the License for the specific language governing permissions and
+ *  limitations under the License.
+ *
+ */
+
+body {
+	font-family:"Trebuchet MS",Verdana,Geneva,Arial,Helvetica,sans-serif;
+	font-size:small; 
+}
+
+div#logo {
+    float: right; 
+    padding-left: 10px; 
+    padding-bottom: 10px; 
+    background: white;
+    text-align: center;
+}
+
+#logo img {
+	border: 0;
+}
+
+a#rep {
+	color:#7A9437;
+	text-decoration:none;
+}
+
+a#rep:hover {
+	background-color:#DEE4CD;
+	color:#7A9437;
+}
+
+
+h1 {
+    margin-bottom:2px;
+    
+	border-color:#7A9437;
+	border-style:solid;
+	border-width:0 0 3px 0;
+}
+
+span#module a {
+	color:#7A9437;
+	text-decoration:none;
+}
+
+span#module a:hover {
+	background-color:#DEE4CD;
+	color:#7A9437;
+}
+
+span#organisation a {
+	color:black;
+	text-decoration:none;
+}
+
+span#organisation a:hover {
+	background-color:black;
+	color:white;
+}
+
+
+h2 {
+    margin-bottom:2px;
+    font-size:medium;
+    
+	border-color:#7A9437;
+	border-style:solid;
+	border-width:0 0 2px 0;
+}
+
+div#revision {
+    margin-left:60px;
+	font-size:medium;
+    font-style: italic;
+    font-weight:700;
+}
+
+span#revision {
+	color:#7A9437;
+}
+
+td.title {
+    width:150px;
+    margin-right:15px;
+
+	text-align: left;
+	/*
+	border-color:#7A9437;
+	border-style:solid;
+	border-width:0 0 3px 0;
+	*/
+	font-size:small;
+	font-weight:700;
+	margin:0;
+	padding-left:0em;
+	vertical-align: top;
+}
+
+td.title:first-letter {
+	color:#7A9437;
+	font-size:medium;
+	background-color:transparent;
+}
+
+#repositories table  {
+	width:90%;
+	margin:auto;
+}
+
+#repositories th  {
+	text-align: left;
+}
+
+.conf table, #artifacts table, #dependencies table  {
+	border-collapse:collapse;
+	width:90%;
+	margin:auto;
+	margin-top: 10px;
+}
+.conf thead, #artifacts thead, #dependencies thead {
+	background-color:#DEE4CD;
+	border:1px solid #7A9437;
+}
+.conf tbody, #artifacts tbody, #dependencies tbody {
+	border-collapse:collapse;
+	background-color:#FFFFFF;
+	border:1px solid #7A9437;
+}
+
+.conf th, #artifacts th, #dependencies th {
+	font-family:monospace;
+	border:1px solid #7A9437;
+	padding:5px;
+}
+
+.conf td, #artifacts td, #dependencies td {
+	border:1px dotted #7A9437;
+	padding:5px;
+}
+
+th.conf-name {
+    width:15%;
+}
+th.conf-desc {
+    width:50%;
+}

http://git-wip-us.apache.org/repos/asf/ant-ivy/blob/22bdffb9/asciidoc/samples/ivysettings-default.xml
----------------------------------------------------------------------
diff --git a/asciidoc/samples/ivysettings-default.xml b/asciidoc/samples/ivysettings-default.xml
new file mode 100644
index 0000000..9d985c1
--- /dev/null
+++ b/asciidoc/samples/ivysettings-default.xml
@@ -0,0 +1,24 @@
+<!--
+   Licensed to the Apache Software Foundation (ASF) under one
+   or more contributor license agreements.  See the NOTICE file
+   distributed with this work for additional information
+   regarding copyright ownership.  The ASF licenses this file
+   to you under the Apache License, Version 2.0 (the
+   "License"); you may not use this file except in compliance
+   with the License.  You may obtain a copy of the License at
+
+     http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing,
+   software distributed under the License is distributed on an
+   "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+   KIND, either express or implied.  See the License for the
+   specific language governing permissions and limitations
+   under the License.    
+-->
+<ivysettings>
+	<settings defaultResolver="ivyrep"/>
+	<resolvers>
+		<ivyrep name="ivyrep"/>
+	</resolvers>
+</ivysettings>

http://git-wip-us.apache.org/repos/asf/ant-ivy/blob/22bdffb9/asciidoc/samples/jayasoft-ivyrep-example-default.html
----------------------------------------------------------------------
diff --git a/asciidoc/samples/jayasoft-ivyrep-example-default.html b/asciidoc/samples/jayasoft-ivyrep-example-default.html
new file mode 100644
index 0000000..faa79ec
--- /dev/null
+++ b/asciidoc/samples/jayasoft-ivyrep-example-default.html
@@ -0,0 +1,371 @@
+<!--
+   Licensed to the Apache Software Foundation (ASF) under one
+   or more contributor license agreements.  See the NOTICE file
+   distributed with this work for additional information
+   regarding copyright ownership.  The ASF licenses this file
+   to you under the Apache License, Version 2.0 (the
+   "License"); you may not use this file except in compliance
+   with the License.  You may obtain a copy of the License at
+
+     http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing,
+   software distributed under the License is distributed on an
+   "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+   KIND, either express or implied.  See the License for the
+   specific language governing permissions and limitations
+   under the License.    
+-->
+<html>
+
+<head>
+	<META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=ISO-8859-1">
+<META http-equiv="Content-Type" content="text/html; charset=UTF-8">
+<title>Ivy report :: ivyrep-example by jayasoft :: default</title>
+<meta content="text/html; charset=ISO-8859-1" http-equiv="content-type">
+<meta content="en" http-equiv="content-language">
+<meta content="index,follow" name="robots">
+<link href="ivy-report.css" type="text/css" rel="stylesheet">
+</head>
+<body>
+<div id="logo">
+<a href="http://ant.apache.org/ivy/"><img src="../images/logo.png"></a>
+</div>
+<h1>
+<a name="jayasoft-ivyrep-example"></a><span id="module">ivyrep-example</span> 
+        by 
+        <span id="organisation">jayasoft</span>
+</h1>
+<div id="date">
+    resolved on 
+      2005-04-08 13:33:40</div>
+<ul id="confmenu">
+<li>
+<a class="active" href="jayasoft-ivyrep-example-default.html">default</a>
+</li>
+</ul>
+<div id="content">
+<h2>Dependencies Stats</h2>
+<table class="header">
+<tr>
+<td class="title">Modules</td><td class="value">3</td>
+</tr>
+<tr>
+<td class="title">Revisions</td><td class="value">4  
+            (0 searched <img title="module revisions which required a search with a dependency resolver to be resolved" alt="searched" src="../images/searched.gif">,
+            0 downloaded <img title="module revisions for which ivy file was downloaded by dependency resolver" alt="downloaded" src="../images/downloaded.gif">,
+            1 evicted <img title="module revisions which were evicted by others" alt="evicted" src="../images/evicted.gif">,
+            0 errors <img title="module revisions on which error occurred" alt="error" src="../images/error.gif">)</td>
+</tr>
+<tr>
+<td class="title">Artifacts</td><td class="value">3 
+            (0 downloaded,
+            0 failed)</td>
+</tr>
+<tr>
+<td class="title">Artifacts size</td><td class="value">219 kB
+            (0 kB downloaded,
+            219 kB in cache)</td>
+</tr>
+</table>
+<h2>Dependencies Overview</h2>
+<table class="deps">
+<thead>
+<tr>
+<th>Module</th><th>Revision</th><th>Status</th><th>Licenses</th><th>Size</th><th></th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td><a href="#apache-commons-cli"> commons-cli
+         by
+         apache</a></td><td><a href="#apache-commons-cli-1.0">1.0</a></td><td align="center">release</td><td align="center"><span style="padding-right:3px;"><a href="http://www.apache.org/licenses/LICENSE-2.0.txt">Apache</a></span></td><td align="center">32 kB
+    </td><td align="center"></td>
+</tr>
+<tr>
+<td><a href="#apache-commons-lang">--- commons-lang
+         by
+         apache</a></td><td><a href="#apache-commons-lang-2.0">2.0</a></td><td align="center">release</td><td align="center"></td><td align="center">166 kB
+    </td><td align="center"></td>
+</tr>
+<tr>
+<td><a href="#apache-commons-lang">--- commons-lang
+         by
+         apache</a></td><td><a href="#apache-commons-lang-1.0">1.0</a></td><td align="center"></td><td align="center"></td><td align="center">0 kB
+    </td><td align="center"><img src="http://ivy.jayasoft.org/images/evicted.gif" alt="evicted" title="evicted by 2.0"></td>
+</tr>
+<tr>
+<td><a href="#apache-commons-logging">--- commons-logging
+         by
+         apache</a></td><td><a href="#apache-commons-logging-1.0">1.0</a></td><td align="center">release</td><td align="center"><span style="padding-right:3px;"><a href="http://www.apache.org/licenses/LICENSE-2.0.txt">Apache</a></span></td><td align="center">21 kB
+    </td><td align="center"></td>
+</tr>
+<tr>
+<td><a href="#apache-commons-lang"> commons-lang
+         by
+         apache</a></td><td><a href="#apache-commons-lang-2.0">2.0</a></td><td align="center">release</td><td align="center"></td><td align="center">166 kB
+    </td><td align="center"></td>
+</tr>
+</tbody>
+</table>
+<h2>Details</h2>
+<h3>
+<a name="apache-commons-cli"></a>commons-cli by apache<span class="resolved">resolved by <b>ivyrep</b></span>
+</h3>
+<h4>
+<a name="apache-commons-cli-1.0"></a>
+           Revision: 1.0<span style="padding-left:15px;"></span>
+</h4>
+<table class="header">
+<tr>
+<td class="title">Home Page</td><td class="value"><a href="http://jakarta.apache.org/commons/cli/">http://jakarta.apache.org/commons/cli/</a></td>
+</tr>
+<tr>
+<td class="title">Status</td><td class="value">release</td>
+</tr>
+<tr>
+<td class="title">Publication</td><td class="value">20021227095900</td>
+</tr>
+<tr>
+<td class="title">Resolver</td><td class="value">ivyrep</td>
+</tr>
+<tr>
+<td class="title">Configurations</td><td class="value">default</td>
+</tr>
+<tr>
+<td class="title">Artifacts size</td><td class="value">32 kB
+            (0 kB downloaded,
+            32 kB in cache)</td>
+</tr>
+<tr>
+<td class="title">Licenses</td><td class="value"><span style="padding-right:3px;"><a href="http://www.apache.org/licenses/LICENSE-2.0.txt">Apache</a></span></td>
+</tr>
+</table>
+<h5>Required by</h5>
+<table>
+<thead>
+<tr>
+<th>Organisation</th><th>Name</th><th>In Configurations</th><th>Asked Revision</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td>jayasoft</td><td><a href="#jayasoft-ivyrep-example">ivyrep-example</a></td><td>default</td><td>1.0</td>
+</tr>
+</tbody>
+</table>
+<h5>Dependencies</h5>
+<table class="deps">
+<thead>
+<tr>
+<th>Module</th><th>Revision</th><th>Status</th><th>Licenses</th><th>Size</th><th></th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td><a href="#apache-commons-lang"> commons-lang
+         by
+         apache</a></td><td><a href="#apache-commons-lang-2.0">2.0</a></td><td align="center">release</td><td align="center"></td><td align="center">166 kB
+    </td><td align="center"></td>
+</tr>
+<tr>
+<td><a href="#apache-commons-lang"> commons-lang
+         by
+         apache</a></td><td><a href="#apache-commons-lang-1.0">1.0</a></td><td align="center"></td><td align="center"></td><td align="center">0 kB
+    </td><td align="center"><img src="http://ivy.jayasoft.org/images/evicted.gif" alt="evicted" title="evicted by 2.0"></td>
+</tr>
+<tr>
+<td><a href="#apache-commons-logging"> commons-logging
+         by
+         apache</a></td><td><a href="#apache-commons-logging-1.0">1.0</a></td><td align="center">release</td><td align="center"><span style="padding-right:3px;"><a href="http://www.apache.org/licenses/LICENSE-2.0.txt">Apache</a></span></td><td align="center">21 kB
+    </td><td align="center"></td>
+</tr>
+</tbody>
+</table>
+<h5>Artifacts</h5>
+<table>
+<thead>
+<tr>
+<th>Name</th><th>Type</th><th>Ext</th><th>Download</th><th>Size</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td>commons-cli</td><td>jar</td><td>jar</td><td align="center">no</td><td align="center">32 kB</td>
+</tr>
+</tbody>
+</table>
+<h3>
+<a name="apache-commons-lang"></a>commons-lang by apache<span class="resolved">resolved by <b>ivyrep</b></span>
+</h3>
+<h4>
+<a name="apache-commons-lang-2.0"></a>
+           Revision: 2.0<span style="padding-left:15px;"></span>
+</h4>
+<table class="header">
+<tr>
+<td class="title">Status</td><td class="value">release</td>
+</tr>
+<tr>
+<td class="title">Publication</td><td class="value">20050407222759</td>
+</tr>
+<tr>
+<td class="title">Resolver</td><td class="value">ivyrep</td>
+</tr>
+<tr>
+<td class="title">Configurations</td><td class="value">default</td>
+</tr>
+<tr>
+<td class="title">Artifacts size</td><td class="value">166 kB
+            (0 kB downloaded,
+            166 kB in cache)</td>
+</tr>
+</table>
+<h5>Required by</h5>
+<table>
+<thead>
+<tr>
+<th>Organisation</th><th>Name</th><th>In Configurations</th><th>Asked Revision</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td>apache</td><td><a href="#apache-commons-cli">commons-cli</a></td><td>default</td><td>1.0</td>
+</tr>
+<tr>
+<td>jayasoft</td><td><a href="#jayasoft-ivyrep-example">ivyrep-example</a></td><td>default</td><td>2.0</td>
+</tr>
+</tbody>
+</table>
+<h5>Dependencies</h5>
+<table>
+<tr>
+<td>
+    No dependency
+    </td>
+</tr>
+</table>
+<h5>Artifacts</h5>
+<table>
+<thead>
+<tr>
+<th>Name</th><th>Type</th><th>Ext</th><th>Download</th><th>Size</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td>commons-lang</td><td>jar</td><td>jar</td><td align="center">no</td><td align="center">166 kB</td>
+</tr>
+</tbody>
+</table>
+<h4>
+<a name="apache-commons-lang-1.0"></a>
+           Revision: 1.0<span style="padding-left:15px;"><img src="http://ivy.jayasoft.org/images/evicted.gif" alt="evicted" title="evicted by 2.0"></span>
+</h4>
+<table class="header">
+<tr>
+<td class="title">Status</td><td class="value"></td>
+</tr>
+<tr>
+<td class="title">Publication</td><td class="value"></td>
+</tr>
+<tr>
+<td class="title">Resolver</td><td class="value"></td>
+</tr>
+<tr>
+<td class="title">Configurations</td><td class="value"></td>
+</tr>
+<tr>
+<td class="title">Artifacts size</td><td class="value">0 kB
+            (0 kB downloaded,
+            0 kB in cache)</td>
+</tr>
+<tr>
+<td class="title">Evicted by</td><td class="value">2.0   
+            in <b>latest-revision</b> conflict manager
+        </td>
+</tr>
+</table>
+<h5>Required by</h5>
+<table>
+<thead>
+<tr>
+<th>Organisation</th><th>Name</th><th>In Configurations</th><th>Asked Revision</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td>apache</td><td><a href="#apache-commons-cli">commons-cli</a></td><td>default</td><td>1.0</td>
+</tr>
+</tbody>
+</table>
+<h3>
+<a name="apache-commons-logging"></a>commons-logging by apache<span class="resolved">resolved by <b>ivyrep</b></span>
+</h3>
+<h4>
+<a name="apache-commons-logging-1.0"></a>
+           Revision: 1.0<span style="padding-left:15px;"></span>
+</h4>
+<table class="header">
+<tr>
+<td class="title">Home Page</td><td class="value"><a href="http://jakarta.apache.org/commons/logging/">http://jakarta.apache.org/commons/logging/</a></td>
+</tr>
+<tr>
+<td class="title">Status</td><td class="value">release</td>
+</tr>
+<tr>
+<td class="title">Publication</td><td class="value">20020220232200</td>
+</tr>
+<tr>
+<td class="title">Resolver</td><td class="value">ivyrep</td>
+</tr>
+<tr>
+<td class="title">Configurations</td><td class="value">default</td>
+</tr>
+<tr>
+<td class="title">Artifacts size</td><td class="value">21 kB
+            (0 kB downloaded,
+            21 kB in cache)</td>
+</tr>
+<tr>
+<td class="title">Licenses</td><td class="value"><span style="padding-right:3px;"><a href="http://www.apache.org/licenses/LICENSE-2.0.txt">Apache</a></span></td>
+</tr>
+</table>
+<h5>Required by</h5>
+<table>
+<thead>
+<tr>
+<th>Organisation</th><th>Name</th><th>In Configurations</th><th>Asked Revision</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td>apache</td><td><a href="#apache-commons-cli">commons-cli</a></td><td>default</td><td>1.0</td>
+</tr>
+</tbody>
+</table>
+<h5>Dependencies</h5>
+<table>
+<tr>
+<td>
+    No dependency
+    </td>
+</tr>
+</table>
+<h5>Artifacts</h5>
+<table>
+<thead>
+<tr>
+<th>Name</th><th>Type</th><th>Ext</th><th>Download</th><th>Size</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td>commons-logging</td><td>jar</td><td>jar</td><td align="center">no</td><td align="center">21 kB</td>
+</tr>
+</tbody>
+</table>
+</div>
+</body>
+
+</html>

http://git-wip-us.apache.org/repos/asf/ant-ivy/blob/22bdffb9/asciidoc/samples/jayasoft-ivyrep-example-default.jpg
----------------------------------------------------------------------
diff --git a/asciidoc/samples/jayasoft-ivyrep-example-default.jpg b/asciidoc/samples/jayasoft-ivyrep-example-default.jpg
new file mode 100644
index 0000000..34759ab
Binary files /dev/null and b/asciidoc/samples/jayasoft-ivyrep-example-default.jpg differ

http://git-wip-us.apache.org/repos/asf/ant-ivy/blob/22bdffb9/asciidoc/samples/projects-dependencies-graph-small.jpg
----------------------------------------------------------------------
diff --git a/asciidoc/samples/projects-dependencies-graph-small.jpg b/asciidoc/samples/projects-dependencies-graph-small.jpg
new file mode 100644
index 0000000..1ddbfd2
Binary files /dev/null and b/asciidoc/samples/projects-dependencies-graph-small.jpg differ

http://git-wip-us.apache.org/repos/asf/ant-ivy/blob/22bdffb9/asciidoc/samples/projects-dependencies-graph.jpg
----------------------------------------------------------------------
diff --git a/asciidoc/samples/projects-dependencies-graph.jpg b/asciidoc/samples/projects-dependencies-graph.jpg
new file mode 100644
index 0000000..916226b
Binary files /dev/null and b/asciidoc/samples/projects-dependencies-graph.jpg differ

http://git-wip-us.apache.org/repos/asf/ant-ivy/blob/22bdffb9/asciidoc/samples/standard-osgi/build.xml
----------------------------------------------------------------------
diff --git a/asciidoc/samples/standard-osgi/build.xml b/asciidoc/samples/standard-osgi/build.xml
new file mode 100644
index 0000000..e4a9dc7
--- /dev/null
+++ b/asciidoc/samples/standard-osgi/build.xml
@@ -0,0 +1,83 @@
+<!--
+   Licensed to the Apache Software Foundation (ASF) under one
+   or more contributor license agreements.  See the NOTICE file
+   distributed with this work for additional information
+   regarding copyright ownership.  The ASF licenses this file
+   to you under the Apache License, Version 2.0 (the
+   "License"); you may not use this file except in compliance
+   with the License.  You may obtain a copy of the License at
+
+     http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing,
+   software distributed under the License is distributed on an
+   "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+   KIND, either express or implied.  See the License for the
+   specific language governing permissions and limitations
+   under the License.    
+-->
+<project name="standard-osgi" xmlns:ivy="ivy" xmlns:bnd="bnd">
+
+    <!-- Load Ivy ant tasks -->
+    <taskdef uri="ivy" resource="org/apache/ivy/ant/antlib.xml" />
+    <!-- If Ivy is not in Ant's classpath, get the jar of Ivy and use the folowing -->
+    <!-- taskdef rather than the above one -->
+    <!--path id="ivy.classpath"> 
+        <fileset dir="${basedir}">
+            <include name="ivy.jar" />
+        </fileset>
+    </path>
+    <taskdef uri="ivy" resource="org/apache/ivy/ant/antlib.xml" classpathref="ivy.classpath" /-->
+
+    <!-- Load Bnd ant tasks -->
+    <taskdef uri="bnd" resource="org/apache/ivy/ant/antlib.xml" />
+    <!-- If Bnd is not in Ant's classpath, get the jar of Bnd and use the folowing -->
+    <!-- taskdef rather than the above one -->
+    <!--path id="bnd.classpath"> 
+        <fileset dir="${basedir}">
+            <include name="bnd.jar" />
+        </fileset>
+    </path>
+    <taskdef uri="bnd" resource="aQute/bnd/ant/taskdef.properties" classpathref="bnd.classpath" /-->
+
+    <target name="clean" description="Clean the build directory">
+        <delete dir="${basedir}/target" />
+    </target>
+
+    <target name="ivy:configure">
+        <!-- classical ivy configuration -->
+        <ivy:configure file="${basedir}/ivysettings.xml" />
+    </target>
+
+    <target name="ivy:resolve" depends="ivy:configure">
+        <ivy:resolve file="ivy.xml" conf="*" />
+        <ivy:cachepath pathid="compile.classpath" conf="default" useOrigin="true" />
+    </target>
+
+    <target name="compile" depends="ivy:resolve" description="Compile the OSGi bundle">
+        <mkdir dir="${basedir}/target/classes" />
+        <!-- simple javac (WARNING: contrary to the JDT, javac doesn't understand OSGi's accessibility (private packages)) -->
+        <javac srcdir="${basedir}/src" classpathref="compile.classpath" destdir="${basedir}/target/classes" debug="true" includeAntRuntime="false" />
+        <copy todir="${basedir}/target/classes">
+            <fileset dir="${basedir}/src">
+                <include name="**" />
+                <exclude name="**/*.java" />
+                <exclude name="**/package.html" />
+            </fileset>
+            <fileset dir="${basedir}">
+                <include name="plugin.xml" />
+            </fileset>
+        </copy>
+    </target>
+
+    <target name="generate-manifest" depends="ivy:resolve">
+        <mkdir dir="META-INF" />
+        <bnd:bnd classpath="${toString:compile.classpath}" sourcepath="${basedir}/src" eclipse="false" files="org.apache.ivy.sample.standard-osgi.bnd" />
+    </target>
+
+    <target name="build" depends="compile,generate-manifest" description="Build the OSGi app">
+        <!-- simple jaring -->
+        <jar basedir="${basedir}/target/classes" destfile="${basedir}/target/${ant.project.name}.jar" manifest="META-INF/MANIFEST.MF" />
+    </target>
+
+</project>

http://git-wip-us.apache.org/repos/asf/ant-ivy/blob/22bdffb9/asciidoc/samples/standard-osgi/ivy.xml
----------------------------------------------------------------------
diff --git a/asciidoc/samples/standard-osgi/ivy.xml b/asciidoc/samples/standard-osgi/ivy.xml
new file mode 100644
index 0000000..ca6411e
--- /dev/null
+++ b/asciidoc/samples/standard-osgi/ivy.xml
@@ -0,0 +1,24 @@
+<!--
+   Licensed to the Apache Software Foundation (ASF) under one
+   or more contributor license agreements.  See the NOTICE file
+   distributed with this work for additional information
+   regarding copyright ownership.  The ASF licenses this file
+   to you under the Apache License, Version 2.0 (the
+   "License"); you may not use this file except in compliance
+   with the License.  You may obtain a copy of the License at
+
+     http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing,
+   software distributed under the License is distributed on an
+   "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+   KIND, either express or implied.  See the License for the
+   specific language governing permissions and limitations
+   under the License.    
+-->
+<ivy-module version="2.0">
+    <info organisation="com.acme" module="local-osgi-repo" />
+    <dependencies>
+        <dependency org="javax.servlet" name="com.springsource.javax.servlet" rev="2.4.0" />
+    </dependencies>
+</ivy-module>
\ No newline at end of file