commons-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
Subject svn commit: r1090173 - in /commons/proper/configuration/trunk/src: changes/changes.xml site/xdoc/userguide/howto_configurationbuilder.xml
Date Fri, 08 Apr 2011 09:40:40 GMT
Author: oheger
Date: Fri Apr  8 09:40:40 2011
New Revision: 1090173

[CONFIGURATION-437] Updated documentation and changes.


Modified: commons/proper/configuration/trunk/src/changes/changes.xml
--- commons/proper/configuration/trunk/src/changes/changes.xml (original)
+++ commons/proper/configuration/trunk/src/changes/changes.xml Fri Apr  8 09:40:40 2011
@@ -27,6 +27,11 @@
         JNDIConfiguration.getKeys() no more logs an exception if the prefix does
         not exist.
+      <action dev="oheger" type="update" issue="CONFIGURATION-437">
+        Child configuration builders created for a &lt;configuration&gt; element
+        in a configuration definition file now inherit some of their properties
+        from the builder object which processed the file.
+      </action>
       <action dev="oheger" type="update" issue="CONFIGURATION-436">
         The optional dependency to Apache Ant has been changed to the new
         groupId org.apache.ant. The version was updated to the most recent

Modified: commons/proper/configuration/trunk/src/site/xdoc/userguide/howto_configurationbuilder.xml
--- commons/proper/configuration/trunk/src/site/xdoc/userguide/howto_configurationbuilder.xml
+++ commons/proper/configuration/trunk/src/site/xdoc/userguide/howto_configurationbuilder.xml
Fri Apr  8 09:40:40 2011
@@ -148,7 +148,17 @@
         combined configuration. Like all file-based configurations the
         <code>fileName</code> attribute can be used to specify the configuration
         definition file to be loaded. This file must be an XML document that
-        conforms to the format described here.</dd>
+        conforms to the format described here. Some of the most important
+        settings are copied from the original <code>DefaultConfigurationBuilder</code>
+        object to the newly created builder:
+        <ul>
+        <li>the base path under which configuration files are searched</li>
+        <li>some flags, e.g. for controlling delimiter parsing or throwing
+        exceptions on missing properties</li>
+        <li>the logger</li>
+        <li>the configuration and error listeners</li>
+        </ul>
+        </dd>
         <dd>This tag can be used to include an ini file into the resulting
         combined configuration. Behind the scenes an instance of

View raw message