svn commit: r1502852 - /commons/proper/configuration/trunk/src/main/java/org/apache/commons/configuration/AbstractConfiguration.java

[oh...@apache.org]

Author: oheger
Date: Sat Jul 13 19:31:48 2013
New Revision: 1502852

URL: http://svn.apache.org/r1502852
Log:
Javadocs update related to list delimiter handling.

Modified:
    commons/proper/configuration/trunk/src/main/java/org/apache/commons/configuration/AbstractConfiguration.java

Modified: commons/proper/configuration/trunk/src/main/java/org/apache/commons/configuration/AbstractConfiguration.java
URL: http://svn.apache.org/viewvc/commons/proper/configuration/trunk/src/main/java/org/apache/commons/configuration/AbstractConfiguration.java?rev=1502852&r1=1502851&r2=1502852&view=diff
==============================================================================
--- commons/proper/configuration/trunk/src/main/java/org/apache/commons/configuration/AbstractConfiguration.java (original)
+++ commons/proper/configuration/trunk/src/main/java/org/apache/commons/configuration/AbstractConfiguration.java Sat Jul 13 19:31:48 2013
@@ -60,15 +60,17 @@ import org.apache.commons.logging.impl.N
  * <li>Support for variable interpolation. Property values containing special
  * variable tokens (like <code>${var}</code>) will be replaced by their
  * corresponding values.</li>
- * <li>Support for string lists. The values of properties to be added to this
+ * <li>Optional support for string lists. The values of properties to be added to this
  * configuration are checked whether they contain a list delimiter character. If
  * this is the case and if list splitting is enabled, the string is split and
- * multiple values are added for this property. (With the
- * {@code setListDelimiter()} method the delimiter character can be
- * specified; per default a comma is used. The
- * {@code setDelimiterParsingDisabled()} method can be used to disable
- * list splitting completely.)</li>
- * <li>Allows to specify how missing properties are treated. Per default the
+ * multiple values are added for this property. List splitting is controlled
+ * by a {@link ListDelimiterHandler} object which can be set using the
+ * {@link #setListDelimiterHandler(ListDelimiterHandler)} method. It is
+ * disabled per default. To enable this feature, set a suitable
+ * {@code ListDelimiterHandler}, e.g. an instance of
+ * {@link DefaultListDelimiterHandler} configured with the desired list
+ * delimiter character.</li>
+ * <li>Allows specifying how missing properties are treated. Per default the
  * get methods returning an object will return <b>null</b> if the searched
  * property key is not found (and no default value is provided). With the
  * {@code setThrowExceptionOnMissing()} method this behavior can be