db-jdo-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From an...@apache.org
Subject svn commit: r1432659 [10/12] - in /db/jdo/site: ./ src/ src/site/ src/site/resources/ src/site/resources/images/ src/site/resources/releases/ src/site/xdoc/ src/site/xdoc/guides/ src/site/xdoc/releases/
Date Sun, 13 Jan 2013 17:05:18 GMT
Added: db/jdo/site/src/site/xdoc/mail-lists.xml
URL: http://svn.apache.org/viewvc/db/jdo/site/src/site/xdoc/mail-lists.xml?rev=1432659&view=auto
==============================================================================
--- db/jdo/site/src/site/xdoc/mail-lists.xml (added)
+++ db/jdo/site/src/site/xdoc/mail-lists.xml Sun Jan 13 17:05:15 2013
@@ -0,0 +1,98 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+
+<!--
+
+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.
+-->
+
+<document xmlns="http://maven.apache.org/XDOC/2.0"
+  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+  xsi:schemaLocation="http://maven.apache.org/XDOC/2.0 http://maven.apache.org/xsd/xdoc-2.0.xsd">
+ <properties>
+  <title>Mailing Lists</title>
+  <author email="jdo-dev@db.apache.org">JDO Documentation Team</author>
+ </properties>
+
+<body>
+<section name="Apache JDO Mailing Lists">
+
+<p>
+There are several publicly available mailing lists for JDO. 
+The user list is for general discussion of the Apache JDO project and JDO technology.
+The dev list is for internal discussion among the JDO developers. It is
+open to the public if you are interested in seeing how the sausage is made.
+For those dedicated to the project who want to follow its development even more
+closely there's the commits mailing list!
+</p>
+
+<table>
+<tr>
+<td>
+<p><strong>User List</strong> : <a  href="mailto:jdo-user@db.apache.org">
+ jdo-user@db.apache.org</a> </p>
+</td>
+<td>
+<p> <a  class="external" rel="nofollow" href="mailto:jdo-user-subscribe@db.apache.org">
+ Subscribe</a> </p>
+</td>
+<td>
+<p> <a  class="external" rel="nofollow" href="mailto:jdo-user-unsubscribe@db.apache.org">
+ Unsubscribe</a> </p>
+</td>
+<td>
+<p>
+<a href="http://mail-archives.apache.org/mod_mbox/db-jdo-user/">Archive</a>
+</p>
+</td>
+</tr>
+<tr>
+<td>
+<p><strong>Dev List</strong> : <a  href="mailto:jdo-dev@db.apache.org"> jdo-dev@db.apache.org</a> </p>
+</td>
+<td>
+<p> <a  class="external" rel="nofollow" href="mailto:jdo-dev-subscribe@db.apache.org"> Subscribe</a> </p>
+</td>
+<td>
+<p> <a  class="external" rel="nofollow" href="mailto:jdo-dev-unsubscribe@db.apache.org"> Unsubscribe</a> </p>
+</td>
+<td>
+<p>
+<a href="http://mail-archives.apache.org/mod_mbox/db-jdo-dev/">Archive</a>
+</p>
+</td>
+</tr>
+<tr>
+<td>
+<p><strong>Commits List</strong> : <a href="mailto:jdo-commits@db.apache.org">jdo-commits@db.apache.org</a> </p>
+</td>
+<td>
+<p> <a class="external" rel="nofollow" href="mailto:jdo-commits-subscribe@db.apache.org">Subscribe</a> </p>
+</td>
+<td>
+<p> <a class="external" rel="nofollow" href="mailto:jdo-commits-unsubscribe@db.apache.org">Unsubscribe</a> </p>
+</td>
+<td>
+<p>
+<a href="http://mail-archives.apache.org/mod_mbox/db-jdo-commits/">Archive</a>
+</p>
+</td>
+</tr>
+</table>
+
+</section>
+</body>
+</document>
+

Added: db/jdo/site/src/site/xdoc/metadata.xml
URL: http://svn.apache.org/viewvc/db/jdo/site/src/site/xdoc/metadata.xml?rev=1432659&view=auto
==============================================================================
--- db/jdo/site/src/site/xdoc/metadata.xml (added)
+++ db/jdo/site/src/site/xdoc/metadata.xml Sun Jan 13 17:05:15 2013
@@ -0,0 +1,58 @@
+<?xml version="1.0" encoding="iso-8859-1"?>
+<document xmlns="http://maven.apache.org/XDOC/2.0"
+  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+  xsi:schemaLocation="http://maven.apache.org/XDOC/2.0 http://maven.apache.org/xsd/xdoc-2.0.xsd">
+    <properties>
+        <title>JDO MetaData</title>
+    </properties>
+    <body>
+        <section name="Persistence MetaData">
+            <p>
+                JDO 1.0 and JDO 2.0 support specification of persistence using XML MetaData.
+                JDO 2.1 adds on the ability to specify persistence using Java5 annotations.
+            </p>
+            <subsection name="XML MetaData">
+                <p>
+                    JDO (1.0.1, 2.0, 2.1) expects any XML MetaData to be specified in a file or files 
+                    in particular positions in the file system. For example, if you have a class 
+                    <i>com.mycompany.sample.MyExample</i>, JDO will look for any of the following files 
+                    until it finds one (in the order stated) :-
+                </p>
+                <source>
+META-INF/package.jdo
+WEB-INF/package.jdo
+package.jdo
+com/package.jdo
+com/mycompany/package.jdo
+com/mycompany/sample/package.jdo
+com/mycompany/sample/MyExample.jdo</source>
+                <p>
+                    In addition to specifying XML MetaData in a <b>jdo</b> file, if defining O/R mapping
+                    information you can also split this out into an ORM file. The locations for ORM files
+                    are similar in nature to those for JDO files.
+                </p>
+                <source>
+META-INF/package-{mapping}.orm
+WEB-INF/package-{mapping}.orm
+package-{mapping}.orm
+com/package-{mapping}.orm
+com/mycompany/package-{mapping}.orm
+com/mycompany/sample/package-{mapping}.orm
+com/mycompany/sample/MyExample-{mapping}.orm</source>
+                <p>
+                    where <i>{mapping}</i> is a property specified by the user and may be "mysql" for
+                    ORM information for MySQL datastores, and "oracle" for ORM information for Oracle
+                    datastores, and so on.
+                </p>
+                <br/>
+            </subsection>
+
+            <subsection name="Annotations">
+                <p>
+                    JDO 2.1 provides support for annotations. Classes and fields/properties can be annotated
+                    defining the persistence and, optionally, any ORM information.
+                </p>
+            </subsection>
+        </section>
+    </body>
+</document>

Added: db/jdo/site/src/site/xdoc/newshistory.xml
URL: http://svn.apache.org/viewvc/db/jdo/site/src/site/xdoc/newshistory.xml?rev=1432659&view=auto
==============================================================================
--- db/jdo/site/src/site/xdoc/newshistory.xml (added)
+++ db/jdo/site/src/site/xdoc/newshistory.xml Sun Jan 13 17:05:15 2013
@@ -0,0 +1,54 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+
+<!--
+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.
+-->
+
+<document xmlns="http://maven.apache.org/XDOC/2.0"
+  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+  xsi:schemaLocation="http://maven.apache.org/XDOC/2.0 http://maven.apache.org/xsd/xdoc-2.0.xsd">
+
+ <properties>
+  <title>News</title>
+  <author email="jdo-dev@db.apache.org">JDO Documentation Team</author>
+ </properties>
+
+ <body>
+
+<section name="Older JDO News">
+
+<p>
+<strong>JDO code donated to Apache by Sun Microsystems, Inc.</strong>
+</p>
+<p>On 9-Mar-2005 Sun Microsystems, Inc. officially donated 
+to Apache Software Foundation the
+intellectual property known as Java Data Objects, v. 1.0.2 and
+successors thereto to the extent provided by Sun.
+</p>
+<p>
+This was accomplished via Schedule B-2 to the Software Grant and
+Corporate Contributor License Agreement (CCLA) between 
+The Apache Software Foundation and Sun Microsystems, Inc.
+</p>
+ </section>
+
+ </body>
+ </document>
+
+
+
+
+

Added: db/jdo/site/src/site/xdoc/object_retrieval.xml
URL: http://svn.apache.org/viewvc/db/jdo/site/src/site/xdoc/object_retrieval.xml?rev=1432659&view=auto
==============================================================================
--- db/jdo/site/src/site/xdoc/object_retrieval.xml (added)
+++ db/jdo/site/src/site/xdoc/object_retrieval.xml Sun Jan 13 17:05:15 2013
@@ -0,0 +1,84 @@
+<?xml version="1.0" encoding="iso-8859-1"?>
+<document xmlns="http://maven.apache.org/XDOC/2.0"
+  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+  xsi:schemaLocation="http://maven.apache.org/XDOC/2.0 http://maven.apache.org/xsd/xdoc-2.0.xsd">
+    <properties>
+        <title>JDO Object Retrieval</title>
+    </properties>
+
+    <body>
+        <section name="Object Retrieval">
+            <p>
+                JDO provides persistence of objects. The logical next step after persisting 
+                objects is to retrieve them for use in your application. 
+                There are several ways to do this
+            </p>
+
+            <subsection name="Retrieve an object from its identity">
+                <p>
+                    The simplest form of object retrieval is where we have the identity. 
+                    This is simply 
+                </p>
+                <source>
+Object obj = pm.getObjectById(identity);
+                </source>
+                <p>
+                    If the object is in the JDO cache then it is retrieved from there, 
+                    otherwise the JDO implementation goes to the datastore. When the object 
+                    is retrieved its fields are populated according to its Fetch Group.
+                </p>
+            </subsection>
+
+            <subsection name="Retrieve an object based on its Extent">
+                <p>
+                    A persistable class can be persisted with an <b>Extent</b> of all 
+                    instances of that type.
+                    You can use this to retrieve objects of the required type, like this
+                </p>
+                <source>
+Extent ex = pm.getExtent(MyClass.class, true);
+Iterator iter = ex.iterator();
+while (iter.hasNext())
+{
+    MyClass obj = (MyClass)iter.next();
+    ...
+}</source>
+                <p>
+                    The second argument in the <i>getExtent</i> call is whether to include 
+                    instances of subclasses.
+                </p>
+                <br/>
+            </subsection>
+
+            <subsection name="Retrieve an object based on a criteria">
+                <p>
+                    Where we want to retrieve all objects based on some criteria (e.g all 
+                    objects of class A where field 'x' of A is a certain value) we need to 
+                    use a query language. JDO2 provides 2 options here. JDOQL is object-based 
+                    and allows you to express your query in terms of the classes and fields
+                    you are using. SQL is datastore-based and allows you to express your query 
+                    in terms of the datastore tables and columns.
+                </p>
+                <p>
+                    To give an example of a JDOQL query
+                </p>
+                <source><![CDATA[
+Query q = pm.newQuery(MyClass.class, "field1 < value");
+q.declareParameters("int value");
+List results = q.execute(205);
+Iterator iter = results.iterator();
+while (iter.hasNext())
+{
+    MyClass obj = (MyClass)iter.next();
+}]]></source>
+                <p>
+                    If the objects found by the query are in the JDO cache then they are 
+                    retrieved from there, otherwise the JDO implementation goes to the 
+                    datastore. When the objects are retrieved their fields are populated 
+                    according to the Fetch Group.
+                </p>
+            </subsection>
+        </section>
+
+    </body>
+</document>

