You are viewing a plain text version of this content. The canonical link for it is here.
Posted to ivy-commits@incubator.apache.org by xa...@apache.org on 2007/07/04 15:41:57 UTC
svn commit: r553243 [8/8] - in /incubator/ivy/core/trunk/doc: ./
configuration/ configuration/macrodef/ configuration/namespace/ doc/
history/ ivyfile/ presentations/ resolver/ schemas/ test/ tutorial/
tutorial/build-repository/ use/
Added: incubator/ivy/core/trunk/doc/use/deliver.html
URL: http://svn.apache.org/viewvc/incubator/ivy/core/trunk/doc/use/deliver.html?view=auto&rev=553243
==============================================================================
--- incubator/ivy/core/trunk/doc/use/deliver.html (added)
+++ incubator/ivy/core/trunk/doc/use/deliver.html Wed Jul 4 08:41:45 2007
@@ -0,0 +1,113 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.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 License.
+-->
+<html>
+<head>
+ <META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=ISO-8859-1">
+ <script type="text/javascript">var xookiConfig = {level: 1};</script>
+ <script type="text/javascript" src="../xooki/xooki.js"></script>
+</head>
+<body>
+ <textarea id="xooki-source">
+Delivers a resolved ivy file of the current module, and possibly do recursive delivery of dependencies.
+This task does two main things:
+<h2>Generate a resolved ivy file</h2>
+This task generates a resolved ivy file of the current module, based upon the last resolve done. The resolved ivy file contains updated information about the delivered module, such as revision and status.
+
+Moreover, all included configurations files are included in the ivy file, and variables are replaced by their values.
+
+Finally, in the resolved ivy file, dynamic revisions are replaced by the static ones that have been found during the resolve step, so the ivy file can be used later safely to obtain the same dependencies (providing that a revision uniquely identifies a module, which should be the case for proper ivy use).
+
+<span class="since">since 1.3</span> The replacement of dynamic revisions by static ones can be turned off, so that dynamic revisions are kept in the ivy file.
+<h2>do recursive delivery</h2>
+This is done only if a deliver target is given to the deliver task.
+
+If a deliver target is set, then it is called (via an antcall) for each dependency which has not a suffisant status compared to the deliver status set for this task. This means that if you deliver an integration revision, no recursive delivery will be done.
+
+If you deliver a milestone or a release revision, deliver target will be called with each integration dependency.
+
+The deliver target is called with the following properties available:
+<ul>
+ <li>dependency.name</li>
+the name of the dependency to recursively deliver
+ <li>dependency.published.status</li>
+the status to which the dependency should be delivered
+ <li>dependency.published.version</li>
+the revision to which the dependency should be delivered
+ <li>dependency.version</li>
+the revision of the dependency that should be delivered (the one that was retrieved during last resolve)
+</ul>
+Both <code>dependency.published.status</code> and <code>dependency.published.version</code> can be either asked to the user through ant input tasks (default behaviour), or be always the same for the whole recursive delivery process if the following properties are set:
+<ul>
+<li>recursive.delivery.status</li>set to the status to which all dependencies requiring to be delivered will be
+<li>recursive.delivery.version</li>set to the version to which all dependencies requiring to be delivered will be
+</ul>
+
+Usually the deliver target itself triggers an another ant build (using ant task) even if this is up to you to decide.
+
+The delivered ivy file will update its dependency revisions with those given here.
+
+<h2>deliver and publish</h2>
+The deliver task is most of the time not called explicitly, but rather called automatically by the [[ant:publish]] task. So, when shall the deliver task be called explictly? When you actually need to separate what is performed by the deliver task (see above), from what is performed by the publish task, i.e. upload a module to a repository.
+
+And this can be particularly useful if you want to process the generated ivy file before uploading it (if you want to add automatically more information like an SCM tag used, the user who performed the release, ...).
+
+It can also be useful if you want to trigger a recursive delivery and then ensure that you get the recursively delivered modules as dependencies. In this case your build order may look like this:
+- ivy:configure
+- ivy:resolve
+- ivy:deliver with recursive delivery
+- ivy:resolve again with the ivy file generated by the recursive delivery
+- do your build stuff (compile, jar, whatever)
+- ivy:publish
+
+<table class="ant">
+<thead>
+ <tr><th class="ant-att">Attribute</th><th class="ant-desc">Description</th><th class="ant-req">Required</th></tr>
+</thead>
+<tbody>
+ <tr><td>deliverpattern</td><td>the pattern to use for ivy file delivery</td>
+ <td>No. Defaults to ${ivy.deliver.ivy.pattern}</td></tr>
+ <tr><td>pubrevision</td><td>the revision to use for the publication</td>
+ <td>No. Defaults to ${ivy.deliver.revision} if set, or the revision resolved if set, or a timestamp</td></tr>
+ <tr><td>pubdate</td><td>the publication date to use for the publication. This date should be either 'now', or a date given with the following pattern: yyyyMMddHHmmss</td>
+ <td>No. Defaults to 'now'</td></tr>
+ <tr><td>status</td><td>the status to use for the publication</td>
+ <td>No. Defaults to ${ivy.status}</td></tr>
+ <tr><td>delivertarget</td><td>the target to call for recursive delivery</td>
+ <td>No. No recursive delivery is done by default</td></tr>
+ <tr><td>validate</td><td>true to force ivy files validation against ivy.xsd, false to force no validation</td>
+ <td>No. Defaults to default ivy value (as configured in configuration file)</td></tr>
+ <tr><td>replacedynamicrev</td><td>true to replace dynmic revisions by static ones in the delivered file, false to avoid this replacement <span class="since">since 1.3</span></td>
+ <td>No. Defaults to true</td></tr>
+ <tr><td>settingsRef</td><td>A reference to the ivy settings that must be used by this task <span class="since">(since 2.0)</span></td>
+ <td>No, 'ivy.instance' is taken by default.</td></tr>
+ <tr><td>conf</td><td>comma-separated list of configurations to include in the delivered file. Accepts wildcards. <span class="since">since 2.0</span></td>
+ <td>No. Defaults to all configurations</td></tr>
+</tbody>
+</table>
+
+<h1>Example</h1>
+Deliver an ivy file without the private configurations:
+<code type="xml">
+<deliver conf="*(public)" />
+</code>
+</textarea>
+<script type="text/javascript">xooki.postProcess();</script>
+</body>
+</html>
Propchange: incubator/ivy/core/trunk/doc/use/deliver.html
------------------------------------------------------------------------------
svn:eol-style = native
Added: incubator/ivy/core/trunk/doc/use/findrevision.html
URL: http://svn.apache.org/viewvc/incubator/ivy/core/trunk/doc/use/findrevision.html?view=auto&rev=553243
==============================================================================
--- incubator/ivy/core/trunk/doc/use/findrevision.html (added)
+++ incubator/ivy/core/trunk/doc/use/findrevision.html Wed Jul 4 08:41:45 2007
@@ -0,0 +1,70 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.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 License.
+-->
+<html>
+<head>
+ <META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=ISO-8859-1">
+ <script type="text/javascript">var xookiConfig = {level: 1};</script>
+ <script type="text/javascript" src="../xooki/xooki.js"></script>
+</head>
+<body>
+ <textarea id="xooki-source">
+<span class="since">since 1.4</span>
+Finds the latest revision of a module matching a given version constraint.
+
+A version constraint is what is used when declaring a <a href="../../doc/ivyfile/dependency.html">dependency</a> on a module.
+If the module is not found the property is not set.
+
+<h1>Attributes</h1>
+<table class="ant">
+<thead>
+ <tr><th class="ant-att">Attribute</th><th class="ant-desc">Description</th><th class="ant-req">Required</th></tr>
+</thead>
+<tbody>
+ <tr><td>organisation</td><td>the organisation of the module to find</td>
+ <td>Yes</td></tr>
+ <tr><td>module</td><td>the the name of the module to find</td>
+ <td>Yes</td></tr>
+ <tr><td>branch</td><td>the branch of the module to find</td>
+ <td>No, defaults to the default branch for the given module</td></tr>
+ <tr><td>revision</td><td>the revision constraint to apply</td>
+ <td>Yes</td></tr>
+ <tr><td>property</td><td>the property to set with the found revision</td>
+ <td>No, defaults to ivy.revision</td></tr>
+<tr><td>settingsRef</td><td>A reference to the ivy settings that must be used by this task <span class="since">(since 2.0)</span></td><td>No, 'ivy.instance' is taken by default.</td></tr>
+</tbody>
+</table>
+<h1>Examples</h1>
+<code type="xml">
+<ivy:findrevision organisation="apache" module="ivy" revision="latest.integration"/>
+</code>
+finds the latest version of ivy available in the repository and sets the property ivy.revision according to what was found.
+
+<hr/>
+
+<code type="xml">
+<ivy:findrevision organisation="apache" module="ivy" revision="1.0+"/>
+</code>
+same as above but only with 1.0 sub versions.
+
+
+ </textarea>
+<script type="text/javascript">xooki.postProcess();</script>
+</body>
+</html>
Propchange: incubator/ivy/core/trunk/doc/use/findrevision.html
------------------------------------------------------------------------------
svn:eol-style = native
Added: incubator/ivy/core/trunk/doc/use/info.html
URL: http://svn.apache.org/viewvc/incubator/ivy/core/trunk/doc/use/info.html?view=auto&rev=553243
==============================================================================
--- incubator/ivy/core/trunk/doc/use/info.html (added)
+++ incubator/ivy/core/trunk/doc/use/info.html Wed Jul 4 08:41:45 2007
@@ -0,0 +1,59 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.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 License.
+-->
+<html>
+<head>
+ <META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=ISO-8859-1">
+ <script type="text/javascript">var xookiConfig = {level: 1};</script>
+ <script type="text/javascript" src="../xooki/xooki.js"></script>
+</head>
+<body>
+ <textarea id="xooki-source">
+<span class="since">since 1.4</span>
+The info task ease the access to some essential data contained in an ivy file without performing a dependency resolution.
+
+The information is retrieved by setting ant properties:
+<table>
+<tr><td>ivy.organisation</td><td>The organisation of the module, as found in the <a href="../../doc/ivyfile/info.html">info</a> tag of the ivy file parsed</td></tr>
+<tr><td>ivy.module</td><td>The name of the module, as found in the <a href="../../doc/ivyfile/info.html">info</a> tag of the ivy file parsed</td></tr>
+<tr><td>ivy.revision</td><td>The revision of the module, as found in the <a href="../../doc/ivyfile/info.html">info</a> tag of the ivy file parsed</td></tr>
+<tr><td>ivy.configurations</td><td>A comma separated list of configurations of the module, as declared in the <a href="../../doc/ivyfile/configurations.html">configurations</a> section</td></tr>
+<tr><td>ivy.public.configurations</td><td>A comma separated list of public configurations of the module, as declared in the <a href="../../doc/ivyfile/configurations.html">configurations</a> section</td></tr>
+</table>
+
+<h1>Attributes</h1>
+<table class="ant">
+<thead>
+ <tr><th class="ant-att">Attribute</th><th class="ant-desc">Description</th><th class="ant-req">Required</th></tr>
+</thead>
+<tbody>
+ <tr><td>file</td><td>the ivy file to parse</td>
+ <td>Yes</td></tr>
+<tr><td>settingsRef</td><td>A reference to the ivy settings that must be used by this task <span class="since">(since 2.0)</span></td><td>No, 'ivy.instance' is taken by default.</td></tr></tbody>
+</table>
+<h1>Examples</h1>
+<code type="xml">
+<ivy:info file="${basedir}/path/to/ivy.xml" />
+</code>
+Parses ${basedir}/path/to/ivy.xml and set properties as described above accordingly.
+
+ </textarea>
+<script type="text/javascript">xooki.postProcess();</script>
+</body>
+</html>
Propchange: incubator/ivy/core/trunk/doc/use/info.html
------------------------------------------------------------------------------
svn:eol-style = native
Added: incubator/ivy/core/trunk/doc/use/install.html
URL: http://svn.apache.org/viewvc/incubator/ivy/core/trunk/doc/use/install.html?view=auto&rev=553243
==============================================================================
--- incubator/ivy/core/trunk/doc/use/install.html (added)
+++ incubator/ivy/core/trunk/doc/use/install.html Wed Jul 4 08:41:45 2007
@@ -0,0 +1,74 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.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 License.
+-->
+<html>
+<head>
+ <META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=ISO-8859-1">
+ <script type="text/javascript">var xookiConfig = {level: 1};</script>
+ <script type="text/javascript" src="../xooki/xooki.js"></script>
+</head>
+<body>
+ <textarea id="xooki-source">
+Installs a module and all its dependencies in a resolver. <span class="since">since 1.3</span>
+
+The module to install should be available in a resolver, and will be installed in another resolver which should support publish.
+
+This is particularly useful for users who only have a private repository, and want to benefit from public repositories from time to time. In this case, when a module is missing in the private repository, a call to install let download the module from a public repository not usually used for dependency resolution, and install it and its dependencies in the private repository.
+
+For more details about this task and its usage see the <a href="../../doc/tutorial/build-repository.html">build repository tutorial</a>
+
+<table class="ant">
+<thead>
+ <tr><th class="ant-att">Attribute</th><th class="ant-desc">Description</th><th class="ant-req">Required</th></tr>
+</thead>
+<tbody>
+ <tr><td>from</td><td>the name of the resolver in which the module must be found</td>
+ <td>Yes</td></tr>
+ <tr><td>to</td><td>the name of the resolver in which the module must be installed</td>
+ <td>Yes</td></tr>
+ <tr><td>organisation</td><td>the name of the organisation of the module to install</td>
+ <td>Yes</td></tr>
+ <tr><td>module</td><td>the name of the module to install</td>
+ <td>Yes</td></tr>
+ <tr><td>revision</td><td>the revision of the module to install</td>
+ <td>Yes</td></tr>
+ <tr><td>validate</td><td>true to force ivy files validation against ivy.xsd, false to force no validation</td>
+ <td>No. Defaults to default ivy value (as configured in configuration file)</td></tr>
+ <tr><td>overwrite</td><td>true to override modules already present in the destination resolver, false otherwise</td>
+ <td>No, defaults to false</td></tr>
+ <tr><td>transitive</td><td>true to install the module and all its transitive dependencies, false to install only the module</td>
+ <td>No, defaults to false</td></tr>
+ <tr><td>matcher</td><td>the name of the matcher to use to find the modules to install</td>
+ <td>No, defaults to exact</td></tr>
+ <tr><td>settingsRef</td><td>A reference to the ivy settings that must be used by this task <span class="since">(since 2.0)</span></td>
+ <td>No, 'ivy.instance' is taken by default.</td></tr>
+ <tr><td>haltonunresolved</td><td>true to fail build on unresolved dependencies <span class="since">since 2.0</span></td>
+ <td>No, defaults to true</td></tr>
+</tbody>
+</table>
+<h1>Examples</h1>
+<code type="xml">
+<ivy:install organisation="apache" module="commons-lang" revision="2.0" from="ivyrep" to="myfsresolver"/>
+</code>
+Installs the module commons-lang from apache in revision 2.0 in the resolver myfsresolver. The module is found in the resolver named 'ivyrep'.
+
+ </textarea>
+<script type="text/javascript">xooki.postProcess();</script>
+</body>
+</html>
Propchange: incubator/ivy/core/trunk/doc/use/install.html
------------------------------------------------------------------------------
svn:eol-style = native
Added: incubator/ivy/core/trunk/doc/use/listmodules.html
URL: http://svn.apache.org/viewvc/incubator/ivy/core/trunk/doc/use/listmodules.html?view=auto&rev=553243
==============================================================================
--- incubator/ivy/core/trunk/doc/use/listmodules.html (added)
+++ incubator/ivy/core/trunk/doc/use/listmodules.html Wed Jul 4 08:41:45 2007
@@ -0,0 +1,76 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.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 License.
+-->
+<html>
+<head>
+ <META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=ISO-8859-1">
+ <script type="text/javascript">var xookiConfig = {level: 1};</script>
+ <script type="text/javascript" src="../xooki/xooki.js"></script>
+</head>
+<body>
+ <textarea id="xooki-source">
+<span class="since">since 1.4</span>
+Finds the list of modules in the repository matching some criteria and set a corresponding list of properties in ant.
+
+The criteria is set by given patterns matching the organisation, name branch and revision of the modules to find.
+
+To know if a module matches the criteria ivy will use the configured <a href="../../doc/concept#matcher.html">pattern matcher</a>.
+
+<h1>Attributes</h1>
+<table class="ant">
+<thead>
+ <tr><th class="ant-att">Attribute</th><th class="ant-desc">Description</th><th class="ant-req">Required</th></tr>
+</thead>
+<tbody>
+ <tr><td>organisation</td><td>the pattern matching the organisation of the modules to list</td>
+ <td>Yes</td></tr>
+ <tr><td>module</td><td>the pattern matching the name of the modules to list</td>
+ <td>Yes</td></tr>
+ <tr><td>branch</td><td>the pattern matching the branch of the modules to list</td>
+ <td>No, defaults to '*'</td></tr>
+ <tr><td>revision</td><td>the pattern matching the revision of the modules to list</td>
+ <td>Yes</td></tr>
+ <tr><td>matcher</td><td>the name of the pattern matcher to use for matching the modules fields</td>
+ <td>No. Defaults to exactOrRegexp.</td></tr>
+ <tr><td>property</td><td>the pattern of the property to set when a module is found</td>
+ <td>Yes</td></tr>
+ <tr><td>value</td><td>The pattern of the value to set when a module is found</td><td>Yes</td></tr>
+<tr><td>settingsRef</td><td>A reference to the ivy settings that must be used by this task <span class="since">(since 2.0)</span></td><td>No, 'ivy.instance' is taken by default.</td></tr></tbody>
+</table>
+<h1>Examples</h1>
+<code type="xml">
+<ivy:listmodules organisation="apache" module="ivy" revision="*" property="ivy.[revision]" value="found"/>
+</code>
+will find all revisions of the module ivy in the org apache, and create one property for each revision found, the name of the property depending on the revision, the value being always 'found'
+
+<hr/>
+
+<code type="xml">
+<ivy:listmodules organisation="*" module="ivy*" revision="1.0" matcher="glob" property="modules.[module]" value="[organisation]"/>
+</code>
+use the glob matcher to find all modules which name starts with ivy with revision 1.0, and sets for each a property with module name found and organisation for value.
+Example:
+modules.ivy=apache
+modules.ivyde=apache
+modules.ivytools=ivytools
+
+ </textarea>
+<script type="text/javascript">xooki.postProcess();</script>
+</body>
+</html>
Propchange: incubator/ivy/core/trunk/doc/use/listmodules.html
------------------------------------------------------------------------------
svn:eol-style = native
Added: incubator/ivy/core/trunk/doc/use/postresolvetask.html
URL: http://svn.apache.org/viewvc/incubator/ivy/core/trunk/doc/use/postresolvetask.html?view=auto&rev=553243
==============================================================================
--- incubator/ivy/core/trunk/doc/use/postresolvetask.html (added)
+++ incubator/ivy/core/trunk/doc/use/postresolvetask.html Wed Jul 4 08:41:45 2007
@@ -0,0 +1,81 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.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 License.
+-->
+<html>
+<head>
+ <META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=ISO-8859-1">
+ <script type="text/javascript">var xookiConfig = {level: 1};</script>
+ <script type="text/javascript" src="../xooki/xooki.js"></script>
+</head>
+<body>
+ <textarea id="xooki-source">
+Several tasks in Ivy are considered as post resolve task and share a common behaviour and settings accordingly.
+
+These tasks are:
+<ul>
+<li>[[ant:retrieve]]</li>
+<li>[[ant:cachefileset]]</li>
+<li>[[ant:cachepath]]</li>
+<li>[[ant:artifactproperty]] <span class="since">(since 2.0)</span></li>
+<li>[[ant:artifactreport]] <span class="since">(since 2.0)</span></li>
+</ul>
+
+All these tasks will trigger automatically a resolve if:
+<ul>
+<li>none has already been called in the current build with the attribute keep set to true (see below)</li>
+<li>organisation and module are not set</li>
+</ul>
+
+Since Ivy 1.4, there are two ways to run a [[ant:resolve]]: with an ivy file, or with the inline mode.
+When you call resolve with an ivy file, the default for it is to keep the resolved data for use by the subsequent post resolve tasks. When you run an inline resolve, the default is not to keep the data. You can override this behaviour by setting the keep attribute as you like.
+
+If you want to to reuse the resolved data obtained through a call to resolve in another build (i.e. not the current one), then you have to set the organisation and module attributes. This work only if the cache was not cleaned since your last resolve call. This does not work with inline calls, which must be performed in the same build.
+
+The attributes listed are then mostly used only if a resolve is triggered automatically.
+
+<h1>Attributes</h1>
+<table class="ant">
+<thead>
+ <tr><th class="ant-att">Attribute</th><th class="ant-desc">Description</th><th class="ant-req">Required</th></tr>
+</thead>
+<tbody>
+ <tr><td>conf</td><td>a comma separated list of the configurations to retrieve</td>
+ <td>No. Defaults to the configurations resolved by the last resolve call, or * if no resolve was explicitly called</td></tr>
+ <tr><td>inline</td><td>true to use inline mode, false to resolve an ivy file <span class="since">since 1.4</span></td><td>No. defaults false</td></tr>
+ <tr><td>organisation</td><td>the organisation of the module to retrieve. This usually doesn't need to be set since it defaults to the last resolved one, except for inline mode where it is required.</td><td>Yes in inline mode, otherwise no, it then defaults to last resolved module name</td></tr>
+ <tr><td>module</td><td>the name of the module to retrieve. This usually doesn't need to be set since it defaults to the last resolved one, except for inline mode where it is required.</td><td>Yes in inline mode, otherwise no, it then defaults to last resolved module name</td></tr>
+ <tr><td>revision</td><td>the revision constraint of the module to retrieve. Used only in inline mode. <span class="since">since 1.4</span></td><td>No. Defaults to latest.integration</td></tr>
+ <tr><td>transitive</td><td>true to resolve dependencies transitively, false otherwise <span class="since">since 1.4</span></td><td>No. Defaults to true</td></tr>
+ <tr><td>haltonfailure</td><td>true to halt the build on ivy failure, false to continue</td><td>No. Defaults to true</td></tr>
+ <tr><td>validate</td><td>true to force ivy files validation against ivy.xsd, false to force no validation</td><td>No. Defaults to default ivy value (as configured in configuration file)</td></tr>
+ <tr><td>file</td><td>the file to resolve if a resolve is necessary <span class="since">since 2.0</span></td><td>No. Defaults to the previous resolved Ivy file or to ${ivy.dep.file}</td></tr>
+ <tr><td>settingsRef</td><td>A reference to the ivy settings that must be used by this task <span class="since">(since 2.0)</span></td><td>No, 'ivy.instance' is taken by default.</td></tr>
+</tbody>
+</table>
+<h1>Examples</h1>
+<code type="xml">
+<ivy:cachepath organisation="emma" module="emma" revision="2.0.4217" inline="true" conf="ant" pathid="emma.classpath"/>
+<taskdef resource="emma_ant.properties" classpathref="emma.classpath" />
+</code>
+Resolves the emma module in version 2.0.4217, constructs an ant path with the corresponding artifacts, and then define the emma tasks using this path.
+
+ </textarea>
+<script type="text/javascript">xooki.postProcess();</script>
+</body>
+</html>
Propchange: incubator/ivy/core/trunk/doc/use/postresolvetask.html
------------------------------------------------------------------------------
svn:eol-style = native
Added: incubator/ivy/core/trunk/doc/use/publish.html
URL: http://svn.apache.org/viewvc/incubator/ivy/core/trunk/doc/use/publish.html?view=auto&rev=553243
==============================================================================
--- incubator/ivy/core/trunk/doc/use/publish.html (added)
+++ incubator/ivy/core/trunk/doc/use/publish.html Wed Jul 4 08:41:45 2007
@@ -0,0 +1,86 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.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 License.
+-->
+<html>
+<head>
+ <META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=ISO-8859-1">
+ <script type="text/javascript">var xookiConfig = {level: 1};</script>
+ <script type="text/javascript" src="../xooki/xooki.js"></script>
+</head>
+<body>
+ <textarea id="xooki-source">
+Publishes the current modules artifacts.
+
+This task is meant to publish the declared published artifacts of the current module to a repository.
+
+The repository is given through the name of a resolver declared in current ivy configuration. See <a href="../../doc/configuration.html">configuration</a> for details about resolver supporting artifact publishing.
+It also publishes the delivered ivy file (except if you don't want), and even deliver it if it has not been done with a previous deliver call or if forcedeliver is set to true. That's why this task takes some parameters useful only for delivery.
+
+<span class="since">since 1.4.1</span>
+The source artifact pattern can be specified either as an attribute on the task (artifactspattern) or using a list of nested artifacts element (see examples below).
+
+<table class="ant">
+<thead>
+ <tr><th class="ant-att">Attribute</th><th class="ant-desc">Description</th><th class="ant-req">Required</th></tr>
+</thead>
+<tbody>
+ <tr><td>artifactspattern</td><td>the pattern to use to find artifacts to publish</td>
+ <td>No. Defaults to ${ivy.publish.src.artifacts.pattern}</td></tr>
+ <tr><td>resolver</td><td>the name of the resolver to use for publication</td>
+ <td>Yes</td></tr>
+ <tr><td>pubrevision</td><td>the revision to use for the publication</td>
+ <td>No. Defaults to the ${ivy.deliver.revision}</td></tr>
+ <tr><td>forcedeliver</td><td>true to force the implicit call to deliver, false to do it only if the ivy file to publish doesn't exist yet <span class="since">since 1.4</span></td>
+ <td>No. Defaults to false</td></tr>
+ <tr><td>validate</td><td>true to force ivy files validation against ivy.xsd, false to force no validation</td>
+ <td>No. Defaults to default ivy value (as configured in configuration file)</td></tr>
+ <tr><td>replacedynamicrev</td><td>true to replace dynmic revisions by static ones in the delivered file, false to avoid this replacement <span class="since">since 1.3</span></td>
+ <td>No. Defaults to true</td></tr>
+ <tr><td>publishivy</td><td>True to publish delivered ivy file, false otherwise</td>
+ <td>No. Defaults to true</td></tr>
+ <tr><td>conf</td><td>A comma separated list of configurations to publish. <span class="since">since 1.4.1</span></td>
+ <td>No. Defaults to all configurations</td></tr>
+ <tr><td>overwrite</td><td>True to overwrite files in repository if the revision already exist, false to let it as is</td>
+ <td>No. Defaults to false</td></tr>
+ <tr><td>warnonmissing</td><td>True to warn when artifacts to be published are missing</td>
+ <td>No. Defaults to true</td></tr>
+ <tr><td>haltonmissing</td><td>True to halt build when artifacts to be published are missing</td>
+ <td>No. Defaults to true</td></tr>
+ <tr><td>srcivypattern</td><td>the pattern to use to find ivy file to publish, and even deliver if necessary (<span class="since">since 1.2</span>)</td>
+ <td>No. Defaults to the value of artifactspattern</td></tr>
+ <tr><td>pubdate</td><td>the publication date to use for the delivery, if necessary. This date should be either 'now', or a date given with the following pattern: yyyyMMddHHmmss</td>
+ <td>No. Defaults to 'now'</td></tr>
+ <tr><td>status</td><td>the status to use for the delivery, if necessary</td>
+ <td>No. Defaults to ${ivy.status}</td></tr>
+ <tr><td>delivertarget</td><td>the target to call for recursive delivery</td>
+ <td>No. No recursive delivery is done by default</td></tr>
+ <tr><td>settingsRef</td><td>A reference to the ivy settings that must be used by this task <span class="since">(since 2.0)</span></td><td>No, 'ivy.instance' is taken by default.</td></tr></tbody>
+</table>
+<h1>Examples</h1>
+<code type="xml">
+<ivy:publish resolver="local" pubrevision="1.0">
+ <artifacts pattern="1/[artifact].[ext]" />
+ <artifacts pattern="2/[artifact].[ext]" />
+</ivy:publish>
+</code>
+Publishes the last resolved module in the local resolver with revision 1.0, looking for artifacts in directories 1 and 2.
+ </textarea>
+<script type="text/javascript">xooki.postProcess();</script>
+</body>
+</html>
Propchange: incubator/ivy/core/trunk/doc/use/publish.html
------------------------------------------------------------------------------
svn:eol-style = native
Added: incubator/ivy/core/trunk/doc/use/report.html
URL: http://svn.apache.org/viewvc/incubator/ivy/core/trunk/doc/use/report.html?view=auto&rev=553243
==============================================================================
--- incubator/ivy/core/trunk/doc/use/report.html (added)
+++ incubator/ivy/core/trunk/doc/use/report.html Wed Jul 4 08:41:45 2007
@@ -0,0 +1,98 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.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 License.
+-->
+<html>
+<head>
+ <META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=ISO-8859-1">
+ <script type="text/javascript">var xookiConfig = {level: 1};</script>
+ <script type="text/javascript" src="../xooki/xooki.js"></script>
+</head>
+<body>
+ <textarea id="xooki-source">
+Generates reports of dependency resolving. One report per configuration is generated, but all reports generated together are hyperlinked one to each other.
+
+This task should be used only after a call to resolve, even if the call was not done during the same ant build.
+In fact, this task uses xml report generated by resolve in cache. So if you call resolve on a module for a given configuration, you can call report safely on this module and this configuration as long as you do not clean your ivy cache.
+
+If you want to have an idea of what reports look like, check this very simple <a href="../../samples/jayasoft-ivyrep-example-default.html">example</a>.
+The task also generates a graphml file which can be loaded with the free <a href="http://www.yworks.com/en/products_yed_about.htm">yEd</a> graph editor.
+Then following a few <a href="../../doc/yed.html">simple steps</a> you can obtain a graph like this <a href="../../samples/jayasoft-ivyrep-example-default.jpg">one</a>.
+
+<div class="since">since 1.4</div> If a custom XSL is specified, it's possible to specify additional parameters to the stylesheet.
+
+<table class="ant">
+<thead>
+ <tr><th class="ant-att">Attribute</th><th class="ant-desc">Description</th><th class="ant-req">Required</th></tr>
+</thead>
+<tbody>
+ <tr><td>todir</td><td>the directory to which reports should be generated</td>
+ <td>No, defaults to ${ivy.report.todir}, or execution directory if not defined</td></tr>
+ <tr><td>outputpattern</td><td>the generated report names pattern</td>
+ <td>No, defaults to ${ivy.report.output.pattern}, or [organisation]-[module]-[conf].[ext] if not defined</td></tr>
+ <tr><td>xsl</td><td>true to generate a report (by default html report) using xslt, false otherwise <span class="since">since 1.3</span></td>
+ <td>No, defaults to true</td></tr>
+ <tr><td>xml</td><td>true to generate a xml report, false otherwise <span class="since">since 1.3</span></td>
+ <td>No, defaults to false</td></tr>
+ <tr><td>graph</td><td>true to generate graphml files, false otherwise</td>
+ <td>No, defaults to true</td></tr>
+ <tr><td>dot</td><td>true to generate <a href="http://www.graphviz.org/">graphviz dot</a> files, false otherwise <span class="since">since 1.4</span></td>
+ <td>No, defaults to false</td></tr>
+ <tr><td>conf</td><td>a comma separated list of the configurations for which a report should be generated</td>
+ <td>No. Defaults to the configurations resolved by the last resolve call (during same ant build), or ${ivy.resolved.configurations} if no resolve was called</td></tr>
+ <tr><td>organisation</td><td>the name of the organisation of the module for which report should be generated</td>
+ <td>No, unless no resolve was called during the build. Defaults to last resolved module organisation.</td></tr>
+ <tr><td>module</td><td>the name of the module for which report should be generated</td>
+ <td>No, unless no resolve was called during the build. Defaults to last resolved module.</td></tr>
+ <tr><td>validate</td><td>true to force ivy files validation against ivy.xsd, false to force no validation</td>
+ <td>No. Defaults to default ivy value (as configured in configuration file)</td></tr>
+ <tr><td>xslfile</td><td>indicates which xsl file should be used to generate the report</td>
+ <td>No, defaults to ivy provided xsl which generates html report</td></tr>
+ <tr><td>settingsRef</td><td>A reference to the ivy settings that must be used by this task <span class="since">(since 2.0)</span></td><td>No, 'ivy.instance' is taken by default.</td></tr></tbody>
+</table>
+
+<h1>Examples</h1>
+To generate a HTML and graphml report:
+<code type="xml">
+<report conf="compile" />
+</code>
+
+<hr/>
+To generate a HTML report only:
+<code type="xml">
+<report conf="compile" graph="false" />
+</code>
+
+<hr/>
+To generate an XML report using a custom stylesheet:
+<code type="xml">
+<report conf="compile" xslfile="my-custom-stylesheet.xsl" xslext="xml" />
+</code>
+
+To generate an XML report using a custom stylesheet which needs some parameters:
+<code type="xml">
+<report conf="compile" xslfile="my-custom-stylesheet.xsl" xslext="xml">
+ <param name="param1" expression="value1" />
+ <param name="param2" expression="value2" />
+</report>
+</code>
+
+ </textarea>
+<script type="text/javascript">xooki.postProcess();</script>
+</body>
+</html>
Propchange: incubator/ivy/core/trunk/doc/use/report.html
------------------------------------------------------------------------------
svn:eol-style = native
Added: incubator/ivy/core/trunk/doc/use/repreport.html
URL: http://svn.apache.org/viewvc/incubator/ivy/core/trunk/doc/use/repreport.html?view=auto&rev=553243
==============================================================================
--- incubator/ivy/core/trunk/doc/use/repreport.html (added)
+++ incubator/ivy/core/trunk/doc/use/repreport.html Wed Jul 4 08:41:45 2007
@@ -0,0 +1,114 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.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 License.
+-->
+<html>
+<head>
+ <META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=ISO-8859-1">
+ <script type="text/javascript">var xookiConfig = {level: 1};</script>
+ <script type="text/javascript" src="../xooki/xooki.js"></script>
+</head>
+<body>
+ <textarea id="xooki-source">
+Generates reports about dependencies among several modules in the repository (repreport stands for repository report).<span class="since">since 1.4</span>
+
+This task is similar to the [[ant:report]] task, except that instead of working on a single module you just resolved, it works with a set of modules in your repository.
+
+Note that the set of modules for which you generate the report is determined by setting organisation module and revision and using a matcher, but also by the dependencies of these modules. No dependency is excluded.
+
+Usually the most useful report is a graph, you can generate either a graphml file that you can then easily <a href="../../doc/yed.html">layout using yEd</a>, or a dot file which is the format recognized by graphviz, which is a free tool which does automatic graph layout, and can thus be used to generate automatically a GIF or PNG of the dependencies between all your modules.
+
+<table class="ant">
+<thead>
+ <tr><th class="ant-att">Attribute</th><th class="ant-desc">Description</th><th class="ant-req">Required</th></tr>
+</thead>
+<tbody>
+ <tr><td>organisation</td><td>A pattern matching the organisation of the modules for which the report should be generated</td>
+ <td>No, defaults to '*'</td></tr>
+ <tr><td>module</td><td>A pattern matching the name of the modules for which the report should be generated</td>
+ <td>No, defaults to '*'</td></tr>
+ <tr><td>branch</td><td>The name of the branch of the modules for which the report should be generated</td>
+ <td>No, defaults to no branch specified</td></tr>
+ <tr><td>revision</td><td>The revision of the modules for which the report should be generated. Only one revision per module will be used, so most of the time keeping the default (latest.integration) is the best thing to do, because it's not very easy to specify only one revision for several modules.</td>
+ <td>No, defaults to 'latest.integration'</td></tr>
+ <tr><td>todir</td><td>the directory to which reports should be generated</td>
+ <td>No, defaults to execution directory</td></tr>
+ <tr><td>outputname</td><td>the name to use for the generate file (without extension)</td>
+ <td>No, defaults to ivy-repository-report</td></tr>
+ <tr><td>xml</td><td>true to generate a xml report, false otherwise</td>
+ <td>No, defaults to true</td></tr>
+ <tr><td>xsl</td><td>true to generate a report using xslt, false otherwise</td>
+ <td>No, defaults to false</td></tr>
+ <tr><td>xslfile</td><td>indicates which xsl file should be used to generate the report</td>
+ <td>Yes if you want to use xsl transformation</td></tr>
+ <tr><td>xslext</td><td>indicates the extension to use when generating report using xsl</td>
+ <td>No defaults to 'html'</td></tr>
+ <tr><td>graph</td><td>true to generate graphml file, false otherwise</td>
+ <td>No, defaults to false</td></tr>
+ <tr><td>dot</td><td>true to generate graphviz dot format file, false otherwise</td>
+ <td>No, defaults to false</td></tr>
+ <tr><td>matcher</td><td>the name of the matcher to use for matching modules names and organisations in your repository</td>
+ <td>No. Defaults to exactOrRegexp</td></tr>
+ <tr><td>validate</td><td>true to force ivy files validation against ivy.xsd, false to force no validation</td>
+ <td>No. Defaults to default ivy value (as configured in configuration file)</td></tr>
+ <tr><td>settingsRef</td><td>A reference to the ivy settings that must be used by this task <span class="since">(since 2.0)</span></td><td>No, 'ivy.instance' is taken by default.</td></tr></tbody>
+</table>
+
+<h1>Examples</h1>
+To generate a xml report for all the latest versions of all the modules in your repository:
+<code type="xml">
+<ivy:repreport />
+</code>
+
+<hr/>
+To generate a graphml report for all the latest versions of all the modules in your repository:
+<code type="xml">
+<ivy:repreport xml="false" graph="true" />
+</code>
+
+<hr/>
+To generate a xml report for all the latest versions of the modules from the organisation foo in your repository:
+<code type="xml">
+<ivy:repreport organisation="foo" />
+</code>
+
+<hr/>
+To generate a xml report for all the versions on the 1.x stream of the modules named bar* from the organisation foo in your repository:
+<code type="xml">
+<ivy:repreport organisation="foo" module="bar*" revision="1.+" matcher="glob" />
+</code>
+
+<hr/>
+To generate an XML report using a custom stylesheet:
+<code type="xml">
+<ivy:repreport xsl="true" xslfile="my-custom-stylesheet.xsl" xslext="xml" />
+</code>
+
+<hr/>
+To generate an XML report using a custom stylesheet which needs some parameters:
+<code type="xml">
+<ivy:repreport xsl="true" xslfile="my-custom-stylesheet.xsl" xslext="xml">
+ <param name="param1" expression="value1" />
+ <param name="param2" expression="value2" />
+</report>
+</code>
+
+ </textarea>
+<script type="text/javascript">xooki.postProcess();</script>
+</body>
+</html>
Propchange: incubator/ivy/core/trunk/doc/use/repreport.html
------------------------------------------------------------------------------
svn:eol-style = native
Added: incubator/ivy/core/trunk/doc/use/resolve.html
URL: http://svn.apache.org/viewvc/incubator/ivy/core/trunk/doc/use/resolve.html?view=auto&rev=553243
==============================================================================
--- incubator/ivy/core/trunk/doc/use/resolve.html (added)
+++ incubator/ivy/core/trunk/doc/use/resolve.html Wed Jul 4 08:41:45 2007
@@ -0,0 +1,151 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.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 License.
+-->
+<html>
+<head>
+ <META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=ISO-8859-1">
+ <script type="text/javascript">var xookiConfig = {level: 1};</script>
+ <script type="text/javascript" src="../xooki/xooki.js"></script>
+</head>
+<body>
+ <textarea id="xooki-source">
+The resolve task actually resolve dependencies described in an <a href="../../doc/ivyfile.html">ivy file</a>, and put the resolved dependencies in the ivy cache.
+If configure has not been called before resolve is called, a default configuration will be used (equivalent to call configure with no attributes).
+
+After the call to this task, four properties are set in ant:
+<ul>
+<li>ivy.organisation</li>
+set to the organisation name found in the ivyfile which was used for resolve
+<li>ivy.module</li>
+set to the module name found in the ivyfile which was used for resolve
+<li>ivy.revision</li>
+set to the revision name found in the ivyfile which was used for resolve, or a generated revision name if no revision was specified in the file
+<li>ivy.resolved.configurations</li>
+set to the comma separated list of configurations resolved
+</ul>
+<b>Since 1.2:</b>
+An additional property is set to true if the resolved dependencies are changes since the last resolve, and to false otherwise: <code>ivy.deps.changed</code>
+
+<b>Since 2.0:</b>
+In addition, if the <i>resolveId</i> attribute has been set, the following properties are set as well:
+<ul>
+<li>ivy.organisation.${resolveId}</li>
+<li>ivy.module.${resolveId}</li>
+<li>ivy.revision.${resolveId}</li>
+<li>ivy.resolved.configurations.${resolveId}</li>
+<li>ivy.deps.changed.${resolveId}</li>
+</ul>
+
+When ivy has finished the resolve task, it outputs a summary of what has been resolved. This summary looks like this:
+<pre>
+---------------------------------------------------------------------
+| | modules || artifacts |
+| conf | number| search|dwnlded|evicted|| number|dwnlded|
+---------------------------------------------------------------------
+| default | 4 | 0 | 0 | 0 || 4 | 0 |
+---------------------------------------------------------------------
+</pre>
+This table gives some statistics about the dependency resolution. Each line correspond to a configuration resolved. Then the table is divided in two parts:
+<ul>
+<li>modules</li>
+<ul>
+<li>number</li>
+This is the total number of dependency modules resolved in this configuration, including transitive ones
+<li>search</li>
+This is the number of dependency modules that required a repository access. The repository access is needed if the module is not yet in cache, or if a latest version is required, or in some other cases (depending on checkModified, for instance)
+<li>dwnlded</li>
+This is the number of dependency ivy files downloaded from the repository. This number can be less than the total number of modules even with a clean cache, if no ivy file is provided for some dependencies.
+<li>evicted</li>
+This is the number of dependency module evicted by conflict managers.
+</ul>
+<li>artifacts</li>
+<ul>
+<li>number</li>
+This is the total number of artifacts resolved in the given configuration.
+<li>dwnlded</li>
+This is the number of artifacts actually downloaded from the repository.
+</ul>
+</ul>
+
+<span class="since">since 1.4</span> A new inline mode allow to call a resolve without an ivy file, by setting directly the module which should be resolved from the repository. It is particularly useful to install released software, like an ant task for example. When inline is set to true, the organisation module and revision attributes are used to specify which module should be resolved from the repository.
+
+<i>Note for developers:
+After the call to this task, a reference to the module descriptor resolved is put in the ant project under the id <code>"ivy.resolved.descriptor"</code>.</i>
+
+<table class="ant">
+<thead>
+ <tr><th class="ant-att">Attribute</th><th class="ant-desc">Description</th><th class="ant-req">Required</th></tr>
+</thead>
+<tbody>
+ <tr><td>file</td><td>path to the ivy file to use for resolution</td>
+ <td>No. Defaults to ${ivy.dep.file} or nothing in inline mode</td></tr>
+ <tr><td>conf</td><td>a comma separated list of the configurations to resolve</td><td>No. Defaults to ${ivy.configurations}</td></tr>
+ <tr><td>useOrigin</td><td>true to avoid the copy of local artifacts to the cache and use directly their original location, false otherwise <span class="since">since 1.4</span>.
+To know if an artifact is local ivy asks to the resolver. Only filesystem resolver is considered local by default, but this can be disabled if you want to force the copy on one filesystem resolver and use the original location on another. Note that it is safe to use useOrigin even if you some no local resolvers, Ivy will behave as usual in this case. Note also that this only applies to artifacts, not to ivy files, which are still copied in the cache.</td><td>No. defaults to false</td></tr>
+ <tr><td>inline</td><td>true to use inline mode, false to resolve an ivy file <span class="since">since 1.4</span></td><td>No. defaults to false</td></tr>
+ <tr><td>organisation</td><td>the organisation of the module to resolve in inline mode <span class="since">since 1.4</span></td><td>Yes in inline mode, no otherwise.</td></tr>
+ <tr><td>module</td><td>the name of the module to resolve in inline mode <span class="since">since 1.4</span></td><td>Yes in inline mode, no otherwise.</td></tr>
+ <tr><td>revision</td><td>the revision constraint to apply to the module to resolve in inline mode <span class="since">since 1.4</span></td><td>No. Defaults to "latest.integration" in inline mode, nothing in standard mode.</td></tr>
+ <tr><td>type</td><td>comma separated list of accepted artifact types (<span class="since">since 1.2</span>)</td><td>No. defaults to ${ivy.resolve.default.type.filter}</td></tr>
+ <tr><td>haltonfailure</td><td>true to halt the build on ivy failure, false to continue</td><td>No. Defaults to true</td></tr>
+ <tr><td>failureproperty</td><td>the name of the property to set if the resolve failed <span class="since">since 1.4</span></td><td>No. No property is set by default.</td></tr>
+ <tr><td>transitive</td><td>true to resolve dependencies transitively, false otherwise <span class="since">since 1.4</span></td><td>No. Defaults to true</td></tr>
+ <tr><td>showprogress</td><td>true to show dots while downloading, false otherwise</td><td>No. Defaults to true</td></tr>
+ <tr><td>validate</td><td>true to force ivy files validation against ivy.xsd, false to force no validation</td><td>No. Defaults to default ivy value (as configured in configuration file)</td></tr>
+ <tr><td>settingsRef</td><td>A reference to the ivy settings that must be used by this task <span class="since">(since 2.0)</span></td><td>No, 'ivy.instance' is taken by default.</td></tr>
+ <tr><td>resolveId</td><td>An id which can be used later to refer to the results of this resolve <span class="since">(since 2.0)</span></td><td>No, defaults to '[org]-[module]'.</td></tr>
+</tbody>
+</table>
+<h1>Examples</h1>
+<code type="xml">
+<ivy:resolve file="path/to/ivy.xml"/>
+</code>
+Resolve all dependencies declared in path/to/ivy.xml file.
+
+<hr/>
+
+<code type="xml">
+<ivy:resolve file="path/to/ivy.xml" transitive="false" />
+</code>
+Same as above, but with transitive dependencies disabled.
+
+<hr/>
+
+<code type="xml">
+<ivy:resolve file="path/to/ivy.xml" conf="default, test"/>
+</code>
+Resolve the dependencies declared in the configuration default and test of the path/to/ivy.xml file.
+
+<hr/>
+
+<code type="xml">
+<ivy:resolve file="path/to/ivy.xml" type="jar"/>
+</code>
+Resolve all dependencies declared in path/to/ivy.xml file, but download only jar artifacts.
+
+<hr/>
+<code type="xml">
+<ivy:resolve organisation="apache" module="commons-lang" revision="2+" inline="true" />
+</code>
+Resolve the commons-lang module revision 2+ from the repository, with its dependencies.
+
+ </textarea>
+<script type="text/javascript">xooki.postProcess();</script>
+</body>
+</html>
Propchange: incubator/ivy/core/trunk/doc/use/resolve.html
------------------------------------------------------------------------------
svn:eol-style = native
Added: incubator/ivy/core/trunk/doc/use/retrieve.html
URL: http://svn.apache.org/viewvc/incubator/ivy/core/trunk/doc/use/retrieve.html?view=auto&rev=553243
==============================================================================
--- incubator/ivy/core/trunk/doc/use/retrieve.html (added)
+++ incubator/ivy/core/trunk/doc/use/retrieve.html Wed Jul 4 08:41:45 2007
@@ -0,0 +1,137 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.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 License.
+-->
+<html>
+<head>
+ <META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=ISO-8859-1">
+ <script type="text/javascript">var xookiConfig = {level: 1};</script>
+ <script type="text/javascript" src="../xooki/xooki.js"></script>
+</head>
+<body>
+ <textarea id="xooki-source">
+The retrieve task copies resolved dependencies anywhere you want in your file system.
+
+This is a [[ant:postresolvetask post resolve task]], with all the behaviour and attributes common to all post resolve tasks.
+
+<span class="since">since 1.4</span> This task can even be used to synchronize the destination directory with what should actually be in according to the dependency resolution. This means that by setting sync="true", Ivy will not only copy the necessary files, but it will also remove the files which do not need to be there.
+
+The synchronisation actually consists in deleting all filles and directories in the root destination directory which are not required by the retrieve.
+
+The root destination directory is the the directory denoted by the first level up the first token in the destination pattern.
+Example:
+pattern: lib/[conf]/[artifact].[ext]
+root: lib
+
+<span class="since">since 1.4</span> The behaviour is like this when 'useOrigin=true':
+<ul>
+<li>if the artifact is not local, the location from within the cache is used</li>
+<li>if the artifact is a local artifact, it's original location is used</li>
+</ul>
+Note that if resolve has been called separately, the copy to the cache may have occur normally if useOrigin was not set when calling [[ant:resolve]]. If resolve has not been called, it will be called automatically with useOrigin set to the value specified on this task.
+
+<table class="ant">
+<thead>
+ <tr><th class="ant-att">Attribute</th><th class="ant-desc">Description</th><th class="ant-req">Required</th></tr>
+</thead>
+<tbody>
+ <tr><td>pattern</td><td>the pattern to use to copy the dependencies</td>
+ <td>No. Defaults to ${ivy.retrieve.pattern}</td></tr>
+ <tr><td>ivypattern</td><td>the pattern to use to copy the ivy files of dependencies <span class="since">since 1.3</span></td>
+ <td>No. Dependencies ivy files are not retrieved by default.</td></tr>
+ <tr><td>conf</td><td>a comma separated list of the configurations to retrieve</td>
+ <td>No. Defaults to the configurations resolved by the last resolve call, or * if no resolve was explicitly called</td></tr>
+ <tr><td>sync</td><td>true to synchronize the destination, false to just make a copy <span class="since">since 1.4</span></td>
+ <td>No. Defaults to false</td></tr>
+ <tr><td>type</td><td>comma separated list of accepted artifact types <span class="since">since 1.4</span></td>
+ <td>No. All artifact types are accepted by default.</td></tr>
+ <tr><td>useOrigin</td><td>true to copy artifacts from their original location for local artifacts, false to use only cache locations <span class="since">since 1.4</span></td>
+ <td>No. Defaults to false</td></tr>
+ <tr><td>settingsRef</td><td>A reference to the ivy settings that must be used by this task <span class="since">(since 2.0)</span></td><td>No, 'ivy.instance' is taken by default.</td></tr></tbody>
+</table>
+<h1>Examples</h1>
+<code type="xml">
+<ivy:retrieve />
+</code>
+Retrieves dependencies using default parameters. This usually retrieves all the dependencies of the last resolve call to a lib directory.
+
+<hr/>
+<code type="xml">
+<ivy:retrieve pattern="${lib.dir}/[conf]/[artifact].[ext]"/>
+</code>
+Retrieves all dependencies of the last resolve call to a lib directory, dependencies being separated in directories named by configuration, each conf directory containing corresponding artifacts without the revision.
+For instance, if the ivy file declares two configurations default and test, the resulting lib dir could look like this:
+<code>
+lib
+ default
+ commons-lang.jar
+ commons-logging.jar
+ test
+ junit.jar
+</code>
+Note that if a dependency is required in the two configurations, it will be copied in the two directories. The download of the dependency is however only made once at resolve time.
+
+<hr/>
+<code type="xml">
+<ivy:retrieve pattern="${lib.dir}/[conf]/[artifact].[ext]" sync="true" />
+</code>
+Same as before, but with synchronisation enabled.
+
+For instance, if the ivy file declares two configurations default and test, the resulting lib dir could look like this:
+<code>
+lib
+ default
+ commons-lang.jar
+ commons-logging.jar
+ test
+ junit.jar
+</code>
+And now suppose commons-logging is no longer part of the dependencies of the default configuration, then a new call to retrieve will result in:
+<code>
+lib
+ default
+ commons-lang.jar
+ test
+ junit.jar
+</code>
+With no synchronisation, commons-logging would not have been removed by the call.
+
+<hr/>
+<code type="xml">
+<ivy:retrieve pattern="${lib.dir}/[type]/[artifact]-[revision].[ext]" conf="runtime"/>
+</code>
+Retrieves only the dependencies of the <code>runtime</code> configuration in directories named by artifact type. The resulting lib dir could look like this:
+<code>
+lib
+ jar
+ commons-lang-1.0.jar
+ looks-1.1.jar
+ source
+ looks-1.1.zip
+</code>
+
+
+<hr/>
+<code type="xml">
+<ivy:retrieve organisation="foo" module="bar" inline="true" pattern="${my.install.dir}/[artifact].[ext]"/>
+</code>
+Resolves and retrieve the latest version of the module bar and its dependencies in the directory pointed by ${my.install.dir}.
+ </textarea>
+<script type="text/javascript">xooki.postProcess();</script>
+</body>
+</html>
Propchange: incubator/ivy/core/trunk/doc/use/retrieve.html
------------------------------------------------------------------------------
svn:eol-style = native
Added: incubator/ivy/core/trunk/doc/use/settings.html
URL: http://svn.apache.org/viewvc/incubator/ivy/core/trunk/doc/use/settings.html?view=auto&rev=553243
==============================================================================
--- incubator/ivy/core/trunk/doc/use/settings.html (added)
+++ incubator/ivy/core/trunk/doc/use/settings.html Wed Jul 4 08:41:45 2007
@@ -0,0 +1,86 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.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 License.
+-->
+<html>
+<head>
+ <script type="text/javascript">var xookiConfig = {level: 1};</script>
+ <script type="text/javascript" src="../xooki/xooki.js"></script>
+</head>
+<body>
+ <textarea id="xooki-source">
+<span class="since">(since 2.0)</span>
+
+The settings declaration is used to configure ivy with an xml settings file.<br/><br/>
+
+See <a href="../../doc/doc/configuration.html">Settings Files</a> for details about the settings file itself.<br/><br/>
+
+Multiple settings can be defined in a build script. Every task can reference his own settings.<br/><br/>
+
+<table class="ant">
+<thead>
+ <tr><th class="ant-att">Attribute</th><th class="ant-desc">Description</th><th class="ant-req">Required</th></tr>
+</thead>
+<tbody>
+ <tr><td>id</td><td>The settings id useable in the refId attributes of the ivy task that needs a setting. Note that the ivy tasks will search by default for the settings with the id "ivy.instance".</td><td>Yes</td></tr>
+ <tr><td>file</td><td>path to the settings file to use</td>
+ <td rowspan="2">No. If a file is provided, url is ignored. If none are provided, then it attempts to find a file at ${ivy.settings.file}, and if this file does not exist, it uses a <a href="../tutorial/defaultconf.html">default settings file</a></td></tr>
+ <tr><td>url</td><td>url of the settings file to use</td></tr>
+ <tr><td>host</td><td>http authentication host</td><td rowspan="4">No, unless authentication is required</td></tr>
+ <tr><td>realm</td><td>http authentication realm</td></tr>
+ <tr><td>username</td><td>http authentication user name</td></tr>
+ <tr><td>passwd</td><td>http authentication password</td></tr>
+</tbody>
+</table>
+<h2>HTTP Authentication</h2>
+<i>Note: HTTP Authentication can be used only if <a href="http://jakarta.apache.org/commons/httpclient/">commons-httpclient.jar</a> is in your classpath</i>
+If any of the url you use in ivy (especially in dependency resolvers) need http
+authentication, then you have to provide the host, realm, username and passwd
+attributes of the configure task. These settings will then be used in any
+further call to ivy tasks.<br/><br/>
+
+<h2>Multiple classloader</h2>
+A special attention should be applied when you have a multi-project build with <i>subant</i> call, using ivy task loaded by a <i>typedef</i>. Indeed in this situation, it is possible to pass settings reference to a subbuild. When you do that, you should take of the classloader. The ivy task of your subant should not be defined in a different classloader than the parent one. This can be achieved by using the <i>loader</i> parameter of the antlib declaration, or avoid to reload the ivy antlib in the subbuild (place the taskdef in a target only executed when the antlib is not yet loaded).<br/><br/>
+
+
+<h2>Examples</h2>
+<h3>Simplest settings</h3>
+<code><ivy:settings id="ivy.instance"/></code>
+Use either ${ivy.settings.file} if it exists, or the <a href="./misc/ivy/samples/ivysettings-default.xml">default settings file</a><br>
+This simplest setting is implicit.
+<h3>Configure with a file</h3>
+<code><ivy:settings id="ivy.instance" file="mysettings.xml" /></code>
+<h3>Configure with an url</h3>
+<code><ivy:settings id="ivy.instance" url="http://mysite.com/mysettings.xml" /></code>
+<h3>Configure multiple URLs which require autentication</h3>
+<code>
+<ivy:settings id="authenticated.settings" file="path/to/my/ivysettings.xml">
+ <credentials host="myhost.com" realm="My Realm" username="myuser" passwd="mypasswd" />
+ <credentials host="yourhost.com" realm="Your Realm" username="myuser" passwd="myotherpasswd" />
+</ivy:configure>
+</code>
+<h3>Configure 2 different settings</h3>
+You can use multiple ivy settings during a build. In that case, every ivy task has specify the settings that it mmust use.
+<code>
+ <ivy:settings id="ivy.normal.settings" file="normal_settings.xml" />
+ <ivy:settings id="ivy.release.settings" file="release_settings.xml" />
+</code>
+</textarea>
+<script type="text/javascript">xooki.postProcess();</script>
+</body>
+</html>
Propchange: incubator/ivy/core/trunk/doc/use/settings.html
------------------------------------------------------------------------------
svn:eol-style = native
Added: incubator/ivy/core/trunk/doc/use/var.html
URL: http://svn.apache.org/viewvc/incubator/ivy/core/trunk/doc/use/var.html?view=auto&rev=553243
==============================================================================
--- incubator/ivy/core/trunk/doc/use/var.html (added)
+++ incubator/ivy/core/trunk/doc/use/var.html Wed Jul 4 08:41:45 2007
@@ -0,0 +1,57 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.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 License.
+-->
+<html>
+<head>
+ <META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=ISO-8859-1">
+ <script type="text/javascript">var xookiConfig = {level: 1};</script>
+ <script type="text/javascript" src="../xooki/xooki.js"></script>
+</head>
+<body>
+ <textarea id="xooki-source">
+Sets a variable (by name and value), or set of variables (from file or url) in ivy. <br/>
+Variables are case sensitive.<br/><br/>
+Contrary to ant properties, ivy variables are mutable. But a problem with this is that you do not control when
+variables are substituted, and usually it is done as soon as possible. So changing the value of a variable will
+have no effect if it has already been substituted. Consequently, <b>using this task is NOT recommended</b>.
+See <a href="../../doc/reference.html">reference</a> page for details about ivy variables.
+<br/><br/>
+
+<table class="ant">
+<thead>
+ <tr><th class="ant-att">Attribute</th><th class="ant-desc">Description</th><th class="ant-req">Required</th></tr>
+</thead>
+<tbody>
+ <tr><td>name</td><td>the name of the variable to set</td>
+ <td>No</td></tr>
+ <tr><td>value</td><td>the value of the variable to set</td>
+ <td>Yes when using the name attribute</td></tr>
+ <tr><td>file</td><td>the filename of the property file to load as ivy variables</td>
+ <td rowspan="2">One of these, when <b>not</b> using the name attribute</td></tr>
+ <tr><td>url</td><td>the url from which to read ivy variables</td></tr>
+ <tr><td>prefix</td><td>Prefix to apply to variables. A "." is appended to the prefix if not specified.</td>
+ <td>No</td></tr>
+ <tr><td>settingsRef</td><td>A reference to the ivy settings that must be used by this task <span class="since">(since 2.0)</span></td><td>No, 'ivy.instance' is taken by default.</td></tr>
+</tbody>
+</table>
+
+ </textarea>
+<script type="text/javascript">xooki.postProcess();</script>
+</body>
+</html>
Propchange: incubator/ivy/core/trunk/doc/use/var.html
------------------------------------------------------------------------------
svn:eol-style = native
Added: incubator/ivy/core/trunk/doc/yed.html
URL: http://svn.apache.org/viewvc/incubator/ivy/core/trunk/doc/yed.html?view=auto&rev=553243
==============================================================================
--- incubator/ivy/core/trunk/doc/yed.html (added)
+++ incubator/ivy/core/trunk/doc/yed.html Wed Jul 4 08:41:45 2007
@@ -0,0 +1,67 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.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 License.
+-->
+<html>
+<head>
+ <META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=ISO-8859-1">
+ <script type="text/javascript">var xookiConfig = {level: 0};</script>
+ <script type="text/javascript" src="xooki/xooki.js"></script>
+</head>
+<body>
+ <textarea id="xooki-source">
+<a href="http://www.yworks.com/en/products_yed_about.htm">yEd</a> is a free graph editor, benefiting from
+all the automatic layouts of yFiles. Ivy is able to generate graphs which are readable by yEd.
+
+The graphs generated by ivy are not layed out (in fact it's why we use yEd), so you have to follow a simple sequence of steps to layout the generated graphs.
+
+<h2>Preparation</h2>
+First you have to generate a graphml file. Simply call the report task (see <a href="../doc/use.html">ivy use documentation</a>) for that.
+
+<h2>Step 1: open the graphml file</h2>
+Launch yEd editor, and open the graphml file generated by the report task. You should obtain something like this:
+<center>
+<img src="../images/yed-step1.jpg"/><br/>
+</center>
+
+<h2>Step 2: ask yEd to adjust nodes size</h2>
+<center>
+<img src="../images/yed-step2.jpg"/><br/>
+<img src="../images/yed-step3.jpg"/><br/>
+<img src="../images/yed-step3-2.jpg"/><br/>
+</center>
+
+<h2>Step 3: ask yEd to layout nodes</h2>
+<center>
+<img src="../images/yed-step4.jpg"/><br/>
+<img src="../images/yed-step5.jpg"/><br/>
+<img src="../images/yed-step6.jpg"/><br/>
+
+That's all, you should have obtained something like this:
+
+<img src="../images/yed-step7.jpg"/><br/>
+
+Note that this is only one possibility, test the available layouts yourself, you could find one better in your case.
+Once you have layed out the graph, you can either save it with in the same file (but be warned that it will be overwritten at next ivy report call), or another file, export it to jpg, gif, svg, etc. (see <a href="http://www.yworks.com/en/products_yed_about.htm">yEd</a> site for details).
+</center>
+
+
+ </textarea>
+<script type="text/javascript">xooki.postProcess();</script>
+</body>
+</html>
Propchange: incubator/ivy/core/trunk/doc/yed.html
------------------------------------------------------------------------------
svn:eol-style = native