[seam-commits] Seam SVN: r8681 - trunk/doc/Seam_Reference_Guide/en-US.

[seam-commits at lists.jboss.org]

Author: jbalunas at redhat.com
Date: 2008-08-13 11:32:26 -0400 (Wed, 13 Aug 2008)
New Revision: 8681

Modified:
   trunk/doc/Seam_Reference_Guide/en-US/Configuration.xml
   trunk/doc/Seam_Reference_Guide/en-US/Dependencies.xml
   trunk/doc/Seam_Reference_Guide/en-US/Gettingstarted.xml
   trunk/doc/Seam_Reference_Guide/en-US/Testing.xml
Log:
JBSEAM-3178 - updated JDK 6 information

Modified: trunk/doc/Seam_Reference_Guide/en-US/Configuration.xml
===================================================================
--- trunk/doc/Seam_Reference_Guide/en-US/Configuration.xml	2008-08-13 15:19:22 UTC (rev 8680)
+++ trunk/doc/Seam_Reference_Guide/en-US/Configuration.xml	2008-08-13 15:32:26 UTC (rev 8681)
@@ -716,7 +716,8 @@
 
             <para>
               Embedded JBoss must by installed into Tomcat for Seam applications
-              to run correctly on it. Embedded JBoss only runs on JDK 1.5 (not JDK 1.6). 
+              to run correctly on it. Embedded JBoss runs with JDK 5 or JDK 6 (
+              see <xref linkend="jdk_dependencies" /> for details on using JDK 6).                
               Embedded JBoss can be downloaded 
               <ulink url="http://sourceforge.net/project/showfiles.php?group_id=22866&amp;package_id=228977">here</ulink>.
               The process for installing Embedded JBoss into Tomcat 6 is quite 

Modified: trunk/doc/Seam_Reference_Guide/en-US/Dependencies.xml
===================================================================
--- trunk/doc/Seam_Reference_Guide/en-US/Dependencies.xml	2008-08-13 15:19:22 UTC (rev 8680)
+++ trunk/doc/Seam_Reference_Guide/en-US/Dependencies.xml	2008-08-13 15:32:26 UTC (rev 8681)
@@ -4,6 +4,40 @@
 <chapter id="dependencies">
   <title>Dependencies</title>
   
+  <section id="jdk_dependencies">
+    <title>JDK Dependencies</title>
+    
+    <para>
+      Seam does not work with JDK 1.4 and requires JDK 5 or above as it uses 
+      annotations and other JDK 5.0 features..  Seam has been thoroughly tested 
+      using Sun's JDKs.  However there are no known issues specific to Seam with
+      other JDK's.
+    </para>
+    
+    <section id="jdk6_dependencies">
+        <title>Sun's JDK 6 Considerations</title>
+        <para>
+            Earlier versions of Sun's JDK 6 contained an incompatible 
+            version of JAXB and required overriding it using the "endorsed" 
+            directory.  Sun's JDK6 Update 4 release upgraded to JAXB 2.1 and 
+            removed this requirement.  When building, testing, or executing be
+            sure to use this version or higher. 
+        </para>
+        
+        <para>
+            Seam used JBoss Embedded in its unit and integration testing.  This
+            has an additional requirement when using JDK 6. In order to run 
+            JBoss Embedded with JDK 6 you need to set the following JVM argument:
+            
+            <programlisting>-Dsun.lang.ClassLoader.allowArraySyntax=true</programlisting>
+            
+            Seam's internal build system is setting this by default when it 
+            executes Seam's test suite.  However if you are also using JBoss
+            Embedded for your testing you will need to set this value. 
+        </para>
+    </section>    
+  </section>
+  
   <section>
     <title>Project Dependencies</title>
 

Modified: trunk/doc/Seam_Reference_Guide/en-US/Gettingstarted.xml
===================================================================
--- trunk/doc/Seam_Reference_Guide/en-US/Gettingstarted.xml	2008-08-13 15:19:22 UTC (rev 8680)
+++ trunk/doc/Seam_Reference_Guide/en-US/Gettingstarted.xml	2008-08-13 15:32:26 UTC (rev 8681)
@@ -24,7 +24,8 @@
     <section>
         <title>Before you start</title>
 
-        <para>Make sure you have JDK 5 or JDK 6, JBoss AS 4.2 and Ant 1.6, along with recent versions of Eclipse, the
+        <para>Make sure you have JDK 5 or JDK 6 (see <xref
+                           linkend="jdk_dependencies"/> for details), JBoss AS 4.2 and Ant 1.6, along with recent versions of Eclipse, the
             JBoss IDE plugin for Eclipse and the TestNG plugin for Eclipse correctly installed before starting. Add your
             JBoss installation to the JBoss Server View in Eclipse. Start JBoss in debug mode. Finally, start a command
             prompt in the directory where you unzipped the Seam distribution.</para>

Modified: trunk/doc/Seam_Reference_Guide/en-US/Testing.xml
===================================================================
--- trunk/doc/Seam_Reference_Guide/en-US/Testing.xml	2008-08-13 15:19:22 UTC (rev 8680)
+++ trunk/doc/Seam_Reference_Guide/en-US/Testing.xml	2008-08-13 15:32:26 UTC (rev 8681)
@@ -103,8 +103,8 @@
         <para>
             The approach taken by Seam is to let you write tests that exercise your
             components while running inside a pruned down container environment (Seam,
-            together with the JBoss Embedded container; n.b. JBoss Embedded requires
-            JDK 1.5 and does not work with JDK 1.6).
+            together with the JBoss Embedded container; see 
+            <xref linkend="config.install.embedded" /> for configuration details)
         </para>
         
 <programlisting role="JAVA"><![CDATA[public class RegisterTest extends SeamTest