Added: db/jdo/site/src/site/xdoc/orm_dtd.xml
URL: http://svn.apache.org/viewvc/db/jdo/site/src/site/xdoc/orm_dtd.xml?rev=1432659&view=auto
==============================================================================
--- db/jdo/site/src/site/xdoc/orm_dtd.xml (added)
+++ db/jdo/site/src/site/xdoc/orm_dtd.xml Sun Jan 13 17:05:15 2013
@@ -0,0 +1,46 @@
+<?xml version="1.0" encoding="iso-8859-1"?>
+<document xmlns="http://maven.apache.org/XDOC/2.0"
+  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+  xsi:schemaLocation="http://maven.apache.org/XDOC/2.0 http://maven.apache.org/xsd/xdoc-2.0.xsd">
+    <properties>
+        <title>ORM DTD</title>
+    </properties>
+    <body>
+        <section name="Meta-Data - ORM">
+            <p>
+                JDO defines XML MetaData in <b>jdo</b> files as well as <b>orm</b> files.
+                As always with XML, the metadata must match the defined DTD/XSD for that file type.
+                This section describes the content of the <b>orm</b> files.
+                The content of <b>jdo</b> files can be found <a href="jdo_dtd.html">here</a>.
+                All <b>orm</b> files must contain a valid DTD/DOCTYPE specification. You can use PUBLIC or SYSTEM versions of these.
+            </p>
+            <p>
+                Here are a couple of examples valid for <b>orm</b> files with DTD specification
+            </p>
+            <source><![CDATA[
+<!DOCTYPE orm PUBLIC
+    "-//Sun Microsystems, Inc.//DTD Java Data Objects Mapping Metadata 3.0//EN"
+    "http://java.sun.com/dtd/orm_3_0.dtd">
+
+
+<!DOCTYPE orm SYSTEM "file:/javax/jdo/orm.dtd">]]></source>
+            <br/>
+            <p>
+                Here is an example valid for <b>orm</b> files with XSD specification
+            </p>
+            <source><![CDATA[
+<?xml version="1.0" encoding="UTF-8" ?>
+<orm xmlns="http://java.sun.com/xml/ns/jdo/orm"
+     xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+     xsi:schemaLocation="http://java.sun.com/xml/ns/jdo/orm
+        http://java.sun.com/xml/ns/jdo/orm_3_0.xsd">
+    ...
+</orm>]]></source>
+            <p>
+                Your MetaData should match either the <a href="http://java.sun.com/dtd/orm_3_0.dtd" target="_blank">DTD</a>
+                or the <a href="http://java.sun.com/xml/ns/jdo/orm_3_0.xsd" target="_blank">XSD</a> specification.
+            </p>
+
+        </section>
+    </body>
+</document>

Added: db/jdo/site/src/site/xdoc/pm.xml
URL: http://svn.apache.org/viewvc/db/jdo/site/src/site/xdoc/pm.xml?rev=1432659&view=auto
==============================================================================
--- db/jdo/site/src/site/xdoc/pm.xml (added)
+++ db/jdo/site/src/site/xdoc/pm.xml Sun Jan 13 17:05:15 2013
@@ -0,0 +1,214 @@
+<?xml version="1.0" encoding="iso-8859-1"?>
+<document xmlns="http://maven.apache.org/XDOC/2.0"
+  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+  xsi:schemaLocation="http://maven.apache.org/XDOC/2.0 http://maven.apache.org/xsd/xdoc-2.0.xsd">
+    <properties>
+        <title>Persistence Manager</title>
+    </properties>
+
+    <body>
+        <section name="Persistence Manager">
+            <p>
+                Any JDO-enabled application will require at least one <i>PersistenceManager</i> (PM).
+                This is obtained from the <a href="pmf.html">PersistenceManagerFactory</a> for the datastore.
+            </p>
+            <p>
+                The simplest way of creating a <i>PersistenceManager</i> 
+                <a href="api20/apidocs/javax/jdo/PersistenceManager.html" target="_blank"><img alt="" src="images/javadoc.gif"/></a>
+                is as follows
+            </p>
+            <source>
+PersistenceManagerFactory pmf = JDOHelper.getPersistenceManagerFactory(props);
+PersistenceManager pm = pmf.getPersistenceManager();</source>
+            <p>
+                A <i>PersistenceManager</i> is the key to all persistence operations in JDO. With it you can
+                persist, update, delete, and retrieve objects from the datastore. A <i>PersistenceManager</i>
+                has a single transaction.
+            </p>
+            <br/>
+
+            <subsection name="Persist Objects">
+                <p>
+                    To persist an object, the object must first be marked as persistable using
+                    <a href="metadata.html">MetaData (XML/Annotations)</a>. Then you would start the
+                    PM transaction, and use <i>makePersistent</i> as follows
+                </p>
+                <source>
+PersistenceManager pm = pmf.getPersistenceManager();
+Transaction tx = pm.currentTransaction();
+try
+{
+    // Start the transaction
+    tx.begin();
+
+    // Create the object to persist
+    MyClass obj = new MyClass();
+
+    // Persist it to the datastore
+    pm.makePersistent(obj);
+
+    // Commit the transaction, flushing the object to the datastore
+    tx.commit();
+}
+catch (Exception e)
+{
+    ... handle exceptions
+}
+finally
+{
+    if (tx.isActive())
+    {
+        // Error occurred so rollback the transaction
+        tx.rollback();
+    }
+    pm.close();
+}</source>
+                <p>
+                    The <i>makePersistent</i> method of <b>PersistenceManager</b> makes the object persistent in 
+                    the datastore, and updates the 'state' of the object from <i>Transient</i> (at the start) 
+                    to <i>Hollow</i> (after commit() of the transaction).
+                </p>
+                <p>
+                    When an object is persisted, if it has any other objects referenced from that object they 
+                    also will be made persistent. This is referred to as <b>persistence-by-reachability</b>. 
+                    The main benefit of this is that if you have an object graph to persist, then you don't 
+                    need to call <i>makePersistent()</i> on all objects, instead just using one that can be 
+                    used to find all of the others. <b>persistence-by-reachability</b> is also run at the time of
+                    calling <i>commit()</i> on the transaction. This has the effect that if you had called 
+                    <i>makePersistent()</i> on an object and that had persisted another object, and before 
+                    commit you had removed the relation to this other object, then at <i>commit()</i> the 
+                    reachability algorithm will find that this other object is no longer reachable and will 
+                    remove it from persistence.
+                </p>
+                <br/>
+            </subsection>
+
+            <subsection name="Retrieve Objects">
+                <p>
+                    So we've made some of our objects persistent, and now we want to retrieve them in 
+                    our application. Here's one way of retrieving objects of a particular type.
+                </p>
+                <source>
+tx = pm.currentTransaction();
+try
+{
+    tx.begin();
+
+    Extent e = pm.getExtent(mydomain.MyClass.class, true);
+    Iterator iter=e.iterator();
+    while (iter.hasNext())
+    {
+        MyClass my_obj=(MyClass)iter.next();
+        ...
+    }
+
+    tx.commit();
+}
+catch (Exception e)
+{
+    if (tx.isActive())
+    {
+        tx.rollback();
+    }
+}</source>
+                <p>
+                    The <b>Extent</b> interface is one of the ways to retrieve your objects. 
+                    The others use the <b>Query</b> interface, allowing more precise filtering over the 
+                    objects returned.
+                </p>
+                <br/>
+            </subsection>
+
+            <subsection name="Update Objects">
+                <p>
+                    To update an object we firstly retrieve it, as above, and then we call any of its
+                    mutator methods. For example
+                </p>
+                <source>
+tx = pm.currentTransaction();
+try
+{
+    tx.begin();
+
+    Extent e = pm.getExtent(mydomain.MyClass.class, true);
+    Iterator iter=e.iterator();
+    while (iter.hasNext())
+    {
+        MyClass my_obj=(MyClass)iter.next();
+        my_obj.setValue(25.0); // Change the value
+        ...
+    }
+
+    tx.commit();
+}
+catch (Exception e)
+{
+    if (tx.isActive())
+    {
+        tx.rollback();
+    }
+}</source>
+                <p>
+                    When <i>setValue()</i> is called on the persistent object this change is intercepted
+                    by JDO and the value change will be automatically sent to the datastore ... transparently!
+                </p>
+                <br/>
+            </subsection>
+
+            <subsection name="Delete Objects">
+                <p>
+                    So we can persist objects, and retrieve them. Now we want to remove one from persistence.
+                </p>
+                <source>try
+{
+    tx = pm.currentTransaction();
+    tx.begin();
+
+    ... (code to retrieve object in question) ...
+
+    pm.deletePersistent(my_obj);
+
+    tx.commit();
+}
+catch (Exception e)
+{
+    if (tx.isActive())
+    {
+        tx.rollback();
+    }
+}</source>
+                <br/>
+            </subsection>
+
+            <subsection name="Making an object transient">
+                <p>
+                    As we have seen in the <a href="state_transition.html">JDO States guide</a>, an object can 
+                    have many possible states. When we want to take an object and work on it, but removing 
+                    its identity we can make it <b>transient</b>. This means that it will retain the values 
+                    of its fields, yet will no longer be associated with the object in the datastore. 
+                    We do this as follows
+                </p>
+                <source>try
+{
+    tx = pm.currentTransaction();
+    tx.begin();
+
+    ... (code to retrieve object in question) ...
+
+    pm.makeTransient(my_obj);
+
+    tx.commit();
+}
+catch (Exception e)
+{
+    if (tx.isActive())
+    {
+        tx.rollback();
+    }
+}
+
+... (code to work on "my_obj")</source>
+            </subsection>
+        </section>
+    </body>
+</document>

