openjpa-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From allee8...@apache.org
Subject svn commit: r1410639 - in /openjpa/site/trunk: WhoIsWorkingOnWhat.txt content/building.mdtext
Date Sat, 17 Nov 2012 00:09:34 GMT
Author: allee8285
Date: Sat Nov 17 00:09:33 2012
New Revision: 1410639

URL: http://svn.apache.org/viewvc?rev=1410639&view=rev
Log:
CMS migration updates.

Modified:
    openjpa/site/trunk/WhoIsWorkingOnWhat.txt
    openjpa/site/trunk/content/building.mdtext

Modified: openjpa/site/trunk/WhoIsWorkingOnWhat.txt
URL: http://svn.apache.org/viewvc/openjpa/site/trunk/WhoIsWorkingOnWhat.txt?rev=1410639&r1=1410638&r2=1410639&view=diff
==============================================================================
--- openjpa/site/trunk/WhoIsWorkingOnWhat.txt (original)
+++ openjpa/site/trunk/WhoIsWorkingOnWhat.txt Sat Nov 17 00:09:33 2012
@@ -13,7 +13,7 @@ done			automated-builds.mdtext
 			begin-using-openjpa---the-basics.mdtext
 			build-and-runtime-dependencies.mdtext
 			building-and-running-openbooks.mdtext
-			building.mdtext
+done			building.mdtext
 done			coding-standards.mdtext
 			committers.mdtext
 			community.mdtext

Modified: openjpa/site/trunk/content/building.mdtext
URL: http://svn.apache.org/viewvc/openjpa/site/trunk/content/building.mdtext?rev=1410639&r1=1410638&r2=1410639&view=diff
==============================================================================
--- openjpa/site/trunk/content/building.mdtext (original)
+++ openjpa/site/trunk/content/building.mdtext Sat Nov 17 00:09:33 2012
@@ -1,25 +1,30 @@
 Title: Building
-{excerpt:hidden=true}How to build OpenJPA from source{excerpt}
+<a name="Building"></a>
 
 <a name="Building-Contents"></a>
 # Contents
