Mailing-List: contact derby-commits-help@db.apache.org; run by ezmlm
Precedence: bulk
Reply-To: "Derby Development" <derby-dev@db.apache.org>
Content-Type: text/plain; charset="utf-8"
MIME-Version: 1.0
Content-Transfer-Encoding: 7bit
Subject: svn commit: r525933 - in
 /db/derby/code/trunk/java/testing/org/apache/derbyTesting/junit:
 BaseJDBCTestCase.java XML.java
Date: Thu, 05 Apr 2007 19:17:01 -0000
To: derby-commits@db.apache.org
From: rhillegas@apache.org
Message-Id: <20070405191702.5625F1A9838@eris.apache.org>

Author: rhillegas
Date: Thu Apr  5 12:17:00 2007
New Revision: 525933

URL: http://svn.apache.org/viewvc?view=rev&rev=525933
Log:
DERBY-2502: Add a header comment to XML.java, explaining how to configure your environment so that the XML tests run. Also fix a javadoc warning in BaseJDBCTestCase.java.

Modified:
    db/derby/code/trunk/java/testing/org/apache/derbyTesting/junit/BaseJDBCTestCase.java
    db/derby/code/trunk/java/testing/org/apache/derbyTesting/junit/XML.java

Modified: db/derby/code/trunk/java/testing/org/apache/derbyTesting/junit/BaseJDBCTestCase.java
URL: http://svn.apache.org/viewvc/db/derby/code/trunk/java/testing/org/apache/derbyTesting/junit/BaseJDBCTestCase.java?view=diff&rev=525933&r1=525932&r2=525933
==============================================================================
--- db/derby/code/trunk/java/testing/org/apache/derbyTesting/junit/BaseJDBCTestCase.java (original)
+++ db/derby/code/trunk/java/testing/org/apache/derbyTesting/junit/BaseJDBCTestCase.java Thu Apr  5 12:17:00 2007
@@ -723,9 +723,9 @@
     /**
      * Executes the Callable statement that is expected to fail and verifies
      * that it throws the expected SQL exception.
-     * @param conn The Connection handle
-     * @param sql The SQL to execute
      * @param expectedSE The expected SQL exception
+     * @param conn The Connection handle
+     * @param callSQL The SQL to execute
      * @throws SQLException
      */
     public static void assertCallError(String expectedSE, Connection conn, String callSQL)

Modified: db/derby/code/trunk/java/testing/org/apache/derbyTesting/junit/XML.java
URL: http://svn.apache.org/viewvc/db/derby/code/trunk/java/testing/org/apache/derbyTesting/junit/XML.java?view=diff&rev=525933&r1=525932&r2=525933
==============================================================================
--- db/derby/code/trunk/java/testing/org/apache/derbyTesting/junit/XML.java (original)
+++ db/derby/code/trunk/java/testing/org/apache/derbyTesting/junit/XML.java Thu Apr  5 12:17:00 2007
@@ -39,7 +39,40 @@
 import junit.framework.Assert;
 
 /**
+ * <p>
  * XML utility methods for the JUnit tests.
+ * </p>
+ *
+ * <p>
+ * Note that The XML tests require a more advanced version of Xalan
+ * than the default version bundled with JDK 1.4. The XML tests silently
+ * exit if the required environment is not found.
+ * </p>
+ *
+ * <p>
+ * To run the XML tests under JDK 1.4, you must do the following:
+ * </p>
+ *
+ * <ul>
+ * <li>Download the latest version of Xalan (2.7.0 as of this writing).</li>
+ * <li>Copy all of the downloaded jars into the jre/lib/endorsed directory
+ * of your JDK 1.4 installation. Those jar files are:
+ * serializer.jar, xalan.jar, xercesImpl.jar, xml-apis.jar, and xsltc.jar.</li>
+ * </ul>
+ *
+ * <p>
+ *That's it! Now the XML tests should run for you under JDK 1.4.
+ * </p>
+ *
+ * <p>
+ * To run the XML tests under a higher version of the JDK, you must do the
+ * following:
+ * </p>
+ *
+ * <ul>
+ * <li>Download the latest version of Xalan as described above.</li>
+ * <li>Wire the downloaded jar files into your CLASSPATH.</li>
+ * </ul>
  */
 public class XML {