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/09/11 14:27:23 UTC
svn commit: r1808031 [19/25] - in /ant/site/ivy/production/history/master:
./ dev/ ivyfile/ js/ osgi/ resolver/ samples/ samples/eclipse-plugin/
samples/standard-osgi/ settings/ settings/caches/ settings/macrodef/
settings/namespace/ tutorial/ tutorial...
Modified: ant/site/ivy/production/history/master/tutorial/multiproject.html
URL: http://svn.apache.org/viewvc/ant/site/ivy/production/history/master/tutorial/multiproject.html?rev=1808031&r1=1808030&r2=1808031&view=diff
==============================================================================
--- ant/site/ivy/production/history/master/tutorial/multiproject.html (original)
+++ ant/site/ivy/production/history/master/tutorial/multiproject.html Mon Sep 11 14:27:20 2017
@@ -1,6 +1,6 @@
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"><!----><!-- 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 L
icense.--><html lang="en"><head><meta http-equiv="Content-Type" content="text/html; charset=utf-8" /><meta name="generator" content="Asciidoctor 1.5.4" /><title>Using Ivy in multiple projects environment | Apache Ivy™ Documentation</title><link rel="stylesheet" type="text/css" href="../style/style.css" /><script src="../js/jquery.pack.js" type="text/javascript"></script><script src="../js/jquery.treeview.js" type="text/javascript"></script><link rel="stylesheet" href="//cdnjs.cloudflare.com/ajax/libs/highlight.js/9.12.0/styles/default.min.css" /><script src="//cdnjs.cloudflare.com/ajax/libs/highlight.js/9.12.0/highlight.min.js" type="text/javascript"></script><script>$(document).ready(function(){$("#treemenu").Treeview({speed: "fast",store: true});});
-hljs.initHighlightingOnLoad();</script></head><body><div id="body"><table id="header" summary="Navigation elements." border="0" cellpadding="0" cellspacing="0" width="100%"><tr><td id="home" width="30%"><a href="http://ant.apache.org/" title="Apache Ant"><img src="../images/ant-project-logo.svg" alt="Apache Ant" border="0" height="80px" /></a></td><td class="product" width="70%" align="right" valign="middle"><img src="../images/logo.png" alt="ivy" border="0" /></td></tr></table><table id="top-menu" summary="Navigation elements." border="0" cellpadding="0" cellspacing="0" width="100%"><tr><td><div id="navcontainer"> <a href="http://www.apache.org/">Apache™</a> > <a href="http://ant.apache.org/">Apache Ant™</a> > <a href="http://ant.apache.org/ivy/">Apache Ivy™</a> ><span class="breadCrumb"> <a href="index.html" class="current">Documentation (2.5.0-local-20170725163541)</a> > <a href="tutorial.html" class="current">Tutorials</a> > <a href="../tutorial/m
ultiproject.html" class="current">Using Ivy in multiple projects environment</a></span></div></td></tr></table><table id="content" border="0" cellpadding="0" cellspacing="0" width="100%"><tr><td id="sidebar-left"><div class="block block-book" id="block-book-0"><div class="sidebar-title">Apache Ivy™</div><div class="content"><ul id="treemenu" class="treeview">
-<li id="xooki-index" class="submenu"><a href="../index.html">Documentation (2.5.0-local-20170725163541)</a><ul class="open"><ul id="treemenu" class="treeview">
+hljs.initHighlightingOnLoad();</script></head><body><div id="body"><table id="header" summary="Navigation elements." border="0" cellpadding="0" cellspacing="0" width="100%"><tr><td id="home" width="30%"><a href="http://ant.apache.org/" title="Apache Ant"><img src="../images/ant-project-logo.svg" alt="Apache Ant" border="0" height="80px" /></a></td><td class="product" width="70%" align="right" valign="middle"><img src="../images/logo.png" alt="ivy" border="0" /></td></tr></table><table id="top-menu" summary="Navigation elements." border="0" cellpadding="0" cellspacing="0" width="100%"><tr><td><div id="navcontainer"> <a href="http://www.apache.org/">Apache™</a> > <a href="http://ant.apache.org/">Apache Ant™</a> > <a href="http://ant.apache.org/ivy/">Apache Ivy™</a> ><span class="breadCrumb"> <a href="index.html" class="current">Documentation (2.5.0-local-20170911195251)</a> > <a href="tutorial.html" class="current">Tutorials</a> > <a href="../tutorial/m
ultiproject.html" class="current">Using Ivy in multiple projects environment</a></span></div></td></tr></table><table id="content" border="0" cellpadding="0" cellspacing="0" width="100%"><tr><td id="sidebar-left"><div class="block block-book" id="block-book-0"><div class="sidebar-title">Apache Ivy™</div><div class="content"><ul id="treemenu" class="treeview">
+<li id="xooki-index" class="submenu"><a href="../index.html">Documentation (2.5.0-local-20170911195251)</a><ul class="open"><ul id="treemenu" class="treeview">
<li id="xooki-release-notes"><a href="../release-notes.html">Release Notes</a></li>
<li id="xooki-tutorial" class="submenu"><a href="../tutorial.html">Tutorials</a><ul class="open"><ul id="treemenu" class="treeview">
<li id="xooki-tutorial/start"><a href="../tutorial/start.html">Quick Start</a></li>
@@ -69,15 +69,15 @@ hljs.initHighlightingOnLoad();</script><
<li id="xooki-settings/resolvers" class="submenu"><a href="../settings/resolvers.html">resolvers</a><ul class="closed"><ul id="treemenu" class="treeview">
<li id="xooki-resolver/ivyrep"><a href="../resolver/ivyrep.html">IvyRep Resolver</a></li>
<li id="xooki-resolver/ibiblio"><a href="../resolver/ibiblio.html">IBiblio Resolver</a></li>
-<li id="xooki-resolver/packager"><a href="../resolver/packager.html">Packager resolver</a></li>
-<li id="xooki-resolver/filesystem"><a href="../resolver/filesystem.html">File System resolver</a></li>
-<li id="xooki-resolver/url"><a href="../resolver/url.html">Url Resolver</a></li>
+<li id="xooki-resolver/packager"><a href="../resolver/packager.html">Packager Resolver</a></li>
+<li id="xooki-resolver/filesystem"><a href="../resolver/filesystem.html">File System Resolver</a></li>
+<li id="xooki-resolver/url"><a href="../resolver/url.html">URL Resolver</a></li>
<li id="xooki-resolver/chain"><a href="../resolver/chain.html">Chain Resolver</a></li>
-<li id="xooki-resolver/dual"><a href="../resolver/dual.html">Dual resolver</a></li>
-<li id="xooki-resolver/sftp"><a href="../resolver/sftp.html">sftp resolver</a></li>
-<li id="xooki-resolver/ssh"><a href="../resolver/ssh.html">ssh resolver</a></li>
-<li id="xooki-resolver/vfs"><a href="../resolver/vfs.html">vfs resolver</a></li>
-<li id="xooki-resolver/jar"><a href="../resolver/jar.html">Jar resolver</a></li>
+<li id="xooki-resolver/dual"><a href="../resolver/dual.html">Dual Resolver</a></li>
+<li id="xooki-resolver/sftp"><a href="../resolver/sftp.html">SFTP Resolver</a></li>
+<li id="xooki-resolver/ssh"><a href="../resolver/ssh.html">SSH Resolver</a></li>
+<li id="xooki-resolver/vfs"><a href="../resolver/vfs.html">VFS Resolver</a></li>
+<li id="xooki-resolver/jar"><a href="../resolver/jar.html">Jar Resolver</a></li>
<li id="xooki-resolver/obr"><a href="../resolver/obr.html">OSGi Bundle Repository</a></li>
<li id="xooki-resolver/osgiagg"><a href="../resolver/osgiagg.html">Aggregated OSGi Repository</a></li>
<li id="xooki-resolver/updatesite"><a href="../resolver/updatesite.html">Eclipse updatesite</a></li>
@@ -91,7 +91,6 @@ hljs.initHighlightingOnLoad();</script><
</ul>
</ul></li>
<li id="xooki-settings/outputters"><a href="../settings/outputters.html">outputters</a></li>
-<li id="xooki-settings/signers"><a href="../settings/signers.html">signers</a></li>
<li id="xooki-settings/statuses" class="submenu"><a href="../settings/statuses.html">statuses</a><ul class="closed"><ul id="treemenu" class="treeview">
<li id="xooki-settings/status"><a href="../settings/status.html">status</a></li>
</ul>
@@ -179,14 +178,14 @@ hljs.initHighlightingOnLoad();</script><
<li id="xooki-use/makepom"><a href="../use/makepom.html">makepom</a></li>
<li id="xooki-use/postresolvetask"><a href="../use/postresolvetask.html">post resolve tasks</a></li>
<li id="xooki-use/publish"><a href="../use/publish.html">publish</a></li>
-<li id="xooki-use/repreport"><a href="../use/repreport.html">repreport</a></li>
-<li id="xooki-use/resolve"><a href="../use/resolve.html">resolve</a></li>
-<li id="xooki-use/resources"><a href="../use/resources.html">resources</a></li>
-<li id="xooki-use/retrieve"><a href="../use/retrieve.html">retrieve</a></li>
<li id="xooki-use/report" class="submenu"><a href="../use/report.html">report</a><ul class="closed"><ul id="treemenu" class="treeview">
<li id="xooki-yed"><a href="../yed.html">Using yEd to layout report graphs</a></li>
</ul>
</ul></li>
+<li id="xooki-use/repreport"><a href="../use/repreport.html">repreport</a></li>
+<li id="xooki-use/resolve"><a href="../use/resolve.html">resolve</a></li>
+<li id="xooki-use/resources"><a href="../use/resources.html">resources</a></li>
+<li id="xooki-use/retrieve"><a href="../use/retrieve.html">retrieve</a></li>
<li id="xooki-use/settings"><a href="../use/settings.html">settings</a></li>
<li id="xooki-use/var"><a href="../use/var.html">var</a></li>
</ul>
@@ -214,13 +213,13 @@ hljs.initHighlightingOnLoad();</script><
<p>In the previous tutorial, you saw how to deal with dependencies between two simple projects.</p>
</div>
<div class="paragraph">
-<p>This tutorial will guide you through the use of Ivy in a more complete environment. All of the code for this tutorial is available in the <code>src/example/multi-project</code> directory of the Ivy distribution.</p>
+<p>This tutorial will guide you through the use of Ivy in a more complex environment. All of the code for this tutorial is available in the <code>src/example/multi-project</code> directory of the Ivy distribution.</p>
</div>
<div class="sect1">
<h2 id="_context">Context</h2>
<div class="sectionbody">
<div class="paragraph">
-<p>Here is a 10000ft overview of the projects involved in this tutorial:</p>
+<p>Here is a 10000 ft overview of the projects involved in this tutorial:</p>
</div>
<div class="ulist">
<ul>
@@ -257,8 +256,15 @@ give access to all other modules feature
<p>But this gives a simple understanding of how Ant+Ivy can be used to develop an application divided in multiple modules.</p>
</div>
<div class="paragraph">
-<p>Now, here is how these modules relate to each other:
-link:../samples/projects-dependencies-graph.jpg<em class="image::../samples/projects-dependencies-graph-small.jpg[">click to enlarge</em>]</p>
+<p>Now, here is how these modules relate to each other:</p>
+</div>
+<div class="imageblock">
+<div class="content">
+<img src="../samples/projects-dependencies-graph-small.jpg" alt="projects dependencies graph small"/>
+</div>
+</div>
+<div class="paragraph">
+<p><a href="../samples/projects-dependencies-graph.jpg"><em>click to enlarge</em></a></p>
</div>
<div class="paragraph">
<p>Modules in yellow are the modules described in this tutorial, and modules in blue are external dependencies (we will see how to generate this graph later in this tutorial).</p>
@@ -310,25 +316,25 @@ Example:</p>
</div>
<div class="listingblock">
<div class="content">
-<pre class="highlightjs highlight"><code> <ivy-module version="1.0">
- <info
- organisation="org.apache.ivy.example"
- module="find"
- status="integration"/>
- <configurations>
+<pre class="highlightjs highlight"><code><ivy-module version="1.0">
+ <info
+ organisation="org.apache.ivy.example"
+ module="find"
+ status="integration"/>
+ <configurations>
<conf name="core"/>
<conf name="standalone" extends="core"/>
- </configurations>
- <publications>
+ </configurations>
+ <publications>
<artifact name="find" type="jar" conf="core"/>
- </publications>
- <dependencies>
+ </publications>
+ <dependencies>
<dependency name="version" rev="latest.integration" conf="core->default"/>
<dependency name="list" rev="latest.integration" conf="core"/>
<dependency org="commons-collections" name="commons-collections" rev="3.1" conf="core->default"/>
<dependency org="commons-cli" name="commons-cli" rev="1.0" conf="standalone->default"/>
- </dependencies>
- </ivy-module></code></pre>
+ </dependencies>
+</ivy-module></code></pre>
</div>
</div>
<div class="ulist">
@@ -341,11 +347,11 @@ The build file of the project, which con
</div>
<div class="listingblock">
<div class="content">
-<pre class="highlightjs highlight"><code> <project name="find" default="compile">
- <property file="build.properties"/>
+<pre class="highlightjs highlight"><code><project name="find" default="compile">
+ <property file="build.properties"/>
- <import file="${common.dir}/common.xml"/>
- </project></code></pre>
+ <import file="${common.dir}/common.xml"/>
+</project></code></pre>
</div>
</div>
<div class="ulist">
@@ -367,7 +373,7 @@ Module specific properties + properties
<ul>
<li>
<p>src<br/>
-the source directory with all java sources</p>
+the source directory with all Java sources</p>
</li>
</ul>
</div>
@@ -375,20 +381,20 @@ the source directory with all java sourc
<p>Note that this example doesn’t demonstrate many good practices for software development in general, in particular you won’t find any unit test in these samples, even if we think unit testing is very important. But this isn’t the aim of this tutorial.</p>
</div>
<div class="paragraph">
-<p>Now that you are a bit more familiar with the structure, let’s have a look at the most important part of this example: the common build file. Indeed, as you have seen, all the module’s build files only import the common build file, and define their dependencies in their ivy files (which you should begin to be familiar with).</p>
+<p>Now that you are a bit more familiar with the structure, let’s have a look at the most important part of this example: the common build file. Indeed, as you have seen, all the module’s build files only import the common build file, and define their dependencies in their Ivy files (which you should begin to be familiar with).</p>
</div>
<div class="paragraph">
<p>So, here are some aspects of this common build file:</p>
</div>
<div class="sect2">
-<h3 id="_ivy_settings">ivy settings</h3>
+<h3 id="_ivy_settings">Ivy settings</h3>
<div class="listingblock">
<div class="content">
-<pre class="highlightjs highlight"><code><!-- setup ivy default configuration with some custom info -->
+<pre class="highlightjs highlight"><code><!-- setup Ivy default configuration with some custom info -->
<property name="ivy.local.default.root" value="${repository.dir}/local"/>
<property name="ivy.shared.default.root" value="${repository.dir}/shared"/>
-<!-- here is how we would have configured ivy if we had our own ivysettings file
+<!-- here is how we would have configured Ivy if we had our own Ivy settings file
<ivy:settings file="${common.dir}/ivysettings.xml" id="ivy.instance"/>
--></code></pre>
</div>
@@ -402,8 +408,8 @@ Commented out you can see how the settin
<h3 id="_resolve_dependencies">resolve dependencies</h3>
<div class="listingblock">
<div class="content">
-<pre class="highlightjs highlight"><code><target name="resolve" depends="clean-lib, load-ivy" description="--> resolve and retrieve dependencies with ivy">
- <mkdir dir="${lib.dir}"/> <!-- not usually necessary, ivy creates the directory IF there are dependencies -->
+<pre class="highlightjs highlight"><code><target name="resolve" depends="clean-lib, load-ivy" description="--> resolve and retrieve dependencies with Ivy">
+ <mkdir dir="${lib.dir}"/> <!-- not usually necessary, Ivy creates the directory IF there are dependencies -->
<!-- the call to resolve is not mandatory, retrieve makes an implicit call if we don't -->
<ivy:resolve file="${ivy.file}"/>
@@ -412,7 +418,7 @@ Commented out you can see how the settin
</div>
</div>
<div class="paragraph">
-<p>You should begin to be familiar with using Ivy this way. We call <em>resolve</em> explicitly to use the ivy file configured (the default would have been fine), and then call <em>retrieve</em> to copy resolved dependencies artifacts from the cache to a local lib directory. The pattern is also used to name the artifacts in the lib dir with their name and extension only (without revision), this is easier to use with an IDE, as the IDE configuration won’t change when the artifacts version change.</p>
+<p>You should begin to be familiar with using Ivy this way. We call <em>resolve</em> explicitly to use the Ivy file configured (the default would have been fine), and then call <em>retrieve</em> to copy resolved dependencies artifacts from the cache to a local lib directory. The pattern is also used to name the artifacts in the lib dir with their name and extension only (without revision), this is easier to use with an IDE, as the IDE configuration won’t change when the artifact versions change.</p>
</div>
</div>
<div class="sect2">
@@ -432,7 +438,7 @@ Commented out you can see how the settin
</div>
</div>
<div class="paragraph">
-<p>This target is used to ask Ivy to find a new version for a module. To get details about the module we are dealing with, we pull information out of the ivy file by using the ivy:info task. Then the <a href="../use/buildnumber.html">buildnumber</a> task is used to get a new revision, based on a prefix we set with a property, by default it will be 1.0-dev-b (have a look at the default value for <code>module.version.target</code> in the <code>common/build.properties</code> file). Each module built by this common build file could easily override this by either setting a different <code>module.version.target</code> in its module specific <code>build.properties</code>, or even overriding <code>module.version.prefix</code>. To get the new revision, Ivy scans the repository to find the latest available version with the given prefix, and then increments this version by 1.</p>
+<p>This target is used to ask Ivy to find a new version for a module. To get details about the module we are dealing with, we pull information out of the Ivy file by using the ivy:info task. Then the <a href="../use/buildnumber.html">buildnumber</a> task is used to get a new revision, based on a prefix we set with a property. By default, it will be 1.0-dev-b (have a look at the default value for <code>module.version.target</code> in the <code>common/build.properties</code> file). Each module built by this common build file could easily override this by either setting a different <code>module.version.target</code> in its module specific <code>build.properties</code>, or even overriding <code>module.version.prefix</code>. To get the new revision, Ivy scans the repository to find the latest available version with the given prefix, and then increments this version by 1.</p>
</div>
</div>
<div class="sect2">
@@ -441,9 +447,9 @@ Commented out you can see how the settin
<div class="content">
<pre class="highlightjs highlight"><code><target name="publish" depends="clean-build, jar" description="--> publish this project in the ivy repository">
<ivy:publish artifactspattern="${build.dir}/[artifact].[ext]"
- resolver="shared"
- pubrevision="${version}"
- status="release"/>
+ resolver="shared"
+ pubrevision="${version}"
+ status="release"/>
<echo message="project ${ant.project.name} released with version ${version}"/>
</target></code></pre>
</div>
@@ -458,11 +464,11 @@ Commented out you can see how the settin
<div class="content">
<pre class="highlightjs highlight"><code><target name="publish-local" depends="local-version, jar" description="--> publish this project in the local ivy repository">
<ivy:publish artifactspattern="${build.dir}/[artifact].[ext]"
- resolver="local"
- pubrevision="${version}"
- pubdate="${now}"
- status="integration"
- forcedeliver="true"/>
+ resolver="local"
+ pubrevision="${version}"
+ pubdate="${now}"
+ status="integration"
+ forcedeliver="true"/>
<echo message="project ${ant.project.name} published locally with version ${version}"/>
</target></code></pre>
</div>
@@ -476,7 +482,7 @@ Commented out you can see how the settin
<div class="listingblock">
<div class="content">
<pre class="highlightjs highlight"><code><target name="clean-local" description="--> cleans the local repository for the current module">
- <delete dir="${ivy.local.default.root}/${ant.project.name}"/>
+ <delete dir="${ivy.local.default.root}/${ant.project.name}"/>
</target></code></pre>
</div>
</div>
@@ -494,18 +500,10 @@ Commented out you can see how the settin
</div>
</div>
<div class="paragraph">
-<p>Generates both an html report and a graphml report.</p>
-</div>
-<div class="paragraph">
-<p>For example, to generate a graph like the one shown at the beginning of this tutorial, you just have to follow the instructions given <a href="../yed.html">here</a> with the graphml file you will find in</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code>projects/console/build/</code></pre>
-</div>
+<p>Generates both an HTML report and a GraphML report.</p>
</div>
<div class="paragraph">
-<p>after having called report in the console project, and that’s it, you have a clear overview of all your app dependencies!</p>
+<p>For example, to generate a graph like the one shown at the beginning of this tutorial, you just have to follow the instructions given <a href="../yed.html">here</a> with the GraphML file you will find in <code>projects/console/build</code> after having called report in the console project, and that’s it, you have a clear overview of all your app dependencies!</p>
</div>
</div>
</div>
@@ -514,7 +512,7 @@ Commented out you can see how the settin
<h2 id="_playing_with_the_projects">Playing with the projects</h2>
<div class="sectionbody">
<div class="paragraph">
-<p>You can play with this tutorial by using regular Ant commands. Begin in the base directory of the tutorial (src/example/multi-project), and run ant -p:</p>
+<p>You can play with this tutorial by using regular Ant commands. Begin in the base directory of the tutorial (<code>src/example/multi-project</code>), and run <code>ant -p</code>:</p>
</div>
<div class="listingblock">
<div class="content">
@@ -532,10 +530,10 @@ Main targets:
<p>This gives you an idea of what you can do here. To make sure you have at least one version of all your modules published in your repository (required to build modules having dependencies on the others), you can run <code>ant publish-all</code> (example log <a href="log/multi-project-general-publishall.txt">here</a>).</p>
</div>
<div class="paragraph">
-<p>You will see that Ivy calls the publish target on all the modules, following the order of the dependencies, so that a dependee is always built and published before its depender. Feel free to make changes in the source code of a module (changing a method name for instance) and in the module using the method, then call publish-all to see how the change in the dependee is compiled first, published, and then available to the depender which can compile successfully.</p>
+<p>You will see that Ivy calls the publish target on all the modules, following the order of the dependencies, so that a dependee is always built and published before its depender. Feel free to make changes in the source code of a module (changing a method name, for instance) and in the module using the method, then call publish-all to see how the change in the dependee is compiled first, published, and then available to the depender which can compile successfully.</p>
</div>
<div class="paragraph">
-<p>Then you can go in one of the example project directories (like projects/find for instance), and run <code>ant -p</code>:</p>
+<p>Then you can go in one of the example project directories (like <code>projects/find</code>, for instance), and run <code>ant -p</code>:</p>
</div>
<div class="listingblock">
<div class="content">
@@ -559,10 +557,10 @@ Default target: compile</code></pre>
</div>
</div>
<div class="paragraph">
-<p>You can see the targets available, thanks to the import of the <code>common.xml</code> build file. Play with the project by calling resolve, and publish, and see what happens when you do the same in other projects. An interesting thing to do for instance, is to change the dependencies of a project. If the module version now depends on a new commons library, you will see that all other projects depending on that version will get this library as part of their transitive dependencies once the new revision of the version project is published. Very easy! And if a project introduces a change with which the depender isn’t compatible with yet, you can easily change the dependency in the depender to move from <code>latest.integration</code> to a fixed version with which the depender is compatible (probably the latest before the change). Keeping your modules under control is now very easy!</p>
+<p>You can see the targets available, thanks to the import of the <code>common.xml</code> build file. Play with the project by calling resolve, and publish, and see what happens when you do the same in other projects. An interesting thing to do, for instance, is to change the dependencies of a project. If the module version now depends on a new commons library, you will see that all other projects depending on that version will get this library as part of their transitive dependencies once the new revision of the version project is published. Very easy! And if a project introduces a change with which the depender isn’t compatible yet, you can easily change the dependency in the depender to move from <code>latest.integration</code> to a fixed version with which the depender is compatible (probably the latest before the change). Keeping your modules under control is now very easy!</p>
</div>
<div class="paragraph">
-<p>By now, you should be pretty familiar with multi-project development with Ivy. We hope you will appreciate its power and flexibility! And these tutorials are only the beginning of your journey with Ivy, browse the <a href="../reference.html">reference documentation</a> to learn more about the features, subscribe to the mailing lists to share your experience and ask questions with the community, browse the source code, open jira issues, submit patches, join in and help make Ivy the best of dependency management tools!</p>
+<p>By now, you should be pretty familiar with multi-project development with Ivy. We hope you will appreciate its power and flexibility! And these tutorials are only the beginning of your journey with Ivy, browse the <a href="../reference.html">reference documentation</a> to learn more about the features, subscribe to the mailing lists to share your experience and ask questions with the community, browse the source code, open Jira issues, submit patches, join in and help make Ivy the best of dependency management tools!</p>
</div>
</div>
</div></div></div></td></tr></table><table id="footer-menu" summary="Navigation elements." border="0" cellpadding="0" cellspacing="0" width="100%"><tr><td align="center" valign="middle"><div class="primary-links">::<a href="index.html">Home</a>::<a href="reference.html">Reference</a>::<a href="tutorial.html">Tutorials</a>::<a href="dev.html">Developer's doc</a>::</div></td></tr></table><div id="footer-message" class="footer"><hr /><i>Copyright © 2007 - 2017 The Apache Software Foundation, Licensed under the<a href="http://www.apache.org/licenses/">Apache License, Version 2.0</a>.</i><br /><i>Apache Ivy, Apache Ant, Ivy, Ant, Apache, the Apache Ivy logo, the Apache Ant logo and the Apache feather logo are trademarks of The Apache Software Foundation.</i><br /><i>All other marks mentioned may be trademarks or registered trademarks of their respective owners.</i></div></div></body></html>
\ No newline at end of file
Modified: ant/site/ivy/production/history/master/tutorial/start.html
URL: http://svn.apache.org/viewvc/ant/site/ivy/production/history/master/tutorial/start.html?rev=1808031&r1=1808030&r2=1808031&view=diff
==============================================================================
--- ant/site/ivy/production/history/master/tutorial/start.html (original)
+++ ant/site/ivy/production/history/master/tutorial/start.html Mon Sep 11 14:27:20 2017
@@ -1,6 +1,6 @@
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"><!----><!-- 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 L
icense.--><html lang="en"><head><meta http-equiv="Content-Type" content="text/html; charset=utf-8" /><meta name="generator" content="Asciidoctor 1.5.4" /><title>Quick Start | Apache Ivy™ Documentation</title><link rel="stylesheet" type="text/css" href="../style/style.css" /><script src="../js/jquery.pack.js" type="text/javascript"></script><script src="../js/jquery.treeview.js" type="text/javascript"></script><link rel="stylesheet" href="//cdnjs.cloudflare.com/ajax/libs/highlight.js/9.12.0/styles/default.min.css" /><script src="//cdnjs.cloudflare.com/ajax/libs/highlight.js/9.12.0/highlight.min.js" type="text/javascript"></script><script>$(document).ready(function(){$("#treemenu").Treeview({speed: "fast",store: true});});
-hljs.initHighlightingOnLoad();</script></head><body><div id="body"><table id="header" summary="Navigation elements." border="0" cellpadding="0" cellspacing="0" width="100%"><tr><td id="home" width="30%"><a href="http://ant.apache.org/" title="Apache Ant"><img src="../images/ant-project-logo.svg" alt="Apache Ant" border="0" height="80px" /></a></td><td class="product" width="70%" align="right" valign="middle"><img src="../images/logo.png" alt="ivy" border="0" /></td></tr></table><table id="top-menu" summary="Navigation elements." border="0" cellpadding="0" cellspacing="0" width="100%"><tr><td><div id="navcontainer"> <a href="http://www.apache.org/">Apache™</a> > <a href="http://ant.apache.org/">Apache Ant™</a> > <a href="http://ant.apache.org/ivy/">Apache Ivy™</a> ><span class="breadCrumb"> <a href="index.html" class="current">Documentation (2.5.0-local-20170725163541)</a> > <a href="tutorial.html" class="current">Tutorials</a> > <a href="../tutorial/s
tart.html" class="current">Quick Start</a></span></div></td></tr></table><table id="content" border="0" cellpadding="0" cellspacing="0" width="100%"><tr><td id="sidebar-left"><div class="block block-book" id="block-book-0"><div class="sidebar-title">Apache Ivy™</div><div class="content"><ul id="treemenu" class="treeview">
-<li id="xooki-index" class="submenu"><a href="../index.html">Documentation (2.5.0-local-20170725163541)</a><ul class="open"><ul id="treemenu" class="treeview">
+hljs.initHighlightingOnLoad();</script></head><body><div id="body"><table id="header" summary="Navigation elements." border="0" cellpadding="0" cellspacing="0" width="100%"><tr><td id="home" width="30%"><a href="http://ant.apache.org/" title="Apache Ant"><img src="../images/ant-project-logo.svg" alt="Apache Ant" border="0" height="80px" /></a></td><td class="product" width="70%" align="right" valign="middle"><img src="../images/logo.png" alt="ivy" border="0" /></td></tr></table><table id="top-menu" summary="Navigation elements." border="0" cellpadding="0" cellspacing="0" width="100%"><tr><td><div id="navcontainer"> <a href="http://www.apache.org/">Apache™</a> > <a href="http://ant.apache.org/">Apache Ant™</a> > <a href="http://ant.apache.org/ivy/">Apache Ivy™</a> ><span class="breadCrumb"> <a href="index.html" class="current">Documentation (2.5.0-local-20170911195251)</a> > <a href="tutorial.html" class="current">Tutorials</a> > <a href="../tutorial/s
tart.html" class="current">Quick Start</a></span></div></td></tr></table><table id="content" border="0" cellpadding="0" cellspacing="0" width="100%"><tr><td id="sidebar-left"><div class="block block-book" id="block-book-0"><div class="sidebar-title">Apache Ivy™</div><div class="content"><ul id="treemenu" class="treeview">
+<li id="xooki-index" class="submenu"><a href="../index.html">Documentation (2.5.0-local-20170911195251)</a><ul class="open"><ul id="treemenu" class="treeview">
<li id="xooki-release-notes"><a href="../release-notes.html">Release Notes</a></li>
<li id="xooki-tutorial" class="submenu"><a href="../tutorial.html">Tutorials</a><ul class="open"><ul id="treemenu" class="treeview">
<li id="xooki-tutorial/start"><a href="../tutorial/start.html" class="current">Quick Start</a></li>
@@ -69,15 +69,15 @@ hljs.initHighlightingOnLoad();</script><
<li id="xooki-settings/resolvers" class="submenu"><a href="../settings/resolvers.html">resolvers</a><ul class="closed"><ul id="treemenu" class="treeview">
<li id="xooki-resolver/ivyrep"><a href="../resolver/ivyrep.html">IvyRep Resolver</a></li>
<li id="xooki-resolver/ibiblio"><a href="../resolver/ibiblio.html">IBiblio Resolver</a></li>
-<li id="xooki-resolver/packager"><a href="../resolver/packager.html">Packager resolver</a></li>
-<li id="xooki-resolver/filesystem"><a href="../resolver/filesystem.html">File System resolver</a></li>
-<li id="xooki-resolver/url"><a href="../resolver/url.html">Url Resolver</a></li>
+<li id="xooki-resolver/packager"><a href="../resolver/packager.html">Packager Resolver</a></li>
+<li id="xooki-resolver/filesystem"><a href="../resolver/filesystem.html">File System Resolver</a></li>
+<li id="xooki-resolver/url"><a href="../resolver/url.html">URL Resolver</a></li>
<li id="xooki-resolver/chain"><a href="../resolver/chain.html">Chain Resolver</a></li>
-<li id="xooki-resolver/dual"><a href="../resolver/dual.html">Dual resolver</a></li>
-<li id="xooki-resolver/sftp"><a href="../resolver/sftp.html">sftp resolver</a></li>
-<li id="xooki-resolver/ssh"><a href="../resolver/ssh.html">ssh resolver</a></li>
-<li id="xooki-resolver/vfs"><a href="../resolver/vfs.html">vfs resolver</a></li>
-<li id="xooki-resolver/jar"><a href="../resolver/jar.html">Jar resolver</a></li>
+<li id="xooki-resolver/dual"><a href="../resolver/dual.html">Dual Resolver</a></li>
+<li id="xooki-resolver/sftp"><a href="../resolver/sftp.html">SFTP Resolver</a></li>
+<li id="xooki-resolver/ssh"><a href="../resolver/ssh.html">SSH Resolver</a></li>
+<li id="xooki-resolver/vfs"><a href="../resolver/vfs.html">VFS Resolver</a></li>
+<li id="xooki-resolver/jar"><a href="../resolver/jar.html">Jar Resolver</a></li>
<li id="xooki-resolver/obr"><a href="../resolver/obr.html">OSGi Bundle Repository</a></li>
<li id="xooki-resolver/osgiagg"><a href="../resolver/osgiagg.html">Aggregated OSGi Repository</a></li>
<li id="xooki-resolver/updatesite"><a href="../resolver/updatesite.html">Eclipse updatesite</a></li>
@@ -91,7 +91,6 @@ hljs.initHighlightingOnLoad();</script><
</ul>
</ul></li>
<li id="xooki-settings/outputters"><a href="../settings/outputters.html">outputters</a></li>
-<li id="xooki-settings/signers"><a href="../settings/signers.html">signers</a></li>
<li id="xooki-settings/statuses" class="submenu"><a href="../settings/statuses.html">statuses</a><ul class="closed"><ul id="treemenu" class="treeview">
<li id="xooki-settings/status"><a href="../settings/status.html">status</a></li>
</ul>
@@ -179,14 +178,14 @@ hljs.initHighlightingOnLoad();</script><
<li id="xooki-use/makepom"><a href="../use/makepom.html">makepom</a></li>
<li id="xooki-use/postresolvetask"><a href="../use/postresolvetask.html">post resolve tasks</a></li>
<li id="xooki-use/publish"><a href="../use/publish.html">publish</a></li>
-<li id="xooki-use/repreport"><a href="../use/repreport.html">repreport</a></li>
-<li id="xooki-use/resolve"><a href="../use/resolve.html">resolve</a></li>
-<li id="xooki-use/resources"><a href="../use/resources.html">resources</a></li>
-<li id="xooki-use/retrieve"><a href="../use/retrieve.html">retrieve</a></li>
<li id="xooki-use/report" class="submenu"><a href="../use/report.html">report</a><ul class="closed"><ul id="treemenu" class="treeview">
<li id="xooki-yed"><a href="../yed.html">Using yEd to layout report graphs</a></li>
</ul>
</ul></li>
+<li id="xooki-use/repreport"><a href="../use/repreport.html">repreport</a></li>
+<li id="xooki-use/resolve"><a href="../use/resolve.html">resolve</a></li>
+<li id="xooki-use/resources"><a href="../use/resources.html">resources</a></li>
+<li id="xooki-use/retrieve"><a href="../use/retrieve.html">retrieve</a></li>
<li id="xooki-use/settings"><a href="../use/settings.html">settings</a></li>
<li id="xooki-use/var"><a href="../use/var.html">var</a></li>
</ul>
@@ -216,7 +215,7 @@ hljs.initHighlightingOnLoad();</script><
<p>In this tutorial, you will see one of the simplest ways to use Ivy. With no specific settings, Ivy uses the Maven 2 repository to resolve the dependencies you declare in an Ivy file. Let’s have a look at the content of the files involved.</p>
</div>
<div class="paragraph">
-<p><em>You’ll find this tutorial’s sources in the ivy distribution in the src/example/hello-ivy directory.</em></p>
+<p><em>You’ll find this tutorial’s sources in the Ivy distribution in the src/example/hello-ivy directory.</em></p>
</div>
</div>
</div>
@@ -224,8 +223,7 @@ hljs.initHighlightingOnLoad();</script><
<h2 id="_the_ivy_xml_file">The ivy.xml file</h2>
<div class="sectionbody">
<div class="paragraph">
-<p>This file is used to describe the dependencies of the project on other libraries.
-Here is the sample:</p>
+<p>This file describes the dependencies of the project on other libraries. Here is the sample:</p>
</div>
<div class="listingblock">
<div class="content">
@@ -239,10 +237,10 @@ Here is the sample:</p>
</div>
</div>
<div class="paragraph">
-<p>The format of this file should pretty easy to understand, but let’s give some details about what is declared here. First, the root element <code>ivy-module</code>, with the <code>version</code> attribute used to tell Ivy which version of Ivy this file uses.</p>
+<p>The format of this file should be pretty easy to understand, but let’s discuss some details about what is declared here. First, the root element is <code>ivy-module</code>, with the <code>version</code> attribute telling Ivy which lowest version of Ivy this file is compatible with.</p>
</div>
<div class="paragraph">
-<p>Then there is an <code>info</code> tag, which is used to give information about the module for which we are defining dependencies. Here we define only the <code>organization</code> and <code>module</code> name. You are free to choose whatever you want for them, but we recommend avoiding spaces for both.</p>
+<p>Then there is an <code>info</code> tag, which provides information about the module for which we are defining dependencies. Here we define only the <code>organization</code> and <code>module</code> names. You are free to choose whatever you want for them, but we recommend avoiding spaces for both.</p>
</div>
<div class="paragraph">
<p>Finally, the <code>dependencies</code> section lets you define dependencies. In this example, this module depends on two libraries: <code>commons-lang</code> and <code>commons-cli</code>. As you can see, we use the <code>org</code> and <code>name</code> attributes to define the organization and module name of the dependencies we need. The <code>rev</code> attribute is used to specify the version of the module you depend on.</p>
@@ -272,7 +270,7 @@ Here is the sample:</p>
<div class="sectionbody">
<div class="paragraph">
<p>The corresponding build file contains a set of targets, allowing you to resolve dependencies declared in the Ivy file, to compile and run the sample code, produce a report of dependency resolution, and clean the cache or the project.
-You can use the standard <code>ant -p</code> to get the list of available targets. Feel free to have a look at the whole file, but here is the part relevant to dependency resolution:</p>
+You can use the standard <code>ant -p</code> command to get the list of available targets. Feel free to have a look at the whole file, but here is the part relevant to dependency resolution:</p>
</div>
<div class="listingblock">
<div class="content">
@@ -283,14 +281,14 @@ You can use the standard <code>ant -p</c
<!-- =================================
target: resolve
================================= -->
- <target name="resolve" description="--> retrieve dependencies with ivy">
+ <target name="resolve" description="--> retrieve dependencies with Ivy">
<ivy:retrieve/>
</target>
</project></code></pre>
</div>
</div>
<div class="paragraph">
-<p>As you can see, it’s very easy to call Ivy to resolve and retrieve dependencies: all you need if Ivy is properly <a href="../install.html">installed</a> is to define an XML namespace in your Ant file (xmlns:ivy="antlib:org.apache.ivy.ant"). Then all the <a href="../ant.html">Ivy ant tasks</a> will be available in this namespace.</p>
+<p>As you can see, it’s very easy to call Ivy to resolve and retrieve dependencies: all you need if Ivy is properly <a href="../install.html">installed</a> is to define an XML namespace in your Ant file (<code>xmlns:ivy="antlib:org.apache.ivy.ant"</code>). Then all the <a href="../ant.html">Ivy Ant tasks</a> will be available in this namespace.</p>
</div>
<div class="paragraph">
<p>Here we use only one task: the <a href="../use/retrieve.html">retrieve</a> task. With no attributes, it will use default settings and look for a file named <code>ivy.xml</code> for the dependency definitions. That’s exactly what we want, so we need nothing more than that.</p>
@@ -387,7 +385,7 @@ Total time: 45 seconds</code></pre>
<div class="sectionbody">
<div class="paragraph">
<p>Without any settings, Ivy retrieves files from the Maven 2 repository. That’s what happened here.
-The resolve task has found the <code>commons-lang</code> and <code>commons-cli</code> modules in the Maven 2 central repository, identified that <code>commons-cli</code> depends on <code>commons-logging</code> and so resolved it as a transitive dependency. Then Ivy has downloaded all corresponding artifacts in its cache (by default in your user home, in a <code>.ivy2/cache</code> directory). Finally, the retrieve task copies the resolved jars from the ivy cache to the default library directory of the project: the <code>lib</code> dir (you can change this easily by setting the pattern attribute on the <a href="../use/retrieve.html">retrieve</a> task).</p>
+The resolve task has found the <code>commons-lang</code> and <code>commons-cli</code> modules in the Maven 2 central repository, identified that <code>commons-cli</code> depends on <code>commons-logging</code> and so resolved it as a transitive dependency. Then Ivy has downloaded all corresponding artifacts in its cache (by default in your user home, in a <code>.ivy2/cache</code> directory). Finally, the retrieve task copies the resolved jars from the Ivy cache to the default library directory of the project: the <code>lib</code> dir (you can change this easily by setting the pattern attribute on the <a href="../use/retrieve.html">retrieve</a> task).</p>
</div>
<div class="paragraph">
<p>You might say that the task took a long time just to write out a "Hello Ivy!" message. But remember that a lot of time was spent downloading the required files from the web. Let’s try to run it again:</p>
@@ -435,7 +433,7 @@ Total time: 0 seconds</code></pre>
<p>And now, if you want to generate a report detailing all the dependencies of your module, you can call the report target, and check the generated file in the build directory. You should obtain something looking like <a href="../samples/apache-hello-ivy-default.html">this</a>.</p>
</div>
<div class="paragraph">
-<p>As you can see, using Ivy to resolve dependencies stored in the Maven 2 repository is extremely easy. Now you can go on with the next tutorials to learn more about <a href="../tutorial/conf.html">how to use module configurations</a> which is a very powerful Ivy specific feature. Other tutorials are also available where you will learn how to use Ivy settings to leverage a possibly complex enterprise repository. It may also be a good time to start reading the <a href="../reference.html">reference documentation</a>, and especially the introduction material which gives a good overview of Ivy. The <a href="../bestpractices.html">best practices</a> page is also a must read to start thinking about how to use Ant+Ivy to build a clean and robust build system.</p>
+<p>As you can see, using Ivy to resolve dependencies stored in the Maven 2 repository is extremely easy. Now you can go on with the other tutorials to learn more about <a href="../tutorial/conf.html">how to use module configurations</a> which is a very powerful Ivy specific feature. More tutorials are also available where you will learn how to use Ivy settings to leverage a possibly complex enterprise repository. It may also be a good time to start reading the <a href="../reference.html">reference documentation</a>, and especially the introduction material which gives a good overview of Ivy. The <a href="../bestpractices.html">best practices</a> page is also a must read to start thinking about how to use Ant+Ivy to build a clean and robust build system.</p>
</div>
</div>
</div></div></div></td></tr></table><table id="footer-menu" summary="Navigation elements." border="0" cellpadding="0" cellspacing="0" width="100%"><tr><td align="center" valign="middle"><div class="primary-links">::<a href="index.html">Home</a>::<a href="reference.html">Reference</a>::<a href="tutorial.html">Tutorials</a>::<a href="dev.html">Developer's doc</a>::</div></td></tr></table><div id="footer-message" class="footer"><hr /><i>Copyright © 2007 - 2017 The Apache Software Foundation, Licensed under the<a href="http://www.apache.org/licenses/">Apache License, Version 2.0</a>.</i><br /><i>Apache Ivy, Apache Ant, Ivy, Ant, Apache, the Apache Ivy logo, the Apache Ant logo and the Apache feather logo are trademarks of The Apache Software Foundation.</i><br /><i>All other marks mentioned may be trademarks or registered trademarks of their respective owners.</i></div></div></body></html>
\ No newline at end of file
Modified: ant/site/ivy/production/history/master/use/artifactproperty.html
URL: http://svn.apache.org/viewvc/ant/site/ivy/production/history/master/use/artifactproperty.html?rev=1808031&r1=1808030&r2=1808031&view=diff
==============================================================================
--- ant/site/ivy/production/history/master/use/artifactproperty.html (original)
+++ ant/site/ivy/production/history/master/use/artifactproperty.html Mon Sep 11 14:27:20 2017
@@ -1,6 +1,6 @@
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"><!----><!-- 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 L
icense.--><html lang="en"><head><meta http-equiv="Content-Type" content="text/html; charset=utf-8" /><meta name="generator" content="Asciidoctor 1.5.4" /><title>artifactproperty | Apache Ivy™ Documentation</title><link rel="stylesheet" type="text/css" href="../style/style.css" /><script src="../js/jquery.pack.js" type="text/javascript"></script><script src="../js/jquery.treeview.js" type="text/javascript"></script><link rel="stylesheet" href="//cdnjs.cloudflare.com/ajax/libs/highlight.js/9.12.0/styles/default.min.css" /><script src="//cdnjs.cloudflare.com/ajax/libs/highlight.js/9.12.0/highlight.min.js" type="text/javascript"></script><script>$(document).ready(function(){$("#treemenu").Treeview({speed: "fast",store: true});});
-hljs.initHighlightingOnLoad();</script></head><body><div id="body"><table id="header" summary="Navigation elements." border="0" cellpadding="0" cellspacing="0" width="100%"><tr><td id="home" width="30%"><a href="http://ant.apache.org/" title="Apache Ant"><img src="../images/ant-project-logo.svg" alt="Apache Ant" border="0" height="80px" /></a></td><td class="product" width="70%" align="right" valign="middle"><img src="../images/logo.png" alt="ivy" border="0" /></td></tr></table><table id="top-menu" summary="Navigation elements." border="0" cellpadding="0" cellspacing="0" width="100%"><tr><td><div id="navcontainer"> <a href="http://www.apache.org/">Apache™</a> > <a href="http://ant.apache.org/">Apache Ant™</a> > <a href="http://ant.apache.org/ivy/">Apache Ivy™</a> ><span class="breadCrumb"> <a href="index.html" class="current">Documentation (2.5.0-local-20170725163541)</a> > <a href="reference.html" class="current">Reference</a> > <a href="ant.html" c
lass="current">Ant Tasks</a> > <a href="../use/artifactproperty.html" class="current">artifactproperty</a></span></div></td></tr></table><table id="content" border="0" cellpadding="0" cellspacing="0" width="100%"><tr><td id="sidebar-left"><div class="block block-book" id="block-book-0"><div class="sidebar-title">Apache Ivy™</div><div class="content"><ul id="treemenu" class="treeview">
-<li id="xooki-index" class="submenu"><a href="../index.html">Documentation (2.5.0-local-20170725163541)</a><ul class="open"><ul id="treemenu" class="treeview">
+hljs.initHighlightingOnLoad();</script></head><body><div id="body"><table id="header" summary="Navigation elements." border="0" cellpadding="0" cellspacing="0" width="100%"><tr><td id="home" width="30%"><a href="http://ant.apache.org/" title="Apache Ant"><img src="../images/ant-project-logo.svg" alt="Apache Ant" border="0" height="80px" /></a></td><td class="product" width="70%" align="right" valign="middle"><img src="../images/logo.png" alt="ivy" border="0" /></td></tr></table><table id="top-menu" summary="Navigation elements." border="0" cellpadding="0" cellspacing="0" width="100%"><tr><td><div id="navcontainer"> <a href="http://www.apache.org/">Apache™</a> > <a href="http://ant.apache.org/">Apache Ant™</a> > <a href="http://ant.apache.org/ivy/">Apache Ivy™</a> ><span class="breadCrumb"> <a href="index.html" class="current">Documentation (2.5.0-local-20170911195251)</a> > <a href="reference.html" class="current">Reference</a> > <a href="ant.html" c
lass="current">Ant Tasks</a> > <a href="../use/artifactproperty.html" class="current">artifactproperty</a></span></div></td></tr></table><table id="content" border="0" cellpadding="0" cellspacing="0" width="100%"><tr><td id="sidebar-left"><div class="block block-book" id="block-book-0"><div class="sidebar-title">Apache Ivy™</div><div class="content"><ul id="treemenu" class="treeview">
+<li id="xooki-index" class="submenu"><a href="../index.html">Documentation (2.5.0-local-20170911195251)</a><ul class="open"><ul id="treemenu" class="treeview">
<li id="xooki-release-notes"><a href="../release-notes.html">Release Notes</a></li>
<li id="xooki-tutorial" class="submenu"><a href="../tutorial.html">Tutorials</a><ul class="closed"><ul id="treemenu" class="treeview">
<li id="xooki-tutorial/start"><a href="../tutorial/start.html">Quick Start</a></li>
@@ -69,15 +69,15 @@ hljs.initHighlightingOnLoad();</script><
<li id="xooki-settings/resolvers" class="submenu"><a href="../settings/resolvers.html">resolvers</a><ul class="closed"><ul id="treemenu" class="treeview">
<li id="xooki-resolver/ivyrep"><a href="../resolver/ivyrep.html">IvyRep Resolver</a></li>
<li id="xooki-resolver/ibiblio"><a href="../resolver/ibiblio.html">IBiblio Resolver</a></li>
-<li id="xooki-resolver/packager"><a href="../resolver/packager.html">Packager resolver</a></li>
-<li id="xooki-resolver/filesystem"><a href="../resolver/filesystem.html">File System resolver</a></li>
-<li id="xooki-resolver/url"><a href="../resolver/url.html">Url Resolver</a></li>
+<li id="xooki-resolver/packager"><a href="../resolver/packager.html">Packager Resolver</a></li>
+<li id="xooki-resolver/filesystem"><a href="../resolver/filesystem.html">File System Resolver</a></li>
+<li id="xooki-resolver/url"><a href="../resolver/url.html">URL Resolver</a></li>
<li id="xooki-resolver/chain"><a href="../resolver/chain.html">Chain Resolver</a></li>
-<li id="xooki-resolver/dual"><a href="../resolver/dual.html">Dual resolver</a></li>
-<li id="xooki-resolver/sftp"><a href="../resolver/sftp.html">sftp resolver</a></li>
-<li id="xooki-resolver/ssh"><a href="../resolver/ssh.html">ssh resolver</a></li>
-<li id="xooki-resolver/vfs"><a href="../resolver/vfs.html">vfs resolver</a></li>
-<li id="xooki-resolver/jar"><a href="../resolver/jar.html">Jar resolver</a></li>
+<li id="xooki-resolver/dual"><a href="../resolver/dual.html">Dual Resolver</a></li>
+<li id="xooki-resolver/sftp"><a href="../resolver/sftp.html">SFTP Resolver</a></li>
+<li id="xooki-resolver/ssh"><a href="../resolver/ssh.html">SSH Resolver</a></li>
+<li id="xooki-resolver/vfs"><a href="../resolver/vfs.html">VFS Resolver</a></li>
+<li id="xooki-resolver/jar"><a href="../resolver/jar.html">Jar Resolver</a></li>
<li id="xooki-resolver/obr"><a href="../resolver/obr.html">OSGi Bundle Repository</a></li>
<li id="xooki-resolver/osgiagg"><a href="../resolver/osgiagg.html">Aggregated OSGi Repository</a></li>
<li id="xooki-resolver/updatesite"><a href="../resolver/updatesite.html">Eclipse updatesite</a></li>
@@ -91,7 +91,6 @@ hljs.initHighlightingOnLoad();</script><
</ul>
</ul></li>
<li id="xooki-settings/outputters"><a href="../settings/outputters.html">outputters</a></li>
-<li id="xooki-settings/signers"><a href="../settings/signers.html">signers</a></li>
<li id="xooki-settings/statuses" class="submenu"><a href="../settings/statuses.html">statuses</a><ul class="closed"><ul id="treemenu" class="treeview">
<li id="xooki-settings/status"><a href="../settings/status.html">status</a></li>
</ul>
@@ -179,14 +178,14 @@ hljs.initHighlightingOnLoad();</script><
<li id="xooki-use/makepom"><a href="../use/makepom.html">makepom</a></li>
<li id="xooki-use/postresolvetask"><a href="../use/postresolvetask.html">post resolve tasks</a></li>
<li id="xooki-use/publish"><a href="../use/publish.html">publish</a></li>
-<li id="xooki-use/repreport"><a href="../use/repreport.html">repreport</a></li>
-<li id="xooki-use/resolve"><a href="../use/resolve.html">resolve</a></li>
-<li id="xooki-use/resources"><a href="../use/resources.html">resources</a></li>
-<li id="xooki-use/retrieve"><a href="../use/retrieve.html">retrieve</a></li>
<li id="xooki-use/report" class="submenu"><a href="../use/report.html">report</a><ul class="closed"><ul id="treemenu" class="treeview">
<li id="xooki-yed"><a href="../yed.html">Using yEd to layout report graphs</a></li>
</ul>
</ul></li>
+<li id="xooki-use/repreport"><a href="../use/repreport.html">repreport</a></li>
+<li id="xooki-use/resolve"><a href="../use/resolve.html">resolve</a></li>
+<li id="xooki-use/resources"><a href="../use/resources.html">resources</a></li>
+<li id="xooki-use/retrieve"><a href="../use/retrieve.html">retrieve</a></li>
<li id="xooki-use/settings"><a href="../use/settings.html">settings</a></li>
<li id="xooki-use/var"><a href="../use/var.html">var</a></li>
</ul>
@@ -212,19 +211,19 @@ hljs.initHighlightingOnLoad();</script><
</ul>
<center><iframe src="http://www.apache.org/ads/buttonbar.html" style="border-width:0;" frameborder="0" scrolling="no" width="135" height="265"></iframe></center></div></div></td><td valign="top"><div id="main"><h1>artifactproperty</h1><div id="content"><div class="paragraph">
<p><strong><em>since 1.1</em></strong>
-Sets an Ant property for each dependency artifacts previously resolved.</p>
+Sets an Ant property for each dependency artifact previously resolved.</p>
</div>
<div class="paragraph">
<p><strong><em>since 2.0</em></strong> This is a <a href="../use/postresolvetask.html">post resolve task</a>, with all the behaviour and attributes common to all post resolve tasks.</p>
</div>
<div class="paragraph">
-<p>Please prefer the use of retrieve + standard ant path creation, which make your build more independent from Ivy (once artifacts are properly retrieved, Ivy is not required any more).</p>
+<p>Please prefer the use of retrieve + standard Ant path creation, which make your build more independent from Ivy (once artifacts are properly retrieved, Ivy is not required any more).</p>
</div>
<div class="paragraph">
<p>The property name and value are generated using the classical pattern concept, all artifact tokens and Ivy variables being available.</p>
</div>
<div class="paragraph">
-<p><strong><em>since 2.0</em></strong> This tag will follow the ant usual behavior for properties. If a property of the same name already exist, it’s value will be unchanged. This behavior can be changed using the <code>overwrite</code> attribute.</p>
+<p><strong><em>since 2.0</em></strong> This tag will follow the Ant usual behavior for properties. If a property with the same name already exists, its value will be unchanged. This behavior can be changed using the <code>overwrite</code> attribute.</p>
</div>
<div class="paragraph">
<p><em>WARNING</em>: Before 2.0, the behavior was to overwrite the properties. Since 2.0, the default is to not overwrite to properties</p>
@@ -263,22 +262,22 @@ Sets an Ant property for each dependency
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">haltonfailure</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock"><code>true</code> to halt the build on ivy failure, <code>false</code> to continue</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>true</code> to halt the build on Ivy failure, <code>false</code> to continue</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">No. Defaults to <code>true</code></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">validate</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock"><code>true</code> to force ivy files validation against ivy.xsd, <code>false</code> to force no validation</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">No. Defaults to default ivy value (as configured in configuration file)</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>true</code> to force validation of Ivy files against ivy.xsd, <code>false</code> to skip validation</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">No. Defaults to default Ivy value (as configured in settings file)</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">settingsRef</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">A reference to the ivy settings that must be used by this task <strong>(since 2.0)</strong></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">A reference to Ivy settings that must be used by this task <strong>(since 2.0)</strong></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">No, <code>ivy.instance</code> is taken by default.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">overwrite</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Overwrite the value of the property if it already exist <strong>(since 2.0)</strong>. Before 2.0, the properties were always overwritten.</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Overwrite the value of the property if it already exists <strong>(since 2.0)</strong>. Before 2.0, the properties were always overwritten.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">No, <code>false</code> by default.</p></td>
</tr>
</tbody>
Modified: ant/site/ivy/production/history/master/use/artifactreport.html
URL: http://svn.apache.org/viewvc/ant/site/ivy/production/history/master/use/artifactreport.html?rev=1808031&r1=1808030&r2=1808031&view=diff
==============================================================================
--- ant/site/ivy/production/history/master/use/artifactreport.html (original)
+++ ant/site/ivy/production/history/master/use/artifactreport.html Mon Sep 11 14:27:20 2017
@@ -1,6 +1,6 @@
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"><!----><!-- 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 L
icense.--><html lang="en"><head><meta http-equiv="Content-Type" content="text/html; charset=utf-8" /><meta name="generator" content="Asciidoctor 1.5.4" /><title>artifactreport | Apache Ivy™ Documentation</title><link rel="stylesheet" type="text/css" href="../style/style.css" /><script src="../js/jquery.pack.js" type="text/javascript"></script><script src="../js/jquery.treeview.js" type="text/javascript"></script><link rel="stylesheet" href="//cdnjs.cloudflare.com/ajax/libs/highlight.js/9.12.0/styles/default.min.css" /><script src="//cdnjs.cloudflare.com/ajax/libs/highlight.js/9.12.0/highlight.min.js" type="text/javascript"></script><script>$(document).ready(function(){$("#treemenu").Treeview({speed: "fast",store: true});});
-hljs.initHighlightingOnLoad();</script></head><body><div id="body"><table id="header" summary="Navigation elements." border="0" cellpadding="0" cellspacing="0" width="100%"><tr><td id="home" width="30%"><a href="http://ant.apache.org/" title="Apache Ant"><img src="../images/ant-project-logo.svg" alt="Apache Ant" border="0" height="80px" /></a></td><td class="product" width="70%" align="right" valign="middle"><img src="../images/logo.png" alt="ivy" border="0" /></td></tr></table><table id="top-menu" summary="Navigation elements." border="0" cellpadding="0" cellspacing="0" width="100%"><tr><td><div id="navcontainer"> <a href="http://www.apache.org/">Apache™</a> > <a href="http://ant.apache.org/">Apache Ant™</a> > <a href="http://ant.apache.org/ivy/">Apache Ivy™</a> ><span class="breadCrumb"> <a href="index.html" class="current">Documentation (2.5.0-local-20170725163541)</a> > <a href="reference.html" class="current">Reference</a> > <a href="ant.html" c
lass="current">Ant Tasks</a> > <a href="../use/artifactreport.html" class="current">artifactreport</a></span></div></td></tr></table><table id="content" border="0" cellpadding="0" cellspacing="0" width="100%"><tr><td id="sidebar-left"><div class="block block-book" id="block-book-0"><div class="sidebar-title">Apache Ivy™</div><div class="content"><ul id="treemenu" class="treeview">
-<li id="xooki-index" class="submenu"><a href="../index.html">Documentation (2.5.0-local-20170725163541)</a><ul class="open"><ul id="treemenu" class="treeview">
+hljs.initHighlightingOnLoad();</script></head><body><div id="body"><table id="header" summary="Navigation elements." border="0" cellpadding="0" cellspacing="0" width="100%"><tr><td id="home" width="30%"><a href="http://ant.apache.org/" title="Apache Ant"><img src="../images/ant-project-logo.svg" alt="Apache Ant" border="0" height="80px" /></a></td><td class="product" width="70%" align="right" valign="middle"><img src="../images/logo.png" alt="ivy" border="0" /></td></tr></table><table id="top-menu" summary="Navigation elements." border="0" cellpadding="0" cellspacing="0" width="100%"><tr><td><div id="navcontainer"> <a href="http://www.apache.org/">Apache™</a> > <a href="http://ant.apache.org/">Apache Ant™</a> > <a href="http://ant.apache.org/ivy/">Apache Ivy™</a> ><span class="breadCrumb"> <a href="index.html" class="current">Documentation (2.5.0-local-20170911195251)</a> > <a href="reference.html" class="current">Reference</a> > <a href="ant.html" c
lass="current">Ant Tasks</a> > <a href="../use/artifactreport.html" class="current">artifactreport</a></span></div></td></tr></table><table id="content" border="0" cellpadding="0" cellspacing="0" width="100%"><tr><td id="sidebar-left"><div class="block block-book" id="block-book-0"><div class="sidebar-title">Apache Ivy™</div><div class="content"><ul id="treemenu" class="treeview">
+<li id="xooki-index" class="submenu"><a href="../index.html">Documentation (2.5.0-local-20170911195251)</a><ul class="open"><ul id="treemenu" class="treeview">
<li id="xooki-release-notes"><a href="../release-notes.html">Release Notes</a></li>
<li id="xooki-tutorial" class="submenu"><a href="../tutorial.html">Tutorials</a><ul class="closed"><ul id="treemenu" class="treeview">
<li id="xooki-tutorial/start"><a href="../tutorial/start.html">Quick Start</a></li>
@@ -69,15 +69,15 @@ hljs.initHighlightingOnLoad();</script><
<li id="xooki-settings/resolvers" class="submenu"><a href="../settings/resolvers.html">resolvers</a><ul class="closed"><ul id="treemenu" class="treeview">
<li id="xooki-resolver/ivyrep"><a href="../resolver/ivyrep.html">IvyRep Resolver</a></li>
<li id="xooki-resolver/ibiblio"><a href="../resolver/ibiblio.html">IBiblio Resolver</a></li>
-<li id="xooki-resolver/packager"><a href="../resolver/packager.html">Packager resolver</a></li>
-<li id="xooki-resolver/filesystem"><a href="../resolver/filesystem.html">File System resolver</a></li>
-<li id="xooki-resolver/url"><a href="../resolver/url.html">Url Resolver</a></li>
+<li id="xooki-resolver/packager"><a href="../resolver/packager.html">Packager Resolver</a></li>
+<li id="xooki-resolver/filesystem"><a href="../resolver/filesystem.html">File System Resolver</a></li>
+<li id="xooki-resolver/url"><a href="../resolver/url.html">URL Resolver</a></li>
<li id="xooki-resolver/chain"><a href="../resolver/chain.html">Chain Resolver</a></li>
-<li id="xooki-resolver/dual"><a href="../resolver/dual.html">Dual resolver</a></li>
-<li id="xooki-resolver/sftp"><a href="../resolver/sftp.html">sftp resolver</a></li>
-<li id="xooki-resolver/ssh"><a href="../resolver/ssh.html">ssh resolver</a></li>
-<li id="xooki-resolver/vfs"><a href="../resolver/vfs.html">vfs resolver</a></li>
-<li id="xooki-resolver/jar"><a href="../resolver/jar.html">Jar resolver</a></li>
+<li id="xooki-resolver/dual"><a href="../resolver/dual.html">Dual Resolver</a></li>
+<li id="xooki-resolver/sftp"><a href="../resolver/sftp.html">SFTP Resolver</a></li>
+<li id="xooki-resolver/ssh"><a href="../resolver/ssh.html">SSH Resolver</a></li>
+<li id="xooki-resolver/vfs"><a href="../resolver/vfs.html">VFS Resolver</a></li>
+<li id="xooki-resolver/jar"><a href="../resolver/jar.html">Jar Resolver</a></li>
<li id="xooki-resolver/obr"><a href="../resolver/obr.html">OSGi Bundle Repository</a></li>
<li id="xooki-resolver/osgiagg"><a href="../resolver/osgiagg.html">Aggregated OSGi Repository</a></li>
<li id="xooki-resolver/updatesite"><a href="../resolver/updatesite.html">Eclipse updatesite</a></li>
@@ -91,7 +91,6 @@ hljs.initHighlightingOnLoad();</script><
</ul>
</ul></li>
<li id="xooki-settings/outputters"><a href="../settings/outputters.html">outputters</a></li>
-<li id="xooki-settings/signers"><a href="../settings/signers.html">signers</a></li>
<li id="xooki-settings/statuses" class="submenu"><a href="../settings/statuses.html">statuses</a><ul class="closed"><ul id="treemenu" class="treeview">
<li id="xooki-settings/status"><a href="../settings/status.html">status</a></li>
</ul>
@@ -179,14 +178,14 @@ hljs.initHighlightingOnLoad();</script><
<li id="xooki-use/makepom"><a href="../use/makepom.html">makepom</a></li>
<li id="xooki-use/postresolvetask"><a href="../use/postresolvetask.html">post resolve tasks</a></li>
<li id="xooki-use/publish"><a href="../use/publish.html">publish</a></li>
-<li id="xooki-use/repreport"><a href="../use/repreport.html">repreport</a></li>
-<li id="xooki-use/resolve"><a href="../use/resolve.html">resolve</a></li>
-<li id="xooki-use/resources"><a href="../use/resources.html">resources</a></li>
-<li id="xooki-use/retrieve"><a href="../use/retrieve.html">retrieve</a></li>
<li id="xooki-use/report" class="submenu"><a href="../use/report.html">report</a><ul class="closed"><ul id="treemenu" class="treeview">
<li id="xooki-yed"><a href="../yed.html">Using yEd to layout report graphs</a></li>
</ul>
</ul></li>
+<li id="xooki-use/repreport"><a href="../use/repreport.html">repreport</a></li>
+<li id="xooki-use/resolve"><a href="../use/resolve.html">resolve</a></li>
+<li id="xooki-use/resources"><a href="../use/resources.html">resources</a></li>
+<li id="xooki-use/retrieve"><a href="../use/retrieve.html">retrieve</a></li>
<li id="xooki-use/settings"><a href="../use/settings.html">settings</a></li>
<li id="xooki-use/var"><a href="../use/var.html">var</a></li>
</ul>
@@ -212,7 +211,7 @@ hljs.initHighlightingOnLoad();</script><
</ul>
<center><iframe src="http://www.apache.org/ads/buttonbar.html" style="border-width:0;" frameborder="0" scrolling="no" width="135" height="265"></iframe></center></div></div></td><td valign="top"><div id="main"><h1>artifactreport</h1><div id="content"><div class="paragraph">
<p><strong><em>since 1.4</em></strong>
-The <code>artifactreport</code> task generates an xml report of all artifacts dependencies resolved by the last <a href="../use/resolve.html">resolve</a> task call during the same build.</p>
+The <code>artifactreport</code> task generates an XML report of all artifact dependencies resolved by the last <a href="../use/resolve.html">resolve</a> task call during the same build.</p>
</div>
<div class="paragraph">
<p><strong><em>since 2.0</em></strong> This is a <a href="../use/postresolvetask.html">post resolve task</a>, with all the behaviour and attributes common to all post resolve tasks.</p>
@@ -227,7 +226,7 @@ The <code>artifactreport</code> task gen
<p>See this <a href="http://www.jaya.free.fr/ivy/doc/articles/ease-multi-module.html">article by Johan Stuyts</a> (who contributed this task) to see how he uses this task.</p>
</div>
<div class="paragraph">
-<p>Here is an example of generate file:</p>
+<p>Here is an example of generated file:</p>
</div>
<div class="listingblock">
<div class="content">
@@ -283,7 +282,7 @@ The <code>artifactreport</code> task gen
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">pattern</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">the retrieve pattern to use to fill the retrieve location information about the artifacts</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">the retrieve pattern to use for adding the retrieve location information about the artifacts</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">No. Defaults to <code>${ivy.retrieve.pattern}</code>.</p></td>
</tr>
<tr>
@@ -293,12 +292,12 @@ The <code>artifactreport</code> task gen
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">haltonfailure</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock"><code>true</code> to halt the build on ivy failure, <code>false</code> to continue</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>true</code> to halt the build on Ivy failure, <code>false</code> to continue</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">No. Defaults to <code>true</code></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">settingsRef</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">A reference to the ivy settings that must be used by this task <strong>(since 2.0)</strong></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">A reference to Ivy settings that must be used by this task <strong>(since 2.0)</strong></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">No, <code>ivy.instance</code> is taken by default.</p></td>
</tr>
</tbody>