Author: oheger
Date: Sat Mar 19 15:16:39 2016
New Revision: 1735783
URL: http://svn.apache.org/viewvc?rev=1735783&view=rev
Log:
Updated release notes for version 2.0.
Modified:
commons/proper/configuration/trunk/RELEASE-NOTES.txt
Modified: commons/proper/configuration/trunk/RELEASE-NOTES.txt
URL:
http://svn.apache.org/viewvc/commons/proper/configuration/trunk/RELEASE-NOTES.txt?rev=1735783&r1=1735782&r2=1735783&view=diff
==============================================================================
--- commons/proper/configuration/trunk/RELEASE-NOTES.txt (original)
+++ commons/proper/configuration/trunk/RELEASE-NOTES.txt Sat Mar 19 15:16:39
2016
@@ -1,7 +1,7 @@
$Id$
Commons Configuration Package
- Version 2.0-beta2
+ Version 2.0
Release Notes
INTRODUCTION
@@ -13,6 +13,66 @@ The Commons Configuration software libra
interface which enables an application to read configuration data from a
variety
of sources.
+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-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.
+
+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/
+
+Older release notes
+===================
+
+ 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
