svn commit: r385708 - /jakarta/commons/proper/digester/trunk/src/java/org/apache/commons/digester/Digester.java

[sk...@apache.org]

Author: skitching
Date: Mon Mar 13 17:50:30 2006
New Revision: 385708

URL: http://svn.apache.org/viewcvs?rev=385708&view=rev
Log:
Document fact that ParserFeatureSetterFactory is broken and is unlikely to be fixed.

Modified:
    jakarta/commons/proper/digester/trunk/src/java/org/apache/commons/digester/Digester.java

Modified: jakarta/commons/proper/digester/trunk/src/java/org/apache/commons/digester/Digester.java
URL: http://svn.apache.org/viewcvs/jakarta/commons/proper/digester/trunk/src/java/org/apache/commons/digester/Digester.java?rev=385708&r1=385707&r2=385708&view=diff
==============================================================================
--- jakarta/commons/proper/digester/trunk/src/java/org/apache/commons/digester/Digester.java (original)
+++ jakarta/commons/proper/digester/trunk/src/java/org/apache/commons/digester/Digester.java Mon Mar 13 17:50:30 2006
@@ -837,6 +837,13 @@
      * See also method setSchemaLanguage which allows the type of the schema
      * specified here to be defined. By default, the schema is expected to
      * be a W3C xml schema definition.
+     * <p>
+     * IMPORTANT NOTE: This functionality was never very reliable, and has
+     * been horribly broken since the 1.6 release of Digester. There are
+     * currently no plans to fix it, so you are strongly recommended to
+     * avoid using this method. Instead, create an XMLParser instance
+     * yourself, configure validation appropriately, and pass it as a
+     * parameter to the Digester constructor.
      *
      * @param schemaLocation a URI to the schema.
      */



---------------------------------------------------------------------
To unsubscribe, e-mail: commons-dev-unsubscribe@jakarta.apache.org
For additional commands, e-mail: commons-dev-help@jakarta.apache.org