commons-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From ohe...@apache.org
Subject svn commit: r550047 - /jakarta/commons/proper/configuration/trunk/src/java/org/apache/commons/configuration/PropertiesConfiguration.java
Date Sat, 23 Jun 2007 14:44:16 GMT
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>{@link 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: commons-dev-unsubscribe@jakarta.apache.org
For additional commands, e-mail: commons-dev-help@jakarta.apache.org


Mime
View raw message