You are viewing a plain text version of this content. The canonical link for it is here.
Posted to notifications@ant.apache.org by hi...@apache.org on 2012/04/12 20:09:10 UTC

svn commit: r1325416 - in /ant/ivy/core/trunk/doc: images/warning.png osgi.html osgi/eclipse-plugin.html osgi/standard-osgi.html osgi/target-platform.html

Author: hibou
Date: Thu Apr 12 18:09:09 2012
New Revision: 1325416

URL: http://svn.apache.org/viewvc?rev=1325416&view=rev
Log:
- Improvement of the doc about OSGI
- improve the message that it is experimental
- add TODOs

Added:
    ant/ivy/core/trunk/doc/images/warning.png   (with props)
Modified:
    ant/ivy/core/trunk/doc/osgi.html
    ant/ivy/core/trunk/doc/osgi/eclipse-plugin.html
    ant/ivy/core/trunk/doc/osgi/standard-osgi.html
    ant/ivy/core/trunk/doc/osgi/target-platform.html

Added: ant/ivy/core/trunk/doc/images/warning.png
URL: http://svn.apache.org/viewvc/ant/ivy/core/trunk/doc/images/warning.png?rev=1325416&view=auto
==============================================================================
Binary file - no diff available.

Propchange: ant/ivy/core/trunk/doc/images/warning.png
------------------------------------------------------------------------------
    svn:mime-type = image/png

Modified: ant/ivy/core/trunk/doc/osgi.html
URL: http://svn.apache.org/viewvc/ant/ivy/core/trunk/doc/osgi.html?rev=1325416&r1=1325415&r2=1325416&view=diff
==============================================================================
--- ant/ivy/core/trunk/doc/osgi.html (original)
+++ ant/ivy/core/trunk/doc/osgi.html Thu Apr 12 18:09:09 2012
@@ -28,9 +28,14 @@
 
 Since Apache Ivy™ 2.3, some support for OSGi™ dependency management has been introduced.
 
-<div class="notice">
+<table class="notice">
+  <tr>
+    <td style="vertical-align: top"><img src="images/warning.png" style="float:left;" /></td>
+    <td>
     Note that this feature is considered as <b>experimental</b>. It should work with simple configuration but may not in complex ones. If you have any issue with that feature, you are welcomed to come discussed your use case on the <a href="http://ant.apache.org/ivy/mailing-lists.html">ivy-user</a> mailing list, or discuss about implementation issues or improvement you may have found on <a href="http://ant.apache.org/ivy/mailing-lists.html">ant-dev</a>.
-</div>
+    </td>
+  </tr>
+</table>
 
 So with a standard ivy.xml, you can express some dependency on some OSGi bundle and every of their trasitive dependencies will be resolved. You can also declare in your ivy.xml some OSGi dependency, like a <tt>Require-Bundle</tt>, an <tt>Import-Package</tt> or an <tt>Import-Service</tt>, miming an OSGi MANIFEST.MF.
 

Modified: ant/ivy/core/trunk/doc/osgi/eclipse-plugin.html
URL: http://svn.apache.org/viewvc/ant/ivy/core/trunk/doc/osgi/eclipse-plugin.html?rev=1325416&r1=1325415&r2=1325416&view=diff
==============================================================================
--- ant/ivy/core/trunk/doc/osgi/eclipse-plugin.html (original)
+++ ant/ivy/core/trunk/doc/osgi/eclipse-plugin.html Thu Apr 12 18:09:09 2012
@@ -26,9 +26,14 @@
 <body>
 	<textarea id="xooki-source">
 
-<div class="notice">
-This documentation is describing the <b>experimental</b> OSGi capability of Ivy. It should work with simple configuration but may not in complex ones. If you have any issue with that feature, you are welcomed to come discussed your use case on the <a href="http://ant.apache.org/ivy/mailing-lists.html">ivy-user</a> mailing list, or discuss about implementation issues or improvement you may have found on <a href="http://ant.apache.org/ivy/mailing-lists.html">ant-dev</a>.
-</div>
+<table class="notice">
+  <tr>
+    <td style="vertical-align: top"><img src="../images/warning.png" style="float:left;" /></td>
+    <td>
+    Note that this feature is considered as <b>experimental</b>. It should work with simple configuration but may not in complex ones. If you have any issue with that feature, you are welcomed to come discussed your use case on the <a href="http://ant.apache.org/ivy/mailing-lists.html">ivy-user</a> mailing list, or discuss about implementation issues or improvement you may have found on <a href="http://ant.apache.org/ivy/mailing-lists.html">ant-dev</a>.
+    </td>
+  </tr>
+</table>
 
 This page describes how to build an Eclipse&#153; plugin with Apache Ivy&#153; and its OSGi&#153; capabilities.
 

Modified: ant/ivy/core/trunk/doc/osgi/standard-osgi.html
URL: http://svn.apache.org/viewvc/ant/ivy/core/trunk/doc/osgi/standard-osgi.html?rev=1325416&r1=1325415&r2=1325416&view=diff
==============================================================================
--- ant/ivy/core/trunk/doc/osgi/standard-osgi.html (original)
+++ ant/ivy/core/trunk/doc/osgi/standard-osgi.html Thu Apr 12 18:09:09 2012
@@ -26,9 +26,18 @@
 <body>
 	<textarea id="xooki-source">
 
