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]