Author: brett
Date: Fri Jun  3 00:49:48 2005
New Revision: 179740

URL: http://svn.apache.org/viewcvs?rev=179740&view=rev
Log:
update compat notes

Modified:
    maven/maven-1/core/trunk/xdocs/reference/backwards-compatibility.xml

Modified: maven/maven-1/core/trunk/xdocs/reference/backwards-compatibility.xml
URL: 
http://svn.apache.org/viewcvs/maven/maven-1/core/trunk/xdocs/reference/backwards-compatibility.xml?rev=179740&r1=179739&r2=179740&view=diff
==============================================================================
--- maven/maven-1/core/trunk/xdocs/reference/backwards-compatibility.xml 
(original)
+++ maven/maven-1/core/trunk/xdocs/reference/backwards-compatibility.xml Fri 
Jun  3 00:49:48 2005
@@ -31,18 +31,6 @@
         might encounter upgrading between Maven versions, and how to update 
your
         project.
       </p>
-      <subsection name="Known Issues">
-        <p>
-          <b>XSLT and PDF generation on JDK 5.0</b>
-        </p>
-        <p>
-          A <a href="http://issues.apache.org/jira/browse/XALANJ-1978";>bug in 
Xalan</a> presently causes
-          the PDF plugin to fail under JDK 5.0.
-        </p>
-        <p>
-          XSLT otherwise should now work under JDK 1.4 and 5.0 without the 
plugin modifications previously required.
-        </p>
-      </subsection>
       <subsection name="Changes Between Maven 1.0 and Maven 1.1 (Subversion 
Only)">
         <p>
           <b>JDK requirement is now 1.4 and above</b>
@@ -59,7 +47,10 @@
           that particular version of Xerces and are no JAXP compliant may need 
modifications.
         </p>
         <p>
-          <b>Bundled Ant version changed from 1.5.3-1 to 1.6.4</b>
+          XSLT should now work under JDK 1.4 and 5.0 without the plugin 
modifications previously required.
+        </p>
+        <p>
+          <b>Bundled Ant version changed from 1.5.3-1 to 1.6.5</b>
         </p>
         <p>
           While in most cases this change should be transparent, those using 
optional tasks will need to add them as
@@ -126,10 +117,24 @@
         <p>
           <code>project.xml</code> files that used to work in older versions 
of Maven may now present parse
           errors. The parser in Maven 1.1 is much less tolerant of invalid 
<code>project.xml</code> files
-          to avoid silently masking syntax errors.
+          to avoid silently masking syntax errors. Some XML features are not 
enabled (such as DOCTYPE ENTITY
+          declarations) - see the <a href="/faq.html">FAQ</a> for an 
explanation.
         </p>
         <p>
           <b>Fix:</b> Check your project file against the XSD published for 
the model version you are using.
+        </p>
+        <p>
+          <b>Entities and JDK 1.4</b>
+        </p>
+        <p>
+          Due to a bug in the parser included with JDK 1.4, relative SYSTEM 
entities will not work in
+          <code>maven.xml</code> where they may have previously. 
+        </p>
+        <p>
+          <b>Fix:</b> As above, we recommend not using entities in 
<code>maven.xml</code>, in favour of inheritance
+          and plugins. If you want an existing file to work without 
modifications, you should
+          download <a 
href="http://repo1.maven.org/xerces/jars/xerces-2.6.2.jar";>Xerces</a> and place 
it in
+          <code>&lt;JAVA_HOME&gt;/jre/lib/endorsed</code> (this directory may 
need to be created).
         </p>
       </subsection>
     </section>



---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]

Reply via email to