[CVS jcontainer] Add in CDATA stuff
Peter Donald <pdonald-yCVjj/[email protected]> Wed, 31 Mar 2004 00:46:59 -0600
| Newsgroups | gmane.comp.java.jcontainer.cvs |
|---|---|
| Message-ID | <[email protected]> |
<html>
<head>
<style><!--
body {background-color:#ffffff;}
.file {border:1px solid #eeeeee;margin-top:1em;margin-bottom:1em;}
.pathname {font-family:monospace; float:right;}
.fileheader {margin-bottom:.5em;}
.diff {margin:0;}
.tasklist {padding:4px;border:1px dashed #000000;margin-top:1em;}
.tasklist ul {margin-top:0;margin-bottom:0;}
tr.alt {background-color:#eeeeee}
#added {background-color:#ddffdd;}
#addedchars {background-color:#99ff99;font-weight:bolder;}
tr.alt #added {background-color:#ccf7cc;}
#removed {background-color:#ffdddd;}
#removedchars {background-color:#ff9999;font-weight:bolder;}
tr.alt #removed {background-color:#f7cccc;}
#info {color:#888888;}
#context {background-color:#eeeeee;}
td {padding-left:.3em;padding-right:.3em;}
tr.head {border-bottom-width:1px;border-bottom-style:solid;}
tr.head td {padding:0;padding-top:.2em;}
.task {background-color:#ffff00;}
.comment {padding:4px;border:1px dashed #000000;background-color:#ffffdd}
.error {color:red;}
hr {border-width:0px;height:2px;background:black;}
--></style>
</head>
<body>
<table cellspacing="0" cellpadding="0" border="0" rules="cols">
<tr class="head"><td colspan="4">Commit in <b><tt>jcontainer/loom/support/extension/xdocs</tt></b><span id="info"> on MAIN</span></td></tr>
<tr><td><tt><a href="#file1">index.xml</a></tt></td><td align="right" id="added">+16</td><td align="right" id="removed">-18</td><td nowrap="nowrap" align="center"><a href="http://xstream.cvs.codehaus.org/jcontainer/loom/support/extension/xdocs/index.xml?rev=1.3&content-type=text/vnd.viewcvs-markup">1.3</a> <a href="http://xstream.cvs.codehaus.org/jcontainer/loom/support/extension/xdocs/index.xml.diff?r1=1.3&r2=1.4">-></a> <a href="http://xstream.cvs.codehaus.org/jcontainer/loom/support/extension/xdocs/index.xml?rev=1.4&content-type=text/vnd.viewcvs-markup">1.4</a></td></tr>
</table>
<pre class="comment">
Add in CDATA stuff
</pre>
<hr /><a name="file1" /><div class="file">
<span class="pathname"><a href="http://xstream.cvs.codehaus.org/jcontainer">jcontainer</a>/<a href="http://xstream.cvs.codehaus.org/jcontainer/loom">loom</a>/<a href="http://xstream.cvs.codehaus.org/jcontainer/loom/support">support</a>/<a href="http://xstream.cvs.codehaus.org/jcontainer/loom/support/extension">extension</a>/<a href="http://xstream.cvs.codehaus.org/jcontainer/loom/support/extension/xdocs">xdocs</a><br /></span>
<div class="fileheader"><big><b>index.xml</b></big> <small id="info"><a href="http://xstream.cvs.codehaus.org/jcontainer/loom/support/extension/xdocs/index.xml?rev=1.3&content-type=text/vnd.viewcvs-markup">1.3</a> <a href="http://xstream.cvs.codehaus.org/jcontainer/loom/support/extension/xdocs/index.xml.diff?r1=1.3&r2=1.4">-></a> <a href="http://xstream.cvs.codehaus.org/jcontainer/loom/support/extension/xdocs/index.xml?rev=1.4&content-type=text/vnd.viewcvs-markup">1.4</a></small></div>
<pre class="diff"><small id="info">diff -u -r1.3 -r1.4
--- index.xml 21 Mar 2004 23:37:20 -0000 1.3
+++ index.xml 31 Mar 2004 06:46:58 -0000 1.4
@@ -12,26 +12,24 @@
</small></pre><pre class="diff" id="context"> as described in the manifest of a JAR file. The toolkit can also
parse and represent Specification sections described in manifests.
</p>
</pre><pre class="diff" id="removed">- <p>
- All Spice jars are held in the
- <a href="http://spice.sf.net/maven">http://spice.sf.net/maven</a>
- repository for Maven usage.
- </p>
</pre><pre class="diff" id="context"> </section>
<section name="Extensions">
<p>
The "Optional Package" mechanism can be used to declare is used
to declare dependencies on libraries. Prior to JDK1.3, an "Optional
</pre><pre class="diff" id="removed">- Package" was known as an <em>Extension</em>. The specification for this
</pre><pre class="diff" id="added">+ Package" was known as an
+ <em>Extension</em>. The specification for this
</pre><pre class="diff" id="context"> mechanism is available in the JDK1.3 documentation in the directory
<tt>$JDK_HOME/docs/guide/extensions/versioning.html</tt>. Alternatively
</pre><pre class="diff" id="removed">- it is available online at <a href="http://java.sun.com/j2se/1.3/docs/guide/extensions/versioning.html">
</pre><pre class="diff" id="added">+ it is available online at
+ <a href="http://java.sun.com/j2se/1.3/docs/guide/extensions/versioning.html">
</pre><pre class="diff" id="context"> http://java.sun.com/j2se/1.3/docs/guide/extensions/versioning.html</a>.
</p>
<p>
Support for the "Optional Package" specification is being mandated
</pre><pre class="diff" id="removed">- by other specifications such as the <em>Servlet 2.3 API</em>. Thus we
</pre><pre class="diff" id="added">+ by other specifications such as the
+ <em>Servlet 2.3 API</em>. Thus we
</pre><pre class="diff" id="context"> are likely to see an increase of jars using this mechanism to specify
dependencies.
</p>
</pre><pre class="diff"><small id="info">@@ -43,11 +41,11 @@
</small></pre><pre class="diff" id="context"> to the manifest of your jar.
</p>
</pre><pre class="diff" id="removed">- <source>
</pre><pre class="diff" id="added">+ <source><span id="addedchars"><![CDATA[</span>
</pre><pre class="diff" id="context"> Extension-List: trax
trax-Extension-Name: Java API for XML Parsing
trax-Specification-Version: 1.1
</pre><pre class="diff" id="removed">- </source>
</pre><pre class="diff" id="added">+ <span id="addedchars">]]></span></source>
</pre><pre class="diff" id="context">
<p>
In some cases you may also wish to specify a dependency on a specific vendors
</pre><pre class="diff"><small id="info">@@ -55,14 +53,14 @@
</small></pre><pre class="diff" id="context"> particular extension you need. In that case you manifest may contain;
</p>
</pre><pre class="diff" id="removed">- <source>
</pre><pre class="diff" id="added">+ <source><span id="addedchars"><![CDATA[</span>
</pre><pre class="diff" id="context"> Extension-List: trax
trax-Extension-Name: Java API for XML Parsing
trax-Specification-Version: 1.1
trax-Implementation-Title: org.apache.xalan.xslt
trax-Implementation-Version: 2.1.0
trax-Implementation-Vendor: Apache Software Foundation
</pre><pre class="diff" id="removed">- </source>
</pre><pre class="diff" id="added">+ <span id="addedchars">]]></span></source>
</pre><pre class="diff" id="context">
<p>
In many cases there will be no distinction between the specification and
</pre><pre class="diff"><small id="info">@@ -72,7 +70,7 @@
</small></pre><pre class="diff" id="context"> both the Trax API and the Velocity project may look like;
</p>
</pre><pre class="diff" id="removed">- <source>
</pre><pre class="diff" id="added">+ <source><span id="addedchars"><![CDATA[</span>
</pre><pre class="diff" id="context"> Extension-List: trax velocity
velocity-Extension-Name: org.apache.velocity
velocity-Specification-Version: 1.0
</pre><pre class="diff"><small id="info">@@ -81,17 +79,17 @@
</small></pre><pre class="diff" id="context"> trax-Implementation-Title: org.apache.xalan.xslt
trax-Implementation-Version: 2.1.0
trax-Implementation-Vendor: Apache Software Foundation
</pre><pre class="diff" id="removed">- </source>
</pre><pre class="diff" id="added">+ <span id="addedchars">]]></span></source>
</pre><pre class="diff" id="context">
<p>To make other jars available as possible to libraries to add libraries
as "Optional Packages" or Extensions then you need to add a few lines
to the manifest of the other jar. The minimal manifest is the following;</p>
</pre><pre class="diff" id="removed">- <source>
</pre><pre class="diff" id="added">+ <source><span id="addedchars"><![CDATA[</span>
</pre><pre class="diff" id="context"> Extension-Name: org.realityforge.dve
Specification-Vendor: Peter Donald
Specification-Version: 1.0
</pre><pre class="diff" id="removed">- </source>
</pre><pre class="diff" id="added">+ <span id="addedchars">]]></span></source>
</pre><pre class="diff" id="context">
<p>
It is important to note that resolving dependencies is recursive. For example,
</pre><pre class="diff"><small id="info">@@ -106,7 +104,7 @@
</small></pre><pre class="diff" id="context"> The Extension class is responsible for both parsing and representing
information about Extensions. Example usage;
</p>
</pre><pre class="diff" id="removed">- <pre>
</pre><pre class="diff" id="added">+ <pre><span id="addedchars"><![CDATA[</span>
</pre><pre class="diff" id="context"> //Get manifest file for library
final Manifest manifest = ...;
</pre><pre class="diff"><small id="info">@@ -117,7 +115,7 @@
</small></pre><pre class="diff" id="context"> // Get a list of extensions that this
// library requires to work
Extension[] required = Extension.getRequired( manifest );
</pre><pre class="diff" id="removed">- </pre>
</pre><pre class="diff" id="added">+ <span id="addedchars">]]></span></pre>
</pre><pre class="diff" id="context"> </section>
</body>
</document>
</pre></div>
<center><small><a href="http://www.badgers-in-foil.co.uk/projects/cvsspam/" title="commit -> email">CVSspam</a> 0.2.8</small></center>
</body></html>