Added: db/jdo/site/src/site/xdoc/pmf.xml
URL: http://svn.apache.org/viewvc/db/jdo/site/src/site/xdoc/pmf.xml?rev=1432659&view=auto
==============================================================================
--- db/jdo/site/src/site/xdoc/pmf.xml (added)
+++ db/jdo/site/src/site/xdoc/pmf.xml Sun Jan 13 17:05:15 2013
@@ -0,0 +1,447 @@
+<?xml version="1.0" encoding="iso-8859-1"?>
+<document xmlns="http://maven.apache.org/XDOC/2.0"
+  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+  xsi:schemaLocation="http://maven.apache.org/XDOC/2.0 http://maven.apache.org/xsd/xdoc-2.0.xsd">
+    <properties>
+        <title>Persistence Manager Factory</title>
+    </properties>
+
+    <body>
+        <section name="Persistence Manager Factory">
+            <p>
+                Any JDO-enabled application will require at least one <i>PersistenceManagerFactory</i>. 
+                Typically applications create one per datastore being utilised. A 
+                <i>PersistenceManagerFactory</i> provides access to <i>PersistenceManager</i>s which allow 
+                objects to be persisted, and retrieved. The <i>PersistenceManagerFactory</i> can be configured
+                to provide particular behaviour.
+            </p>
+            <p>
+                The simplest way of creating a <i>PersistenceManagerFactory</i> 
+                <a href="api20/apidocs/javax/jdo/PersistenceManagerFactory.html" target="_blank"><img alt="" src="images/javadoc.gif"/></a>
+                is as follows
+            </p>
+            <source>
+Properties properties = new Properties();
+properties.setProperty("javax.jdo.PersistenceManagerFactoryClass",
+                "{my_implementation_pmf_class}");
+properties.setProperty("javax.jdo.option.ConnectionDriverName","com.mysql.jdbc.Driver");
+properties.setProperty("javax.jdo.option.ConnectionURL","jdbc:mysql://localhost/myDB");
+properties.setProperty("javax.jdo.option.ConnectionUserName","login");
+properties.setProperty("javax.jdo.option.ConnectionPassword","password");
+PersistenceManagerFactory pmf = JDOHelper.getPersistenceManagerFactory(properties);</source>
+            <p>
+                A slight variation on this, is to use a file ("jdo.properties" for example) to specify these 
+                properties like this
+            </p>
+            <source>
+javax.jdo.PersistenceManagerFactoryClass={my_implementation_pmf_class}
+javax.jdo.option.ConnectionDriverName=com.mysql.jdbc.Driver
+javax.jdo.option.ConnectionURL=jdbc:mysql://localhost/myDB
+javax.jdo.option.ConnectionUserName=login
+javax.jdo.option.ConnectionPassword=password</source>
+            <p>
+                and then to create the <i>PersistenceManagerFactory</i> using this file
+            </p>
+            <source>
+PersistenceManagerFactory pmf = JDOHelper.getPersistenceManagerFactory("jdo.properties");</source>
+            <p>
+                A final alternative would be to call 
+                <i>JDOHelper.getPersistenceManagerFactory(jndiLocation, context);</i>, hence
+                accessing the properties via JNDI.
+            </p>
+            <p>
+                Whichever way we wish to obtain the <i>PersistenceManagerFactory</i> we have defined a 
+                series of properties to give the behaviour of the <i>PersistenceManagerFactory</i>. 
+                The first property specifies to use PMF of the implementation required to be used,
+                and the following 4 properties define the datastore that it should connect to.
+            </p>
+            <br/>
+
+            <subsection name="Standard JDO Properties">
+                <table>
+                    <tr>
+                        <th colspan="2">
+                            <b>javax.jdo.PersistenceManagerFactoryClass</b>
+                        </th>
+                    </tr>
+                    <tr>
+                        <td width="120">Description</td>
+                        <td>The name of the PersistenceManager implementation</td>
+                    </tr>
+                </table>
+                <br/>
+                <table>
+                    <tr>
+                        <th colspan="2">
+                            <b>javax.jdo.option.ConnectionFactory</b>
+                        </th>
+                    </tr>
+                    <tr>
+                        <td width="120">Description</td>
+                        <td>Instance of a connection factory. For RBDMS, it must be an instance of 
+                            javax.sql.DataSource. <b>This is for a transactional DataSource</b></td>
+                    </tr>
+                </table>
+                <br/>
+                <table>
+                    <tr>
+                        <th colspan="2">
+                            <b>javax.jdo.option.ConnectionFactory2</b>
+                        </th>
+                    </tr>
+                    <tr>
+                        <td width="120">Description</td>
+                        <td>Instance of a connection factory. For RBDMS, it must be an instance of 
+                            javax.sql.DataSource. <b>This is for a non-transactional DataSource</b></td>
+                    </tr>
+                </table>
+                <br/>
+                <table>
+                    <tr>
+                        <th colspan="2">
+                            <b>javax.jdo.option.ConnectionFactoryName</b>
+                        </th>
+                    </tr>
+                    <tr>
+                        <td width="120">Description</td>
+                        <td>The JNDI name for a connection factory. For RBDMS, it must be a JNDI name 
+                            that points to a javax.sql.DataSource object. 
+                            <b>This is for a transactional DataSource</b></td>
+                    </tr>
+                </table>
+                <br/>
+                <table>
+                    <tr>
+                        <th colspan="2">
+                            <b>javax.jdo.option.ConnectionFactory2Name</b>
+                        </th>
+                    </tr>
+                    <tr>
+                        <td width="120">Description</td>
+                        <td>The JNDI name for a connection factory. For RBDMS, it must be a JNDI name 
+                            that points to a javax.sql.DataSource object.
+                            <b>This is for a non-transactional DataSource</b></td>
+                    </tr>
+                </table>
+                <br/>
+                <table>
+                    <tr>
+                        <th colspan="2">
+                            <b>javax.jdo.option.ConnectionDriverName</b>
+                        </th>
+                    </tr>
+                    <tr>
+                        <td width="120">Description</td>
+                        <td>The name of the driver to use for the DB</td>
+                    </tr>
+                </table>
+                <br/>
+                <table>
+                    <tr>
+                        <th colspan="2">
+                            <b>javax.jdo.option.ConnectionDriverURL</b>
+                        </th>
+                    </tr>
+                    <tr>
+                        <td width="120">Description</td>
+                        <td>URL specifying the datastore to use for persistence</td>
+                    </tr>
+                </table>
+                <br/>
+                <table>
+                    <tr>
+                        <th colspan="2">
+                            <b>javax.jdo.option.ConnectionUserName</b>
+                        </th>
+                    </tr>
+                    <tr>
+                        <td width="120">Description</td>
+                        <td>Username to use for connecting to the DB</td>
+                    </tr>
+                </table>
+                <br/>
+                <table>
+                    <tr>
+                        <th colspan="2">
+                            <b>javax.jdo.option.ConnectionPassword</b>
+                        </th>
+                    </tr>
+                    <tr>
+                        <td width="120">Description</td>
+                        <td>Password to use for connecting to the DB</td>
+                    </tr>
+                </table>
+                <br/>
+                <table>
+                    <tr>
+                        <th colspan="2">
+                            <b>javax.jdo.option.IgnoreCache</b>
+                        </th>
+                    </tr>
+                    <tr>
+                        <td width="120">Description</td>
+                        <td>Whether to ignore the cache for queries</td>
+                    </tr>
+                    <tr>
+                        <td>Range of Values</td>
+                        <td>true | false</td>
+                    </tr>
+                </table>
+                <br/>
+                <table>
+                    <tr>
+                        <th colspan="2">
+                            <b>javax.jdo.option.Multithreaded</b>
+                        </th>
+                    </tr>
+                    <tr>
+                        <td width="120">Description</td>
+                        <td>Whether to run the PersistenceManager multithreaded</td>
+                    </tr>
+                    <tr>
+                        <td>Range of Values</td>
+                        <td>true | false</td>
+                    </tr>
+                </table>
+                <br/>
+                <table>
+                    <tr>
+                        <th colspan="2">
+                            <b>javax.jdo.option.NontransactionalRead</b>
+                        </th>
+                    </tr>
+                    <tr>
+                        <td width="120">Description</td>
+                        <td>Whether to allow nontransactional reads</td>
+                    </tr>
+                    <tr>
+                        <td>Range of Values</td>
+                        <td>true | false</td>
+                    </tr>
+                </table>
+                <br/>
+                <table>
+                    <tr>
+                        <th colspan="2">
+                            <b>javax.jdo.option.NontransactionalWrite</b>
+                        </th>
+                    </tr>
+                    <tr>
+                        <td width="120">Description</td>
+                        <td>Whether to allow nontransactional writes</td>
+                    </tr>
+                    <tr>
+                        <td>Range of Values</td>
+                        <td>true | false</td>
+                    </tr>
+                </table>
+                <br/>
+                <table>
+                    <tr>
+                        <th colspan="2">
+                            <b>javax.jdo.option.Optimistic</b>
+                        </th>
+                    </tr>
+                    <tr>
+                        <td width="120">Description</td>
+                        <td>Whether to use <a href="transactions.html">Optimistic transactions</a></td>
+                    </tr>
+                    <tr>
+                        <td>Range of Values</td>
+                        <td>true | false</td>
+                    </tr>
+                </table>
+                <br/>
+                <table>
+                    <tr>
+                        <th colspan="2">
+                            <b>javax.jdo.option.RetainValues</b>
+                        </th>
+                    </tr>
+                    <tr>
+                        <td width="120">Description</td>
+                        <td>Whether to suppress the clearing of values from persistent instances on transaction
+                            completion</td>
+                    </tr>
+                    <tr>
+                        <td>Range of Values</td>
+                        <td>true | false</td>
+                    </tr>
+                </table>
+                <br/>
+                <table>
+                    <tr>
+                        <th colspan="2">
+                            <b>javax.jdo.option.RestoreValues</b>
+                        </th>
+                    </tr>
+                    <tr>
+                        <td width="120">Description</td>
+                        <td>Whether persistent object have transactional field values restored when 
+                            transaction rollback occurs.</td>
+                    </tr>
+                    <tr>
+                        <td>Range of Values</td>
+                        <td>true | false</td>
+                    </tr>
+                </table>
+                <br/>
+                <table>
+                    <tr>
+                        <th colspan="2">
+                            <b>javax.jdo.option.Mapping</b>
+                        </th>
+                    </tr>
+                    <tr>
+                        <td width="120">Description</td>
+                        <td>Name for the ORM MetaData mapping files to use with this PMF. For example if this is set to 
+                            "mysql" then the implementation looks for MetaData mapping files called 
+                            "{classname}-mysql.orm" or "package-mysql.orm". If this is not specified then the JDO 
+                            implementation assumes that all is specified in the JDO MetaData file.
+                            <i>ORM datastores only</i></td>
+                    </tr>
+                </table>
+                <br/>
+                <table>
+                    <tr>
+                        <th colspan="2">
+                            <b>javax.jdo.mapping.Catalog</b>
+                        </th>
+                    </tr>
+                    <tr>
+                        <td width="120">Description</td>
+                        <td>Name of the catalog to use by default for all classes persisted using this PMF.
+                            This can be overridden in the MetaData where required, and is optional.
+                            JPOX will prefix all table names with this catalog name if the RDBMS supports specification
+                            of catalog names in DDL.
+                            <i>ORM datastores only</i></td>
+                    </tr>
+                </table>
+                <br/>
+                <table>
+                    <tr>
+                        <th colspan="2">
+                            <b>javax.jdo.mapping.Schema</b>
+                        </th>
+                    </tr>
+                    <tr>
+                        <td width="120">Description</td>
+                        <td>Name of the schema to use by default for all classes persisted using this PMF.
+                            This can be overridden in the MetaData where required, and is optional.
+                            JPOX will prefix all table names with this schema name if the RDBMS supports specification
+                            of schema names in DDL.
+                            <i>ORM datastores only</i></td>
+                    </tr>
+                </table>
+                <br/>
+                <table>
+                    <tr>
+                        <th colspan="2"><b>javax.jdo.option.DetachAllOnCommit</b></th>
+                    </tr>
+                    <tr>
+                        <td width="120">Description</td>
+                        <td>Allows the user to select that when a transaction is committed all objects 
+                            enlisted in that transaction will be automatically detached.</td>
+                    </tr>
+                    <tr>
+                        <td>Range of Values</td>
+                        <td>true | <b>false</b></td>
+                    </tr>
+                </table>
+                <br/>
+                <table>
+                    <tr>
+                        <th colspan="2"><b>javax.jdo.option.CopyOnAttach</b></th>
+                    </tr>
+                    <tr>
+                        <td width="120">Description</td>
+                        <td>Whether, when attaching a detached object, we create an attached copy or simply
+                            migrate the detached object to attached state. This is from JDO 2.1</td>
+                    </tr>
+                    <tr>
+                        <td>Range of Values</td>
+                        <td><b>true</b> | false</td>
+                    </tr>
+                </table>
+                <br/>
+                <table>
+                    <tr>
+                        <th colspan="2"><b>javax.jdo.option.TransactionType</b></th>
+                    </tr>
+                    <tr>
+                        <td width="120">Description</td>
+                        <td>Type of transaction to use. If running under J2SE the default is RESOURCE_LOCAL, and
+                            if running under J2EE the default is JTA.</td>
+                    </tr>
+                    <tr>
+                        <td>Range of Values</td>
+                        <td>RESOURCE_LOCAL | JTA</td>
+                    </tr>
+                </table>
+                <br/>
+                <table>
+                    <tr>
+                        <th colspan="2"><b>javax.jdo.option.PersistenceUnitName</b></th>
+                    </tr>
+                    <tr>
+                        <td width="120">Description</td>
+                        <td>Name of the "persistence-unit" to use with this PMF. This borrows the 
+                            "persistence-unit" concept from JPA for use with JDO 2.1.</td>
+                    </tr>
+                </table>
+                <br/>
+                <table>
+                    <tr>
+                        <th colspan="2"><b>javax.jdo.option.ServerTimeZoneID</b></th>
+                    </tr>
+                    <tr>
+                        <td width="120">Description</td>
+                        <td>Id of the TimeZone under which the datastore server is running. 
+                            If this is not specified or is set to null it is assumed that the datastore server
+                            is running in the same timezone as the JVM under which the implementation is running.</td>
+                    </tr>
+                </table>
+                <br/>
+                <table>
+                    <tr>
+                        <th colspan="2"><b>javax.jdo.option.Name</b></th>
+                    </tr>
+                    <tr>
+                        <td width="120">Description</td>
+                        <td>Name of the PMF. This is for use with "named PMF" functionality in JDO 2.1</td>
+                    </tr>
+                </table>
+                <br/>
+                <table>
+                    <tr>
+                        <th colspan="2"><b>javax.jdo.option.ReadOnly</b></th>
+                    </tr>
+                    <tr>
+                        <td width="120">Description</td>
+                        <td>Whether this datastore should be treated as read only. Added in JDO 2.2</td>
+                    </tr>
+                    <tr>
+                        <td>Range of Values</td>
+                        <td>true | <b>false</b></td>
+                    </tr>
+                </table>
+                <br/>
+                <table>
+                    <tr>
+                        <th colspan="2"><b>javax.jdo.option.TransactionIsolationLevel</b></th>
+                    </tr>
+                    <tr>
+                        <td width="120">Description</td>
+                        <td>Isolation level to use for connections in the current transaction. Added in JDO 2.2</td>
+                    </tr>
+                    <tr>
+                        <td>Range of Values</td>
+                        <td>none | read-committed | read-uncommitted | repeatable-read | snapshot | serializable</td>
+                    </tr>
+                </table>
+                <br/>
+                <br/>
+            </subsection>
+        </section>
+    </body>
+</document>

