Author: oheger
Date: Sat Jun 23 07:44:15 2007
New Revision: 550047
URL: http://svn.apache.org/viewvc?view=rev&rev=550047
Log:
Improved Javadocs for PropertiesConfiguration related to the handling of
properties with multiple values when the properties file is saved.
Modified:
jakarta/commons/proper/configuration/trunk/src/java/org/apache/commons/configuration/PropertiesConfiguration.java
Modified:
jakarta/commons/proper/configuration/trunk/src/java/org/apache/commons/configuration/PropertiesConfiguration.java
URL:
http://svn.apache.org/viewvc/jakarta/commons/proper/configuration/trunk/src/java/org/apache/commons/configuration/PropertiesConfiguration.java?view=diff&rev=550047&r1=550046&r2=550047
==============================================================================
---
jakarta/commons/proper/configuration/trunk/src/java/org/apache/commons/configuration/PropertiesConfiguration.java
(original)
+++
jakarta/commons/proper/configuration/trunk/src/java/org/apache/commons/configuration/PropertiesConfiguration.java
Sat Jun 23 07:44:15 2007
@@ -82,7 +82,17 @@
* </li>
* <li>
* If a <i>key</i> is used more than once, the values are appended
- * like if they were on the same line separated with commas.
+ * like if they were on the same line separated with commas. <em>Note</em>:
+ * When the configuration file is written back to disk the associated
+ * <code>[EMAIL PROTECTED] PropertiesConfigurationLayout}</code> object (see
below) will
+ * try to preserve as much of the original format as possible, i.e.
properties
+ * with multiple values defined on a single line will also be written back on
+ * a single line, and multiple occurrences of a single key will be written on
+ * multiple lines. If the <code>addProperty()</code> method was called
+ * multiple times for adding multiple values to a property, these properties
+ * will per default be written on multiple lines in the output file, too.
+ * Some options of the <code>PropertiesConfigurationLayout</code> class have
+ * influence on that behavior.
* </li>
* <li>
* Blank lines and lines starting with character '#' or '!' are skipped.
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
