You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@commons.apache.org by si...@apache.org on 2012/03/15 11:46:53 UTC

svn commit: r1300903 - /commons/proper/digester/trunk/core/src/main/java/org/apache/commons/digester3/binder/DigesterLoader.java

Author: simonetripodi
Date: Thu Mar 15 10:46:53 2012
New Revision: 1300903

URL: http://svn.apache.org/viewvc?rev=1300903&view=rev
Log:
added recommendations on using shortcut methods

Modified:
    commons/proper/digester/trunk/core/src/main/java/org/apache/commons/digester3/binder/DigesterLoader.java

Modified: commons/proper/digester/trunk/core/src/main/java/org/apache/commons/digester3/binder/DigesterLoader.java
URL: http://svn.apache.org/viewvc/commons/proper/digester/trunk/core/src/main/java/org/apache/commons/digester3/binder/DigesterLoader.java?rev=1300903&r1=1300902&r2=1300903&view=diff
==============================================================================
--- commons/proper/digester/trunk/core/src/main/java/org/apache/commons/digester3/binder/DigesterLoader.java (original)
+++ commons/proper/digester/trunk/core/src/main/java/org/apache/commons/digester3/binder/DigesterLoader.java Thu Mar 15 10:46:53 2012
@@ -525,6 +525,9 @@ public final class DigesterLoader
      * Creates a new {@link XMLReader} instance that relies on the given {@code XMLReader}
      * and the default {@link Rules} implementation.
      *
+     * <b>WARNING</b> Input {@link XMLReader} will be linked to built Digester instance so it is recommended
+     * to <b>NOT</b> share same {@link XMLReader} instance to produce the Digester.
+     *
      * @param reader The user defined {@code XMLReader}
      * @return a new {@link Digester} instance
      */
@@ -537,6 +540,9 @@ public final class DigesterLoader
      * Creates a new {@link XMLReader} instance that relies on the given {@code XMLReader}
      * and custom user define {@link Rules} implementation.
      *
+     * <b>WARNING</b> Input {@link XMLReader} and {@link Rules} will be linked to built Digester instance,
+     * so it is recommended to <b>NOT</b> share same {@link XMLReader} and {@link Rules} instance to produce the Digester.
+     *
      * @param reader The user defined {@code XMLReader}
      * @param rules The custom user define {@link Rules} implementation
      * @return a new {@link Digester} instance