Added: db/jdo/site/src/site/xdoc/references.xml
URL: http://svn.apache.org/viewvc/db/jdo/site/src/site/xdoc/references.xml?rev=1432659&view=auto
==============================================================================
--- db/jdo/site/src/site/xdoc/references.xml (added)
+++ db/jdo/site/src/site/xdoc/references.xml Sun Jan 13 17:05:15 2013
@@ -0,0 +1,67 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+
+<!--
+
+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.
+-->
+
+<document xmlns="http://maven.apache.org/XDOC/2.0"
+  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+  xsi:schemaLocation="http://maven.apache.org/XDOC/2.0 http://maven.apache.org/xsd/xdoc-2.0.xsd">
+    <properties>
+        <title>References</title>
+        <author email="jdo-dev@db.apache.org">JDO Documentation Team</author>
+    </properties>
+
+    <body>
+    <section name="JDO References">
+        <subsection name="Articles">
+            <p>
+            There have been several articles about JDO on various websites. Some are listed below
+            </p>
+            <ul>
+            <li>SUN : <a target="_blank" href="http://java.sun.com/products/jdo/">JDO Web Site</a></li>
+            <li>SUN : <a target="_blank" href="http://java.sun.com/developer/technicalArticles/J2SE/jdo/">Getting started with JDO</a></li>
+            <li>TheServerSide.com : <a href="http://www.theserverside.com/discussions/thread.tss?thread_id=771">discussion on JDO and Entity Beans</a></li>
+            <li>TheServerSide.com : <a target="_blank" href="http://www.theserverside.com/articles/article.tss?l=JDOQueryPart1">JDO 2 Queries - Methods, Paging, Unbound Variables</a></li>
+            <li>TheServerSide.com : <a target="_blank" href="http://www.theserverside.com/articles/article.tss?l=JDOQueryPart2">JDO 2 Queries - Projections, Aggregates</a></li>
+            <li>DevX.com : <a target="_blank" href="http://www.devx.com/java/article/16373/">JDO brings DB Programming into 21st Century Despite Controversy</a> by Dirk Bartels</li>
+            <li><a target="_blank" href="http://www.mainejug.org/jug/meetings/010829/index.htm">Java Data Objects</a> by David Ezzio</li>
+			<li><a target="_blank" href="http://www-128.ibm.com/developerworks/db2/library/techarticle/dm-0506bhogal/">Introduction to JDO2 using JPOX and DB2</a></li>
+            <li><a target="_blank" href="http://db.apache.org/derby/integrate/JPOX_Derby.html">Using JPOX with Apache Derby</a></li>
+            </ul>
+            <br/>
+        </subsection>
+
+        <subsection name="Books">
+            <p>
+            A number of books covering JDO are available. Some are listed below
+            </p>
+            <ul>
+            <li><a href="http://www.oreilly.com/catalog/jvadtaobj/">
+                <u>Java Data Objects</u></a> by Craig Russell and David Jordan. Publisher: O'Reilly
+            </li> 
+            <li><a href="http://www.phptr.com/bookstore/product.asp?isbn=0131407317&amp;rl=1">
+            <u>Core Java Data Objects</u></a> by Sameer Tyagi, Michael Vorburger, Keiron McCammon, Heiko Bobzin. Publisher: Prentice Hall
+            </li>
+            </ul>      
+            <br/>
+        </subsection>
+
+</section>
+</body>
+</document>
+

