10:32 a.m.
Author: jbalunas(a)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&...;.
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