openjpa-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From build...@apache.org
Subject svn commit: r841236 [8/35] - in /websites/staging/openjpa/trunk/content: ./ artifacts/ css/ images/ images/datacache-plugin/
Date Sun, 09 Dec 2012 13:13:50 GMT
Added: websites/staging/openjpa/trunk/content/building.html
==============================================================================
--- websites/staging/openjpa/trunk/content/building.html (added)
+++ websites/staging/openjpa/trunk/content/building.html Sun Dec  9 13:13:35 2012
@@ -0,0 +1,731 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<!--
+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.
+-->
+<html lang="en">
+    <head>
+        <META http-equiv="Content-Type" content="text/html;charset=UTF-8" />
+        <link href="http://openjpa.apache.org/styles/site.css" rel="stylesheet" type="text/css"/>
+        <!-- <link href="http://openjpa.apache.org/styles/type-settings.css" rel="stylesheet" type="text/css"/> -->
+        <link href="./css/type-settings.css" rel="stylesheet" type="text/css"/>
+        <LINK rel="schema.DC" href="http://purl.org/DC/elements/1.0/">
+        <META name="Description" content="Apache OpenJPA -- Building
" />
+        <META name="Keywords" content="Apache OpenJPA, JPA, JPA 1.0, JSR-220, JPA2, JPA 2.0, JSR-317, " />
+        <META name="Owner" content="dev@openjpa.apache.org" />
+        <META name="Robots" content="index, follow" />
+        <META name="Security" content="Public" />
+        <META name="Source" content="wiki template" />
+        <META name="DC.Date" scheme="iso8601" content="2010-08-11" />
+        <META name="DC.Language" scheme="rfc1766" content="en" />
+        <META name="DC.Rights" content="Copyright © 2006,2010 The Apache Software Foundation" />
+        <META http-equiv="PICS-Label" content='(PICS-1.1 "http://www.icra.org/ratingsv02.html" l gen true r (cz 1 lz 1 nz 1 oz 1 vz 1) "http://www.rsac.org/ratingsv01.html" l gen true r (n 0 s 0 v 0 l 0) "http://www.classify.org/safesurf/" l gen true r (SS~~000 1))'/>
+
+        <title>
+            Apache OpenJPA --
+        </title>
+    </head>
+    <body>
+        <div class="white_box">
+            <div class="header">
+                <div class="header_l">
+                    <div class="header_r">
+                    </div>
+                </div>
+            </div>
+            <div class="content">
+                <div class="content_l">
+                    <div class="content_r">
+                        <div>
+                            <!-- Banner -->
+                            <TABLE valign="top" border="0" cellspacing="0" cellpadding="5" width="100%" background="images/header-bg3.png">
+                                <TR>
+                                    <TD valing="top" align="left">
+                                        <A href="http://openjpa.apache.org/"><IMG src="images/openjpa-logo.png" border="0" alt="OpenJPA Logo"></A>
+                                    </TD>
+                                    <TD width="100%">
+                                        &nbsp;
+                                    </TD>
+                                    <TD valing="top" align="right">
+                                        <A href="http://www.apache.org/"><IMG src="images/asf_logo_wide2.png" border="0" alt="ASF Logo"></A>
+                                    </TD>
+                                </TR>
+                            </TABLE>
+
+                            <!-- Navigation Bar -->
+                            <div class="bottom_red_bar">
+                                <div id="site-breadcrumbs">
+                                    <!-- Breadcrumbs --
+                                    <a href="/">Home</a>&nbsp;&raquo&nbsp;<a href="/building.html">Building
</a>
+                                     -- Breadcrumbs -->
+                                </div>
+                            </div>
+
+                            <!-- Content -->
+                            <table border="0">
+                                <tbody>
+                                    <tr>
+                                        <td valign="top">
+                                            <div class="navigation">
+                                                <div class="navigation_top">
+                                                    <div class="navigation_bottom">
+                                                        <!-- NavigationBar -->
+                                                        <h3><a name="SideNav-Overview"></a><a href="overview.html" title="Overview">Overview</a></h3>
+
+                                                        <ul class="alternate" type="square">
+                                                            <li><a href="quick-start.html" title="Quick Start">Quick Start</a></li>
+                                                            <li><a href="documentation.html" title="Documentation">Documentation</a></li>
+                                                            <li><a href="downloads.html" title="Downloads">Downloads</a></li>
+                                                            <li><a href="site-index.html" title="Site Index">Site Index</a></li>
+                                                            <li><a href="license.html" title="License">License</a></li>
+                                                            <li><a href="privacy-policy.html" title="Privacy Policy">Privacy Policy</a></li>
+                                                        </ul>
+
+                                                        <h3><a name="SideNav-Community"></a><a href="community.html" title="Community">Community</a></h3>
+
+                                                        <ul class="alternate" type="square">
+                                                            <li><a href="index.html#Index-eventsandnews" title="Events and News">Events and News</a></li>
+                                                            <li><a href="found-a-bug.html" title="Found a Bug">Found a Bug</a>?</li>
+                                                            <li><a href="get-involved.html" title="Get Involved">Get Involved</a></li>
+                                                            <li><a href="mailing-lists.html" title="Mailing Lists">Mailing Lists</a></li>
+                                                            <li><a href="committers.html" title="Committers">Committers</a></li>
+                                                            <li><a href="integration.html" title="Integration">Integration</a></li>
+                                                            <li><a href="powered-by.html" title="Powered By">Powered By</a></li>
+                                                            <li><a href="thanks.html" title="Thanks">Thanks</a></li>
+                                                        </ul>
+
+
+                                                        <h3><a name="SideNav-Development"></a><a href="development.html" title="Development">Development</a></h3>
+
+                                                        <ul class="alternate" type="square">
+                                                            <li><a href="http://issues.apache.org/jira/browse/OPENJPA" class="external-link" rel="nofollow">Issue Tracker</a></li>
+                                                            <li><a href="source-code.html" title="Source Code">Source Code</a></li>
+                                                            <li><a href="testing.html" title="Testing">Testing</a></li>
+                                                            <li><a href="tools.html" title="Tools">Tools</a></li>
+                                                            <li><a href="samples.html" title="Samples">Samples</a></li>
+                                                            <li><a href="release-management.html" title="Release Management">Release Management</a></li>
+                                                        </ul>
+
+                                                        <h3>Search</h3>
+
+                                                        <div style="padding: 5px 5px 0px 25px;">
+                                                            <form action="http://www.google.com/search" method="get" style="font-size: 10px;">
+                                                                <input name="ie" type="hidden" value="UTF-8">
+                                                                <input name="oe" type="hidden" value="UTF-8">
+                                                                <input maxlength="255" name="q" size="9" type="text" value=""><br><br>
+                                                                <input name="btnG" type="submit" value="Google">
+                                                                <input name="domains" type="hidden" value="openjpa.apache.org">
+                                                                <input name="sitesearch" type="hidden" value="openjpa.apache.org">
+                                                            </form>
+                                                        </div>
+                                                    </div>
+                                                </div>
+                                            </div>
+                                        </td>
+                                        <td valign="top" width="100%" style="overflow:hidden;">
+                                            <div class="wiki-content">
+                                                <p><a name="Building"></a></p>
+<p><a name="Building-Contents"></a></p>
+<h1 id="contents">Contents</h1>
+<ul>
+<li>
+<p><a href="#Building-BuildingOpenJPA">Building OpenJPA</a></p>
+<ul>
+<li>
+<p><a href="#Building-Maven">Maven</a></p>
+<ul>
+<li><a href="#Building-CommandLineBuilds">Command Line Builds</a></li>
+<li>
+<p><a href="#Building-ExecutingvariousMavenbuildtasks">Executing various Maven build tasks</a></p>
+<ul>
+<li><a href="#Building-RunningjusttheTestPersistencetestcase">Running just the "TestPersistence" test case</a></li>
+<li><a href="#Building-RunningtestswithJava2securityenabled">Running tests with Java 2 security enabled</a></li>
+<li><a href="#Building-Buildingandrunningonlytheexamplesincludedinthedistribution">Building and running only the examples included in the distribution</a></li>
+<li><a href="#Building-Buildingjustthejavadoc">Building just the javadoc</a></li>
+<li><a href="#Building-Buildingjustthedocbookdocumentation">Building just the docbook documentation</a></li>
+<li><a href="#Building-BuildingwithJDK1.4moduleverification(onlyforversionsofOpenJPApriortosvnrevision640685)">Building with JDK 1.4 module verification (only for versions of OpenJPA prior to svn revision 640685)</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li>
+<p><a href="#Building-EclipsewithCommand-lineMavenutilities">Eclipse with Command-line Maven utilities</a></p>
+</li>
+<li><a href="#Building-EclipsewithM2Eclipseplugin">Eclipse with M2Eclipse plugin</a></li>
+<li>
+<p><a href="#Building-Common2.xBuildProblems">Common 2.x Build Problems</a></p>
+<ul>
+<li><a href="#Building-WrongMavenLevel">Wrong Maven Level</a></li>
+<li><a href="#Building-WrongJavaLevel">Wrong Java Level</a></li>
+<li><a href="#Building-MissingLicenseHeaders">Missing License Headers</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+<p><a name="Building-BuildingOpenJPA"></a></p>
+<h1 id="building-openjpa">Building OpenJPA</h1>
+<p>See <a href="build-and-runtime-dependencies.html">Build and Runtime Dependencies</a>
+ for details on the required Java levels.</p>
+<p><a name="Building-Maven"></a></p>
+<h2 id="maven">Maven</h2>
+<p><a name="Building-CommandLineBuilds"></a></p>
+<h3 id="command-line-builds">Command Line Builds</h3>
+<p>These instructions describe how to check out the current OpenJPA source
+code (from the Subversion source code management repository) and build it
+(using the Apache Maven 2 build tool). They are written for use from the
+console, and are known to work on Linux, Mac OSX and Windows.</p>
+<ol>
+<li>Ensure that you have Java installed and in your path by running: <code>java
+-fullversion</code></li>
+<li>Install the build tool, Apache Maven 2.2.1 or later, from
+<a href="http://maven.apache.org/">http://maven.apache.org/</a>. If it is installed correctly, typing <em>mvn -v</em>
+from the console will result in text like <code>Apache Maven 2.2.1 (r801777;
+2009-08-06 21:16:01+0200)</code></li>
+<li>Install Subversion v1.4.x or newer from <a href="http://subversion.apache.org/">http://subversion.apache.org/</a>.
+If it is installed correctly, typing the following command should output
+help information: <strong>svn help</strong> or <strong>svn --version</strong></li>
+<li>Create a new directory you want to do your work in, then change to that
+directory from the console.</li>
+<li>Check out the sources by running: <code>svn co</code>
+<a href="https://svn.apache.org/repos/asf/openjpa/trunk">https://svn.apache.org/repos/asf/openjpa/trunk</a> <code>openjpa-trunk</code>. It will
+check out the sources to the openjpa-trunk directory. More information on
+checking out the OpenJPA sources can be found on the <a href="source-code.html">Source Code</a>
+ page.</li>
+<li>Change to the openjpa-trunk directory, which has already been created in
+the previous step.</li>
+<li>
+<p>Build OpenJPA by running: <code>mvn package</code> or better <code>mvn install</code>. The
+first time you run the build, many dependencies are automatically resolved
+and downloaded. <strong>It is common for dependency downloading to fail the first
+time, which will fail the build.</strong> If any of these dependency downloads
+fail, just re-run the command. You may also add the following to your
+<code>~/.m2/setting.xml</code> file (see <a href="http://maven.apache.org/guides/mini/guide-mirror-settings.html">http://maven.apache.org/guides/mini/guide-mirror-settings.html</a>)</p>
+<div class="codehilite"><pre><span class="nt">&lt;settings&gt;</span>
+    <span class="nt">&lt;mirrors&gt;</span>
+        <span class="nt">&lt;mirror&gt;</span>
+            <span class="nt">&lt;id&gt;</span>repo.mergere.com<span class="nt">&lt;/id&gt;</span>
+            <span class="nt">&lt;url&gt;</span>http://repo.mergere.com/maven2<span class="nt">&lt;/url&gt;</span>
+            <span class="nt">&lt;mirrorOf&gt;</span>central<span class="nt">&lt;/mirrorOf&gt;</span>
+        <span class="nt">&lt;/mirror&gt;</span>
+    <span class="nt">&lt;/mirrors&gt;</span>
+<span class="nt">&lt;/settings&gt;</span>
+</pre></div>
+
+
+</li>
+</ol>
+<p>If any tests fail, and you want to ignore the failures, instead run:</p>
+<div class="codehilite"><pre><span class="n">mvn</span> <span class="nb">package</span> <span class="o">-</span><span class="n">DfailIfNoTests</span><span class="o">=</span><span class="n">false</span>
+
+  <span class="ow">or</span>
+
+<span class="n">mvn</span> <span class="nb">package</span> <span class="o">-</span><span class="n">DskipTests</span>
+</pre></div>
+
+
+<p>An example session is as follows:</p>
+<div class="codehilite"><pre><span class="nv">$</span> <span class="nv">cd</span> <span class="sr">/tmp/</span>
+
+<span class="nv">$</span> <span class="nv">java</span> <span class="o">-</span><span class="n">version</span>
+
+<span class="n">java</span> <span class="n">version</span> <span class="s">&quot;1.6.0&quot;</span>
+<span class="n">Java</span><span class="p">(</span><span class="n">TM</span><span class="p">)</span> <span class="n">SE</span> <span class="n">Runtime</span> <span class="n">Environment</span> <span class="p">(</span><span class="n">build</span> <span class="mf">1.6.0</span><span class="o">-</span><span class="n">b105</span><span class="p">)</span>
+<span class="n">Java</span> <span class="n">HotSpot</span><span class="p">(</span><span class="n">TM</span><span class="p">)</span> <span class="n">Client</span> <span class="n">VM</span> <span class="p">(</span><span class="n">build</span> <span class="mf">1.6.0</span><span class="o">-</span><span class="n">b105</span><span class="p">,</span> <span class="n">mixed</span> <span class="n">mode</span><span class="p">,</span> <span class="n">sharing</span><span class="p">)</span>
+
+<span class="nv">$</span> <span class="nv">mvn</span> <span class="o">-</span><span class="n">v</span>
+
+<span class="n">Apache</span> <span class="n">Maven</span> <span class="mf">2.2.1</span> <span class="p">(</span><span class="n">r801777</span><span class="p">;</span> <span class="mi">2009</span><span class="o">-</span><span class="mi">08</span><span class="o">-</span><span class="mo">06</span> <span class="mi">21</span><span class="p">:</span><span class="mi">16</span><span class="p">:</span><span class="mo">01</span><span class="o">+</span><span class="mo">0200</span><span class="p">)</span>
+<span class="n">Java</span> <span class="n">version:</span> <span class="mf">1.6.0</span>
+<span class="n">Java</span> <span class="n">home:</span> <span class="sr">/alt/s</span><span class="n">un160</span><span class="o">/</span><span class="n">jre</span>
+<span class="n">Default</span> <span class="n">locale:</span> <span class="n">en_US</span><span class="p">,</span> <span class="n">platform</span> <span class="n">encoding:</span> <span class="n">UTF</span><span class="o">-</span><span class="mi">8</span>
+<span class="n">OS</span> <span class="n">name:</span> <span class="s">&quot;linux&quot;</span> <span class="n">version:</span> <span class="s">&quot;2.6.18-1.2798.fc6&quot;</span> <span class="n">arch:</span> <span class="s">&quot;i386&quot;</span> <span class="n">Family:</span> <span class="s">&quot;unix&quot;</span>
+
+<span class="nv">$</span> <span class="nv">svn</span> <span class="o">--</span><span class="n">version</span>
+
+<span class="n">svn</span><span class="p">,</span> <span class="n">version</span> <span class="mf">1.4.3</span> <span class="p">(</span><span class="n">r23084</span><span class="p">)</span>
+   <span class="n">compiled</span> <span class="n">Jan</span> <span class="mi">18</span> <span class="mi">2007</span><span class="p">,</span> <span class="mo">07</span><span class="p">:</span><span class="mi">47</span><span class="p">:</span><span class="mi">40</span>
+
+<span class="nv">$</span> <span class="nv">svn</span> <span class="n">co</span> <span class="n">https:</span><span class="sr">//s</span><span class="n">vn</span><span class="o">.</span><span class="n">apache</span><span class="o">.</span><span class="n">org</span><span class="sr">/repos/</span><span class="n">asf</span><span class="sr">/openjpa/</span><span class="n">trunk</span><span class="o">/</span>
+
+<span class="n">A</span>  <span class="n">trunk</span><span class="o">/</span><span class="n">openjpa</span><span class="o">-</span><span class="n">lib</span>
+<span class="n">A</span>  <span class="n">trunk</span><span class="sr">/openjpa-lib/s</span><span class="n">rc</span>
+<span class="n">A</span>  <span class="n">trunk</span><span class="sr">/openjpa-lib/s</span><span class="n">rc</span><span class="o">/</span><span class="n">test</span>
+<span class="n">A</span>  <span class="n">trunk</span><span class="sr">/openjpa-lib/s</span><span class="n">rc</span><span class="sr">/test/</span><span class="n">java</span>
+<span class="n">A</span>  <span class="n">trunk</span><span class="sr">/openjpa-lib/s</span><span class="n">rc</span><span class="sr">/test/</span><span class="n">java</span><span class="o">/</span><span class="n">org</span>
+<span class="n">A</span>  <span class="n">trunk</span><span class="sr">/openjpa-lib/s</span><span class="n">rc</span><span class="sr">/test/</span><span class="n">java</span><span class="sr">/org/</span><span class="n">apache</span>
+<span class="n">A</span>  <span class="n">trunk</span><span class="sr">/openjpa-lib/s</span><span class="n">rc</span><span class="sr">/test/</span><span class="n">java</span><span class="sr">/org/</span><span class="n">apache</span><span class="o">/</span><span class="n">openjpa</span>
+<span class="n">A</span>  <span class="n">trunk</span><span class="sr">/openjpa-lib/s</span><span class="n">rc</span><span class="sr">/test/</span><span class="n">java</span><span class="sr">/org/</span><span class="n">apache</span><span class="sr">/openjpa/</span><span class="n">lib</span>
+<span class="n">A</span>  <span class="n">trunk</span><span class="sr">/openjpa-lib/s</span><span class="n">rc</span><span class="sr">/test/</span><span class="n">java</span><span class="sr">/org/</span><span class="n">apache</span><span class="sr">/openjpa/</span><span class="n">lib</span><span class="o">/</span><span class="n">test</span>
+<span class="n">A</span>  <span class="n">trunk</span><span class="sr">/openjpa-lib/s</span><span class="n">rc</span><span class="sr">/test/</span><span class="n">java</span><span class="sr">/org/</span><span class="n">apache</span><span class="sr">/openjpa/</span><span class="n">lib</span><span class="sr">/test/</span><span class="n">AbstractTestCase</span><span class="o">.</span><span class="n">java</span>
+
+ <span class="o">...</span>
+
+<span class="n">A</span>  <span class="n">trunk</span><span class="sr">/openjpa-persistence/</span><span class="n">pom</span><span class="o">.</span><span class="n">xml</span>
+<span class="n">Checked</span> <span class="n">out</span> <span class="n">revision</span> <span class="mi">1065345</span><span class="o">.</span>
+
+<span class="nv">$</span> <span class="nv">cd</span> <span class="n">trunk</span><span class="o">/</span>
+
+<span class="nv">$</span> <span class="nv">mvn</span> <span class="n">compile</span>
+
+<span class="p">[</span><span class="n">INFO</span><span class="p">]</span> <span class="n">Scanning</span> <span class="k">for</span> <span class="n">projects</span><span class="o">...</span>
+<span class="p">[</span><span class="n">INFO</span><span class="p">]</span> <span class="n">Reactor</span> <span class="n">build</span> <span class="n">order:</span> 
+<span class="p">[</span><span class="n">INFO</span><span class="p">]</span>   <span class="n">OpenJPA</span> <span class="n">Parent</span> <span class="n">POM</span>
+<span class="p">[</span><span class="n">INFO</span><span class="p">]</span>   <span class="n">OpenJPA</span> <span class="n">Utilities</span> <span class="n">Library</span>
+<span class="p">[</span><span class="n">INFO</span><span class="p">]</span>   <span class="n">OpenJPA</span> <span class="n">Kernel</span>
+<span class="p">[</span><span class="n">INFO</span><span class="p">]</span>   <span class="n">OpenJPA</span> <span class="n">JDBC</span>
+<span class="p">[</span><span class="n">INFO</span><span class="p">]</span>   <span class="n">OpenJPA</span> <span class="n">Persistence</span>
+<span class="p">[</span><span class="n">INFO</span><span class="p">]</span>   <span class="n">OpenJPA</span> <span class="n">Persistence</span> <span class="n">JDBC</span>
+<span class="p">[</span><span class="n">INFO</span><span class="p">]</span>   <span class="n">OpenJPA</span> <span class="n">Persistence</span> <span class="n">Locking</span> <span class="n">Tests</span>
+<span class="p">[</span><span class="n">INFO</span><span class="p">]</span>   <span class="n">OpenJPA</span> <span class="n">XML</span> <span class="n">Store</span>
+<span class="p">[</span><span class="n">INFO</span><span class="p">]</span>   <span class="n">OpenJPA</span> <span class="n">Slice</span>
+<span class="p">[</span><span class="n">INFO</span><span class="p">]</span>   <span class="n">OpenJPA</span> <span class="n">JEST</span>
+<span class="p">[</span><span class="n">INFO</span><span class="p">]</span>   <span class="n">OpenJPA</span> <span class="n">Aggregate</span> <span class="n">Jar</span>
+<span class="p">[</span><span class="n">INFO</span><span class="p">]</span>   <span class="n">OpenJPA</span> <span class="n">Aggregate</span> <span class="n">Jar</span> <span class="n">with</span> <span class="n">Dependencies</span>
+<span class="p">[</span><span class="n">INFO</span><span class="p">]</span>   <span class="n">OpenJPA</span> <span class="n">Project</span> <span class="n">Docs</span> <span class="ow">and</span> <span class="n">Assemblies</span>
+<span class="p">[</span><span class="n">INFO</span><span class="p">]</span>   <span class="n">OpenJPA</span> <span class="n">Examples</span>
+<span class="p">[</span><span class="n">INFO</span><span class="p">]</span>   <span class="n">OpenJPA</span> <span class="n">Examples</span> <span class="o">-</span> <span class="n">Simple</span>
+<span class="p">[</span><span class="n">INFO</span><span class="p">]</span>   <span class="n">OpenJPA</span> <span class="n">Examples</span> <span class="o">-</span> <span class="n">image</span><span class="o">-</span><span class="n">gallery</span>
+<span class="p">[</span><span class="n">INFO</span><span class="p">]</span>   <span class="n">OpenJPA</span> <span class="n">Examples</span> <span class="o">-</span> <span class="n">OpenBooks</span>
+<span class="p">[</span><span class="n">INFO</span><span class="p">]</span>   <span class="n">OpenJPA</span> <span class="n">Integration</span> <span class="n">Tests</span>
+<span class="p">[</span><span class="n">INFO</span><span class="p">]</span>   <span class="n">OpenJPA</span> <span class="n">Integration</span> <span class="n">Tests</span> <span class="o">-</span> <span class="n">Daytrader</span>
+<span class="p">[</span><span class="n">INFO</span><span class="p">]</span>   <span class="n">OpenJPA</span> <span class="n">Integration</span> <span class="n">Tests</span> <span class="o">-</span> <span class="n">Examples</span>
+<span class="p">[</span><span class="n">INFO</span><span class="p">]</span>   <span class="n">OpenJPA</span> <span class="n">Integration</span> <span class="n">Tests</span> <span class="o">-</span> <span class="n">SLF4JLogFactory</span>
+<span class="p">[</span><span class="n">INFO</span><span class="p">]</span>   <span class="n">OpenJPA</span> <span class="n">Integration</span> <span class="n">Tests</span> <span class="o">-</span> <span class="n">JPA</span> <span class="n">TCK</span>
+<span class="p">[</span><span class="n">INFO</span><span class="p">]</span>   <span class="n">OpenJPA</span> <span class="n">Integration</span> <span class="n">Tests</span> <span class="o">-</span> <span class="n">Bean</span> <span class="n">Validation</span>
+<span class="p">[</span><span class="n">INFO</span><span class="p">]</span>   <span class="n">OpenJPA</span> <span class="n">Integration</span> <span class="n">Tests</span> <span class="o">-</span> <span class="n">JMX</span> <span class="n">Platform</span> <span class="n">MBeans</span>
+<span class="p">[</span><span class="n">INFO</span><span class="p">]</span> <span class="o">------------------------------------------------------------------------</span>
+<span class="p">[</span><span class="n">INFO</span><span class="p">]</span> <span class="n">Building</span> <span class="n">OpenJPA</span> <span class="n">Parent</span> <span class="n">POM</span>
+<span class="p">[</span><span class="n">INFO</span><span class="p">]</span>    <span class="n">task</span><span class="o">-</span><span class="n">segment:</span> <span class="p">[</span><span class="n">compile</span><span class="p">]</span>
+<span class="p">[</span><span class="n">INFO</span><span class="p">]</span> <span class="o">------------------------------------------------------------------------</span>
+
+ <span class="o">...</span>
+
+<span class="p">[</span><span class="n">INFO</span><span class="p">]</span>
+<span class="p">[</span><span class="n">INFO</span><span class="p">]</span> <span class="o">------------------------------------------------------------------------</span>
+<span class="p">[</span><span class="n">INFO</span><span class="p">]</span> <span class="n">Reactor</span> <span class="n">Summary:</span>
+<span class="p">[</span><span class="n">INFO</span><span class="p">]</span> <span class="o">------------------------------------------------------------------------</span>
+<span class="p">[</span><span class="n">INFO</span><span class="p">]</span> <span class="n">OpenJPA</span> <span class="n">Parent</span> <span class="n">POM</span> <span class="o">....................................</span> <span class="n">SUCCESS</span> <span class="p">[</span><span class="mi">1</span><span class="p">:</span><span class="mf">23.143</span><span class="n">s</span><span class="p">]</span>
+<span class="p">[</span><span class="n">INFO</span><span class="p">]</span> <span class="n">OpenJPA</span> <span class="n">Utilities</span> <span class="n">Library</span> <span class="o">.............................</span> <span class="n">SUCCESS</span> <span class="p">[</span><span class="mf">13.749</span><span class="n">s</span><span class="p">]</span>
+<span class="p">[</span><span class="n">INFO</span><span class="p">]</span> <span class="n">OpenJPA</span> <span class="n">Kernel</span> <span class="o">........................................</span> <span class="n">SUCCESS</span> <span class="p">[</span><span class="mf">19.251</span><span class="n">s</span><span class="p">]</span>
+<span class="p">[</span><span class="n">INFO</span><span class="p">]</span> <span class="n">OpenJPA</span> <span class="n">JDBC</span> <span class="o">..........................................</span> <span class="n">SUCCESS</span> <span class="p">[</span><span class="mf">14.351</span><span class="n">s</span><span class="p">]</span>
+<span class="p">[</span><span class="n">INFO</span><span class="p">]</span> <span class="n">OpenJPA</span> <span class="n">Persistence</span> <span class="o">...................................</span> <span class="n">SUCCESS</span> <span class="p">[</span><span class="mf">10.254</span><span class="n">s</span><span class="p">]</span>
+<span class="p">[</span><span class="n">INFO</span><span class="p">]</span> <span class="n">OpenJPA</span> <span class="n">Persistence</span> <span class="n">JDBC</span> <span class="o">..............................</span> <span class="n">SUCCESS</span> <span class="p">[</span><span class="mf">46.774</span><span class="n">s</span><span class="p">]</span>
+<span class="p">[</span><span class="n">INFO</span><span class="p">]</span> <span class="n">OpenJPA</span> <span class="n">Persistence</span> <span class="n">Locking</span> <span class="n">Tests</span> <span class="o">.....................</span> <span class="n">SUCCESS</span> <span class="p">[</span><span class="mf">15.183</span><span class="n">s</span><span class="p">]</span>
+<span class="p">[</span><span class="n">INFO</span><span class="p">]</span> <span class="n">OpenJPA</span> <span class="n">XML</span> <span class="n">Store</span> <span class="o">.....................................</span> <span class="n">SUCCESS</span> <span class="p">[</span><span class="mf">11.788</span><span class="n">s</span><span class="p">]</span>
+<span class="p">[</span><span class="n">INFO</span><span class="p">]</span> <span class="n">OpenJPA</span> <span class="n">Slice</span> <span class="o">.........................................</span> <span class="n">SUCCESS</span> <span class="p">[</span><span class="mf">4.437</span><span class="n">s</span><span class="p">]</span>
+<span class="p">[</span><span class="n">INFO</span><span class="p">]</span> <span class="n">OpenJPA</span> <span class="n">JEST</span> <span class="o">..........................................</span> <span class="n">SUCCESS</span> <span class="p">[</span><span class="mf">4.854</span><span class="n">s</span><span class="p">]</span>
+<span class="p">[</span><span class="n">INFO</span><span class="p">]</span> <span class="n">OpenJPA</span> <span class="n">Aggregate</span> <span class="n">Jar</span> <span class="o">.................................</span> <span class="n">SUCCESS</span> <span class="p">[</span><span class="mf">10.729</span><span class="n">s</span><span class="p">]</span>
+<span class="p">[</span><span class="n">INFO</span><span class="p">]</span> <span class="n">OpenJPA</span> <span class="n">Aggregate</span> <span class="n">Jar</span> <span class="n">with</span> <span class="n">Dependencies</span> <span class="o">...............</span> <span class="n">SUCCESS</span> <span class="p">[</span><span class="mf">6.761</span><span class="n">s</span><span class="p">]</span>
+<span class="p">[</span><span class="n">INFO</span><span class="p">]</span> <span class="n">OpenJPA</span> <span class="n">Project</span> <span class="n">Docs</span> <span class="ow">and</span> <span class="n">Assemblies</span> <span class="o">...................</span> <span class="n">SUCCESS</span> <span class="p">[</span><span class="mi">1</span><span class="p">:</span><span class="mf">41.937</span><span class="n">s</span><span class="p">]</span>
+<span class="p">[</span><span class="n">INFO</span><span class="p">]</span> <span class="n">OpenJPA</span> <span class="n">Examples</span> <span class="o">......................................</span> <span class="n">SUCCESS</span> <span class="p">[</span><span class="mf">0.663</span><span class="n">s</span><span class="p">]</span>
+<span class="p">[</span><span class="n">INFO</span><span class="p">]</span> <span class="n">OpenJPA</span> <span class="n">Examples</span> <span class="o">-</span> <span class="n">Simple</span> <span class="o">.............................</span> <span class="n">SUCCESS</span> <span class="p">[</span><span class="mf">1.475</span><span class="n">s</span><span class="p">]</span>
+<span class="p">[</span><span class="n">INFO</span><span class="p">]</span> <span class="n">OpenJPA</span> <span class="n">Examples</span> <span class="o">-</span> <span class="n">image</span><span class="o">-</span><span class="n">gallery</span> <span class="o">......................</span> <span class="n">SUCCESS</span> <span class="p">[</span><span class="mf">3.920</span><span class="n">s</span><span class="p">]</span>
+<span class="p">[</span><span class="n">INFO</span><span class="p">]</span> <span class="n">OpenJPA</span> <span class="n">Examples</span> <span class="o">-</span> <span class="n">OpenBooks</span> <span class="o">..........................</span> <span class="n">SUCCESS</span> <span class="p">[</span><span class="mf">12.961</span><span class="n">s</span><span class="p">]</span>
+<span class="p">[</span><span class="n">INFO</span><span class="p">]</span> <span class="n">OpenJPA</span> <span class="n">Integration</span> <span class="n">Tests</span> <span class="o">.............................</span> <span class="n">SUCCESS</span> <span class="p">[</span><span class="mf">0.381</span><span class="n">s</span><span class="p">]</span>
+<span class="p">[</span><span class="n">INFO</span><span class="p">]</span> <span class="n">OpenJPA</span> <span class="n">Integration</span> <span class="n">Tests</span> <span class="o">-</span> <span class="n">Daytrader</span> <span class="o">.................</span> <span class="n">SUCCESS</span> <span class="p">[</span><span class="mf">7.565</span><span class="n">s</span><span class="p">]</span>
+<span class="p">[</span><span class="n">INFO</span><span class="p">]</span> <span class="n">OpenJPA</span> <span class="n">Integration</span> <span class="n">Tests</span> <span class="o">-</span> <span class="n">Examples</span> <span class="o">..................</span> <span class="n">SUCCESS</span> <span class="p">[</span><span class="mf">0.269</span><span class="n">s</span><span class="p">]</span>
+<span class="p">[</span><span class="n">INFO</span><span class="p">]</span> <span class="n">OpenJPA</span> <span class="n">Integration</span> <span class="n">Tests</span> <span class="o">-</span> <span class="n">SLF4JLogFactory</span> <span class="o">...........</span> <span class="n">SUCCESS</span> <span class="p">[</span><span class="mf">1.977</span><span class="n">s</span><span class="p">]</span>
+<span class="p">[</span><span class="n">INFO</span><span class="p">]</span> <span class="n">OpenJPA</span> <span class="n">Integration</span> <span class="n">Tests</span> <span class="o">-</span> <span class="n">JPA</span> <span class="n">TCK</span> <span class="o">...................</span> <span class="n">SUCCESS</span> <span class="p">[</span><span class="mf">0.248</span><span class="n">s</span><span class="p">]</span>
+<span class="p">[</span><span class="n">INFO</span><span class="p">]</span> <span class="n">OpenJPA</span> <span class="n">Integration</span> <span class="n">Tests</span> <span class="o">-</span> <span class="n">Bean</span> <span class="n">Validation</span> <span class="o">...........</span> <span class="n">SUCCESS</span> <span class="p">[</span><span class="mf">3.213</span><span class="n">s</span><span class="p">]</span>
+<span class="p">[</span><span class="n">INFO</span><span class="p">]</span> <span class="n">OpenJPA</span> <span class="n">Integration</span> <span class="n">Tests</span> <span class="o">-</span> <span class="n">JMX</span> <span class="n">Platform</span> <span class="n">MBeans</span> <span class="o">.......</span> <span class="n">SUCCESS</span> <span class="p">[</span><span class="mf">7.729</span><span class="n">s</span><span class="p">]</span>
+<span class="p">[</span><span class="n">INFO</span><span class="p">]</span> <span class="o">------------------------------------------------------------------------</span>
+<span class="p">[</span><span class="n">INFO</span><span class="p">]</span> <span class="o">------------------------------------------------------------------------</span>
+<span class="p">[</span><span class="n">INFO</span><span class="p">]</span> <span class="n">BUILD</span> <span class="n">SUCCESSFUL</span>
+<span class="p">[</span><span class="n">INFO</span><span class="p">]</span> <span class="o">------------------------------------------------------------------------</span>
+<span class="p">[</span><span class="n">INFO</span><span class="p">]</span> <span class="n">Total</span> <span class="nb">time</span><span class="p">:</span> <span class="mi">6</span> <span class="n">minutes</span> <span class="mi">26</span> <span class="n">seconds</span>
+<span class="p">[</span><span class="n">INFO</span><span class="p">]</span> <span class="n">Finished</span> <span class="n">at:</span> <span class="n">Sun</span> <span class="n">Jan</span> <span class="mi">30</span> <span class="mi">19</span><span class="p">:</span><span class="mi">43</span><span class="p">:</span><span class="mi">50</span> <span class="n">CET</span> <span class="mi">2011</span>
+<span class="p">[</span><span class="n">INFO</span><span class="p">]</span> <span class="n">Final</span> <span class="n">Memory:</span> <span class="mi">92</span><span class="n">M</span><span class="o">/</span><span class="mi">158</span><span class="n">M</span>
+<span class="p">[</span><span class="n">INFO</span><span class="p">]</span> <span class="o">------------------------------------------------------------------------</span>
+
+<span class="nv">$</span> <span class="nv">mvn</span> <span class="nb">package</span> <span class="o">-</span><span class="n">DskipTests</span>
+
+<span class="p">[</span><span class="n">INFO</span><span class="p">]</span> <span class="n">Scanning</span> <span class="k">for</span> <span class="n">projects</span><span class="o">...</span>
+
+<span class="o">...</span>
+
+<span class="p">[</span><span class="n">INFO</span><span class="p">]</span> <span class="n">Building</span> <span class="n">zip:</span><span class="sr">/tmp/</span><span class="n">trunk</span><span class="sr">/openjpa-project/</span><span class="n">target</span><span class="sr">/site/</span><span class="n">downloads</span><span class="o">/</span><span class="n">apache</span><span class="o">-</span><span class="n">openjpa</span><span class="o">-</span><span class="mf">2.2.0</span><span class="o">-</span><span class="n">SNAPSHOT</span><span class="o">-</span><span class="n">binary</span><span class="o">.</span><span class="n">zip</span>
+
+<span class="o">...</span>
+
+<span class="nv">$</span> <span class="nv">ls</span> <span class="o">-</span><span class="n">lh</span> <span class="n">openjpa</span><span class="o">-</span><span class="n">project</span><span class="sr">/target/si</span><span class="n">te</span><span class="sr">/downloads/</span>
+
+<span class="n">total</span> <span class="mi">40</span><span class="n">M</span>
+<span class="o">-</span><span class="n">rw</span><span class="o">-</span><span class="n">r</span><span class="o">--</span><span class="n">r</span><span class="o">--</span> <span class="mi">1</span> <span class="n">milosz</span> <span class="n">milosz</span> <span class="mi">15</span><span class="n">M</span> <span class="n">Jan</span> <span class="mi">30</span> <span class="mi">19</span><span class="p">:</span><span class="mi">41</span> <span class="n">apache</span><span class="o">-</span><span class="n">openjpa</span><span class="o">-</span><span class="mf">2.2.0</span><span class="o">-</span><span class="n">SNAPSHOT</span><span class="o">-</span><span class="n">binary</span><span class="o">.</span><span class="n">zip</span>
+<span class="o">-</span><span class="n">rw</span><span class="o">-</span><span class="n">r</span><span class="o">--</span><span class="n">r</span><span class="o">--</span> <span class="mi">1</span> <span class="n">milosz</span> <span class="n">milosz</span> <span class="mi">25</span><span class="n">M</span> <span class="n">Jan</span> <span class="mi">30</span> <span class="mi">19</span><span class="p">:</span><span class="mi">43</span> <span class="n">apache</span><span class="o">-</span><span class="n">openjpa</span><span class="o">-</span><span class="mf">2.2.0</span><span class="o">-</span><span class="n">SNAPSHOT</span><span class="o">-</span><span class="n">source</span><span class="o">.</span><span class="n">zip</span>
+</pre></div>
+
+
+<p><a name="Building-ExecutingvariousMavenbuildtasks"></a></p>
+<h3 id="executing-various-maven-build-tasks">Executing various Maven build tasks</h3>
+<p><a name="Building-RunningjusttheTestPersistencetestcase"></a></p>
+<h5 id="running-just-the-testpersistence-test-case">Running just the "TestPersistence" test case</h5>
+<div class="codehilite"><pre><span class="n">mvn</span> <span class="n">test</span> <span class="o">-</span><span class="n">Dtest</span><span class="o">=</span><span class="n">TestPersistence</span>
+</pre></div>
+
+
+<p><a name="Building-RunningtestswithJava2securityenabled"></a></p>
+<h5 id="running-tests-with-java-2-security-enabled">Running tests with Java 2 security enabled</h5>
+<div class="codehilite"><pre><span class="n">mvn</span> <span class="n">test</span> <span class="o">-</span><span class="n">Penable</span><span class="o">-</span><span class="n">security</span>
+</pre></div>
+
+
+<p><a name="Building-Buildingandrunningonlytheexamplesincludedinthedistribution"></a></p>
+<h5 id="building-and-running-only-the-examples-included-in-the-distribution">Building and running only the examples included in the distribution</h5>
+<div class="codehilite"><pre><span class="n">mvn</span> <span class="o">-</span><span class="n">DskipTests</span> <span class="o">-</span><span class="n">Pexamples</span><span class="o">-</span><span class="n">profile</span> <span class="n">integration</span><span class="o">-</span><span class="n">test</span>
+</pre></div>
+
+
+<p><a name="Building-Buildingjustthejavadoc"></a></p>
+<h5 id="building-just-the-javadoc">Building just the javadoc</h5>
+<p>First install the jars:</p>
+<div class="codehilite"><pre><span class="n">mvn</span> <span class="n">install</span> <span class="o">-</span><span class="n">DskipTests</span>
+</pre></div>
+
+
+<p>Then build the javadoc:</p>
+<div class="codehilite"><pre><span class="n">mvn</span> <span class="nb">package</span> <span class="o">-</span><span class="n">DskipTests</span> <span class="o">-</span><span class="n">Pjavadoc</span><span class="o">-</span><span class="n">profile</span>
+</pre></div>
+
+
+<p>The javadoc will be output to <em>target/site/apidocs/index.html</em>.</p>
+<p><a name="Building-Buildingjustthedocbookdocumentation"></a></p>
+<h5 id="building-just-the-docbook-documentation">Building just the docbook documentation</h5>
+<div class="codehilite"><pre><span class="n">set</span> <span class="n">MAVEN_OPTS</span><span class="o">=-</span><span class="n">Xmx512m</span>
+<span class="n">mvn</span> <span class="o">-</span><span class="n">f</span> <span class="n">openjpa</span><span class="o">-</span><span class="n">project</span><span class="o">/</span><span class="n">pom</span><span class="o">.</span><span class="n">xml</span> <span class="n">process</span><span class="o">-</span><span class="n">resources</span> <span class="o">-</span><span class="n">Pdocbook</span><span class="o">-</span><span class="n">profile</span>
+</pre></div>
+
+
+<p>The manual HTML will be output to <code>openjpa-project/target/manual/manual.html</code>.</p>
+<p><a name="Building-BuildingwithJDK1.4moduleverification(onlyforversionsofOpenJPApriortosvnrevision640685)"></a></p>
+<h5 id="building-with-jdk-14-module-verification-only-for-versions-of-openjpa-prior-to-svn-revision-640685">Building with JDK 1.4 module verification (only for versions of OpenJPA prior to svn revision 640685)</h5>
+<div class="codehilite"><pre><span class="n">mvn</span> <span class="n">compile</span> <span class="o">-</span><span class="n">Djava14</span><span class="o">.</span><span class="n">jar</span><span class="o">=</span><span class="n">C:</span><span class="o">\</span><span class="n">Program</span> <span class="n">Files</span><span class="o">\</span><span class="n">Java</span><span class="o">\</span><span class="n">j2re1</span><span class="mf">.4.2_07</span><span class="o">\</span><span class="n">lib</span><span class="o">\</span><span class="n">rt</span><span class="o">.</span><span class="n">jar</span> <span class="n">compile</span>
+</pre></div>
+
+
+<p>Specifying the "java14.jar" system property will cause the
+JDK-1.4-dependent modules to be compiled with the value as the
+bootclasspath to the compiler. This can be useful to ensure that
+modifications and additions do not violate the JDK version restriction of
+the module. Since the runtime jar location is platform, version, and
+installation dependent, the exact location of the runtime jar will vary,
+which is why it needs to be manually specified.</p>
+<p><a name="Building-EclipsewithCommand-lineMavenutilities"></a></p>
+<h2 id="eclipse-with-command-line-maven-utilities">Eclipse with Command-line Maven utilities</h2>
+<ol>
+<li>Checkout the source as described above</li>
+<li>Build the source using Maven as described above</li>
+<li>
+<p>Create the Eclipse Metadata -</p>
+<div class="codehilite"><pre><span class="n">mvn</span> <span class="n">eclipse:eclipse</span>
+</pre></div>
+
+
+<ol>
+<li>
+<p>If this is the first project in your workspace to use maven artifacts you need to create a classpath variable named M2_REPO which contains the full path to your local repository. The eclipse plugin can do this for you with the following command</p>
+<div class="codehilite"><pre>mvn eclipse:configure-workspace -Declipse.workspace=<span class="cp">${</span><span class="n">path</span> <span class="n">to</span> <span class="n">your</span> <span class="n">workspace</span><span class="cp">}</span>
+</pre></div>
+
+
+</li>
+</ol>
+</li>
+<li>
+<p>Start Eclipse (3.2 - 3.4 SR2 are known to work) and create a new
+workspace</p>
+</li>
+<li>
+<p>Import the OpenJPA projects, by:</p>
+<ul>
+<li>Select File --&gt; Import... --&gt; General - Existing Projects into Workspace --&gt; Next</li>
+<li>Select root directory = <svn checkout location above></li>
+<li>Deselect the openjpa-examples project</li>
+<li>Press Finish</li>
+</ul>
+</li>
+<li>
+<p>A few fixups will be required to remove the errors that exist in the
+imported projects...</p>
+<ul>
+<li>
+<p>openjpa-kernel -&gt; Properties -&gt; Java Build Path -&gt; Source -&gt; Add Folders</p>
+<ul>
+<li>add target/generated-sources/javacc</li>
+</ul>
+</li>
+<li>
+<p>openjpa-jdbc -&gt; Properties -&gt; Java Build Path -&gt; Libraries -&gt; JRE System Library -&gt; Edit</p>
+<ul>
+<li>change this to a Java 6 JRE to remove these errors (see below if you can not use Java SE 6)</li>
+</ul>
+</li>
+<li>
+<p>openjpa-persistence -&gt; Properties -&gt; Java Build Path -&gt; Libraries -&gt; JRE System Library -&gt; Edit</p>
+<ul>
+<li>change this to a Java 6 JRE to remove these errors (see below if you
+can not use Java SE 6)</li>
+</ul>
+</li>
+<li>
+<p>openjpa-persistence-jdbc -&gt; Properties -&gt; Java Build Path -&gt; Libraries
+-&gt; JRE System Library -&gt; Edit</p>
+<ul>
+<li>change this to a Java 6 JRE to remove these errors (see below if you
+can not use Java SE 6)</li>
+</ul>
+</li>
+<li>
+<p>openjpa-examples.  Open up src/main/java and select ReverseMapping
+folder.  Right mouse click.</p>
+<ul>
+<li>Select Build Path -&gt; Exclude</li>
+</ul>
+</li>
+</ul>
+</li>
+<li>
+<p>For each imported project, you'll need to edit the build properties to
+remove an incorrect dependency:</p>
+<ul>
+<li>Project --&gt; Properties --&gt; Java Build Path --&gt; Source</li>
+<li>Remove openjpa-project from the list of source folders</li>
+</ul>
+</li>
+</ol>
+<p>For Java SE 5 users building from the 2.0.x branch, you will need to
+exclude some Java SE 6 specific classes by performing the following steps
+for the source:</p>
+<ol>
+<li>Open the Properties for openjpa-persistence</li>
+<li>Select Java Build Path --&gt; Source</li>
+<li>
+<p>Edit the openjpa-persistence/src/main/java --&gt; Excluded setting to
+include the following:</p>
+<div class="codehilite"><pre><span class="n">org</span><span class="sr">/apache/o</span><span class="n">penjpa</span><span class="sr">/persistence/m</span><span class="n">eta</span><span class="o">/</span><span class="n">AnnotationProcessor6</span><span class="o">.</span><span class="n">java</span>
+<span class="n">org</span><span class="sr">/apache/o</span><span class="n">penjpa</span><span class="sr">/persistence/m</span><span class="n">eta</span><span class="o">/</span><span class="n">CompileTimeLogger</span><span class="o">.</span><span class="n">java</span>
+<span class="n">org</span><span class="sr">/apache/o</span><span class="n">penjpa</span><span class="sr">/persistence/m</span><span class="n">eta</span><span class="o">/</span><span class="n">SourceAnnotationHandler</span><span class="o">.</span><span class="n">java</span>
+</pre></div>
+
+
+</li>
+</ol>
+<p><a name="Building-EclipsewithM2Eclipseplugin"></a></p>
+<h2 id="eclipse-with-m2eclipse-plugin">Eclipse with M2Eclipse plugin</h2>
+<ol>
+<li>Checkout the source as described above</li>
+<li>Build the source using Maven as described above</li>
+<li>Start Eclipse (3.5 Galileo is recommended) and create a new workspace</li>
+<li>
+<p>Good references for this M2Eclipse plugin (need to install the plugin
+into your Eclipse environment)</p>
+<ul>
+<li><a href="http://m2eclipse.codehaus.org/">http://m2eclipse.codehaus.org/</a></li>
+<li><a href="http://docs.codehaus.org/display/M2ECLIPSE/Home">http://docs.codehaus.org/display/M2ECLIPSE/Home</a></li>
+<li><a href="http://www.theserverside.com/tt/articles/article.tss?l=Introductiontom2eclipse">http://www.theserverside.com/tt/articles/article.tss?l=Introductiontom2eclipse</a></li>
+</ul>
+</li>
+<li>
+<p>Import the OpenJPA projects, by:</p>
+<ul>
+<li>Select File --&gt; Import... --&gt; General -&gt; Maven Projects --&gt; Next</li>
+<li>Select root directory = <svn checkout location above></li>
+<li>All of the pom.xml files should be pre-selected for the svn checkout
+location</li>
+<li>You can affect the naming convention used for the generated Eclipse projects (one for each Maven module).  Click on Advanced and fill in the Name Template field.  I prefer "TRUNK-[artifactId](artifactid.html)
+" since it helps with workspace organization, but it's your choice.</li>
+<li>Press Finish</li>
+<li><strong>Note:</strong>  You may get a popup internal error at the end of this Import
+processing.  Not sure what the problem is, but it doesn't seem to affect
+the usage.</li>
+</ul>
+</li>
+<li>
+<p>A few fixups will be required to remove the errors that exist in the
+imported projects...</p>
+<ul>
+<li>openjpa-kernel -&gt; Properties -&gt; Java Build Path -&gt; Source -&gt; Add Folders<ul>
+<li>add target/generated-sources/javacc</li>
+</ul>
+</li>
+<li>openjpa-jdbc -&gt; Properties -&gt; Java Build Path -&gt; Libraries -&gt; JRE System
+Library -&gt; Edit<ul>
+<li>change this to a Java 6 JRE to remove these errors (see below if you
+can not use Java SE 6)</li>
+</ul>
+</li>
+<li>openjpa-persistence -&gt; Properties -&gt; Java Build Path -&gt; Libraries -&gt; JRE
+System Library -&gt; Edit<ul>
+<li>change this to a Java 6 JRE to remove these errors (see below if you
+can not use Java SE 6)</li>
+</ul>
+</li>
+<li>openjpa-persistence-jdbc -&gt; Properties -&gt; Java Build Path -&gt; Libraries
+-&gt; JRE System Library -&gt; Edit<ul>
+<li>change this to a Java 6 JRE to remove these errors (see below if you
+can not use Java SE 6)</li>
+</ul>
+</li>
+<li>openjpa-examples.  Open up src/main/java and select ReverseMapping
+folder.  Right mouse click.<ul>
+<li>Select Build Path -&gt; Exclude</li>
+</ul>
+</li>
+</ul>
+</li>
+</ol>
+<p>For Java SE 5 users building from the 2.0.x branch, you will need to
+exclude some Java SE 6 specific classes by performing the following steps
+for the source:</p>
+<ol>
+<li>Open the Properties for BR20-openjpa-persistence (or whatever your naming
+convention is)</li>
+<li>Select Java Build Path --&gt; Source</li>
+<li>
+<p>Edit the openjpa-persistence/src/main/java --&gt; Excluded setting to
+include the following:</p>
+<div class="codehilite"><pre><span class="n">org</span><span class="sr">/apache/o</span><span class="n">penjpa</span><span class="sr">/persistence/m</span><span class="n">eta</span><span class="o">/</span><span class="n">AnnotationProcessor6</span><span class="o">.</span><span class="n">java</span>
+<span class="n">org</span><span class="sr">/apache/o</span><span class="n">penjpa</span><span class="sr">/persistence/m</span><span class="n">eta</span><span class="o">/</span><span class="n">CompileTimeLogger</span><span class="o">.</span><span class="n">java</span>
+<span class="n">org</span><span class="sr">/apache/o</span><span class="n">penjpa</span><span class="sr">/persistence/m</span><span class="n">eta</span><span class="o">/</span><span class="n">SourceAnnotationHandler</span><span class="o">.</span><span class="n">java</span>
+</pre></div>
+
+
+</li>
+</ol>
+<p><a name="Building-Common2.xBuildProblems"></a></p>
+<h2 id="common-2x-build-problems">Common 2.x Build Problems</h2>
+<p><a name="Building-WrongMavenLevel"></a></p>
+<h3 id="wrong-maven-level">Wrong Maven Level</h3>
+<p>Example Maven output -</p>
+<div class="codehilite"><pre><span class="k">[INFO] [enforcer:enforce {execution: default}]</span>
+<span class="err">[WARNING]</span> <span class="err">Rule</span> <span class="err">0:</span> <span class="err">org.apache.maven.plugins.enforcer.RequireMavenVersion</span> <span class="err">failed</span> <span class="err">with</span> <span class="err">message:</span>
+<span class="err">Detected</span> <span class="err">Maven</span> <span class="err">Version:</span> <span class="err">2.0.10</span> <span class="err">is</span> <span class="err">not</span> <span class="err">in</span> <span class="err">the</span> <span class="err">allowed</span> <span class="err">range</span> <span class="err">[2.2.1,).</span>
+<span class="err">[INFO]</span> <span class="err">------------------------------------------------------------------------</span>
+<span class="err">[ERROR]</span> <span class="err">BUILD</span> <span class="err">ERROR</span>
+<span class="err">[INFO]</span> <span class="err">------------------------------------------------------------------------</span>
+<span class="err">[INFO]</span> <span class="err">Some</span> <span class="err">Enforcer</span> <span class="err">rules</span> <span class="err">have</span> <span class="err">failed.</span> <span class="err">Look</span> <span class="err">above</span> <span class="err">for</span> <span class="err">specific</span> <span class="err">messages</span> <span class="err">explaining</span> <span class="err">why</span> <span class="err">the</span> <span class="err">rule</span> <span class="err">failed.</span>
+</pre></div>
+
+
+<p>Solution - Upgrade to Maven 2.2.1 or later</p>
+<p><a name="Building-WrongJavaLevel"></a></p>
+<h3 id="wrong-java-level">Wrong Java Level</h3>
+<p>Example Maven output -</p>
+<div class="codehilite"><pre><span class="k">[INFO] [enforcer:enforce {execution: default}]</span>
+<span class="err">[WARNING]</span> <span class="err">Rule</span> <span class="err">1:</span> <span class="err">org.apache.maven.plugins.enforcer.RequireJavaVersion</span> <span class="err">failed</span> <span class="err">with</span> <span class="err">message:</span>
+<span class="err">Detected</span> <span class="err">JDK</span> <span class="err">Version:</span> <span class="err">1.5.0-19</span> <span class="err">is</span> <span class="err">not</span> <span class="err">in</span> <span class="err">the</span> <span class="err">allowed</span> <span class="err">range</span> <span class="err">[1.6,).</span>
+<span class="err">[INFO]</span> <span class="err">------------------------------------------------------------------------</span>
+<span class="err">[ERROR]</span> <span class="err">BUILD</span> <span class="err">ERROR</span>
+<span class="err">[INFO]</span> <span class="err">------------------------------------------------------------------------</span>
+<span class="err">[INFO]</span> <span class="err">Some</span> <span class="err">Enforcer</span> <span class="err">rules</span> <span class="err">have</span> <span class="err">failed.</span> <span class="err">Look</span> <span class="err">above</span> <span class="err">for</span> <span class="err">specific</span> <span class="err">messages</span> <span class="err">explaining</span> <span class="err">why</span> <span class="err">the</span> <span class="err">rule</span> <span class="err">failed.</span>
+</pre></div>
+
+
+<p>Solution - Upgrade to latest Sun JDK 1.6.0 or IBM 6 SDK</p>
+<p>Note - OpenJDK and Java SE 7 are not supported at this time.</p>
+<p><a name="Building-MissingLicenseHeaders"></a></p>
+<h3 id="missing-license-headers">Missing License Headers</h3>
+<p>Example Maven output -</p>
+<div class="codehilite"><pre><span class="o">.</span> <span class="o">.</span> <span class="o">.</span>
+<span class="p">[</span><span class="n">INFO</span><span class="p">]</span> <span class="o">------------------------------------------------------------------------</span>
+<span class="p">[</span><span class="n">INFO</span><span class="p">]</span> <span class="n">Building</span> <span class="n">OpenJPA</span> <span class="n">Parent</span> <span class="n">POM</span>
+<span class="p">[</span><span class="n">INFO</span><span class="p">]</span>    <span class="n">task</span><span class="o">-</span><span class="n">segment:</span> <span class="p">[</span><span class="n">clean</span><span class="p">,</span> <span class="n">install</span><span class="p">]</span>
+<span class="p">[</span><span class="n">INFO</span><span class="p">]</span> <span class="o">------------------------------------------------------------------------</span>
+<span class="o">.</span> <span class="o">.</span> <span class="o">.</span>
+<span class="p">[</span><span class="n">INFO</span><span class="p">]</span> <span class="p">[</span><span class="n">enforcer:enforce</span> <span class="p">{</span><span class="n">execution:</span> <span class="n">default</span><span class="p">}]</span>
+<span class="p">[</span><span class="n">INFO</span><span class="p">]</span> <span class="p">[</span><span class="n">source:test</span><span class="o">-</span><span class="n">jar</span> <span class="p">{</span><span class="n">execution:</span> <span class="n">attach</span><span class="o">-</span><span class="n">sources</span><span class="p">}]</span>
+<span class="p">[</span><span class="n">INFO</span><span class="p">]</span> <span class="p">[</span><span class="n">ianal:verify</span><span class="o">-</span><span class="n">legal</span><span class="o">-</span><span class="n">files</span> <span class="p">{</span><span class="n">execution:</span> <span class="n">default</span><span class="p">}]</span>
+<span class="p">[</span><span class="n">INFO</span><span class="p">]</span> <span class="p">[</span><span class="n">apache</span><span class="o">-</span><span class="n">rat:check</span> <span class="p">{</span><span class="n">execution:</span> <span class="n">default</span><span class="p">}]</span>
+<span class="p">[</span><span class="n">INFO</span><span class="p">]</span> <span class="n">Exclude:</span> <span class="o">**/</span><span class="n">javax</span><span class="o">.</span><span class="n">persistence</span><span class="o">.</span><span class="n">spi</span><span class="o">.</span><span class="n">PersistenceProvider</span>
+<span class="p">[</span><span class="n">INFO</span><span class="p">]</span> <span class="n">Exclude:</span> <span class="o">**/</span><span class="n">javax</span><span class="o">.</span><span class="n">annotation</span><span class="o">.</span><span class="n">processing</span><span class="o">.</span><span class="n">Processor</span>
+<span class="p">[</span><span class="n">INFO</span><span class="p">]</span> <span class="n">Exclude:</span> <span class="o">**/*.</span><span class="n">rsrc</span>
+<span class="p">[</span><span class="n">INFO</span><span class="p">]</span> <span class="n">Exclude:</span> <span class="o">**/</span><span class="n">org</span><span class="o">.</span><span class="n">apache</span><span class="o">.</span><span class="n">openjpa</span><span class="o">.</span><span class="n">revision</span><span class="o">.</span><span class="n">properties</span>
+<span class="p">[</span><span class="n">INFO</span><span class="p">]</span> <span class="n">Exclude:</span> <span class="n">scripts</span><span class="o">/*.</span><span class="n">list</span>
+<span class="p">[</span><span class="n">INFO</span><span class="p">]</span> <span class="n">Exclude:</span> <span class="n">scripts</span><span class="o">/*.</span><span class="n">options</span>
+<span class="p">[</span><span class="n">INFO</span><span class="p">]</span> <span class="n">Exclude:</span> <span class="n">scripts</span><span class="o">/*.</span><span class="n">dict</span>
+<span class="p">[</span><span class="n">INFO</span><span class="p">]</span> <span class="n">Exclude:</span> <span class="o">**</span><span class="sr">/.*/</span><span class="o">**</span>
+<span class="p">[</span><span class="n">INFO</span><span class="p">]</span> <span class="n">Exclude:</span> <span class="o">**</span><span class="sr">/target/</span><span class="o">**/*</span>
+<span class="p">[</span><span class="n">INFO</span><span class="p">]</span> <span class="n">Exclude:</span> <span class="o">**/</span><span class="n">dependency</span><span class="o">-</span><span class="n">reduced</span><span class="o">-</span><span class="n">pom</span><span class="o">.</span><span class="n">xml</span>
+<span class="p">[</span><span class="n">INFO</span><span class="p">]</span> <span class="n">Exclude:</span> <span class="o">**/*.</span><span class="nb">log</span>
+<span class="p">[</span><span class="n">INFO</span><span class="p">]</span> <span class="n">Exclude:</span> <span class="o">**/</span><span class="n">maven</span><span class="o">-</span><span class="n">eclipse</span><span class="o">.</span><span class="n">xml</span>
+<span class="p">[</span><span class="n">INFO</span><span class="p">]</span> <span class="n">Exclude:</span> <span class="o">**/</span><span class="n">rat</span><span class="o">.</span><span class="n">txt</span>
+<span class="p">[</span><span class="n">INFO</span><span class="p">]</span> <span class="n">Exclude:</span> <span class="o">**</span><span class="sr">/internal-repository/</span><span class="o">**</span>
+<span class="p">[</span><span class="n">INFO</span><span class="p">]</span> <span class="o">------------------------------------------------------------------------</span>
+<span class="p">[</span><span class="n">ERROR</span><span class="p">]</span> <span class="n">BUILD</span> <span class="n">FAILURE</span>
+<span class="p">[</span><span class="n">INFO</span><span class="p">]</span> <span class="o">------------------------------------------------------------------------</span>
+<span class="p">[</span><span class="n">INFO</span><span class="p">]</span> <span class="n">Too</span> <span class="n">many</span> <span class="n">unapproved</span> <span class="n">licenses:</span> <span class="mi">1</span>
+<span class="p">[</span><span class="n">INFO</span><span class="p">]</span> <span class="o">------------------------------------------------------------------------</span>
+</pre></div>
+
+
+<p>For the module that failed to build (which in the case above is the root
+pom.xml) open the target/rat.txt file and search for any "????"
+occurrences, like -</p>
+<div class="codehilite"><pre><span class="o">.</span> <span class="o">.</span> <span class="o">.</span>
+<span class="o">*****************************************************</span>
+  <span class="n">Files</span> <span class="n">with</span> <span class="n">Apache</span> <span class="n">License</span> <span class="n">headers</span> <span class="n">will</span> <span class="n">be</span> <span class="n">marked</span> <span class="n">AL</span>
+  <span class="n">Binary</span> <span class="n">files</span> <span class="p">(</span><span class="n">which</span> <span class="k">do</span> <span class="ow">not</span> <span class="nb">require</span> <span class="n">AL</span> <span class="n">headers</span><span class="p">)</span> <span class="n">will</span> <span class="n">be</span> <span class="n">marked</span> <span class="n">B</span>
+  <span class="n">Compressed</span> <span class="n">archives</span> <span class="n">will</span> <span class="n">be</span> <span class="n">marked</span> <span class="n">A</span>
+  <span class="n">Notices</span><span class="p">,</span> <span class="n">licenses</span> <span class="n">etc</span> <span class="n">will</span> <span class="n">be</span> <span class="n">marked</span> <span class="n">N</span>
+  <span class="n">N</span> <span class="n">LICENSE</span><span class="o">.</span><span class="n">txt</span>
+  <span class="n">N</span> <span class="n">NOTICE</span><span class="o">.</span><span class="n">txt</span>
+  <span class="n">AL</span>    <span class="n">openjpa</span><span class="o">/</span><span class="n">pom</span><span class="o">.</span><span class="n">xml</span>
+  <span class="n">AL</span>    <span class="n">openjpa</span><span class="sr">/src/m</span><span class="n">ain</span><span class="sr">/appended-resources/</span><span class="n">META</span><span class="o">-</span><span class="n">INF</span><span class="o">/</span><span class="n">LICENSE</span><span class="o">.</span><span class="n">vm</span>
+  <span class="n">AL</span>    <span class="n">openjpa</span><span class="sr">/src/m</span><span class="n">ain</span><span class="sr">/appended-resources/</span><span class="n">META</span><span class="o">-</span><span class="n">INF</span><span class="o">/</span><span class="n">NOTICE</span><span class="o">.</span><span class="n">vm</span>
+ <span class="o">!</span><span class="p">?????</span> <span class="n">OPENJPA</span><span class="o">-</span><span class="mi">1621</span><span class="o">.</span><span class="n">patch</span>
+<span class="o">.</span> <span class="o">.</span> <span class="o">.</span>
+</pre></div>
+
+
+<p>Solution - either add the missing ASL 2.0 license header, remove the file
+from your local working directory (if it is a temporary file that should
+not be added to svn), or ask on the dev@openjpa list if the file can be
+added to the exclude list for the apache-rat checks.</p>
+                                            </div>
+                                        </td>
+                                        </tr>
+                                    </tbody>
+                                </table>
+                                <div class="bottom_red_bar"></div>
+                            </div>
+                        </div>
+                    </div>
+                </div>
+                <div class="black_box">
+                    <div class="footer">
+                        <div class="footer_l">
+                            <div class="footer_r">
+                                <div>
+                                </div>
+                            </div>
+                        </div>
+                    </div>
+                </div>
+            </div>
+            <div class="design_attribution">
+                Copyright (C) 2006,2012 The Apache Software Foundation. Licensed under <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License 2.0</a>.<br />
+                Apache, the Apache feather logo and OpenJPA are trademarks of The Apache Software Foundation.<br />
+                Other names may be trademarks of their respective owners.<br />
+            </div>
+
+        <script src="http://www.google-analytics.com/urchin.js" type="text/javascript">
+        </script>
+        <script type="text/javascript">
+            _uacct = "UA-1940143-1";
+            urchinTracker();
+        </script>
+
+    </body>
+</html>

Added: websites/staging/openjpa/trunk/content/coding-standards.html
==============================================================================
--- websites/staging/openjpa/trunk/content/coding-standards.html (added)
+++ websites/staging/openjpa/trunk/content/coding-standards.html Sun Dec  9 13:13:35 2012
@@ -0,0 +1,261 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<!--
+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.
+-->
+<html lang="en">
+    <head>
+        <META http-equiv="Content-Type" content="text/html;charset=UTF-8" />
+        <link href="http://openjpa.apache.org/styles/site.css" rel="stylesheet" type="text/css"/>
+        <!-- <link href="http://openjpa.apache.org/styles/type-settings.css" rel="stylesheet" type="text/css"/> -->
+        <link href="./css/type-settings.css" rel="stylesheet" type="text/css"/>
+        <LINK rel="schema.DC" href="http://purl.org/DC/elements/1.0/">
+        <META name="Description" content="Apache OpenJPA -- Coding Standards
" />
+        <META name="Keywords" content="Apache OpenJPA, JPA, JPA 1.0, JSR-220, JPA2, JPA 2.0, JSR-317, " />
+        <META name="Owner" content="dev@openjpa.apache.org" />
+        <META name="Robots" content="index, follow" />
+        <META name="Security" content="Public" />
+        <META name="Source" content="wiki template" />
+        <META name="DC.Date" scheme="iso8601" content="2010-08-11" />
+        <META name="DC.Language" scheme="rfc1766" content="en" />
+        <META name="DC.Rights" content="Copyright © 2006,2010 The Apache Software Foundation" />
+        <META http-equiv="PICS-Label" content='(PICS-1.1 "http://www.icra.org/ratingsv02.html" l gen true r (cz 1 lz 1 nz 1 oz 1 vz 1) "http://www.rsac.org/ratingsv01.html" l gen true r (n 0 s 0 v 0 l 0) "http://www.classify.org/safesurf/" l gen true r (SS~~000 1))'/>
+
+        <title>
+            Apache OpenJPA --
+        </title>
+    </head>
+    <body>
+        <div class="white_box">
+            <div class="header">
+                <div class="header_l">
+                    <div class="header_r">
+                    </div>
+                </div>
+            </div>
+            <div class="content">
+                <div class="content_l">
+                    <div class="content_r">
+                        <div>
+                            <!-- Banner -->
+                            <TABLE valign="top" border="0" cellspacing="0" cellpadding="5" width="100%" background="images/header-bg3.png">
+                                <TR>
+                                    <TD valing="top" align="left">
+                                        <A href="http://openjpa.apache.org/"><IMG src="images/openjpa-logo.png" border="0" alt="OpenJPA Logo"></A>
+                                    </TD>
+                                    <TD width="100%">
+                                        &nbsp;
+                                    </TD>
+                                    <TD valing="top" align="right">
+                                        <A href="http://www.apache.org/"><IMG src="images/asf_logo_wide2.png" border="0" alt="ASF Logo"></A>
+                                    </TD>
+                                </TR>
+                            </TABLE>
+
+                            <!-- Navigation Bar -->
+                            <div class="bottom_red_bar">
+                                <div id="site-breadcrumbs">
+                                    <!-- Breadcrumbs --
+                                    <a href="/">Home</a>&nbsp;&raquo&nbsp;<a href="/coding-standards.html">Coding Standards
</a>
+                                     -- Breadcrumbs -->
+                                </div>
+                            </div>
+
+                            <!-- Content -->
+                            <table border="0">
+                                <tbody>
+                                    <tr>
+                                        <td valign="top">
+                                            <div class="navigation">
+                                                <div class="navigation_top">
+                                                    <div class="navigation_bottom">
+                                                        <!-- NavigationBar -->
+                                                        <h3><a name="SideNav-Overview"></a><a href="overview.html" title="Overview">Overview</a></h3>
+
+                                                        <ul class="alternate" type="square">
+                                                            <li><a href="quick-start.html" title="Quick Start">Quick Start</a></li>
+                                                            <li><a href="documentation.html" title="Documentation">Documentation</a></li>
+                                                            <li><a href="downloads.html" title="Downloads">Downloads</a></li>
+                                                            <li><a href="site-index.html" title="Site Index">Site Index</a></li>
+                                                            <li><a href="license.html" title="License">License</a></li>
+                                                            <li><a href="privacy-policy.html" title="Privacy Policy">Privacy Policy</a></li>
+                                                        </ul>
+
+                                                        <h3><a name="SideNav-Community"></a><a href="community.html" title="Community">Community</a></h3>
+
+                                                        <ul class="alternate" type="square">
+                                                            <li><a href="index.html#Index-eventsandnews" title="Events and News">Events and News</a></li>
+                                                            <li><a href="found-a-bug.html" title="Found a Bug">Found a Bug</a>?</li>
+                                                            <li><a href="get-involved.html" title="Get Involved">Get Involved</a></li>
+                                                            <li><a href="mailing-lists.html" title="Mailing Lists">Mailing Lists</a></li>
+                                                            <li><a href="committers.html" title="Committers">Committers</a></li>
+                                                            <li><a href="integration.html" title="Integration">Integration</a></li>
+                                                            <li><a href="powered-by.html" title="Powered By">Powered By</a></li>
+                                                            <li><a href="thanks.html" title="Thanks">Thanks</a></li>
+                                                        </ul>
+
+
+                                                        <h3><a name="SideNav-Development"></a><a href="development.html" title="Development">Development</a></h3>
+
+                                                        <ul class="alternate" type="square">
+                                                            <li><a href="http://issues.apache.org/jira/browse/OPENJPA" class="external-link" rel="nofollow">Issue Tracker</a></li>
+                                                            <li><a href="source-code.html" title="Source Code">Source Code</a></li>
+                                                            <li><a href="testing.html" title="Testing">Testing</a></li>
+                                                            <li><a href="tools.html" title="Tools">Tools</a></li>
+                                                            <li><a href="samples.html" title="Samples">Samples</a></li>
+                                                            <li><a href="release-management.html" title="Release Management">Release Management</a></li>
+                                                        </ul>
+
+                                                        <h3>Search</h3>
+
+                                                        <div style="padding: 5px 5px 0px 25px;">
+                                                            <form action="http://www.google.com/search" method="get" style="font-size: 10px;">
+                                                                <input name="ie" type="hidden" value="UTF-8">
+                                                                <input name="oe" type="hidden" value="UTF-8">
+                                                                <input maxlength="255" name="q" size="9" type="text" value=""><br><br>
+                                                                <input name="btnG" type="submit" value="Google">
+                                                                <input name="domains" type="hidden" value="openjpa.apache.org">
+                                                                <input name="sitesearch" type="hidden" value="openjpa.apache.org">
+                                                            </form>
+                                                        </div>
+                                                    </div>
+                                                </div>
+                                            </div>
+                                        </td>
+                                        <td valign="top" width="100%" style="overflow:hidden;">
+                                            <div class="wiki-content">
+                                                <p><a name="Coding-Standards"></a></p>
+<p><a name="CodingStandards-CodingStandards"></a></p>
+<h1 id="coding-standards">Coding Standards</h1>
+<p><a name="CodingStandards-ASFRequirements"></a></p>
+<h2 id="asf-requirements">ASF Requirements</h2>
+<p><a name="CodingStandards-Copyrightnoticesforsubmittedpatches"></a></p>
+<h3 id="copyright-notices-for-submitted-patches">Copyright notices for submitted patches</h3>
+<p>Please see <a href="http://www.apache.org/legal/src-headers.html">http://www.apache.org/legal/src-headers.html</a>
+ for details of the following summary.</p>
+<p>Apache does not require you to assign ownership or copyright for any
+patches that you submit via the above process. You retain ownership for all
+such patches. But Apache does require you to grant Apache a license to use
+the patch. To do this for new files, do not include a copyright statement
+in the file but include this license as comments in the header of your
+source contribution - <a href="http://www.apache.org/legal/src-headers.html#headers">http://www.apache.org/legal/src-headers.html#headers</a>
+If you require that distributions of the project include your copyright
+notice, you should include with your patch an update to the NOTICE file at
+trunk/openjpa-project/NOTICE.txt documenting for which files you are
+notifying your copyright.</p>
+<p><a name="CodingStandards-LicenseandNoticefiles"></a></p>
+<h3 id="license-and-notice-files">License and Notice files</h3>
+<p>Please see <a href="http://www.apache.org/licenses/">http://www.apache.org/licenses/</a>
+ for details of the following summary.</p>
+<p>All release artifacts published by an Apache project (JAR/WAR/EAR, zip,
+tar, ...) must include License and Notice files.  A Disclaimer file must be
+included for any artifacts included form the incubator.</p>
+<p><a name="CodingStandards-GeneralFormattingConventions"></a></p>
+<h2 id="general-formatting-conventions">General Formatting Conventions</h2>
+<p>OpenJPA adheres to Sun's <em>Code Conventions for the Java Programming
+Language</em>, which is available at <a href="http://java.sun.com/docs/codeconv/">http://java.sun.com/docs/codeconv/</a></p>
+<ol>
+<li>Maximum line length is 120 characters (this is a deviation from the Java
+standards).</li>
+<li>Use spaces instead of tabs.</li>
+<li>Indendation size is 4 spaces.</li>
+<li>Do not insert a new line before opening brace. Insert a new line before
+closing brace.</li>
+<li>Use fully qualified import statements, i.e. do not use asterisks.</li>
+</ol>
+<p><a name="CodingStandards-EclipseUsers"></a></p>
+<h2 id="eclipse-users">Eclipse Users</h2>
+<p><a name="CodingStandards-FormatterProfile"></a></p>
+<h3 id="formatter-profile">Formatter Profile</h3>
+<p>The profile can be downloaded from here - <a href="artifacts/OpenJPA-formatting-preferences.xml">OpenJPA-formatting-preferences.xml</a>
+<strong>Updated 2009-06-29 (Eclipse Galileo)</strong> <a href="artifacts/OpenJPA-eclipse-galileo-formatting.xml">OpenJPA-eclipse-galileo-formatting.xml</a></p>
+<ol>
+<li>Window -&gt; Preferences</li>
+<li>Java -&gt; Code Style -&gt; Formatter</li>
+<li>Click on import and select the <em>OpenJPA-formatting-preferences.xml</em> file
+downloaded above.</li>
+<li>Press OK after importing</li>
+</ol>
+<p><a name="CodingStandards-CodeTemplate"></a></p>
+<h3 id="code-template">Code Template</h3>
+<p>The latest version with the required ASL header format can be downloaded
+here - <a href="artifacts/OpenJPA-code-style-template.xml">OpenJPA-code-style-template.xml</a></p>
+<ol>
+<li>Window -&gt; Preferences</li>
+<li>Java -&gt; Code Style -&gt; Code Templates</li>
+<li>Click on import and select the <em>OpenJPA-code-style-template.xml</em> file
+downloaded above.</li>
+<li>Press OK after importing</li>
+</ol>
+<p><a name="CodingStandards-SubmittingaPatch"></a></p>
+<h2 id="submitting-a-patch">Submitting a Patch</h2>
+<p>If you make changes to OpenJPA, and would like to contribute the to the
+project, you should create a patch via svn and post it to the <a href="http://issues.apache.org/jira/browse/OPENJPA">OpenJPA JIRA issue tracker</a>
+. To create a patch, simply execute the following command:</p>
+<div class="codehilite"><pre><span class="vg">$&gt;</span> <span class="n">svn</span> <span class="n">diff</span> <span class="o">&gt;</span> <span class="n">your</span><span class="o">-</span><span class="n">changes</span><span class="o">.</span><span class="n">patch</span>
+</pre></div>
+
+
+<p><em>Note:</em> You may also use Eclipse to create a patch (Team -&gt; Create
+Patch...), but this may require committers to modify the patch to match
+their project layout (workspace per branch or all branches in one
+workspace) and some committers may not be using Eclipse/Subclipse.</p>
+<p><a name="CodingStandards-TestCases"></a></p>
+<h2 id="testcases">TestCases</h2>
+<p>When we make a change it's generally a good idea to include a jUnit
+testcase which demonstrates the desired behavior. Changes that only affect
+a specific database or only operate in a certain environment (ie DB2 on
+Z/OS, or only when used with SunOne) are exceptions to the rule. </p>
+<p>The testcase should be self validating via jUnit asserts. Writing messages
+to system.err or system.out is discouraged - they lead to the impression
+that some manual interpretation of the results must be done. Messages like
+these are useful when developing the tests or when diagnosing problems but
+should not be committed. </p>
+                                            </div>
+                                        </td>
+                                        </tr>
+                                    </tbody>
+                                </table>
+                                <div class="bottom_red_bar"></div>
+                            </div>
+                        </div>
+                    </div>
+                </div>
+                <div class="black_box">
+                    <div class="footer">
+                        <div class="footer_l">
+                            <div class="footer_r">
+                                <div>
+                                </div>
+                            </div>
+                        </div>
+                    </div>
+                </div>
+            </div>
+            <div class="design_attribution">
+                Copyright (C) 2006,2012 The Apache Software Foundation. Licensed under <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License 2.0</a>.<br />
+                Apache, the Apache feather logo and OpenJPA are trademarks of The Apache Software Foundation.<br />
+                Other names may be trademarks of their respective owners.<br />
+            </div>
+
+        <script src="http://www.google-analytics.com/urchin.js" type="text/javascript">
+        </script>
+        <script type="text/javascript">
+            _uacct = "UA-1940143-1";
+            urchinTracker();
+        </script>
+
+    </body>
+</html>



Mime
View raw message