Added: db/jdo/site/src/site/xdoc/releases/release-2.0-beta.xml
URL: http://svn.apache.org/viewvc/db/jdo/site/src/site/xdoc/releases/release-2.0-beta.xml?rev=1432659&view=auto
==============================================================================
--- db/jdo/site/src/site/xdoc/releases/release-2.0-beta.xml (added)
+++ db/jdo/site/src/site/xdoc/releases/release-2.0-beta.xml Sun Jan 13 17:05:15 2013
@@ -0,0 +1,103 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<document>
+	<properties>
+<title>Apache JDO 2.0 Release</title>
+<author email="jdoj-dev@db.apache.org">JDO Documentation Team</author>
+</properties>
+<body>
+
+	<section name="JDO 2.0 Beta Distributions">
+
+            <p>Use the links below to download a distribution of Apache JDO from one of our mirrors. To run the Technology Compatibility Kit (TCK), you need only download and extract jdo2-tck-2.0-beta-src-24_Jan_2006.zip, follow the instructions in the Prerequisites section of README.txt, and then follow the procedure in RunRules.html in the jdo2-tck-2.0-beta directory.
+All the distributions below may be extracted into the same directory.</p>
+            <p>It is good practice to <a href="#Verifying">verify the integrity</a> of the distribution files.</p>
+<p>You are currently using <strong>[preferred]</strong>. If you encounter a problem with this mirror, then please select another. If all mirrors are failing, there are backup mirrors at the end of the list. See <a href="http://www.apache.org/mirrors/">status</a> of mirrors.</p>
+<form action="[location]" method="get" id="SelectMirror">
+Other mirrors: <select name="Preferred">
+[if-any http]
+  [for http]<option value="[http]">[http]</option>[end]
+[end]  
+[if-any ftp]
+  [for ftp]<option value="[ftp]">[ftp]</option>[end]
+[end]
+[if-any backup]
+  [for backup]<option value="[backup]">[backup] (backup)</option>[end]
+[end]
+</select>
+<input type="submit" value="Change" />
+</form>
+<p>
+<a href="[preferred]/db/jdo/2.0-beta/jdo2-tck-2.0-beta-src-24_Jan_2006.zip">jdo2-tck-2.0-beta-src-24_Jan_2006.zip</a>
+[<a href="http://www.apache.org/dist/db/jdo/2.0-beta/jdo2-tck-2.0-beta-src-24_Jan_2006.zip.asc">PGP</a>]
+[<a href="http://www.apache.org/dist/db/jdo/2.0-beta/jdo2-tck-2.0-beta-src-24_Jan_2006.zip.md5">MD5</a>]
+</p>
+                                                <p>
+<a href="[preferred]/db/jdo/2.0-beta/jdo2-enhancer-2.0-beta-src.zip">jdo2-enhancer-2.0-beta-src.zip</a>
+[<a href="http://www.apache.org/dist/db/jdo/2.0-beta/jdo2-enhancer-2.0-beta-src.zip.asc">PGP</a>]
+[<a href="http://www.apache.org/dist/db/jdo/2.0-beta/jdo2-enhancer-2.0-beta-src.zip.md5">MD5</a>]
+</p>
+                                                <p>
+<a href="[preferred]/db/jdo/2.0-beta/jdo2-enhancer-2.0-beta-src.tar.gz">jdo2-enhancer-2.0-beta-src.tar.gz</a>
+[<a href="http://www.apache.org/dist/db/jdo/2.0-beta/jdo2-enhancer-2.0-beta-src.tar.gz.asc">PGP</a>]
+[<a href="http://www.apache.org/dist/db/jdo/2.0-beta/jdo2-enhancer-2.0-beta-src.tar.gz.md5">MD5</a>]
+</p>
+                                                <p>
+<a href="[preferred]/db/jdo/2.0-beta/jdo2-core-2.0-beta-src.zip">jdo2-core-2.0-beta-src.zip</a>
+[<a href="http://www.apache.org/dist/db/jdo/2.0-beta/jdo2-core-2.0-beta-src.zip.asc">PGP</a>]
+[<a href="http://www.apache.org/dist/db/jdo/2.0-beta/jdo2-core-2.0-beta-src.zip.md5">MD5</a>]
+</p>
+                                                <p>
+<a href="[preferred]/db/jdo/2.0-beta/jdo2-core-2.0-beta-src.tar.gz">jdo2-core-2.0-beta-src.tar.gz</a>
+[<a href="http://www.apache.org/dist/db/jdo/2.0-beta/jdo2-core-2.0-beta-src.tar.gz.asc">PGP</a>]
+[<a href="http://www.apache.org/dist/db/jdo/2.0-beta/jdo2-core-2.0-beta-src.tar.gz.md5">MD5</a>]
+</p>
+                                                <p>
+<a href="[preferred]/db/jdo/2.0-beta/jdo2-api-2.0-beta-src.zip">jdo2-api-2.0-beta-src.zip</a>
+[<a href="http://www.apache.org/dist/db/jdo/2.0-beta/jdo2-api-2.0-beta-src.zip.asc">PGP</a>]
+[<a href="http://www.apache.org/dist/db/jdo/2.0-beta/jdo2-api-2.0-beta-src.zip.md5">MD5</a>]
+</p>
+                                                <p>
+<a href="[preferred]/db/jdo/2.0-beta/jdo2-api-2.0-beta-src.tar.gz">jdo2-api-2.0-beta-src.tar.gz</a>
+[<a href="http://www.apache.org/dist/db/jdo/2.0-beta/jdo2-api-2.0-beta-src.tar.gz.asc">PGP</a>]
+[<a href="http://www.apache.org/dist/db/jdo/2.0-beta/jdo2-api-2.0-beta-src.tar.gz.md5">MD5</a>]
+</p> 
+</section>
+<section name="Verifying Releases">
+<a name="Verifying"></a>
+<p>It is essential that you verify the integrity of the downloaded
+files using the PGP signature or the SHA1 or MD5 checksums.  The
+checksums are not as strong indicators as the PGP signature.</p>
+<p>The PGP signatures can be verified using PGP or GPG.
+First download the <a href="http://www.apache.org/dist/db/jdo/KEYS">KEYS</a>
+as well as the <code>asc</code> signature file for the particular
+distribution.
+Make sure you get these files from the <a href="http://www.apache.org/dist/db/jdo/">main distribution
+directory</a>, rather than from a mirror. Then verify the signatures
+using</p>
+<p><code>
+% pgpk -a KEYS<br />
+% pgpv <i>release_name</i>.tar.gz.asc<br />
+</code>
+<em>or</em><br />
+<code>
+% pgp -ka KEYS<br />
+% pgp <i>release_name</i>.tar.gz.asc<br />
+</code>
+<em>or</em><br />
+<code>
+% gpg --import KEYS<br/>
+% gpg --verify <i>release_name</i>.tar.gz.asc
+</code></p>
+<p>Alternatively, you can verify the checksums on the files.  Unix
+programs called <code>md5</code>/<code>sha1</code> or
+<code>md5sum</code>/<code>sha1sum</code> are included in many unix
+distributions.  <code>*sum</code> is also available as part of
+<a href="http://www.gnu.org/software/textutils/textutils.html">GNU Textutils</a>.
+Windows users can get binary md5 programs from <a href="http://www.fourmilab.ch/md5/">http://www.fourmilab.ch/md5</a> and
+<a href="http://www.pc-tools.net/win32/freeware/console/">hhttp://www.pc-tools.net/win32/freeware/console</a>.
+Windows SlavaSoft <a href="http://www.slavasoft.com/fsum/">fsum</a> supports MD5 and
+SHA1.</p>
+<p>We highly recommend verifying the PGP signature, though.</p>
+</section>
+</body>
+</document>

Added: db/jdo/site/src/site/xdoc/releases/release-2.0-rc1.xml
URL: http://svn.apache.org/viewvc/db/jdo/site/src/site/xdoc/releases/release-2.0-rc1.xml?rev=1432659&view=auto
==============================================================================
--- db/jdo/site/src/site/xdoc/releases/release-2.0-rc1.xml (added)
+++ db/jdo/site/src/site/xdoc/releases/release-2.0-rc1.xml Sun Jan 13 17:05:15 2013
@@ -0,0 +1,116 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<document>
+	<properties>
+<title>Apache JDO 2.0 Release</title>
+<author email="jdoj-dev@db.apache.org">JDO Documentation Team</author>
+</properties>
+<body>
+
+	<section name="JDO 2.0 RC1 Distributions">
+
+            <p>Use the links below to download Apache JDO from one of our mirrors.
+                For more information about the projects see <a href="../downloads.html">Downloads</a>.
+                For information on running the TCK, see <a href="../tck.html">TCK</a>.
+                </p>
+               <p>
+                It is good practice to <a href="#Verifying">verify the integrity</a> of the distribution files.
+            </p>
+<p>You are currently using <strong>[preferred]</strong>. If you encounter a problem with this mirror, then please select another. If all mirrors are failing, there are backup mirrors at the end of the list. See <a href="http://www.apache.org/mirrors/">status</a> of mirrors.</p>
+<form action="[location]" method="get" id="SelectMirror">
+Other mirrors: <select name="Preferred">
+[if-any http]
+  [for http]<option value="[http]">[http]</option>[end]
+[end]  
+[if-any ftp]
+  [for ftp]<option value="[ftp]">[ftp]</option>[end]
+[end]
+[if-any backup]
+  [for backup]<option value="[backup]">[backup] (backup)</option>[end]
+[end]
+</select>
+<input type="submit" value="Change" />
+</form>
+<br/>
+    <subsection name="TCK">
+<p>
+<a href="[preferred]/db/jdo/2.0-rc1/jdo2-tck-2.0-rc1-src-22_Feb_2006.zip">jdo2-tck-2.0-rc1-src-22_Feb_2006.zip</a>
+[<a href="http://www.apache.org/dist/db/jdo/2.0-rc1/jdo2-tck-2.0-rc1-src-22_Feb_2006.zip.asc">PGP</a>]
+[<a href="http://www.apache.org/dist/db/jdo/2.0-rc1/jdo2-tck-2.0-rc1-src-22_Feb_2006.zip.md5">MD5</a>]
+</p>
+</subsection>
+    <subsection name="Enhancer">
+                                                <p>
+<a href="[preferred]/db/jdo/2.0-rc1/jdo2-enhancer-2.0-rc1-src.zip">jdo2-enhancer-2.0-rc1-src.zip</a>
+[<a href="http://www.apache.org/dist/db/jdo/2.0-rc1/jdo2-enhancer-2.0-rc1-src.zip.asc">PGP</a>]
+[<a href="http://www.apache.org/dist/db/jdo/2.0-rc1/jdo2-enhancer-2.0-rc1-src.zip.md5">MD5</a>]
+</p>
+                                                <p>
+<a href="[preferred]/db/jdo/2.0-rc1/jdo2-enhancer-2.0-rc1-src.tar.gz">jdo2-enhancer-2.0-rc1-src.tar.gz</a>
+[<a href="http://www.apache.org/dist/db/jdo/2.0-rc1/jdo2-enhancer-2.0-rc1-src.tar.gz.asc">PGP</a>]
+[<a href="http://www.apache.org/dist/db/jdo/2.0-rc1/jdo2-enhancer-2.0-rc1-src.tar.gz.md5">MD5</a>]
+</p>
+</subsection>
+    <subsection name="Core">
+                                                <p>
+<a href="[preferred]/db/jdo/2.0-rc1/jdo2-core-2.0-rc1-src.zip">jdo2-core-2.0-rc1-src.zip</a>
+[<a href="http://www.apache.org/dist/db/jdo/2.0-rc1/jdo2-core-2.0-rc1-src.zip.asc">PGP</a>]
+[<a href="http://www.apache.org/dist/db/jdo/2.0-rc1/jdo2-core-2.0-rc1-src.zip.md5">MD5</a>]
+</p>
+                                                <p>
+<a href="[preferred]/db/jdo/2.0-rc1/jdo2-core-2.0-rc1-src.tar.gz">jdo2-core-2.0-rc1-src.tar.gz</a>
+[<a href="http://www.apache.org/dist/db/jdo/2.0-rc1/jdo2-core-2.0-rc1-src.tar.gz.asc">PGP</a>]
+[<a href="http://www.apache.org/dist/db/jdo/2.0-rc1/jdo2-core-2.0-rc1-src.tar.gz.md5">MD5</a>]
+</p>
+</subsection>
+    <subsection name="API">
+                                                <p>
+<a href="[preferred]/db/jdo/2.0-rc1/jdo2-api-2.0-rc1-src.zip">jdo2-api-2.0-rc1-src.zip</a>
+[<a href="http://www.apache.org/dist/db/jdo/2.0-rc1/jdo2-api-2.0-rc1-src.zip.asc">PGP</a>]
+[<a href="http://www.apache.org/dist/db/jdo/2.0-rc1/jdo2-api-2.0-rc1-src.zip.md5">MD5</a>]
+</p>
+                                                <p>
+<a href="[preferred]/db/jdo/2.0-rc1/jdo2-api-2.0-rc1-src.tar.gz">jdo2-api-2.0-rc1-src.tar.gz</a>
+[<a href="http://www.apache.org/dist/db/jdo/2.0-rc1/jdo2-api-2.0-rc1-src.tar.gz.asc">PGP</a>]
+[<a href="http://www.apache.org/dist/db/jdo/2.0-rc1/jdo2-api-2.0-rc1-src.tar.gz.md5">MD5</a>]
+</p> 
+</subsection>
+</section>
+<section name="Verifying Releases">
+<a name="Verifying"></a>
+<p>It is essential that you verify the integrity of the downloaded
+files using the PGP signature or the SHA1 or MD5 checksums.  The
+checksums are not as strong indicators as the PGP signature.</p>
+<p>The PGP signatures can be verified using PGP or GPG.
+First download the <a href="http://www.apache.org/dist/db/jdo/KEYS">KEYS</a>
+as well as the <code>asc</code> signature file for the particular
+distribution.
+Make sure you get these files from the <a href="http://www.apache.org/dist/db/jdo/">main distribution
+directory</a>, rather than from a mirror. Then verify the signatures
+using</p>
+<p><code>
+% pgpk -a KEYS<br />
+% pgpv <i>release_name</i>.tar.gz.asc<br />
+</code>
+<em>or</em><br />
+<code>
+% pgp -ka KEYS<br />
+% pgp <i>release_name</i>.tar.gz.asc<br />
+</code>
+<em>or</em><br />
+<code>
+% gpg --import KEYS<br/>
+% gpg --verify <i>release_name</i>.tar.gz.asc
+</code></p>
+<p>Alternatively, you can verify the checksums on the files.  Unix
+programs called <code>md5</code>/<code>sha1</code> or
+<code>md5sum</code>/<code>sha1sum</code> are included in many unix
+distributions.  <code>*sum</code> is also available as part of
+<a href="http://www.gnu.org/software/textutils/textutils.html">GNU Textutils</a>.
+Windows users can get binary md5 programs from <a href="http://www.fourmilab.ch/md5/">http://www.fourmilab.ch/md5</a> and
+<a href="http://www.pc-tools.net/win32/freeware/console/">hhttp://www.pc-tools.net/win32/freeware/console</a>.
+Windows SlavaSoft <a href="http://www.slavasoft.com/fsum/">fsum</a> supports MD5 and
+SHA1.</p>
+<p>We highly recommend verifying the PGP signature, though.</p>
+</section>
+</body>
+</document>