-<div class="notice">
-This documentation is describing the <b>experimental</b> OSGi capability of Ivy. It should work with simple configuration but may not in complex ones. If you have any issue with that feature, you are welcomed to come discussed your use case on the <a href="http://ant.apache.org/ivy/mailing-lists.html">ivy-user</a> mailing list, or discuss about implementation issues or improvement you may have found on <a href="http://ant.apache.org/ivy/mailing-lists.html">ant-dev</a>.
-</div>
+<table class="notice">
+  <tr>
+    <td style="vertical-align: top"><img src="../images/warning.png" style="float:left;" /></td>
+    <td>
+    Note that this feature is considered as <b>experimental</b>. It should work with simple configuration but may not in complex ones. If you have any issue with that feature, you are welcomed to come discussed your use case on the <a href="http://ant.apache.org/ivy/mailing-lists.html">ivy-user</a> mailing list, or discuss about implementation issues or improvement you may have found on <a href="http://ant.apache.org/ivy/mailing-lists.html">ant-dev</a>.
+    </td>
+  </tr>
+</table>
+
+<hr />
+<center><b>TODO - WORK IN PROGRESS</b></center>
+<hr />
 
 This page describes how to build an OSGi&#153; bundle with Apache Ivy&#153;. In this use case, we just basically want to compute a classpath to compile, optionaly one for testing too, and then publish our bundle in a OSGi aware repository.
 
@@ -46,7 +55,6 @@ In few steps, we will setup a build to c
 <li><i>(optional)</i> if Ivy is not in Ant's classpath, get the jar of <a href="../download.html">Apache Ivy</a> and edit the build.xml accordingly (see the comments at the begining of the file)</li>
 </ol>
 
-
 	</textarea>
 <script type="text/javascript">xooki.postProcess();</script>
 </body>

Modified: ant/ivy/core/trunk/doc/osgi/target-platform.html
URL: http://svn.apache.org/viewvc/ant/ivy/core/trunk/doc/osgi/target-platform.html?rev=1325416&r1=1325415&r2=1325416&view=diff
==============================================================================
--- ant/ivy/core/trunk/doc/osgi/target-platform.html (original)
+++ ant/ivy/core/trunk/doc/osgi/target-platform.html Thu Apr 12 18:09:09 2012
@@ -26,13 +26,26 @@
 <body>
 	<textarea id="xooki-source">
 
-<div class="notice">
-This documentation is describing the <b>experimental</b> OSGi capability of Ivy. It should work with simple configuration but may not in complex ones. If you have any issue with that feature, you are welcomed to come discussed your use case on the <a href="http://ant.apache.org/ivy/mailing-lists.html">ivy-user</a> mailing list, or discuss about implementation issues or improvement you may have found on <a href="http://ant.apache.org/ivy/mailing-lists.html">ant-dev</a>.
-</div>
+<table class="notice">
+  <tr>
+    <td style="vertical-align: top"><img src="../images/warning.png" style="float:left;" /></td>
+    <td>
+    Note that this feature is considered as <b>experimental</b>. It should work with simple configuration but may not in complex ones. If you have any issue with that feature, you are welcomed to come discussed your use case on the <a href="http://ant.apache.org/ivy/mailing-lists.html">ivy-user</a> mailing list, or discuss about implementation issues or improvement you may have found on <a href="http://ant.apache.org/ivy/mailing-lists.html">ant-dev</a>.
+    </td>
+  </tr>
+</table>
 
-Building an OSGi&#153; bundle with standard tools like <tt>javac</tt> and a classpath computed by Apache Ivy&#153; can be erroneous as these tools doesn't take into account the package visibility enforced by the OSGi metadata. Then switching to OSGi dedicated tools like the Eclipse&#153; JTD can be prefered. This kind of tools still need a "target platform", a set of jars against to compile and then later run. A target platform can be easily managed with Ivy and its OSGi capabilities.
+<hr />
+<center><b>TODO - WORK IN PROGRESS</b></center>
+<hr />
 
-TODO
+Building an OSGi&#153; bundle with standard tools like <tt>javac</tt> and a classpath computed by Apache Ivy&#153; can be erroneous as these tools doesn't take into account the package visibility enforced by the OSGi metadata. Then switching to OSGi dedicated tools like the Eclipse&#153; JDT can be prefered. This kind of tools still need a "target platform", a set of jars against to compile and then later run. A target platform can be easily managed with Ivy and its OSGi capabilities.
+
+<ul>Some links of interest:
+  <li><a href="../resolver/obr.html">OSGi Bundle Repository Resolver</a></li>
+  <li><a href="../resolver/updatesite.html">Eclipse updatesite Resolver</a></li>
+  <li><a href="../use/retrieve.html">Ant ivy:retrieve task</a></li>
+</ul>
 
 	</textarea>
 <script type="text/javascript">xooki.postProcess();</script>