From 303a6cf385085aefc4a5d818c664ad982db5bc83 Mon Sep 17 00:00:00 2001
From: Arjen Poutsma <apoutsma@vmware.com>
Date: Sat, 9 Feb 2008 16:44:49 +0000
Subject: [PATCH] Updated FAQ for Java 6. Hasn't SUN learned anything about
 bundling libraries in the JDK?

---
 src/site/fml/faq.fml | 44 ++++++++++++--------------------------------
 1 file changed, 12 insertions(+), 32 deletions(-)

diff --git a/src/site/fml/faq.fml b/src/site/fml/faq.fml
index 7c523fb0..b6c51b3b 100644
--- a/src/site/fml/faq.fml
+++ b/src/site/fml/faq.fml
@@ -25,35 +25,16 @@
                 </p>
                 <table class="bodyTable">
                     <tbody>
-                        <tr>
-                            <th>Library</th>
-                            <th>Version</th>
-                        </tr>
-                        <tr>
-                            <td>
-                                <a href="http://xerces.apache.org/xerces2-j/">Xerces</a>
-                            </td>
-                            <td>2.8.1</td>
-                        </tr>
-                        <tr>
-                            <td>
-                                <a href="http://xml.apache.org/xalan-j/">Xalan</a>
-                            </td>
-                            <td>2.7.0</td>
-                        </tr>
-                        <tr>
-                            <td>
-                                <a href="http://xerces.apache.org/xerces2-j/">XML-APIs</a>
-                            </td>
-                            <td>1.3.04</td>
-                        </tr>
+                        <tr><th>Library</th><th>Version</th></tr>
+                        <tr><td><a href="http://xerces.apache.org/xerces2-j/">Xerces</a></td><td>2.8.1</td></tr>
+                        <tr><td><a href="http://xml.apache.org/xalan-j/">Xalan</a></td><td>2.7.0</td></tr>
+                        <tr><td><a href="http://xerces.apache.org/xerces2-j/">XML-APIs</a></td><td>1.3.04</td></tr>
+                        <tr><td><a href="http://java.sun.com/webservices/downloads/1.3/index.html">SAAJ</a></td><td>1.2</td></tr>
                     </tbody>
                 </table>
                 <p>
-                    Note that the security module requires Java 5, because an underlying library (XWSS) requires it.
-                    Also note that SAAJ 1.3 required Java 5 as well, so you need to use SAAJ 1.2 (which can be
-                    downloaded as part of the<a href="http://java.sun.com/webservices/downloads/1.3/index.html">
-                    Java Web Services Developer Pack 1.3</a>.
+                    Note that the <code>XwsSecurityInterceptor</code> requires Java 5, because an underlying library (XWSS) requires
+                    it. Instead, you can use the<code>Wss4jSecurityInterceptor</code>.
                 </p>
             </answer>
         </faq>
@@ -61,12 +42,11 @@
             <question>Does Spring-WS work under Java 1.6?</question>
             <answer>
                 <p>
-                    Spring Web Services works under Java 1.6, but you must make sure to use the versions of Xerces and
-                    Xalan that are packaged with it. Using other XML parsing libraries will cause exceptions to occur
-                    in the<tt>org.apache.xml.serializer.ToXMLSAXHandler</tt>.
-                </p>
-                <p>
-                    Therefore, when using Java 6, do not bundle Xerces, nor Xalan in your application.
+                    Java 1.6 ships with SAAJ 1.3, JAXB 2.0, and JAXP 1.4 (a custom version of Xerces and Xalan).
+                    Overriding these libraries by putting different version on the classpath will result in various
+                    classloading issues, or exceptions in <tt>org.apache.xml.serializer.ToXMLSAXHandler</tt>.
+                    The only option for using more recent versions is to put the newer version in the
+                    <code>endorsed</code> directory (see above).
                 </p>
             </answer>
         </faq>