Added: db/jdo/site/src/site/xdoc/releases/release-2.0.xml
URL: http://svn.apache.org/viewvc/db/jdo/site/src/site/xdoc/releases/release-2.0.xml?rev=1432659&view=auto
==============================================================================
--- db/jdo/site/src/site/xdoc/releases/release-2.0.xml (added)
+++ db/jdo/site/src/site/xdoc/releases/release-2.0.xml Sun Jan 13 17:05:15 2013
@@ -0,0 +1,180 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<document>
+    <properties>
+        <title>Apache JDO 2.0 Release</title>
+        <author email="jdo-dev@db.apache.org">JDO Documentation Team</author>
+    </properties>
+    <body>
+    <section name="JDO 2.0 Distributions">
+        <p>
+			Use the links below to download Apache JDO from one of our mirrors.
+            For more information about the projects see <a href="../downloads.html">Downloads</a>.
+            For information on running the TCK, see <a href="../tck.html">TCK</a>.
+        </p>
+        <p>
+            It is good practice to <a href="#Verifying">verify the integrity</a> 
+            of the distribution files.
+        </p>
+        <p>
+			You are currently using <strong>[preferred]</strong>. 
+            If you encounter a problem with this mirror, then please select another. 
+            If all mirrors are failing, there are backup mirrors at the end of the list. 
+            See <a href="http://www.apache.org/mirrors/">status</a> of mirrors.
+        </p>
+        <form action="[location]" method="get" id="SelectMirror">
+        Other mirrors: <select name="Preferred">
+            [if-any http]
+              [for http]<option value="[http]">[http]</option>[end]
+            [end]  
+            [if-any ftp]
+              [for ftp]<option value="[ftp]">[ftp]</option>[end]
+            [end]
+            [if-any backup]
+              [for backup]<option value="[backup]">[backup] (backup)</option>[end]
+            [end]
+        </select>
+        <input type="submit" value="Change" />
+        </form>
+        <br/>
+
+        <subsection name="Release Notes">
+            <p>
+            <a href="http://issues.apache.org/jira/secure/ReleaseNote.jspa?version=12310830&amp;styleName=Html&amp;projectId=10630">View release notes for JDO 2.0</a>
+            </p> 
+        </subsection>
+        <subsection name="API">
+			<p>
+				This is the basic download for all users of JDO.
+			</p>
+            <p>
+            <a href="http://www.ibiblio.org/maven/javax.jdo/jars/jdo2-api-2.0.jar">jdo2-api-2.0.jar</a>
+            [<a href="http://www.ibiblio.org/maven/javax.jdo/jars/jdo2-api-2.0.jar.asc">PGP</a>]
+            [<a href="http://www.ibiblio.org/maven/javax.jdo/jars/jdo2-api-2.0.jar.md5">MD5</a>]
+            </p>
+            <p>
+            <a href="http://www.ibiblio.org/maven/javax.jdo/poms/jdo2-api-2.0.pom">jdo2-api-2.0.pom</a>
+            [<a href="http://www.ibiblio.org/maven/javax.jdo/poms/jdo2-api-2.0.pom.asc">PGP</a>]
+            [<a href="http://www.ibiblio.org/maven/javax.jdo/poms/jdo2-api-2.0.pom.md5">MD5</a>]
+            </p>
+            <p>
+            <a href="[preferred]/db/jdo/2.0/jdo2-api-2.0-src.zip">jdo2-api-2.0-src.zip</a>
+            [<a href="http://www.apache.org/dist/db/jdo/2.0/jdo2-api-2.0-src.zip.asc">PGP</a>]
+            [<a href="http://www.apache.org/dist/db/jdo/2.0/jdo2-api-2.0-src.zip.md5">MD5</a>]
+            </p>
+            <p>
+            <a href="[preferred]/db/jdo/2.0/jdo2-api-2.0-src.tar.gz">jdo2-api-2.0-src.tar.gz</a>
+            [<a href="http://www.apache.org/dist/db/jdo/2.0/jdo2-api-2.0-src.tar.gz.asc">PGP</a>]
+            [<a href="http://www.apache.org/dist/db/jdo/2.0/jdo2-api-2.0-src.tar.gz.md5">MD5</a>]
+            </p> 
+        </subsection>
+
+        <subsection name="TCK">
+			<p>
+				This is a download for all implementors of JDO, and for those who want to check
+				how well an implementation is compliant with the JDO specification.
+			</p>
+            <p>
+            <a href="[preferred]/db/jdo/2.0/jdo2-tck-2.0-src.zip">jdo2-tck-2.0-src.zip</a>
+            [<a href="http://www.apache.org/dist/db/jdo/2.0/jdo2-tck-2.0-src.zip.asc">PGP</a>]
+            [<a href="http://www.apache.org/dist/db/jdo/2.0/jdo2-tck-2.0-src.zip.md5">MD5</a>]
+            </p>
+            <p>
+            <a href="[preferred]/db/jdo/2.0/jdo2-tck-2.0-src.tar.gz">jdo2-tck-2.0-src.tar.gz</a>
+            [<a href="http://www.apache.org/dist/db/jdo/2.0/jdo2-tck-2.0-src.tar.gz.asc">PGP</a>]
+            [<a href="http://www.apache.org/dist/db/jdo/2.0/jdo2-tck-2.0-src.tar.gz.md5">MD5</a>]
+            </p>
+        </subsection>
+
+        <subsection name="Enhancer">
+			<p>
+				This is only required by implementors of JDO.
+			</p>
+            <p>
+            <a href="http://www.ibiblio.org/maven/org.apache.jdo/jars/jdo2-enhancer-2.0.jar">jdo2-enhancer-2.0.jar</a>
+            [<a href="http://people.apache.org/repo/m1-ibiblio-rsync-repository/org.apache.jdo/jars/jdo2-enhancer-2.0.jar.asc">PGP</a>]
+            [<a href="http://www.ibiblio.org/maven/org.apache.jdo/jars/jdo2-enhancer-2.0.jar.md5">MD5</a>]
+            </p>
+            <p>
+            <a href="http://www.ibiblio.org/maven/org.apache.jdo/poms/jdo2-enhancer-2.0.pom">jdo2-enhancer-2.0.pom</a>
+            [<a href="http://people.apache.org/repo/m1-ibiblio-rsync-repository/org.apache.jdo/poms/jdo2-enhancer-2.0.pom.asc">PGP</a>]
+            [<a href="http://www.ibiblio.org/maven/org.apache.jdo/poms/jdo2-enhancer-2.0.pom.md5">MD5</a>]
+            </p>
+            <p>
+            <a href="[preferred]/db/jdo/2.0/jdo2-enhancer-2.0-src.zip">jdo2-enhancer-2.0-src.zip</a>
+            [<a href="http://www.apache.org/dist/db/jdo/2.0/jdo2-enhancer-2.0-src.zip.asc">PGP</a>]
+            [<a href="http://www.apache.org/dist/db/jdo/2.0/jdo2-enhancer-2.0-src.zip.md5">MD5</a>]
+            </p>
+            <p>
+            <a href="[preferred]/db/jdo/2.0/jdo2-enhancer-2.0-src.tar.gz">jdo2-enhancer-2.0-src.tar.gz</a>
+            [<a href="http://www.apache.org/dist/db/jdo/2.0/jdo2-enhancer-2.0-src.tar.gz.asc">PGP</a>]
+            [<a href="http://www.apache.org/dist/db/jdo/2.0/jdo2-enhancer-2.0-src.tar.gz.md5">MD5</a>]
+            </p>
+        </subsection>
+
+        <subsection name="Core">
+			<p>
+				This is only required by implementors of JDO.
+			</p>
+            <p>
+            <a href="http://www.ibiblio.org/maven/org.apache.jdo/jars/jdo2-core-2.0.jar">jdo2-core-2.0.jar</a>
+            [<a href="http://people.apache.org/repo/m1-ibiblio-rsync-repository/org.apache.jdo/jars/jdo2-core-2.0.jar.asc">PGP</a>]
+            [<a href="http://www.ibiblio.org/maven/org.apache.jdo/jars/jdo2-core-2.0.jar.md5">MD5</a>]
+            </p>
+            <p>
+            <a href="http://www.ibiblio.org/maven/org.apache.jdo/poms/jdo2-core-2.0.pom">jdo2-core-2.0.pom</a>
+            [<a href="http://people.apache.org/repo/m1-ibiblio-rsync-repository/org.apache.jdo/poms/jdo2-core-2.0.pom.asc">PGP</a>]
+            [<a href="http://www.ibiblio.org/maven/org.apache.jdo/poms/jdo2-core-2.0.pom.md5">MD5</a>]
+            </p>
+            <p>
+            <a href="[preferred]/db/jdo/2.0/jdo2-core-2.0-src.zip">jdo2-core-2.0-src.zip</a>
+            [<a href="http://www.apache.org/dist/db/jdo/2.0/jdo2-core-2.0-src.zip.asc">PGP</a>]
+            [<a href="http://www.apache.org/dist/db/jdo/2.0/jdo2-core-2.0-src.zip.md5">MD5</a>]
+            </p>
+            <p>
+            <a href="[preferred]/db/jdo/2.0/jdo2-core-2.0-src.tar.gz">jdo2-core-2.0-src.tar.gz</a>
+            [<a href="http://www.apache.org/dist/db/jdo/2.0/jdo2-core-2.0-src.tar.gz.asc">PGP</a>]
+            [<a href="http://www.apache.org/dist/db/jdo/2.0/jdo2-core-2.0-src.tar.gz.md5">MD5</a>]
+            </p>
+        </subsection>
+        </section>
+
+<section name="Verifying Releases">
+<a name="Verifying"></a>
+<p>It is essential that you verify the integrity of the downloaded
+files using the PGP signature and/or the MD5 checksum.  The
+checksum is not as strong an indicator as the PGP signature is.</p>
+<p>The PGP signatures can be verified using PGP or GPG.
+First download the <a href="http://www.apache.org/dist/db/jdo/KEYS">KEYS</a>
+as well as the <code>asc</code> signature file for the particular
+distribution.
+Make sure you get these files from the 
+<a href="http://www.apache.org/dist/db/jdo/">main distribution
+directory</a>, rather than from a mirror. Then verify the signatures using
+</p>
+<p><code>
+% pgpk -a KEYS<br />
+% pgpv <i>release_name</i>.tar.gz.asc<br />
+</code>
+<em>or</em><br />
+<code>
+% pgp -ka KEYS<br />
+% pgp <i>release_name</i>.tar.gz.asc<br />
+</code>
+<em>or</em><br />
+<code>
+% gpg --import KEYS<br/>
+% gpg --verify <i>release_name</i>.tar.gz.asc
+</code></p>
+<p>Alternatively, you can verify the checksums on the files.  Unix
+programs called <code>md5</code>/<code>sha1</code> or
+<code>md5sum</code>/<code>sha1sum</code> are included in many unix
+distributions.  <code>*sum</code> is also available as part of
+<a href="http://www.gnu.org/software/textutils/textutils.html">GNU Textutils</a>.
+Windows users can get binary md5 programs from <a href="http://www.fourmilab.ch/md5/">http://www.fourmilab.ch/md5</a> and
+<a href="http://www.pc-tools.net/win32/freeware/console/">hhttp://www.pc-tools.net/win32/freeware/console</a>.
+Windows SlavaSoft <a href="http://www.slavasoft.com/fsum/">fsum</a> supports MD5 and
+SHA1.</p>
+<p>We highly recommend verifying the PGP signature, though.</p>
+        </section>
+    </body>
+</document>

