Updated FAQ for Java 6. Hasn't SUN learned anything about bundling libraries in the JDK?

Author: poutsma

src/site/fml/faq.fml

@@ -25,48 +25,28 @@
                 </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>
         <faq id="java-1.6">
             <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>