Author: oheger
Date: Sun Oct  8 18:05:24 2017
New Revision: 22168

Log:
Added release notes to dist area.

Added:
    dev/commons/configuration/RELEASE-NOTES.txt

Added: dev/commons/configuration/RELEASE-NOTES.txt
==============================================================================
--- dev/commons/configuration/RELEASE-NOTES.txt (added)
+++ dev/commons/configuration/RELEASE-NOTES.txt Sun Oct  8 18:05:24 2017
@@ -0,0 +1,616 @@
+$Id: RELEASE-NOTES.txt 1811478 2017-10-08 11:52:32Z oheger $
+                        Apache Commons Configuration
+                               Version 2.2
+                               Release Notes
+
+
+INTRODUCTION:
+=============
+
+This document contains the release notes for this version of the Commons
+Configuration component. It describes the changes since the previous version.
+The Commons Configuration software library provides a generic configuration
+interface which enables an application to read configuration data from a
+variety of sources.
+
+Version 2.2 is another maintenance release for the Configuration 2.x series. It
+contains a number of bug fixes and also some new features. Among the highlights
+is the new support for JSON and YAML configurations. The release is fully
+source and binary compatible with version 2.1.1.
+
+Commons Configuration 2.2 requires Java 1.7 or higher.
+
+New features
+============
+o CONFIGURATION-666
+  Add convenience ctor ConfigurationRuntimeException(String, Object...).
+
+o CONFIGURATION-665
+  Add 
org.apache.commons.configuration2.AbstractHierarchicalConfiguration.toString().
+
+o CONFIGURATION-664
+  Add API 
org.apache.commons.configuration2.tree.ImmutableNode.getChildren(String).
+
+o CONFIGURATION-660
+  Add toString() methods here and there to help debugging.
+
+o CONFIGURATION-658
+  Add API org.apache.commons.configuration2.DataConfiguration.getURI(String)
+  methods.
+
+o CONFIGURATION-656
+  Added new YAMLConfiguration class to support configuration files in YAML
+  format.
+
+o CONFIGURATION-653
+  ConfigurationUtils and ConfigurationConverter now offer better support for
+  immutable configurations.
+
+o CONFIGURATION-647
+  INIConfiguration can now be configured to use a custom separator between
+  properties and values when writing an ini file.
+
+o CONFIGURATION-258
+  Added new JSONConfiguration class to support configuration files in JSON
+  format.
+
+Fixed Bugs
+==========
+o CONFIGURATION-671
+  Fixed a NPE in INIConfiguration when saving a configuration with an empty
+  section.
+
+o CONFIGURATION-669
+  The node model returned by SubnodeConfiguration.getNodeModel() has now the
+  correct root node set.
+
+Other changes
+=============
+o CONFIGURATION-673
+  Added an Automatic-Module-Name header to the manifest for compatibility with
+  the Java 9 module system.
+
+o CONFIGURATION-669
+  Update optional Spring dependency from 4.2.5.RELEASE to 4.3.9.RELEASE.
+
+o CONFIGURATION-667
+  Update Apache Commons Lang dependency from 3.3.2 to 3.6.
+
+o CONFIGURATION-663
+  Fixed a typo in the upgrade to 2.0 guide.
+
+o CONFIGURATION-661
+  Update platform requirement from Java 6 to 7.
+
+
+Historical list of changes: 
http://commons.apache.org/proper/commons-configuration/changes-report.html
+
+For complete information on Apache Commons Configuration, including 
instructions on how to submit bug reports,
+patches, or suggestions for improvement, see the Apache Apache Commons 
Configuration website:
+
+http://commons.apache.org/proper/commons-configuration/
+
+
+Older release notes
+===================
+
+                        Apache Commons Configuration
+                               Version 2.1.1
+                               Release Notes
+
+
+INTRODUCTION:
+=============
+
+This document contains the release notes for this version of the Commons
+Configuration component. It describes the changes since the previous version.
+The Commons Configuration software library provides a generic configuration
+interface which enables an application to read configuration data from a
+variety of sources.
+
+The release is fully source and binary compatible with version 2.1.
+
+Commons Configuration 2.1 requires Java 1.6 or higher.
+
+Fixed Bugs
+==========
+o CONFIGURATION-649
+  Improved the handling of lists defined by a string with delimiter characters
+  in XMLConfiguration. Such lists now retain their original format when the
+  configuration is saved.
+
+o CONFIGURATION-648
+  Made the IOFactory property of PropertiesBuilderParameter compatible with the
+  most recent version of Commons BeanUtils. This version changed the handling
+  of properties starting with multiple uppercase letters.
+
+o CONFIGURATION-646
+  PropertiesConfiguration now works correctly with the auto-save mode.
+
+o CONFIGURATION-644
+  PropertiesConfigurationLayout no longer duplicates a header comment if a file
+  with another comment is loaded. Thanks to Andrew DeMaria.
+
+o CONFIGURATION-643
+  Documentation improvements for the user's guide.
+
+o CONFIGURATION-641
+  Improved documentation of FileBased interface. The Javadocs now state
+  explicitly that the methods should not be called by client code. Exception
+  handling in configuration classes implementing FileLocatorAware has been
+  improved.
+
+o CONFIGURATION-640
+  PropertiesConfiguration now correctly unescapes some special characters that
+  are always escaped in Java properties files.
+
+Other changes
+=============
+o CONFIGURATION-639
+  In the OSGi bundle manifest of the Commons Configuration bundle the package
+  imports for Spring packages are now marked as optional.
+  Thanks to Rico Neubauer.
+
+o CONFIGURATION-638
+  Improved handling of temporary files and folders in unit tests.
+  Thanks to Ahmet Celik.
+
+o CONFIGURATION-627
+  Updated dependency to Commons BeanUtils to version 1.9.3. This fixes an issue
+  with an exception stacktrace that was logged when a ConfigurationBuilder was
+  used.
+
+
+Historical list of changes: 
http://commons.apache.org/proper/commons-configuration/changes-report.html
+
+For complete information on Apache Commons Configuration, including 
instructions on how to submit bug reports,
+patches, or suggestions for improvement, see the Apache Apache Commons 
Configuration website:
+
+http://commons.apache.org/proper/commons-configuration/
+
+
+                        Commons Configuration Package
+                                 Version 2.1
+                                Release Notes
+
+INTRODUCTION
+============
+
+This document contains the release notes for this version of the Commons
+Configuration component. It describes the changes since the previous version.
+The Commons Configuration software library provides a generic configuration
+interface which enables an application to read configuration data from a 
variety
+of sources.
+
+Version 2.1 is a first bug-fix release for the Configuration 2.x series and
+also adds a new feature related to the integration with the Spring framework.
+A list of all changes can be found below.
+
+The release is fully source and binary compatible with version 2.0.
+
+Commons Configuration 2.1 requires Java 1.6 or higher.
+
+New Features
+============
+o CONFIGURATION-636
+  PropertiesConfigurationLayout now allows manipulating the order of keys when
+  the properties file is written.
+
+o CONFIGURATION-624
+  Support Commons Configuration as PropertySource in Spring.
+
+Fixed Bugs
+==========
+o CONFIGURATION-634
+  HomeDirectoryLocationStrategy now works correctly in the mode that evaluates
+  the FileLocator's base path.
+
+o CONFIGURATION-633
+  Interpolation was improved to better support properties with multiple values.
+
+o CONFIGURATION-632
+  The methods getStringArray() and getList() of CompositeConfiguration now
+  support the interpolation of variables that reference properties with
+  multiple values.
+
+o CONFIGURATION-622
+  Fixed a problem in INIConfiguration.write() with keys containing a separator
+  character. This separator had been duplicated. Such keys are now handled
+  correctly when the configuration is saved.
+
+Other changes
+=============
+o CONFIGURATION-628
+  Support for the ant build was dropped.
+
+o CONFIGURATION-626
+  ImmutableConfiguration.getArray() has been deprecated. Arrays can now be
+  queried using the generic get() method in a type-safe way.
+
+o CONFIGURATION-631
+  Updated optional dependency to Apache Commons VFS from 2.0 to 2.1. (The older
+  version still works.)
+
+o CONFIGURATION-635
+  Updated optional dependency to Apache Commons Codec from 1.9 to 1.10. (The
+  older version still works.)
+
+
+Historical list of changes: 
http://commons.apache.org/proper/commons-configuration/changes-report.html
+
+For complete information on Apache Commons Configuration, including 
instructions
+on how to submit bug reports, patches, or suggestions for improvement, see the
+Apache Commons Configuration website:
+http://commons.apache.org/proper/commons-configuration/
+
+                        Commons Configuration Package
+                                 Version 2.0
+                                Release Notes
+
+INTRODUCTION
+============
+
+After a series of alpha and beta releases (please consult the corresponding
+release notes below), this is the first final release for Apache Commons
+Configuration 2.0.
+
+Version 2.0 is a complete redesign of the Configuration 1.x API with the aim to
+fix some limitations in the original design and make the library more flexible
+and powerful. Therefore, this release is not a drop-in replacement for Commons
+Configuration 1.x; there have been incompatible changes in many areas that
+require adaptations on client code. A migration guide is available at
+
+http://commons.apache.org/configuration/userguide/upgradeto2_0.html
+
+that describes all breaking changes and helps when upgrading to the new
+version. One obvious breaking change is the renaming of the main package
+(all classes are now located under org.apache.commons.configuration2) and the
+Maven coordinates (groupId: org.apache.commons, artifactId:
+commons-configuration2). This was necessary to allow both versions to coexist
+on the classpath without conflicts.
+
+The user's guide has been completely reworked to describe all features of the
+new version. It can be found at
+
+http://commons.apache.org/configuration/userguide/user_guide.html
+
+Changes:
+========
+o CONFIGURATION-621:
+  Moved ConfigurationLogger class to io package to avoid cyclic dependencies
+  between packages.
+o CONFIGURATION-619:
+  CombinedConfigurationBuilder now supports inheritance of its parameters to
+  child configuration sources. This is enabled by default.
+o CONFIGURATION-615:
+  Changed generic types in the signatures of a MapConfiguration constructor
+  and AbstractConfiguration.getList(String, List). These changes were made in
+  version 1.10 as fixes for CONFIGURATION-557 and CONFIGURATION-558. But it
+  had been missed to merge them to trunk.
+
+Fixed Bugs:
+===========
+o CONFIGURATION-620:
+  Fixed two invalid examples in the user's guide for file-based configurations.
+o CONFIGURATION-618:
+  When using immutable configurations exceptions thrown by the wrapped
+  configuration came out as UndeclaredThrowableException. This has been fixed;
+  now the correct original exception is thrown.
+
+Commons Configuration 2.0 requires Java 1.6 or higher.
+
+                        Commons Configuration Package
+                             Version 2.0-beta2
+                                Release Notes
+
+After the first beta release in June 2015 there has been some feedback from the
+community resulting in (minor) adaptations of the API. In most cases, the
+return values of methods have been changed to be more generic. There has also
+been a change in the support for logging. Therefore, this second beta release
+is provided to make these changes more "official".
+
+This release also includes some bug fixes. The bugs addressed here have partly
+existed already in the Configuration 1.0 code base; so these fixes are not all
+related to changes introduced in the 2.0 version.
+
+Below is a list of all changes in this version. Please refer to the clirr
+report at 
http://commons.apache.org/proper/commons-configuration/clirr-report.html
+for information about changes which break binary compatibility.
+
+Changes:
+========
+o CONFIGURATION-614:
+  References to Commons Logging have been removed from the Configuration API.
+  It is still possible to influence logging by making use of the new
+  ConfigurationLogger abstraction.
+o CONFIGURATION-612:
+  The return type of ConfigurationBuilder.getConfiguration() was changed from
+  Configuration to ImmutableConfiguration because this is the base interface
+  for all configuration objects. Thanks to Jon Weygand.
+o CONFIGURATION-608:
+  Adapted the return type of 
ReloadingFileBasedConfigurationBuilder.configure().
+
+Fixed Bugs:
+===========
+o CONFIGURATION-609:
+  Fixed a bug in PropertiesConfiguration related to the loading of include
+  files. The FileHandler used for this purpose was not fully initialized.
+o CONFIGURATION-605:
+  XMLConfiguration no longer drops keys when list delimiter characters occur
+  in element values.
+o CONFIGURATION-604:
+  Fixed a problem in the conversion of a flat configuration to a hierarchical
+  one that could cause the loss of properties in a combined configuration
+  constructed by an override combiner.
+
+Commons Configuration 2.0-beta2 requires Java 1.6 or higher.
+
+Historical list of changes: 
http://commons.apache.org/proper/commons-configuration/changes-report.html
+
+For complete information on Apache Commons Configuration, including 
instructions
+on how to submit bug reports, patches, or suggestions for improvement, see the
+Apache Commons Configuration website:
+http://commons.apache.org/proper/commons-configuration/
+
+                        Commons Configuration Package
+                             Version 2.0-beta1
+                                Release Notes
+
+This is the first beta release of Commons Configuration 2.0 after two alpha
+versions. There has not been much feedback so far and no requests for API
+changes. Therefore, we move forwards to a beta release indicating that the API
+can be considered more stable. However, at this stage, changes of the API can
+still not be fully excluded.
+
+Below is a list of all changes in this version. Compared to version 2.0-alpha2,
+there has only be a single change: an obsolete interface (which had been
+overlooked during a major refactoring) was removed. So applications that are
+using 2.0-alpha2 should be able to migrate to 2.0-beta1 without problems.
+
+Changes:
+========
+o CONFIGURATION-598: Removed obsolete ConfigurationBuilder interface in the
+                     base package.
+
+
+                        Commons Configuration Package
+                             Version 2.0-alpha2
+                                Release Notes
+
+
+After version 2.0-alpha1 has been out for a while (the corresponding release
+notes can be found below), this second alpha release contains a few number of
+improvements and new features whose implementation required some changes on
+existing interfaces. In most cases, new methods were added offering enhanced
+functionality. Because these are typically interfaces implemented by the
+library itself client code using the previous alpha version should hardly be
+affected.
+
+Below is a list of all changes in this version:
+
+New features:
+=============
+o CONFIGURATION-574:  DefaultExpressionEngine can now be customized to match
+                      configuration keys in a case-insensitive manner. This is 
useful
+                      for instance for dealing with Windows INI files.
+o CONFIGURATION-565:  Added support for querying encoded properties.
+o CONFIGURATION-200:  A size() method was added to the ImmutableConfiguration 
interface.
+
+Fixed Bugs:
+===========
+o CONFIGURATION-564:  PropertiesConfiguration now supports again properties 
without a
+                      value and a separator character. The keys of such 
properties
+                      are added to the configuration with an empty String as 
value.
+o CONFIGURATION-427:  XMLPropertyListConfiguration can now save arrays in the 
correct form.
+
+Historical list of changes: 
http://commons.apache.org/proper/commons-configuration/changes-report.html
+
+For complete information on Apache Commons Configuration, including 
instructions on how to submit bug reports,
+patches, or suggestions for improvement, see the Apache Commons Configuration 
website:
+
+http://commons.apache.org/proper/commons-configuration/
+
+                        Commons Configuration Package
+                             Version 2.0-alpha1
+                                Release Notes
+
+This is the first alpha release for version 2.0 of Commons Configuration.
+Version 2 is a major redesign of the Configuration API. It breaks compatibility
+in many areas and, therefore, is not a drop-in replacement for Commons
+Configuration 1.x. To allow collaboration with an older version of the library
+(and to prevent jar and dependency hell), the top-level package and the Maven
+coordinates have been changed. There is an upgrade guide available at
+
+http://commons.apache.org/configuration/userguide/upgradeto2_0.html
+
+describing the most important breaking changes. Be sure to read this
+document if you want to switch from a 1.x version to this new version. The
+user's guide which can be found at
+
+http://commons.apache.org/configuration/userguide/user_guide.html
+
+has been reworked to cover all the new and changed features.
+
+The main purpose of this alpha release is to gather feedback from the
+community about the reworked API. IT IS NOT YET PRODUCTION READY. It is
+expected that there will still be some changes on the public API.
+
+Below is a list of all changes in this version:
+
+New features:
+=============
+o CONFIGURATION-579:  A migration guide has been created which supports when 
upgrading from
+                      version 1.x to 2.0.
+o CONFIGURATION-559:  It is now possible to define default values for 
initialization
+                      properties of configurations.
+o CONFIGURATION-551:  The data type conversion mechanism has been made 
extensible. There is a
+                      new interface ConversionHandler which controls the data 
type conversions
+                      available for a configuration object. By setting a 
custom implementation,
+                      conversions can be adapted or extended.
+o CONFIGURATION-550:  Conversion to Character is now supported.
+o CONFIGURATION-541:  Multi-file configurations are no longer restricted to 
XML configuration
+                      files. Arbitrary file-based configurations are now 
supported.
+o CONFIGURATION-535:  DatabaseConfiguration now provides get methods for 
querying its
+                      properties defining the underlying database structures.
+o CONFIGURATION-533:  DatabaseConfiguration now automatically converts CLOBs 
to strings if
+                      they appear in property values.
+o CONFIGURATION-525:  PropertiesConfiguration now keeps a comment at the 
bottom of a
+                      properties file. A new footer property was added for 
reading and
+                      writing this footer comment.
+o CONFIGURATION-519:  Configuration objects are now created via configuration 
builders. A new
+                      API for configuration builders has been added.
+o CONFIGURATION-517:  Hierarchical configurations now provide methods to 
obtain sub
+                      configurations for all child elements of a given key.
+o CONFIGURATION-514:  Bean declarations now support constructor invocations.
+o CONFIGURATION-512:  It is now possible to obtain an immutable view on a 
Configuration or
+                      HierarchicalConfiguration object. New interfaces,
+                      ImmutableConfiguration, and 
ImmutableHierarchicalConfiguration have
+                      been introduced.
+o CONFIGURATION-508:  Generic get() methods have been added to the 
Configuration interface.
+                      These methods expect a target class and try to convert 
the value of
+                      the specified property to this target class.
+o CONFIGURATION-204:  With the new reloading mechanism automatic and periodic 
reloading checks
+                      can be performed.
+o CONFIGURATION-202:  Reloading checks can now be performed in a background 
thread.
+
+Fixed Bugs:
+===========
+o CONFIGURATION-582:  Fixed a StringIndexOutOfBoundsException in 
PropertiesConfigurationLayout
+                      which was caused by lines containing only whitespace.
+o CONFIGURATION-572:  When a CombinedConfiguration is cleared it removes 
itself as change
+                      listener from all child configurations. This fixes a 
possible memory
+                      leak.
+o CONFIGURATION-570:  Fixed a possible ConcurrentModificationException when a 
SystemConfiguration
+                      instance is passed to the append() or copy() methods.
+o CONFIGURATION-567:  XMLBeanDeclaration now escapes node names before they 
are used to
+                      determine nested properties. Thanks to Shen liang.
+
+Changes:
+o CONFIGURATION-591:  Removed methods from ConfigurationConverter related to 
ExtendedProperties.
+                      This class is no longer supported by recent versions of 
Commons
+                      Collections.
+o CONFIGURATION-590:  Removed Serializable interface from all configuration 
implementations.
+                      Some configuration classes declared this interface 
without being
+                      actually serializable.
+o CONFIGURATION-588:  The name of the top-level package and the maven 
coordinates have been
+                      changed to allow a coexistence of Commons Configuration 
1.x with 2.0.
+o CONFIGURATION-584:  The event mechanism has been reworked. There is now a 
generic event
+                      listener interface which can be used to receive 
notifications from
+                      multiple types of event sources.
+o CONFIGURATION-578:  The user's guide has been fully reworked to cover all 
new and enhanced
+                      features of version 2.0.
+o CONFIGURATION-577:  The dependency to Commons Collections is no longer 
needed.
+o CONFIGURATION-576:  A new abstract base class for hierarchical 
configurations was introduced
+                      which supports arbitrary hierarchical data structures. 
The type of the
+                      nodes used by the configuration can now be specified as 
a generic type
+                      argument. This makes the integration of other 
hierarchical structures
+                      easier.
+o CONFIGURATION-575:  Hierarchical configurations now operate on immutable 
structures.
+                      Data is no longer represented by ConfigurationNode 
objects. The
+                      ImmutableNode class now serves as data container.
+o CONFIGURATION-573:  XPathExpressionEngine can now deal with namespace 
prefixes in node and
+                      attribute names.
+o CONFIGURATION-563:  The DefaultExpressionEngine class is now immutable. An 
instance can be
+                      shared between multiple configuration objects.
+o CONFIGURATION-562:  Improved the API of ExprLookup.
+o CONFIGURATION-555:  Fixed a bug in the handling of the xml:space attribute in
+                      XMLConfiguration. The attribute is now also applied to 
the current
+                      element, not only to sub elements.
+o CONFIGURATION-554:  BeanHelper is no longer a static utility class. 
Instances can be
+                      created with a specific configuration of bean factories. 
There is still
+                      a default instance which can be obtained via the 
BeanHelper.INSTANCE
+                      field.
+o CONFIGURATION-553:  The code for accessing configuration files has been 
reworked. Methods
+                      related to locating configuration files have been moved 
from
+                      ConfigurationUtils to a new FileLocatorUtils class. 
Customizable
+                      strategy classes (implementing the new 
FileLocationStrategy) can be
+                      used for searching for configuration files.
+o CONFIGURATION-546:  BeanHelper can now process BeanDefinitions initializing 
properties of
+                      collection types of their target beans. Thanks to Justin 
Couch.
+o CONFIGURATION-544:  Added missing dependencies to build.xml. Thanks to 
Oliver Kopp.
+o CONFIGURATION-542:  The mechanism for synchronizing configurations has been 
completely
+                      redesigned. It is now based on Synchronizer objects 
which can be
+                      configured by client code. A new chapter was added to 
the user's guide
+                      regarding thread-safety of configurations.
+o CONFIGURATION-540:  MapConfiguration now directly uses a Properties object 
passed to its
+                      constructor as data store rather than copying it. This 
allows
+                      SystemConfiguration to be connected to system 
properties; i.e.
+                      changing a property through SystemConfiguration 
immediately affects
+                      the corresponding system property.
+o CONFIGURATION-539:  The deprecated INIConfiguration class was removed.
+                      HierarchicalINIConfiguration was renamed to 
INIConfiguration.
+o CONFIGURATION-537:  The deprecated ConfigurationFactory class was removed.
+o CONFIGURATION-536:  File-based configurations are now implemented in a 
different way.
+                      The interfaces FileConfiguration and ReloadingStrategy 
have been
+                      removed, also the base classes AbstractFileConfiguration 
and
+                      AbstractHierarchicalFileConfiguration. They are replaced 
by the
+                      FileBased interface and the FileHandler class which 
implements
+                      central I/O functionality. Reloading is now in the 
responsibility of
+                      configuration builders.
+o CONFIGURATION-534:  The includesAllowed property of PropertyConfiguration is 
now independent
+                      from the existence of a base path.
+o CONFIGURATION-530:  Concurrent access to configurations and reloading have 
been completely
+                      redesigned. Because reloading is now handled by 
configuration builders
+                      there is no need to acquire a lock in order to protected 
against a
+                      reload operations.
+o CONFIGURATION-527:  AbstractConfiguration.clearPropertyDirect() is now 
abstract. Thanks to Matthias Richter.
+o CONFIGURATION-526:  XMLPropertiesConfiguration now supports loading from and 
saving to DOM
+                      nodes. Thanks to Oliver Kopp.
+o CONFIGURATION-524:  Interpolation now works correctly after a configuration 
was cloned.
+                      The ConfigurationInterpolator instance is now cloned, 
too.
+o CONFIGURATION-521:  ConfigurationUtils.fileFromUrl() now correctly handles 
URL containing
+                      encoded percent characters. Thanks to Oliver Kopp.
+o CONFIGURATION-520:  Support for reloading of configuration data has been 
reworked.
+o CONFIGURATION-518:  Classes and interfaces related to interpolation have 
been slightly
+                      reworked. ConfigurationInterpolator is now thread-safe. 
There are
+                      multiple ways to define the ConfigurationInterpolator 
object to be
+                      used by an AbstractConfiguration instance.
+o CONFIGURATION-516:  PropertiesConfiguration no longer escapes double quotes 
on saving.
+o CONFIGURATION-515:  The visibility of some internal methods of 
PropertiesConfiguration.PropertiesWriter
+                      has been increased to protected. This simplifies the 
implementation of
+                      a custom escaping strategy.
+o CONFIGURATION-513:  HierarchicalConfiguration is now an interface. The base 
implementation
+                      class is named BaseHierarchicalConfiguration.
+o CONFIGURATION-506:  Removed obsolete nested classes Node and NodeVisitor of
+                      HierarchicalConfiguration. The related deprecated class
+                      ConfigurationKey was removed, too.
+o CONFIGURATION-505:  XMLConfiguration no longer supports attributes with 
multiple values or
+                      list delimiter parsing in attributes. This feature was 
complex and
+                      error prone and brought little value to the user.
+o CONFIGURATION-504:  SubnodeConfiguration now provides a new method for 
clearing it and
+                      removing its root node from the parent configuration. 
The method
+                      HierarchicalConfiguration.configurationsAt() now returns 
a list
+                      of SubnodeConfiguration so that it is easier to make 
direct use of
+                      this feature.
+o CONFIGURATION-500:  XMLConfiguration now adds attributes of elements 
defining a list to
+                      all list nodes.
+o CONFIGURATION-496:  Concurrent access to configurations and reloading have 
been completely
+                      redesigned. This should reduce the amount of 
synchronization.
+o CONFIGURATION-486:  Removed some static fields for specifying global default 
values.
+                      Using static fields in this way is thread-hostile. There 
are now
+                      alternatives for setting default values.
+o CONFIGURATION-462:  Updated dependency to Commons Lang from version 2.6 to 
3.1.
+o CONFIGURATION-419:  EventSource is now an interface. With BaseEventSource 
there is a
+                      default implementation.
+o CONFIGURATION-418:  The handling of list delimiters and their escape 
characters has been
+                      reworked. A new ListDelimiterHandler interface was 
introduced allowing
+                      applications to customize the treatment of list 
delimiters.
+o CONFIGURATION-330:  Concurrent access to configurations has been reworked.
+o CONFIGURATION-153:  It is now possible to define the strategy used for 
locating
+                      configuration files.
+o CONFIGURATION-136:  Reloading can no longer corrupt a configuration 
instance. This is now
+                      handled by a configuration builder; the original 
configuration instance
+                      is not modified.
+o CONFIGURATION-26:   It is now possible to influence the conversion from a 
container object
+                      (a collection or an array) to a single value (e.g. what 
is returned by
+                      getString() if the current property has multiple 
values). Per default,
+                      the first value is returned. By overriding methods of the
+                      configuration's ConversionHandler, this behavior can be 
changed.
+
+
+Historical list of changes: 
http://commons.apache.org/proper/commons-configuration/changes-report.html
+
+For complete information on Apache Commons Configuration, including 
instructions on how to submit bug reports,
+patches, or suggestions for improvement, see the Apache Commons Configuration 
website:
+
+http://commons.apache.org/proper/commons-configuration/


Reply via email to