Added: db/jdo/site/src/site/xdoc/releases/release-2.1.1.xml
URL: http://svn.apache.org/viewvc/db/jdo/site/src/site/xdoc/releases/release-2.1.1.xml?rev=1432659&view=auto
==============================================================================
--- db/jdo/site/src/site/xdoc/releases/release-2.1.1.xml (added)
+++ db/jdo/site/src/site/xdoc/releases/release-2.1.1.xml Sun Jan 13 17:05:15 2013
@@ -0,0 +1,224 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<document>
+    <properties>
+        <title>Apache JDO 2.1.1 Release</title>
+        <author email="jdo-dev@db.apache.org">JDO Documentation Team</author>
+    </properties>
+    <body>
+    <section name="JDO 2.1.1 Distributions">
+        <p>
+			Use the links below to download Apache JDO from one of our mirrors.
+            For more information about the projects see <a href="../downloads.html">Downloads</a>.
+            For information on running the TCK, see <a href="../tck.html">TCK</a>.
+        </p>
+        <p>
+            It is good practice to <a href="#Verifying">verify the integrity</a> 
+            of the distribution files.
+        </p>
+        <p>
+			You are currently using <strong>[preferred]</strong>. 
+            If you encounter a problem with this mirror, then please select another. 
+            If all mirrors are failing, there are backup mirrors at the end of the list. 
+            See <a href="http://www.apache.org/mirrors/">status</a> of mirrors.
+        </p>
+        <form action="[location]" method="get" id="SelectMirror">
+        Other mirrors: <select name="Preferred">
+            [if-any http]
+              [for http]<option value="[http]">[http]</option>[end]
+            [end]  
+            [if-any ftp]
+              [for ftp]<option value="[ftp]">[ftp]</option>[end]
+            [end]
+            [if-any backup]
+              [for backup]<option value="[backup]">[backup] (backup)</option>[end]
+            [end]
+        </select>
+        <input type="submit" value="Change" />
+        </form>
+        <br/>
+
+        <subsection name="Release Notes">
+            <p>
+                <a href="https://issues.apache.org/jira/secure/ReleaseNote.jspa?version=12310923&amp;styleName=Html&amp;projectId=10630"
+                    >View release notes for JDO 2.1.1</a>
+            </p> 
+        </subsection>
+        <subsection name="API">
+			<p>
+            The api2 project contains source to build jdo.jar,
+            which defines the JDO API version 2.
+            The jar file is the only artifact needed for users who wish to compile 
+            their programs using the JDO 2 API.
+            It can be downloaded automatically by maven and placed into the local
+            maven repository if you include the
+            proper dependency in your maven project definition. 
+            Use groupId javax.jdo, artifactId jdo2-api, version 2.1.1
+            and define your remote repository as 
+            http://www.ibiblio.org/maven.
+            Alternatively, it can be downloaded manually and put into a location 
+            of your choice.
+			</p>
+            <p>
+            <a href="http://people.apache.org/repo/m1-ibiblio-rsync-repository/javax.jdo/jars/jdo2-api-2.1.1.jar">jdo2-api-2.1.1.jar</a>
+            [<a href="http://people.apache.org/repo/m1-ibiblio-rsync-repository/javax.jdo/jars/jdo2-api-2.1.1.jar.asc">PGP</a>]
+            [<a href="http://people.apache.org/repo/m1-ibiblio-rsync-repository/javax.jdo/jars/jdo2-api-2.1.1.jar.md5">MD5</a>]
+            </p>
+            <p>
+            <a href="http://people.apache.org/repo/m1-ibiblio-rsync-repository/javax.jdo/poms/jdo2-api-2.1.1.pom">jdo2-api-2.1.1.pom</a>
+            [<a href="http://people.apache.org/repo/m1-ibiblio-rsync-repository/javax.jdo/poms/jdo2-api-2.1.1.pom.asc">PGP</a>]
+            [<a href="http://people.apache.org/repo/m1-ibiblio-rsync-repository/javax.jdo/poms/jdo2-api-2.1.1.pom.md5">MD5</a>]
+            </p>
+            <p>
+            <a href="[preferred]/db/jdo/2.1.1/jdo2-api-2.1.1-src.zip">jdo2-api-2.1.1-src.zip</a>
+            [<a href="http://www.apache.org/dist/db/jdo/2.1.1/jdo2-api-2.1.1-src.zip.asc">PGP</a>]
+            [<a href="http://www.apache.org/dist/db/jdo/2.1.1/jdo2-api-2.1.1-src.zip.md5">MD5</a>]
+            </p>
+            <p>
+            <a href="[preferred]/db/jdo/2.1.1/jdo2-api-2.1.1-src.tar.gz">jdo2-api-2.1.1-src.tar.gz</a>
+            [<a href="http://www.apache.org/dist/db/jdo/2.1.1/jdo2-api-2.1.1-src.tar.gz.asc">PGP</a>]
+            [<a href="http://www.apache.org/dist/db/jdo/2.1.1/jdo2-api-2.1.1-src.tar.gz.md5">MD5</a>]
+            </p> 
+        </subsection>
+
+        <subsection name="TCK">
+			<p>
+				This is a download for all implementors of JDO, and for those who want to check
+				how well an implementation is compliant with the JDO specification.
+            The tck2 project contains the JDO 2 Technology Compatibility Kit. 
+            The source distribution is the only artifact needed to be downloaded 
+            by the user.  The dependencies (including the model20 jar,
+            util20 jar, enhancer20 jar, api2 jar, and JPOX)
+            are automatically downloaded by maven as needed to run the TCK.
+
+			</p>
+            <p>
+            <a href="[preferred]/db/jdo/2.1.1/jdo2-tck-2.1.1-src.zip">jdo2-tck-2.1.1-src.zip</a>
+            [<a href="http://www.apache.org/dist/db/jdo/2.1.1/jdo2-tck-2.1.1-src.zip.asc">PGP</a>]
+            [<a href="http://www.apache.org/dist/db/jdo/2.1.1/jdo2-tck-2.1.1-src.zip.md5">MD5</a>]
+            </p>
+            <p>
+            <a href="[preferred]/db/jdo/2.1.1/jdo2-tck-2.1.1-src.tar.gz">jdo2-tck-2.1.1-src.tar.gz</a>
+            [<a href="http://www.apache.org/dist/db/jdo/2.1.1/jdo2-tck-2.1.1-src.tar.gz.asc">PGP</a>]
+            [<a href="http://www.apache.org/dist/db/jdo/2.1.1/jdo2-tck-2.1.1-src.tar.gz.md5">MD5</a>]
+            </p>
+        </subsection>
+
+        <subsection name="Enhancer">
+			<p>
+           The enhancer20 project contains utility classes the tck uses for verifying enhanced files.
+			</p>
+            <p>
+            <a href="http://people.apache.org/repo/m1-ibiblio-rsync-repository/org.apache.jdo/jars/jdo2-enhancer-2.1.1.jar">jdo2-enhancer-2.1.1.jar</a>
+            [<a href="http://people.apache.org/repo/m1-ibiblio-rsync-repository/org.apache.jdo/jars/jdo2-enhancer-2.1.1.jar.asc">PGP</a>]
+            [<a href="http://people.apache.org/repo/m1-ibiblio-rsync-repository/org.apache.jdo/jars/jdo2-enhancer-2.1.1.jar.md5">MD5</a>]
+            </p>
+            <p>
+            <a href="http://people.apache.org/repo/m1-ibiblio-rsync-repository/org.apache.jdo/poms/jdo2-enhancer-2.1.1.pom">jdo2-enhancer-2.1.1.pom</a>
+            [<a href="http://people.apache.org/repo/m1-ibiblio-rsync-repository/org.apache.jdo/poms/jdo2-enhancer-2.1.1.pom.asc">PGP</a>]
+            [<a href="http://people.apache.org/repo/m1-ibiblio-rsync-repository/org.apache.jdo/poms/jdo2-enhancer-2.1.1.pom.md5">MD5</a>]
+            </p>
+            <p>
+            <a href="[preferred]/db/jdo/2.1.1/jdo2-enhancer-2.1.1-src.zip">jdo2-enhancer-2.1.1-src.zip</a>
+            [<a href="http://www.apache.org/dist/db/jdo/2.1.1/jdo2-enhancer-2.1.1-src.zip.asc">PGP</a>]
+            [<a href="http://www.apache.org/dist/db/jdo/2.1.1/jdo2-enhancer-2.1.1-src.zip.md5">MD5</a>]
+            </p>
+            <p>
+            <a href="[preferred]/db/jdo/2.1.1/jdo2-enhancer-2.1.1-src.tar.gz">jdo2-enhancer-2.1.1-src.tar.gz</a>
+            [<a href="http://www.apache.org/dist/db/jdo/2.1.1/jdo2-enhancer-2.1.1-src.tar.gz.asc">PGP</a>]
+            [<a href="http://www.apache.org/dist/db/jdo/2.1.1/jdo2-enhancer-2.1.1-src.tar.gz.md5">MD5</a>]
+            </p>
+        </subsection>
+
+        <subsection name="Model">
+            <p>
+            The model20 project contains the JDO2 metadata model the tck uses.
+        </p>
+            <p>
+            <a href="http://people.apache.org/repo/m1-ibiblio-rsync-repository/org.apache.jdo/jars/jdo2-model-2.1.1.jar">jdo2-model-2.1.1.jar</a>
+            [<a href="http://people.apache.org/repo/m1-ibiblio-rsync-repository/org.apache.jdo/jars/jdo2-model-2.1.1.jar.asc">PGP</a>]
+            [<a href="http://people.apache.org/repo/m1-ibiblio-rsync-repository/org.apache.jdo/jars/jdo2-model-2.1.1.jar.md5">MD5</a>]
+            </p>
+            <p>
+            <a href="http://people.apache.org/repo/m1-ibiblio-rsync-repository/org.apache.jdo/poms/jdo2-model-2.1.1.pom">jdo2-model-2.1.1.pom</a>
+            [<a href="http://people.apache.org/repo/m1-ibiblio-rsync-repository/org.apache.jdo/poms/jdo2-model-2.1.1.pom.asc">PGP</a>]
+            [<a href="http://people.apache.org/repo/m1-ibiblio-rsync-repository/org.apache.jdo/poms/jdo2-model-2.1.1.pom.md5">MD5</a>]
+            </p>
+            <p>
+            <a href="[preferred]/db/jdo/2.1.1/jdo2-model-2.1.1-src.zip">jdo2-model-2.1.1-src.zip</a>
+            [<a href="http://www.apache.org/dist/db/jdo/2.1.1/jdo2-model-2.1.1-src.zip.asc">PGP</a>]
+            [<a href="http://www.apache.org/dist/db/jdo/2.1.1/jdo2-model-2.1.1-src.zip.md5">MD5</a>]
+            </p>
+            <p>
+            <a href="[preferred]/db/jdo/2.1.1/jdo2-model-2.1.1-src.tar.gz">jdo2-model-2.1.1-src.tar.gz</a>
+            [<a href="http://www.apache.org/dist/db/jdo/2.1.1/jdo2-model-2.1.1-src.tar.gz.asc">PGP</a>]
+            [<a href="http://www.apache.org/dist/db/jdo/2.1.1/jdo2-model-2.1.1-src.tar.gz.md5">MD5</a>]
+            </p>
+        </subsection>
+
+        <subsection name="Util">
+			<p>
+                The util project contains utility classes on which the tck project depends.
+			</p>
+            <p>
+            <a href="http://people.apache.org/repo/m1-ibiblio-rsync-repository/org.apache.jdo/jars/jdo2-util-2.1.1.jar">jdo2-util-2.1.1.jar</a>
+            [<a href="http://people.apache.org/repo/m1-ibiblio-rsync-repository/org.apache.jdo/jars/jdo2-util-2.1.1.jar.asc">PGP</a>]
+            [<a href="http://people.apache.org/repo/m1-ibiblio-rsync-repository/org.apache.jdo/jars/jdo2-util-2.1.1.jar.md5">MD5</a>]
+            </p>
+            <p>
+            <a href="http://people.apache.org/repo/m1-ibiblio-rsync-repository/org.apache.jdo/poms/jdo2-util-2.1.1.pom">jdo2-util-2.1.1.pom</a>
+            [<a href="http://people.apache.org/repo/m1-ibiblio-rsync-repository/org.apache.jdo/poms/jdo2-util-2.1.1.pom.asc">PGP</a>]
+            [<a href="http://people.apache.org/repo/m1-ibiblio-rsync-repository/org.apache.jdo/poms/jdo2-util-2.1.1.pom.md5">MD5</a>]
+            </p>
+            <p>
+            <a href="[preferred]/db/jdo/2.1.1/jdo2-util-2.1.1-src.zip">jdo2-util-2.1.1-src.zip</a>
+            [<a href="http://www.apache.org/dist/db/jdo/2.1.1/jdo2-util-2.1.1-src.zip.asc">PGP</a>]
+            [<a href="http://www.apache.org/dist/db/jdo/2.1.1/jdo2-util-2.1.1-src.zip.md5">MD5</a>]
+            </p>
+            <p>
+            <a href="[preferred]/db/jdo/2.1.1/jdo2-util-2.1.1-src.tar.gz">jdo2-util-2.1.1-src.tar.gz</a>
+            [<a href="http://www.apache.org/dist/db/jdo/2.1.1/jdo2-util-2.1.1-src.tar.gz.asc">PGP</a>]
+            [<a href="http://www.apache.org/dist/db/jdo/2.1.1/jdo2-util-2.1.1-src.tar.gz.md5">MD5</a>]
+            </p>
+        </subsection>
+        </section>
+
+<section name="Verifying Releases">
+<a name="Verifying"></a>
+<p>It is essential that you verify the integrity of the downloaded
+files using the PGP signature and/or the MD5 checksum.  The
+checksum is not as strong an indicator as the PGP signature is.</p>
+<p>The PGP signatures can be verified using PGP or GPG.
+First download the <a href="http://www.apache.org/dist/db/jdo/KEYS">KEYS</a>
+as well as the <code>asc</code> signature file for the particular
+distribution.
+Make sure you get these files from the 
+<a href="http://www.apache.org/dist/db/jdo/">main distribution
+directory</a>, rather than from a mirror. Then verify the signatures using
+</p>
+<p><code>
+% pgpk -a KEYS<br />
+% pgpv <i>release_name</i>.tar.gz.asc<br />
+</code>
+<em>or</em><br />
+<code>
+% pgp -ka KEYS<br />
+% pgp <i>release_name</i>.tar.gz.asc<br />
+</code>
+<em>or</em><br />
+<code>
+% gpg --import KEYS<br/>
+% gpg --verify <i>release_name</i>.tar.gz.asc
+</code></p>
+<p>Alternatively, you can verify the checksums on the files.  Unix
+programs called <code>md5</code>/<code>sha1</code> or
+<code>md5sum</code>/<code>sha1sum</code> are included in many unix
+distributions.  <code>*sum</code> is also available as part of
+<a href="http://www.gnu.org/software/textutils/textutils.html">GNU Textutils</a>.
+Windows users can get binary md5 programs from <a href="http://www.fourmilab.ch/md5/">http://www.fourmilab.ch/md5</a> and
+<a href="http://www.pc-tools.net/win32/freeware/console/">hhttp://www.pc-tools.net/win32/freeware/console</a>.
+Windows SlavaSoft <a href="http://www.slavasoft.com/fsum/">fsum</a> supports MD5 and
+SHA1.</p>
+<p>We highly recommend verifying the PGP signature, though.</p>
+        </section>
+    </body>
+</document>



Mime
View raw message