Author: oheger
Date: Fri Apr 8 09:40:40 2011
New Revision: 1090173
URL: http://svn.apache.org/viewvc?rev=1090173&view=rev
Log:
[CONFIGURATION-437] Updated documentation and changes.
Modified:
commons/proper/configuration/trunk/src/changes/changes.xml
commons/proper/configuration/trunk/src/site/xdoc/userguide/howto_configurationbuilder.xml
Modified: commons/proper/configuration/trunk/src/changes/changes.xml
URL:
http://svn.apache.org/viewvc/commons/proper/configuration/trunk/src/changes/changes.xml?rev=1090173&r1=1090172&r2=1090173&view=diff
==============================================================================
--- 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>
+ <action dev="oheger" type="update" issue="CONFIGURATION-437">
+ Child configuration builders created for a <configuration>
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
URL:
http://svn.apache.org/viewvc/commons/proper/configuration/trunk/src/site/xdoc/userguide/howto_configurationbuilder.xml?rev=1090173&r1=1090172&r2=1090173&view=diff
==============================================================================
---
commons/proper/configuration/trunk/src/site/xdoc/userguide/howto_configurationbuilder.xml
(original)
+++
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>
<dt>ini</dt>
<dd>This tag can be used to include an ini file into the resulting
combined configuration. Behind the scenes an instance of
