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: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]