<document url="http://castor.codehaus.org/download.xml">

  <properties>
    <title>Download instructions &amp; dependencies</title>
    <author email="werner DOT guttmann AT gmx DOT net">Werner Guttmann</author>
    <abstract>
      Outlines how to download Castor JARs, explains dependencies on third-party
      products.
    </abstract>
    <status>Final</status>
  </properties>

  <body>
    <title>Download Castor &amp; its 3rd-party products dependencies</title>

    <section title="Releases">

      <p>
        Please carefully make yourself familiar with the license model of Castor,
        available <a href="license.html"><b>here</b></a>.
      </p>

      <section title="Latest Stable Release">

        <section title="Castor">
        
            <p>
                <b>Latest Released Version: Castor $STABLE_VERSION$ $STABLE_RELEASE$</b><br/>
                <b>Release date: $STABLE_RELEASE_DATE$</b><br/>
                <a href="release-notes.xml">Release notes</a> - What changed ? 
            </p>
            
            <ctable>
                <crow>
                    <td>Castor XML</td>
                    <td>http://dist.codehaus.org/castor/$STABLE_VERSION$/castor-$STABLE_VERSION$$STABLE_RELEASE$-xml.jar</td>
                </crow>
                <crow>
                    <td>Castor Core</td>
                    <td>http://dist.codehaus.org/castor/$STABLE_VERSION$/castor-$STABLE_VERSION$$STABLE_RELEASE$-core.jar</td>
                </crow>
                <crow>
                    <td>Castor JDO</td>
                    <td>http://dist.codehaus.org/castor/$STABLE_VERSION$/castor-$STABLE_VERSION$$STABLE_RELEASE$-jdo.jar</td>
                </crow>
                <crow>
                    <td>Castor XML code generator</td>
                    <td>http://dist.codehaus.org/castor/$STABLE_VERSION$/castor-$STABLE_VERSION$$STABLE_RELEASE$-codegen.jar</td>
                </crow>
                <crow>
                    <td>Ant task definition for Castor XML code generator</td>
                    <td>http://dist.codehaus.org/castor/$STABLE_VERSION$/castor-$STABLE_VERSION$$STABLE_RELEASE$-anttasks.jar</td>
                </crow>
                <crow>
                    <td>Castor JDO DDLGen</td>
                    <td>http://dist.codehaus.org/castor/$STABLE_VERSION$/castor-$STABLE_VERSION$$STABLE_RELEASE$-ddlgen.jar</td>
                </crow>
                <crow>
                    <td>Castor XML schema support</td>
                    <td>http://dist.codehaus.org/castor/$STABLE_VERSION$/castor-$STABLE_VERSION$$STABLE_RELEASE$-xml-schema.jar</td>
                </crow>
            </ctable>

        </section>

        <section title="Download sets">
        
          <ul>
            <li>
              The Castor JARs, docs, DTDs, command line tools, and examples<br/>
              <url>http://dist.codehaus.org/castor/$STABLE_VERSION$/castor-$STABLE_VERSION$$STABLE_RELEASE$.tgz</url><br/>
              <url>http://dist.codehaus.org/castor/$STABLE_VERSION$/castor-$STABLE_VERSION$$STABLE_RELEASE$.zip</url>
              <br/>&#xA0;
            </li>
            <li>
              Full documentation including all JavaDocs and specs (big)<br/>
              <url>http://dist.codehaus.org/castor/$STABLE_VERSION$/castor-$STABLE_VERSION$$STABLE_RELEASE$-doc.tgz</url><br/>
              <url>http://dist.codehaus.org/castor/$STABLE_VERSION$/castor-$STABLE_VERSION$$STABLE_RELEASE$-doc.zip</url>
              <br/>&#xA0;
            </li>
            <li>
              Full SVN snapshot: All sources, docs, and 3rd party libraries (big)<br/>
              <url>http://dist.codehaus.org/castor/$STABLE_VERSION$/castor-$STABLE_VERSION$$STABLE_RELEASE$-src.tgz</url><br/>
              <url>http://dist.codehaus.org/castor/$STABLE_VERSION$/castor-$STABLE_VERSION$$STABLE_RELEASE$-src.zip</url>
              <br/>&#xA0;
            </li>
          </ul>

        </section>

        <section title="Samples">
          <ul>
            <li>
              Self-executing JDO examples using Apache Derby (big)<br/>
              <url>http://dist.codehaus.org/castor/$STABLE_VERSION$/castor-$STABLE_VERSION$$STABLE_RELEASE$-examples.zip</url>
              <br/>&#xA0;
            </li>
            <li>
              Castor examples -- sources (incl. XML, JDO, source generator)<br/>
              <url>http://dist.codehaus.org/castor/$VERSION$/castor-$STABLE_VERSION$$STABLE_RELEASE$-examples-sources.jar</url>
              <br/>&#xA0;
            </li>
          </ul>
        </section>
        
        <section title="Commons">
          <ul>
            <li>
              The Castor Commons JAR<br/>
              <url>http://dist.codehaus.org/castor/$STABLE_VERSION$/castor-$STABLE_VERSION$$STABLE_RELEASE$-commons.jar</url>
              <br/>&#xA0;<br/>
              As of release 0.9.9.1, a new JAR file with the suffix '-commons' has
              been introduced, holding classes that can be used independently of
              Castor XML and Castor JDO. With the 0.9.9.1 release it only contains
              the Base64Decoder, Base64Encoder, IdentityMap and IdentitySet classes.
              More (e.g. Castor's cache) will follow with future releases. Since
              these classes are also required for Castor XML and/or Castor JDO,
              they are included in the other JARs (XML, JDO) that require them.
              Therefore, you don't need to change your class path if it includes
              one of the other Castor JARs (XML, JDO). The only intention of the
              commons package is to provide you with a small JAR containing classes
              that are commonly needed by applications even if they do not need
              Castor's XML and/or JDO part.
            </li>
          </ul>
        </section>

<!--
        <ul>
          <li>
            Castor examples - sources (incl. xml, JDO, source generator)<br/>
            <url>http://dist.codehaus.org/castor/$STABLE_VERSION$/castor-$STABLE_VERSION$$STABLE_RELEASE$-examples-sources.jar</url>
            <br/>&#xA0;
          </li>
          <li>
            Castor sample webapp<br/>
            <url>http://dist.codehaus.org/castor/$STABLE_VERSION$/castor-$STABLE_VERSION$$STABLE_RELEASE$-example-webapp.war</url>
            <br/>&#xA0;
          </li>
        </ul>
-->

         <p>
           <small>The tarball and zips include all the JARs required by Castor,
           the docs, and the API JavaDocs. To fully install Castor, simply
           extract all the JARs into your classpath.</small>
         </p>

         <p>
           <small>The SVN snapshot includes additional JARs required to build
           Castor. It is self-sufficient and does not require any external
           components other than javac.</small>
         </p>

         <p>
           <small>The documentation set includes JavaDocs for the full source
           code, documenting class usage. A small documentation set without the
           full source JavaDocs is available in the tarball and zips.</small>
         </p>

         <p>
           <small>All of the JARs included with Castor (used for building
           Castor) are available for distribution free of charge, subject to
           the respective license agreements.</small>
         </p>

         <p>
           <small>All implementation JARs (i.e. not APIs) are available under
           an open source license and available from our FTP server.  Open
           source licenses in use include Apache (ASF), Exolab, Mozilla (MPL),
           and public domain. All licenses are fully compatible with each
           other.</small>
         </p>

         <p>
           <small>The example JAR includes fully functional samples that
           demonstrate the use of various features of Castor -- including
           marshaling and unmarshaling to and from XML, data persistence using
           JDO, and source code generation from an XML Schema instance.</small>
         </p>

         <p>
           <small>The example web application (in form of a WAR archive)
           includes fully functional samples that demonstrate the use of Castor
           from within a standard J2EE web application. The WAR file can be
           deployed to any J2EE compliant web application container (including,
           amongst others, Tomcat, WebSphere, JBoss, and Weblogic) using the
           standard deployment method of your web application server.</small>
         </p>

      </section>

      <section title="Latest Milestone Release">

          <ul>
            <b>Latest Milestone Version: Castor $VERSION$ $RELEASE$</b><br/>
            <b>Release date: $RELEASE_DATE$</b>

            <li><a href="release-notes.xml">What changed?</a></li>
          </ul>

        <section title="Binaries">

          <ul>
            <li>
              The Castor JAR (XML, DAX; <b>without</b> XML code generator and JDO)<br/>
              <url>http://dist.codehaus.org/castor/1.3rc1/castor-$VERSION$$RELEASE$.jar</url>
              <br/>&#xA0;
            </li>
            <li>
              The Castor XML JAR<br/>
              <url>http://dist.codehaus.org/castor/1.3rc1/castor-$VERSION$$RELEASE$-xml.jar</url>
              <br/>&#xA0;
            </li>
            <li>
              Castor JDO<br/>
              <url>http://dist.codehaus.org/castor/1.3rc1/castor-$VERSION$$RELEASE$-jdo.jar</url>
              <br/>&#xA0;
            </li>
            <li>
              Castor XML code generator<br/>
              <url>http://dist.codehaus.org/castor/1.3rc1/castor-$VERSION$$RELEASE$-codegen.jar</url>
              <br/>&#xA0;
            </li>
            <li>
              Ant task definition for Castor XML code generator<br/>
              <url>http://dist.codehaus.org/castor/1.3rc1/castor-$VERSION$$RELEASE$-anttasks.jar</url>
              <br/>&#xA0;
            </li>
            <li>
              Castor JDO DDL generator<br/>
              <url>http://dist.codehaus.org/castor/1.3rc1/castor-$VERSION$$RELEASE$-ddlgen.jar</url>
              <br/>&#xA0;
            </li>
            <li>
              Castor XML schema support<br/>
              <url>http://dist.codehaus.org/castor/1.3rc1/castor-$VERSION$$RELEASE$-xml-schema.jar</url>
              <br/>&#xA0;
            </li>
            <li>
              <font color="red"><b>*** NEW ***</b></font> The Castor Core JAR<br/>
              <url>http://dist.codehaus.org/castor/1.3rc1/castor-$VERSION$$RELEASE$-core.jar</url>
              <br/>&#xA0;
            </li>
          </ul>

        </section>

        <section title="Download sets">

          <ul>
            <li>
              The Castor JARs, docs, DTDs, command line tools, and examples<br/>
              <url>http://dist.codehaus.org/castor/1.3rc1/castor-$VERSION$$RELEASE$.tgz</url><br/>
              <url>http://dist.codehaus.org/castor/1.3rc1/castor-$VERSION$$RELEASE$.zip</url>
              <br/>&#xA0;
            </li>
            <li>
              Full documentation including all JavaDocs and specs (big)<br/>
              <url>http://dist.codehaus.org/castor/1.3rc1/castor-$VERSION$$RELEASE$-doc.tgz</url><br/>
              <url>http://dist.codehaus.org/castor/1.3rc1/castor-$VERSION$$RELEASE$-doc.zip</url>
              <br/>&#xA0;
            </li>
            <li>
              Full SVN snapshot: All sources, docs, and 3rd party libraries (big)<br/>
              <url>http://dist.codehaus.org/castor/1.3rc1/castor-$VERSION$$RELEASE$-src.tgz</url><br/>
              <url>http://dist.codehaus.org/castor/1.3rc1/castor-$VERSION$$RELEASE$-src.zip</url>
              <br/>&#xA0;
            </li>
          </ul>

        </section>

        <section title="Samples">
          <ul>
            <li>
              Self-executing JDO examples using Apache Derby (big)<br/>
              <url>http://dist.codehaus.org/castor/1.3rc1/castor-$VERSION$$RELEASE$-examples.zip</url>
              <br/>&#xA0;
            </li>
            <li>
              Castor examples -- sources (incl. XML, JDO, source generator)<br/>
              <url>http://dist.codehaus.org/castor/1.3rc1/castor-$VERSION$$RELEASE$-examples-sources.jar</url>
              <br/>&#xA0;
            </li>
          </ul>
        </section>

        <section title="Castor XML Spring factory beans">

          <ul>
            <li>
              Spring factory beans for Castor XML<br/>
              <url>http://snapshots.repository.codehaus.org/org/codehaus/castor/spring-xml/$SPRING-XML-SNAPSHOT$-SNAPSHOT/</url>
              <br/>&#xA0;
            </li>
          </ul>

          <p>
            The JARs in this directory carry a timestamp in their name. Please make sure
            that you always use the <b>latest</b> JAR file, unless you require a specific
            version.
          </p>

          <p>
            For those of you working with <a href="http://maven.apache.org">Maven 2</a>, please add
            the following dependency to your POM to include the <i>Spring factory beans for
            Castor XML</i> with your project:
          </p>

          <source><![CDATA[
<dependency>
   <groupId>org.codehaus.castor</groupId>
   <artifactId>spring-xml</artifactId>
   <version>0.8-SNAPSHOT</version>
</dependency>]]></source>

          <p>
            As we currently provide snapshot releases only for the factory beans, you will
            have to add the following <tt>&lt;repository&gt;</tt> element to your POM as well,
            so that Maven 2 knows about the <i>Codehaus Snapshot repository</i> when trying
            to resolve and download dependencies.
          </p>

          <source><![CDATA[
<repository>
    <id>codehaus-snapshots</id>
    <name>Maven Codehaus Snapshots</name>
    <url>http://snapshots.maven.codehaus.org/maven2/</url>
</repository>]]></source>

<!--
<repository>
    <id>codehaus-snashots</id>
    <name>Maven Codehaus Snapshots</name>
    <url>http://snapshots.maven.codehaus.org/maven2/</url>
</repository>
-->
        </section>

        <section title="Spring ORM for Castor JDO">

          <ul>
            <li>
              Spring ORM implementation for Castor JDO<br/>
              <url>http://snapshots.repository.codehaus.org/org/codehaus/castor/spring-orm/$SPRING-JDO-SNAPSHOT$-SNAPSHOT/</url>
              <br/>&#xA0;
            </li>
          </ul>

          <p>
            The JARs in this directory carry a timestamp in their name. Please make sure
            that you always use the <b>latest</b> JAR file, unless you require a specific
            version.
          </p>

          <p>
            For those of you working with <a href="http://maven.apache.org">Maven 2</a>, please add
            the following dependency to your POM to include the <i>Spring ORM package for
            Castor JDO</i> with your project:
          </p>

          <source><![CDATA[
<dependency>
   <groupId>org.codehaus.castor</groupId>
   <artifactId>spring-orm</artifactId>
   <version>RC2-SNAPSHOT</version>
</dependency>]]></source>

          <p>
            As we currently provide snapshot releases only for the factory beans, you will
            have to add the following <tt>&lt;repository&gt;</tt> element to your POM as well,
            so that Maven 2 knows about the <i>Codehaus Snapshot repository</i> when trying
            to resolve and download dependencies.
          </p>

          <source><![CDATA[
<repository>
    <id>codehaus-snapshots</id>
    <name>Maven Codehaus Snapshots</name>
    <url>http://snapshots.maven.codehaus.org/maven2/</url>
</repository>]]></source>

        </section>

        <section title="Commons">

          <ul>

            <li>
              The Castor Commons JAR<br/>
              <url>http://dist.codehaus.org/castor/$VERSION$/castor-$VERSION$$RELEASE$-commons.jar</url>
              <br/>&#xA0;<br/>
              As of release 0.9.9.1, a new JAR file with the suffix '-commons' has
              been introduced, holding classes that can be used independently of
              Castor XML and Castor JDO. With the 0.9.9.1 release it only contains
              the Base64Decoder, Base64Encoder, IdentityMap and IdentitySet classes.
              More (e.g. Castor's cache) will follow with future releases. Since
              these classes are also required for Castor XML and/or Castor JDO,
              they are included in the other JARs (XML, JDO) that require them.
              Therefore, you don't need to change your class path if it includes
              one of the other Castor JARs (XML, JDO). The only intention of the
              commons package is to provide you with a small JAR containing classes
              that are commonly needed by applications even if they do not need
              Castor's XML and/or JDO part.
            </li>

          </ul>

        </section>

<!--
        <ul>
          <li>
            Castor sample webapp<br/>
            <url>http://dist.codehaus.org/castor/$VERSION$/castor-$VERSION$$RELEASE$-example-webapp.war</url>
            <br/>&#xA0;
          </li>
        </ul>
-->

<!--
        <ctable>
          <crow>
            <td><url title="The Castor Commons JAR">http://dist.codehaus.org/castor/$VERSION$/castor-$VERSION$$RELEASE$-commons.jar</url></td>
          </crow>
          <crow>
            <td><url title="The Castor JAR (XML, JDO, DAX)">http://dist.codehaus.org/castor/$VERSION$/castor-$VERSION$$RELEASE$.jar</url></td>
          </crow>
          <crow>
            <td><url title="The Castor JAR (XML only)">http://dist.codehaus.org/castor/$VERSION$/castor-$VERSION$$RELEASE$-xml.jar</url></td>
          </crow>
        </ctable>
-->
      </section>

      <section title="Past Releases">
         <p>You may be able to find some past releases on the HTTP Server:</p>
         <p><url>http://dist.codehaus.org/castor/</url></p>
      </section>

    </section>

    <section title="SVN Snapshots">

      <p>
        To obtain the latest SVN version, please use a SVN-enabled client to
        access our SVN server. Instructions for doing so can be found
        <a href="scm.xml">here</a>.
      </p>

      <p>
        For those of you behind a firewall with the SVN port non-accessible, please
        download Castor from the SVN server using the HTTP interface at
        <url>http://svn.castor.codehaus.org/viewrep/castor/castor/trunk</url> as provided by FishEye (tm):
      </p>

      <ul>
        <li><a href="http://svn.castor.codehaus.org/browse/~tarball=zip/castor/castor/trunk/trunk.zip">zip</a></li>
        <li><a href="http://svn.castor.codehaus.org/viewrep/~tarball=zip/castor/castor/trunk/trunk.tgz">tgz</a></li>
        <li><a href="http://svn.castor.codehaus.org/viewrep/~tarball=zip/castor/castor/trunk/trunk.tbz2">tbz2</a></li>
      </ul>

    </section>

    <section title="Dependent Libraries">

      <p>
        JARs required to build Castor and dependencies for various packages are
        contained in the <tt>lib</tt> directory. For details, please see
        <a href="dependencies.html">dependencies</a>.
      </p>

    </section>

  </body>

</document>
