svn commit: r781856 - /ant/ivy/site/ivyde/faq.html

[hi...@apache.org]

Author: hibou
Date: Thu Jun  4 21:27:22 2009
New Revision: 781856

URL: http://svn.apache.org/viewvc?rev=781856&view=rev
Log:
IVYDE-139: add the doc about the setup of common-vfs into Eclipse

Modified:
    ant/ivy/site/ivyde/faq.html

Modified: ant/ivy/site/ivyde/faq.html
URL: http://svn.apache.org/viewvc/ant/ivy/site/ivyde/faq.html?rev=781856&r1=781855&r2=781856&view=diff
==============================================================================
--- ant/ivy/site/ivyde/faq.html (original)
+++ ant/ivy/site/ivyde/faq.html Thu Jun  4 21:27:22 2009
@@ -32,6 +32,7 @@
    <li><a href="#wtp">How can I make IvyDE contribute to the classpath used by WTP when launching my web application ?</a>
    <li><a href="#xerces">Parsing ivy file fails in IvyDE while it succeeds in Ant</a>
    <li><a href="#norepo">Updating IvyDE fails with "no repository found containing [...]"</a>
+   <li><a href="#vfs">Using the common-vfs capability of Ivy inside Eclipse</a>
 </ol>
 
 <br/>
@@ -87,6 +88,34 @@
 
 The workaround is to remove the failing updatesite from the list of sites in the Update Manager. Then add it again (no need to restart Eclipse). You can now update Ivy or IvyDE successfully.
 
+<h2><a name="vfs"></a>Using some extra capability of Ivy (like common-vfs) inside Eclipse</h2>
+
+If you are using some common-vfs capability of Ivy, some setup is needed.
+
+When working with ant, basically you just install the common-vfs jar into the lib directory of ant. It is quite similar under Eclipse, but this jar needs to be OSGI capable. So here is a list of jar of the Ivy dependencies which have been repackaged to be deployed in an OSGi environment:
+<ul>
+    <li>Apache Common VFS 1.0: http://repo1.maven.org/maven2/org/apache/servicemix/bundles/org.apache.servicemix.bundles.commons-vfs/1.0_1/org.apache.servicemix.bundles.commons-vfs-1.0_1.jar </li>
+    <li>Apache Commons Httpclient 3.1: http://download.eclipse.org/tools/orbit/downloads/drops/S20090529135407/bundles/org.apache.commons.httpclient_3.1.0.v20080605-1935.jar </li>
+    <li>Apache Commons Codec 1.3.0: http://download.eclipse.org/tools/orbit/downloads/drops/S20090529135407/bundles/org.apache.commons.codec_1.3.0.v20080530-1600.jar </li>
+    <li>Apache Oro 2.0.8: http://download.eclipse.org/tools/orbit/downloads/drops/S20090529135407/bundles/org.apache.oro_2.0.8.v200903061218.jar </li>
+    <li>Apache Commons Logging 1.1.1: http://download.eclipse.org/tools/orbit/downloads/drops/S20090529135407/bundles/org.apache.commons.logging_1.1.1.v200904062255.jar </li>
+    <li>Jcraft Jsch 0.1.41: http://download.eclipse.org/tools/orbit/downloads/drops/S20090529135407/bundles/com.jcraft.jsch_0.1.41.v200903070017.jar </li>
+</ul>
+
+<b>Installing the Ivy optional dependencies:</b>
+You just need to put the files into the <tt>plugins</tt> directory of your Eclipse install. And restart your Eclipse.
+If you are using Eclipse 3.4, you can prefer installing them into the <tt>dropins</tt> directory, so if you want to remove them later, they will be easier to find.
+Note also that some other plugins might bring one of the Ivy dependencies. So you probably don't have to install every Ivy dependency listed above, like Apache Commons Logging.
+
+<b>Important Note:</b> the links above are poiting to artifacts mostly not released by the Apache Software Fundation, so for licencing issues please refer to the hosting site.
+
+Note also that other versions exist of the suggested jar pointed by the links above. You may want to browse these sites to find the jars that fit your needs:
+<ul>
+    <li>Eclipse Orbit: http://download.eclipse.org/tools/orbit/downloads/ </li>
+    <li>OSGi repository: http://www.osgi.org/Repository/HomePage?cmd=browse&amp;keywords=commons&amp;submit=search </li>
+    <li>SpringSource Bundle Repository: http://www.springsource.com/repository/app/ </li>
+</ul>
+
 </textarea>
 <script type="text/javascript">xooki.postProcess();</script>
 </body>