commons-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From s...@apache.org
Subject svn commit: r1650603 - /commons/cms-site/trunk/content/xdoc/commons-parent-pom.xml
Date Fri, 09 Jan 2015 17:14:09 GMT
Author: sebb
Date: Fri Jan  9 17:14:08 2015
New Revision: 1650603

URL: http://svn.apache.org/r1650603
Log:
Bring java profile list up to date and provide more examples

Modified:
    commons/cms-site/trunk/content/xdoc/commons-parent-pom.xml

Modified: commons/cms-site/trunk/content/xdoc/commons-parent-pom.xml
URL: http://svn.apache.org/viewvc/commons/cms-site/trunk/content/xdoc/commons-parent-pom.xml?rev=1650603&r1=1650602&r2=1650603&view=diff
==============================================================================
--- commons/cms-site/trunk/content/xdoc/commons-parent-pom.xml (original)
+++ commons/cms-site/trunk/content/xdoc/commons-parent-pom.xml Fri Jan  9 17:14:08 2015
@@ -243,20 +243,23 @@
         <p>
           For this reason
           <a href="http://svn.apache.org/repos/asf/commons/proper/commons-parent/trunk/pom.xml">commons-parent</a>
-          provides <i>profiles</i> for compiling/testing under different Java
versions:
+          provides <i>profiles</i> for compiling/testing under different Java
versions (correct as of version 36):
         </p>
         <ul>
-            <li><code>java-1.3</code> for compiling and testing using Java
1.3</li>
-            <li><code>java-1.4</code> for compiling and testing using Java
1.4</li>
-            <li><code>java-1.5</code> for compiling and testing using Java
1.5</li>
-            <li><code>java-1.6</code> for compiling and testing using Java
1.6</li>
+            <li><code>java-1.3</code> for compiling and testing using Java
1.3 (uses property JAVA_1_3_HOME)</li>
+            <li><code>java-1.4</code> for compiling and testing using Java
1.4 (uses property JAVA_1_4_HOME)</li>
+            <li><code>java-1.5</code> for compiling and testing using Java
1.5 (uses property JAVA_1_5_HOME)</li>
+            <li><code>java-1.6</code> for compiling and testing using Java
1.6 (uses property JAVA_1_6_HOME)</li>
+            <li><code>java-1.7</code> for compiling and testing using Java
1.7 (uses property JAVA_1_7_HOME)</li>
+            <li><code>java-1.8</code> for compiling and testing using Java
1.8 (uses property JAVA_1_8_HOME)</li>
+            <li><code>java-1.9</code> for compiling and testing using Java
1.9 (uses property JAVA_1_9_HOME)</li>
         </ul>
         <p>
-          In order for these profiles to work, you need to configure the <code>JAVA_1_3_HOME</code>,
-          <code>JAVA_1_4_HOME</code>, <code>JAVA_1_5_HOME</code>
and <code>JAVA_1_6_HOME</code>
-          properties in your <code>settings.xml</code> file (or as environment
variables or even command-line properties).
+          In order for these profiles to work, you need to configure the relevant <code>JAVA_1_N_HOME</code>
+          properties in your <code>settings.xml</code> file. 
+          [There is no need to configure properties for profiles you don't need.]
           Each property should be set to the <code>directory</code> where the
relevant version of the JDK is installed.
-          The Maven compiler plugin has 
+          Note: the Maven compiler plugin has 
           <a href="http://maven.apache.org/plugins/maven-compiler-plugin/examples/compile-using-different-jdk.html">documentation
on how this works</a>.
         </p>
         <p>
@@ -271,30 +274,29 @@
         <source><![CDATA[
         <settings>
             <profiles>
+                <!-- Sample profiles showing different ways of defining the properties
-->
                 <profile>
-                    <id>java-1.3</id>
-                    <properties>
-                        <JAVA_1_3_HOME>C:\j\jdk1.3.1_18</JAVA_1_3_HOME>
-                    </properties>
-                </profile>
-                <profile>
-                    <id>java-1.4</id>
+                    <id>java-1.5</id>
                     <properties>
-                        <JAVA_1_4_HOME>C:\j\jdk1.4.2_19</JAVA_1_4_HOME>
+                        <!-- sample Windows definition -->
+                        <JAVA_1_5_HOME>C:\jdk1.5.0_22</JAVA_1_5_HOME>
                     </properties>
                 </profile>
                 <profile>
-                    <id>java-1.5</id>
+                    <id>java-1.6</id>
                     <properties>
-                        <JAVA_1_5_HOME>C:\j\jdk1.5.0_22</JAVA_1_5_HOME>
+                        <!-- Sample Unix definition -->
+                        <JAVA_1_6_HOME>/home/jenkins/tools/java/latest1.6</JAVA_1_6_HOME>
                     </properties>
                 </profile>
                 <profile>
-                    <id>java-1.6</id>
+                    <id>java-1.7</id>
                     <properties>
-                        <JAVA_1_6_HOME>C:\j\jdk1.6.0_17</JAVA_1_6_HOME>
+                        <!-- sample definition using an OS environment variable -->
+                        <JAVA_1_7_HOME>${env.JAVA_1_7_HOME}</JAVA_1_7_HOME>
                     </properties>
                 </profile>
+                <!-- No need to define every possible java profile, only the ones you
want to use (and have JDKs for) -->
             </profiles>
         </settings>
         ]]></source>
@@ -304,10 +306,18 @@
           the most convenient).
         </p>
         <p>
-          Once you have configured those properties you can, for example, compile and test
with Java 1.4 using the following command:
+          Once you have configured those properties you can, for example, compile and test
with Java 1.6 using the following command:
+        </p>
+        <source>
+            mvn clean test -Pjava-1.6
+        </source>
+        <p>
+        If you don't want to update the <code>settings.xml</code> file, you can
provide the property definition on the command-line.
+        (However for frequent use it is easier to update the settings file)
+        For example:
         </p>
         <source>
-            mvn -Pjava-1.4 clean test
+            mvn clean test -Pjava-1.6 -DJAVA_1_6_HOME=/home/jenkins/tools/java/latest1.6
         </source>
       </subsection>
 



Mime
View raw message