+
 * [Building OpenJPA](#Building-BuildingOpenJPA)
-   * [Maven](#Building-Maven)
-      * [Command Line Builds](#Building-CommandLineBuilds)
-      * [Executing various Maven build tasks](#Building-ExecutingvariousMavenbuildtasks)
-            * [Running just the "TestPersistence" test case](#Building-Runningjustthe"TestPersistence"testcase)
+
+    * [Maven](#Building-Maven)
+   
+        * [Command Line Builds](#Building-CommandLineBuilds)
+        * [Executing various Maven build tasks](#Building-ExecutingvariousMavenbuildtasks)
+      
+            * [Running just the "TestPersistence" test case](#Building-RunningjusttheTestPersistencetestcase)
             * [Running tests with Java 2 security enabled](#Building-RunningtestswithJava2securityenabled)
             * [Building and running only the examples included in the distribution](#Building-Buildingandrunningonlytheexamplesincludedinthedistribution)
             * [Building just the javadoc](#Building-Buildingjustthejavadoc)
             * [Building just the docbook documentation](#Building-Buildingjustthedocbookdocumentation)
-            * [Building with JDK 1.4 module verification (only for versions of OpenJPA
-prior to svn revision 640685)](#Building-BuildingwithJDK1.4moduleverification(onlyforversionsofOpenJPApriortosvnrevision640685))
-   * [Eclipse with Command-line Maven utilities](#Building-EclipsewithCommand-lineMavenutilities)
-   * [Eclipse with M2Eclipse plugin](#Building-EclipsewithM2Eclipseplugin)
-   * [Common 2.x Build Problems](#Building-Common2.xBuildProblems)
-      * [Wrong Maven Level](#Building-WrongMavenLevel)
-      * [Wrong Java Level](#Building-WrongJavaLevel)
-      * [Missing License Headers](#Building-MissingLicenseHeaders)
+            * [Building with JDK 1.4 module verification (only for versions of OpenJPA prior
to svn revision 640685)](#Building-BuildingwithJDK1.4moduleverification(onlyforversionsofOpenJPApriortosvnrevision640685))
+            
+    * [Eclipse with Command-line Maven utilities](#Building-EclipsewithCommand-lineMavenutilities)
+    * [Eclipse with M2Eclipse plugin](#Building-EclipsewithM2Eclipseplugin)
+    * [Common 2.x Build Problems](#Building-Common2.xBuildProblems)
+    
+        * [Wrong Maven Level](#Building-WrongMavenLevel)
+        * [Wrong Java Level](#Building-WrongJavaLevel)
+        * [Missing License Headers](#Building-MissingLicenseHeaders)
 
 <a name="Building-BuildingOpenJPA"></a>
 # Building OpenJPA
@@ -38,51 +43,48 @@ code (from the Subversion source code ma
 (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.
 
-1. Ensure that you have Java installed and in your path by running: {{java
--fullversion}}
+1. Ensure that you have Java installed and in your path by running: `java
+-fullversion`
 1. Install the build tool, Apache Maven 2.2.1 or later, from
-http://maven.apache.org/. If it is installed correctly, typing *mvn -v*
-from the console will result in text like {{Apache Maven 2.2.1 (r801777;
-2009-08-06 21:16:01+0200)}}
-1. Install Subversion v1.4.x or newer from http://subversion.apache.org/.
+<http://maven.apache.org/>. If it is installed correctly, typing *mvn -v*
+from the console will result in text like `Apache Maven 2.2.1 (r801777;
+2009-08-06 21:16:01+0200)`
+1. Install Subversion v1.4.x or newer from <http://subversion.apache.org/>.
 If it is installed correctly, typing the following command should output
-help information: *svn help* or *svn --version*
+help information: **svn help** or **svn --version**
 1. Create a new directory you want to do your work in, then change to that
 directory from the console.
-1. Check out the sources by running: {{svn co
-https://svn.apache.org/repos/asf/openjpa/trunk openjpa-trunk}}. It will
+1. Check out the sources by running: `svn co`
+<https://svn.apache.org/repos/asf/openjpa/trunk> `openjpa-trunk`. It will
 check out the sources to the openjpa-trunk directory. More information on
 checking out the OpenJPA sources can be found on the [Source Code](source-code.html)
  page.
 1. Change to the openjpa-trunk directory, which has already been created in
 the previous step.
-1. Build OpenJPA by running: *mvn package* or better *mvn install*. The
+1. Build OpenJPA by running: `mvn package` or better `mvn install`. The
 first time you run the build, many dependencies are automatically resolved
-and downloaded. *It is common for dependency downloading to fail the first
-time, which will fail the build.* If any of these dependency downloads
+and downloaded. **It is common for dependency downloading to fail the first
+time, which will fail the build.** If any of these dependency downloads
 fail, just re-run the command. You may also add the following to your
-*~/.m2/setting.xml* file (see
-http://maven.apache.org/guides/mini/guide-mirror-settings.html)
-
-
-    <settings>
-        <mirrors>
-    	<mirror>
-    	    <id>repo.mergere.com</id>
-    	    <url>http://repo.mergere.com/maven2</url>
-    	    <mirrorOf>central</mirrorOf>
-    	</mirror>
-        </mirrors>
-    </settings>
+`~/.m2/setting.xml` file (see <http://maven.apache.org/guides/mini/guide-mirror-settings.html>)
 
+        <settings>
+            <mirrors>
+                <mirror>
+                    <id>repo.mergere.com</id>
+                    <url>http://repo.mergere.com/maven2</url>
+                    <mirrorOf>central</mirrorOf>
+                </mirror>
+            </mirrors>
+        </settings>
 
  If any tests fail, and you want to ignore the failures, instead run:
 
-  *mvn package -DfailIfNoTests=false*
+  `mvn package -DfailIfNoTests=false`
 
- or
+    or
 
-  *mvn package -DskipTests*
+  `mvn package -DskipTests`
 
 
 An example session is as follows:
@@ -120,8 +122,7 @@ An example session is as follows:
     A  trunk/openjpa-lib/src/test/java/org/apache/openjpa
     A  trunk/openjpa-lib/src/test/java/org/apache/openjpa/lib
     A  trunk/openjpa-lib/src/test/java/org/apache/openjpa/lib/test
-    A 
-trunk/openjpa-lib/src/test/java/org/apache/openjpa/lib/test/AbstractTestCase.java
+    A  trunk/openjpa-lib/src/test/java/org/apache/openjpa/lib/test/AbstractTestCase.java
     
      ...
     
@@ -132,170 +133,98 @@ trunk/openjpa-lib/src/test/java/org/apac
     
     $ mvn compile
     
-    [INFO]
- Scanning for projects...
-    [INFO]
- Reactor build order: 
-    [INFO]
-   OpenJPA Parent POM
-    [INFO]
-   OpenJPA Utilities Library
-    [INFO]
-   OpenJPA Kernel
-    [INFO]
-   OpenJPA JDBC
-    [INFO]
-   OpenJPA Persistence
-    [INFO]
-   OpenJPA Persistence JDBC
-    [INFO]
-   OpenJPA Persistence Locking Tests
-    [INFO]
-   OpenJPA XML Store
-    [INFO]
-   OpenJPA Slice
-    [INFO]
-   OpenJPA JEST
-    [INFO]
-   OpenJPA Aggregate Jar
-    [INFO]
-   OpenJPA Aggregate Jar with Dependencies
-    [INFO]
-   OpenJPA Project Docs and Assemblies
-    [INFO]
-   OpenJPA Examples
-    [INFO]
-   OpenJPA Examples - Simple
-    [INFO]
-   OpenJPA Examples - image-gallery
-    [INFO]
-   OpenJPA Examples - OpenBooks
-    [INFO]
-   OpenJPA Integration Tests
-    [INFO]
-   OpenJPA Integration Tests - Daytrader
-    [INFO]
-   OpenJPA Integration Tests - Examples
-    [INFO]
-   OpenJPA Integration Tests - SLF4JLogFactory
-    [INFO]
-   OpenJPA Integration Tests - JPA TCK
-    [INFO]
-   OpenJPA Integration Tests - Bean Validation
-    [INFO]
-   OpenJPA Integration Tests - JMX Platform MBeans
-    [INFO]
- ------------------------------------------------------------------------
-    [INFO]
- Building OpenJPA Parent POM
-    [INFO]
-    task-segment: [compile]
-    [INFO]
- ------------------------------------------------------------------------
+    [INFO] Scanning for projects...
+    [INFO] Reactor build order: 
+    [INFO]   OpenJPA Parent POM
+    [INFO]   OpenJPA Utilities Library
+    [INFO]   OpenJPA Kernel
+    [INFO]   OpenJPA JDBC
+    [INFO]   OpenJPA Persistence
+    [INFO]   OpenJPA Persistence JDBC
+    [INFO]   OpenJPA Persistence Locking Tests
+    [INFO]   OpenJPA XML Store
+    [INFO]   OpenJPA Slice
+    [INFO]   OpenJPA JEST
+    [INFO]   OpenJPA Aggregate Jar
+    [INFO]   OpenJPA Aggregate Jar with Dependencies
+    [INFO]   OpenJPA Project Docs and Assemblies
+    [INFO]   OpenJPA Examples
+    [INFO]   OpenJPA Examples - Simple
+    [INFO]   OpenJPA Examples - image-gallery
+    [INFO]   OpenJPA Examples - OpenBooks
+    [INFO]   OpenJPA Integration Tests
+    [INFO]   OpenJPA Integration Tests - Daytrader
+    [INFO]   OpenJPA Integration Tests - Examples
+    [INFO]   OpenJPA Integration Tests - SLF4JLogFactory
+    [INFO]   OpenJPA Integration Tests - JPA TCK
+    [INFO]   OpenJPA Integration Tests - Bean Validation
+    [INFO]   OpenJPA Integration Tests - JMX Platform MBeans
+    [INFO] ------------------------------------------------------------------------
+    [INFO] Building OpenJPA Parent POM
+    [INFO]    task-segment: [compile]
+    [INFO] ------------------------------------------------------------------------
     
      ...
     
     [INFO]
-    [INFO]
- ------------------------------------------------------------------------
-    [INFO]
- Reactor Summary:
-    [INFO]
- ------------------------------------------------------------------------
-    [INFO]
- OpenJPA Parent POM .................................... SUCCESS [1:23.143s]
-    [INFO]
- OpenJPA Utilities Library ............................. SUCCESS [13.749s]
-    [INFO]
- OpenJPA Kernel ........................................ SUCCESS [19.251s]
-    [INFO]
- OpenJPA JDBC .......................................... SUCCESS [14.351s]
-    [INFO]
- OpenJPA Persistence ................................... SUCCESS [10.254s]
-    [INFO]
- OpenJPA Persistence JDBC .............................. SUCCESS [46.774s]
-    [INFO]
- OpenJPA Persistence Locking Tests ..................... SUCCESS [15.183s]
-    [INFO]
- OpenJPA XML Store ..................................... SUCCESS [11.788s]
-    [INFO]
- OpenJPA Slice ......................................... SUCCESS [4.437s]
-    [INFO]
- OpenJPA JEST .......................................... SUCCESS [4.854s]
-    [INFO]
- OpenJPA Aggregate Jar ................................. SUCCESS [10.729s]
-    [INFO]
- OpenJPA Aggregate Jar with Dependencies ............... SUCCESS [6.761s]
-    [INFO]
- OpenJPA Project Docs and Assemblies ................... SUCCESS [1:41.937s]
-    [INFO]
- OpenJPA Examples ...................................... SUCCESS [0.663s]
-    [INFO]
- OpenJPA Examples - Simple ............................. SUCCESS [1.475s]
-    [INFO]
- OpenJPA Examples - image-gallery ...................... SUCCESS [3.920s]
-    [INFO]
- OpenJPA Examples - OpenBooks .......................... SUCCESS [12.961s]
-    [INFO]
- OpenJPA Integration Tests ............................. SUCCESS [0.381s]
-    [INFO]
- OpenJPA Integration Tests - Daytrader ................. SUCCESS [7.565s]
-    [INFO]
- OpenJPA Integration Tests - Examples .................. SUCCESS [0.269s]
-    [INFO]
- OpenJPA Integration Tests - SLF4JLogFactory ........... SUCCESS [1.977s]
-    [INFO]
- OpenJPA Integration Tests - JPA TCK ................... SUCCESS [0.248s]
-    [INFO]
- OpenJPA Integration Tests - Bean Validation ........... SUCCESS [3.213s]
-    [INFO]
- OpenJPA Integration Tests - JMX Platform MBeans ....... SUCCESS [7.729s]
-    [INFO]
- ------------------------------------------------------------------------
-    [INFO]
- ------------------------------------------------------------------------
-    [INFO]
- BUILD SUCCESSFUL
-    [INFO]
- ------------------------------------------------------------------------
-    [INFO]
- Total time: 6 minutes 26 seconds
-    [INFO]
- Finished at: Sun Jan 30 19:43:50 CET 2011
-    [INFO]
- Final Memory: 92M/158M
-    [INFO]
- ------------------------------------------------------------------------
+    [INFO] ------------------------------------------------------------------------
+    [INFO] Reactor Summary:
+    [INFO] ------------------------------------------------------------------------
+    [INFO] OpenJPA Parent POM .................................... SUCCESS [1:23.143s]
+    [INFO] OpenJPA Utilities Library ............................. SUCCESS [13.749s]
+    [INFO] OpenJPA Kernel ........................................ SUCCESS [19.251s]
+    [INFO] OpenJPA JDBC .......................................... SUCCESS [14.351s]
+    [INFO] OpenJPA Persistence ................................... SUCCESS [10.254s]
+    [INFO] OpenJPA Persistence JDBC .............................. SUCCESS [46.774s]
+    [INFO] OpenJPA Persistence Locking Tests ..................... SUCCESS [15.183s]
+    [INFO] OpenJPA XML Store ..................................... SUCCESS [11.788s]
+    [INFO] OpenJPA Slice ......................................... SUCCESS [4.437s]
+    [INFO] OpenJPA JEST .......................................... SUCCESS [4.854s]
+    [INFO] OpenJPA Aggregate Jar ................................. SUCCESS [10.729s]
+    [INFO] OpenJPA Aggregate Jar with Dependencies ............... SUCCESS [6.761s]
+    [INFO] OpenJPA Project Docs and Assemblies ................... SUCCESS [1:41.937s]
+    [INFO] OpenJPA Examples ...................................... SUCCESS [0.663s]
+    [INFO] OpenJPA Examples - Simple ............................. SUCCESS [1.475s]
+    [INFO] OpenJPA Examples - image-gallery ...................... SUCCESS [3.920s]
+    [INFO] OpenJPA Examples - OpenBooks .......................... SUCCESS [12.961s]
+    [INFO] OpenJPA Integration Tests ............................. SUCCESS [0.381s]
+    [INFO] OpenJPA Integration Tests - Daytrader ................. SUCCESS [7.565s]
+    [INFO] OpenJPA Integration Tests - Examples .................. SUCCESS [0.269s]
+    [INFO] OpenJPA Integration Tests - SLF4JLogFactory ........... SUCCESS [1.977s]
+    [INFO] OpenJPA Integration Tests - JPA TCK ................... SUCCESS [0.248s]
+    [INFO] OpenJPA Integration Tests - Bean Validation ........... SUCCESS [3.213s]
+    [INFO] OpenJPA Integration Tests - JMX Platform MBeans ....... SUCCESS [7.729s]
+    [INFO] ------------------------------------------------------------------------
+    [INFO] ------------------------------------------------------------------------
+    [INFO] BUILD SUCCESSFUL
+    [INFO] ------------------------------------------------------------------------
+    [INFO] Total time: 6 minutes 26 seconds
+    [INFO] Finished at: Sun Jan 30 19:43:50 CET 2011
+    [INFO] Final Memory: 92M/158M
+    [INFO] ------------------------------------------------------------------------
     
     
     $ mvn package -DskipTests
     
-    [INFO]
- Scanning for projects...
+    [INFO] Scanning for projects...
     
     ...
     
-    [INFO]
- Building zip:
-/tmp/trunk/openjpa-project/target/site/downloads/apache-openjpa-2.2.0-SNAPSHOT-binary.zip
+    [INFO] Building zip:/tmp/trunk/openjpa-project/target/site/downloads/apache-openjpa-2.2.0-SNAPSHOT-binary.zip
     
     ... 
     
     $ ls -lh openjpa-project/target/site/downloads/
     
     total 40M
-    -rw-r--r-- 1 milosz milosz 15M Jan 30 19:41
-apache-openjpa-2.2.0-SNAPSHOT-binary.zip
-    -rw-r--r-- 1 milosz milosz 25M Jan 30 19:43
-apache-openjpa-2.2.0-SNAPSHOT-source.zip
+    -rw-r--r-- 1 milosz milosz 15M Jan 30 19:41 apache-openjpa-2.2.0-SNAPSHOT-binary.zip
+    -rw-r--r-- 1 milosz milosz 25M Jan 30 19:43 apache-openjpa-2.2.0-SNAPSHOT-source.zip
     
 
-
-
 <a name="Building-ExecutingvariousMavenbuildtasks"></a>
 ### Executing various Maven build tasks
 
-<a name="Building-Runningjustthe"TestPersistence"testcase"></a>
+<a name="Building-RunningjusttheTestPersistencetestcase"></a>
 ##### Running just the "TestPersistence" test case
 
 
@@ -341,15 +270,13 @@ The javadoc will be output to *target/si
     mvn -f openjpa-project/pom.xml process-resources -Pdocbook-profile
 
 
-The manual HTML will be output to
-*openjpa-project/target/manual/manual.html*.
+The manual HTML will be output to `openjpa-project/target/manual/manual.html`.
 
-h5. Building with JDK 1.4 module verification (only for versions of OpenJPA
-prior to svn revision 640685)
+<a name="Building-BuildingwithJDK1.4moduleverification(onlyforversionsofOpenJPApriortosvnrevision640685)"></a>
+##### Building with JDK 1.4 module verification (only for versions of OpenJPA prior to svn
revision 640685)
 
 
-    mvn compile -Djava14.jar=C:\Program Files\Java\j2re1.4.2_07\lib\rt.jar
-compile
+    mvn compile -Djava14.jar=C:\Program Files\Java\j2re1.4.2_07\lib\rt.jar compile
 
 
 Specifying the "java14.jar" system property will cause the
@@ -365,60 +292,67 @@ which is why it needs to be manually spe
 
 1. Checkout the source as described above
 1. Build the source using Maven as described above
-  
-  
-
-    mvn eclipse:eclipse
-
-  
-  
-
-    mvn eclipse:configure-workspace -Declipse.workspace=${path to your
-workspace} 
+1. Create the Eclipse Metadata -
+     
+        mvn eclipse:eclipse
+    1. 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
+    
+            mvn eclipse:configure-workspace -Declipse.workspace=${path to your workspace}

 
 1. Start Eclipse (3.2 - 3.4 SR2 are known to work) and create a new
 workspace
 1. Import the OpenJPA projects, by:
-** Select File --> Import... --> General - Existing Projects into Workspace
---> Next
-** Select root directory = <svn checkout location above>
-** Deselect the openjpa-examples project
-** Press Finish
+
+    * Select File --> Import... --> General - Existing Projects into Workspace -->
Next
+    * Select root directory = <svn checkout location above>
+    * Deselect the openjpa-examples project
+    * Press Finish
+    
 1. A few fixups will be required to remove the errors that exist in the
 imported projects...
-** openjpa-kernel -> Properties -> Java Build Path -> Source -> Add Folders
-*** add target/generated-sources/javacc
-** openjpa-jdbc -> Properties -> Java Build Path -> Libraries -> JRE System
-Library -> Edit
-*** change this to a Java 6 JRE to remove these errors (see below if you
-can not use Java SE 6)
-** openjpa-persistence -> Properties -> Java Build Path -> Libraries -> JRE
-System Library -> Edit
-*** change this to a Java 6 JRE to remove these errors (see below if you
+
+    * openjpa-kernel -> Properties -> Java Build Path -> Source -> Add Folders
+    
+        * add target/generated-sources/javacc
+        
+    * openjpa-jdbc -> Properties -> Java Build Path -> Libraries -> JRE System
Library -> Edit
+    
+        * change this to a Java 6 JRE to remove these errors (see below if you can not use
Java SE 6)
+        
+    * openjpa-persistence -> Properties -> Java Build Path -> Libraries -> JRE
System Library -> Edit
+    
+        * change this to a Java 6 JRE to remove these errors (see below if you
 can not use Java SE 6)
-** openjpa-persistence-jdbc -> Properties -> Java Build Path -> Libraries
+
+    * openjpa-persistence-jdbc -> Properties -> Java Build Path -> Libraries
 -> JRE System Library -> Edit
-*** change this to a Java 6 JRE to remove these errors (see below if you
+
+        * change this to a Java 6 JRE to remove these errors (see below if you
 can not use Java SE 6)
-** openjpa-examples.  Open up src/main/java and select ReverseMapping
+
+    * openjpa-examples.  Open up src/main/java and select ReverseMapping
 folder.  Right mouse click.
-*** Select Build Path -> Exclude
+
+        * Select Build Path -> Exclude
+        
 1. For each imported project, you'll need to edit the build properties to
 remove an incorrect dependency:
-** Project --> Properties --> Java Build Path --> Source
-** Remove openjpa-project from the list of source folders
+
+    * Project --> Properties --> Java Build Path --> Source
+    * Remove openjpa-project from the list of source folders
 
 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:
+
 1. Open the Properties for openjpa-persistence
 1. Select Java Build Path --> Source
 1. Edit the openjpa-persistence/src/main/java --> Excluded setting to
 include the following:
 
-    org/apache/openjpa/persistence/meta/AnnotationProcessor6.java
-    org/apache/openjpa/persistence/meta/CompileTimeLogger.java
-    org/apache/openjpa/persistence/meta/SourceAnnotationHandler.java
+        org/apache/openjpa/persistence/meta/AnnotationProcessor6.java
+        org/apache/openjpa/persistence/meta/CompileTimeLogger.java
+        org/apache/openjpa/persistence/meta/SourceAnnotationHandler.java
 
 
 <a name="Building-EclipsewithM2Eclipseplugin"></a>
@@ -429,57 +363,58 @@ include the following:
 1. Start Eclipse (3.5 Galileo is recommended) and create a new workspace
 1. Good references for this M2Eclipse plugin (need to install the plugin
 into your Eclipse environment)
-** http://m2eclipse.codehaus.org/
-** http://docs.codehaus.org/display/M2ECLIPSE/Home
-**
-http://www.theserverside.com/tt/articles/article.tss?l=Introductiontom2eclipse
+
+    * <http://m2eclipse.codehaus.org/>
+    * <http://docs.codehaus.org/display/M2ECLIPSE/Home>
+    * <http://www.theserverside.com/tt/articles/article.tss?l=Introductiontom2eclipse>
+    
 1. Import the OpenJPA projects, by:
-** Select File --> Import... --> General -> Maven Projects --> Next
-** Select root directory = <svn checkout location above>
-** All of the pom.xml files should be pre-selected for the svn checkout
+
+    * Select File --> Import... --> General -> Maven Projects --> Next
+    * Select root directory = <svn checkout location above>
+    * All of the pom.xml files should be pre-selected for the svn checkout
 location
-** 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)
+    * 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.
-** Press Finish
-** *Note:*  You may get a popup internal error at the end of this Import
+    * Press Finish
+    * **Note:**  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.
+
 1. A few fixups will be required to remove the errors that exist in the
 imported projects...
-** openjpa-kernel -> Properties -> Java Build Path -> Source -> Add Folders
-*** add target/generated-sources/javacc
-** openjpa-jdbc -> Properties -> Java Build Path -> Libraries -> JRE System
+
+    * openjpa-kernel -> Properties -> Java Build Path -> Source -> Add Folders
+        * add target/generated-sources/javacc
+    * openjpa-jdbc -> Properties -> Java Build Path -> Libraries -> JRE System
 Library -> Edit
-*** change this to a Java 6 JRE to remove these errors (see below if you
+        * change this to a Java 6 JRE to remove these errors (see below if you
 can not use Java SE 6)
-** openjpa-persistence -> Properties -> Java Build Path -> Libraries -> JRE
+    * openjpa-persistence -> Properties -> Java Build Path -> Libraries -> JRE
 System Library -> Edit
-*** change this to a Java 6 JRE to remove these errors (see below if you
+        * change this to a Java 6 JRE to remove these errors (see below if you
 can not use Java SE 6)
-** openjpa-persistence-jdbc -> Properties -> Java Build Path -> Libraries
+    * openjpa-persistence-jdbc -> Properties -> Java Build Path -> Libraries
 -> JRE System Library -> Edit
-*** change this to a Java 6 JRE to remove these errors (see below if you
+        * change this to a Java 6 JRE to remove these errors (see below if you
 can not use Java SE 6)
-** openjpa-examples.  Open up src/main/java and select ReverseMapping
+    * openjpa-examples.  Open up src/main/java and select ReverseMapping
 folder.  Right mouse click.
-*** Select Build Path -> Exclude
+        * Select Build Path -> Exclude
 
 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:
+
 1. Open the Properties for BR20-openjpa-persistence (or whatever your naming
 convention is)
 1. Select Java Build Path --> Source
 1. Edit the openjpa-persistence/src/main/java --> Excluded setting to
 include the following:
 
-    org/apache/openjpa/persistence/meta/AnnotationProcessor6.java
-    org/apache/openjpa/persistence/meta/CompileTimeLogger.java
-    org/apache/openjpa/persistence/meta/SourceAnnotationHandler.java
-
-
-  
-  
+        org/apache/openjpa/persistence/meta/AnnotationProcessor6.java
+        org/apache/openjpa/persistence/meta/CompileTimeLogger.java
+        org/apache/openjpa/persistence/meta/SourceAnnotationHandler.java
 
 <a name="Building-Common2.xBuildProblems"></a>
 ## Common 2.x Build Problems
@@ -488,114 +423,73 @@ include the following:
 ### Wrong Maven Level
 
 Example Maven output -
-{code:none}
-[INFO](info.html)
- [enforcer:enforce {execution: default}]
-[WARNING](warning.html)
- Rule 0: org.apache.maven.plugins.enforcer.RequireMavenVersion failed with
-message:
-Detected Maven Version: 2.0.10 is not in the allowed range [2.2.1,).
-[INFO](info.html)
- ------------------------------------------------------------------------
-[ERROR](error.html)
- BUILD ERROR
-[INFO](info.html)
- ------------------------------------------------------------------------
-[INFO](info.html)
- Some Enforcer rules have failed. Look above for specific messages
-explaining why the rule failed.
 
-    Solution - Upgrade to Maven 2.2.1 or later
-    
-    h3. Wrong Java Level
+    [INFO] [enforcer:enforce {execution: default}]
+    [WARNING] Rule 0: org.apache.maven.plugins.enforcer.RequireMavenVersion failed with message:
+    Detected Maven Version: 2.0.10 is not in the allowed range [2.2.1,).
+    [INFO] ------------------------------------------------------------------------
+    [ERROR] BUILD ERROR
+    [INFO] ------------------------------------------------------------------------
+    [INFO] Some Enforcer rules have failed. Look above for specific messages explaining why
the rule failed.
+
+Solution - Upgrade to Maven 2.2.1 or later
+
+<a name="Building-WrongJavaLevel"></a>
+### Wrong Java Level
     
-    Example Maven output -
-    {code:none}
-    [INFO]
- [enforcer:enforce {execution: default}]
-    [WARNING]
- Rule 1: org.apache.maven.plugins.enforcer.RequireJavaVersion failed with
-message:
+Example Maven output -
+
+    [INFO] [enforcer:enforce {execution: default}]
+    [WARNING] Rule 1: org.apache.maven.plugins.enforcer.RequireJavaVersion failed with message:
     Detected JDK Version: 1.5.0-19 is not in the allowed range [1.6,).
-    [INFO]
- ------------------------------------------------------------------------
-    [ERROR]
- BUILD ERROR
-    [INFO]
- ------------------------------------------------------------------------
-    [INFO]
- Some Enforcer rules have failed. Look above for specific messages
-explaining why the rule failed.
+    [INFO] ------------------------------------------------------------------------
+    [ERROR] BUILD ERROR
+    [INFO] ------------------------------------------------------------------------
+    [INFO] Some Enforcer rules have failed. Look above for specific messages explaining why
the rule failed.
 
 Solution - Upgrade to latest Sun JDK 1.6.0 or IBM 6 SDK
+
 Note - OpenJDK and Java SE 7 are not supported at this time.
 
 <a name="Building-MissingLicenseHeaders"></a>
 ### Missing License Headers
 
 Example Maven output -
-{code:none}
-. . .
-[INFO](info.html)
- ------------------------------------------------------------------------
-[INFO](info.html)
- Building OpenJPA Parent POM
-[INFO](info.html)
-    task-segment: [clean, install]
-[INFO](info.html)
- ------------------------------------------------------------------------
-. . .
-[INFO](info.html)
- [enforcer:enforce {execution: default}]
-[INFO](info.html)
- [source:test-jar {execution: attach-sources}]
-[INFO](info.html)
- [ianal:verify-legal-files {execution: default}]
-[INFO](info.html)
- [apache-rat:check {execution: default}]
-[INFO](info.html)
- Exclude: **/javax.persistence.spi.PersistenceProvider
-[INFO](info.html)
- Exclude: **/javax.annotation.processing.Processor
-[INFO](info.html)
- Exclude: **/*.rsrc
-[INFO](info.html)
- Exclude: **/org.apache.openjpa.revision.properties
-[INFO](info.html)
- Exclude: scripts/*.list
-[INFO](info.html)
- Exclude: scripts/*.options
-[INFO](info.html)
- Exclude: scripts/*.dict
-[INFO](info.html)
- Exclude: **/.*/**
-[INFO](info.html)
- Exclude: **/target/**/*
-[INFO](info.html)
- Exclude: **/dependency-reduced-pom.xml
-[INFO](info.html)
- Exclude: **/*.log
-[INFO](info.html)
- Exclude: **/maven-eclipse.xml
-[INFO](info.html)
- Exclude: **/rat.txt
-[INFO](info.html)
- Exclude: **/internal-repository/**
-[INFO](info.html)
- ------------------------------------------------------------------------
-[ERROR](error.html)
- BUILD FAILURE
-[INFO](info.html)
- ------------------------------------------------------------------------
-[INFO](info.html)
- Too many unapproved licenses: 1
-[INFO](info.html)
- ------------------------------------------------------------------------
 
-    For the module that failed to build (which in the case above is the root
+    . . .
+    [INFO] ------------------------------------------------------------------------
+    [INFO] Building OpenJPA Parent POM
+    [INFO]    task-segment: [clean, install]
+    [INFO] ------------------------------------------------------------------------
+    . . .
+    [INFO] [enforcer:enforce {execution: default}]
+    [INFO] [source:test-jar {execution: attach-sources}]
+    [INFO] [ianal:verify-legal-files {execution: default}]
+    [INFO] [apache-rat:check {execution: default}]
+    [INFO] Exclude: **/javax.persistence.spi.PersistenceProvider
+    [INFO] Exclude: **/javax.annotation.processing.Processor
+    [INFO] Exclude: **/*.rsrc
+    [INFO] Exclude: **/org.apache.openjpa.revision.properties
+    [INFO] Exclude: scripts/*.list
+    [INFO] Exclude: scripts/*.options
+    [INFO] Exclude: scripts/*.dict
+    [INFO] Exclude: **/.*/**
+    [INFO] Exclude: **/target/**/*
+    [INFO] Exclude: **/dependency-reduced-pom.xml
+    [INFO] Exclude: **/*.log
+    [INFO] Exclude: **/maven-eclipse.xml
+    [INFO] Exclude: **/rat.txt
+    [INFO] Exclude: **/internal-repository/**
+    [INFO] ------------------------------------------------------------------------
+    [ERROR] BUILD FAILURE
+    [INFO] ------------------------------------------------------------------------
+    [INFO] Too many unapproved licenses: 1
+    [INFO] ------------------------------------------------------------------------
+
+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 -
-    {code:none}
+
     . . .
     *****************************************************
       Files with Apache License headers will be marked AL
@@ -614,7 +508,3 @@ Solution - either add the missing ASL 2.
 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.
-
-
-  
-  



Mime
View raw message