aboutsummaryrefslogtreecommitdiff
path: root/src/site/resources/release-notes/RELEASE-NOTES-2.3.txt
diff options
context:
space:
mode:
Diffstat (limited to 'src/site/resources/release-notes/RELEASE-NOTES-2.3.txt')
-rw-r--r--src/site/resources/release-notes/RELEASE-NOTES-2.3.txt105
1 files changed, 105 insertions, 0 deletions
diff --git a/src/site/resources/release-notes/RELEASE-NOTES-2.3.txt b/src/site/resources/release-notes/RELEASE-NOTES-2.3.txt
new file mode 100644
index 000000000..04697723b
--- /dev/null
+++ b/src/site/resources/release-notes/RELEASE-NOTES-2.3.txt
@@ -0,0 +1,105 @@
+Licensed to the Apache Software Foundation (ASF) under one or more
+contributor license agreements. See the NOTICE file distributed with
+this work for additional information regarding copyright ownership.
+The ASF licenses this file to You under the Apache License, Version 2.0
+(the "License"); you may not use this file except in compliance with
+the License. You may obtain a copy of the License at
+
+http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+
+=============================================================================
+
+ Commons Lang Package
+ Version 2.3
+ Release Notes
+
+
+INTRODUCTION:
+
+This document contains the release notes for the 2.3 version of Apache
+Jakarta Commons Lang.
+Commons Lang is a set of utility functions and reusable components that
+should be of use in any Java environment.
+
+INCOMPATIBLE CHANGES WITH VERSION 2.2:
+
+- Calling stop on a suspended StopWatch will no longer change the underlying time.
+ It's very unlikely anyone was relying on that bug as a feature.
+
+ADDITIONAL INCOMPATIBLE CHANGES WITH VERSION 2.0:
+
+- The Nestable interface defines the method indexOfThrowable(Class).
+Previously the implementations checked only for a specific Class.
+Now they check for subclasses of that Class as well.
+For most situations this will be the expected behavior (i.e. it's a bug fix).
+If it causes problems, please use the ExceptionUtils.indexOfThrowable(Class) method instead.
+Note that the ExceptionUtils method is available in v1.0 and v2.0 of commons-lang and has not been changed.
+(An alternative to this is to change the public static matchSubclasses flag on NestableDelegate.
+However, we don't recommend that as a long-term solution.)
+
+- The StopWatch class has had much extra validation added.
+If your code previously relied on unusual aspects, it may no longer work.
+
+- Starting with version 2.1, Ant version 1.6.x is required to build. Copy
+junit.jar to ANT_HOME/lib. You can get JUnit from https://www.junit.org. See the developer's guide
+for more details.
+
+DEPRECATIONS FROM 2.2 to 2.3:
+
+- None
+
+DEPRECATIONS FROM 2.1 to 2.2:
+
+- None
+
+DEPRECATIONS FROM 2.0 to 2.1:
+
+- The enum package has been renamed to enums for JDK 1.5 compliance.
+All functionality is identical, just the package has changed.
+This package will be removed in v3.0.
+
+- NumberUtils.stringToInt - renamed to toInt
+
+- DateUtils - four constants, MILLIS_IN_* have been deprecated as they were defined
+as int not long. The replacements are MILLIS_PER_*.
+
+
+BUG FIXES IN 2.3:
+
+ * [LANG-69 ] - ToStringBuilder throws StackOverflowError when an Object cycle exists
+ * [LANG-102] - Refactor Entities methods
+ * [LANG-153] - Can't XMLDecode an Enum
+ * [LANG-262] - Use of enum prevents a classloader from being garbage collected resulting in out of memory exceptions.
+ * [LANG-279] - HashCodeBuilder throws java.lang.StackOverflowError when an object contains a cycle.
+ * [LANG-281] - DurationFormatUtils returns wrong result
+ * [LANG-286] - Serialization - not backwards compatible
+ * [LANG-292] - unescapeXml("&12345678;") should be "&12345678;"
+ * [LANG-294] - StrBuilder.replaceAll and StrBuilder.deleteAll can throw ArrayIndexOutOfBoundsException.
+ * [LANG-295] - StrBuilder contains usages of thisBuf.length when they should use size
+ * [LANG-299] - Bug in method appendFixedWidthPadRight of class StrBuilder causes an ArrayIndexOutOfBoundsException
+ * [LANG-300] - NumberUtils.createNumber throws NumberFormatException for one digit long
+ * [LANG-303] - FastDateFormat.mRules is not transient or serializable
+ * [LANG-304] - NullPointerException in isAvailableLocale(Locale)
+ * [LANG-313] - Wrong behavior of Entities.unescape
+ * [LANG-315] - StopWatch: suspend() acts as split(), if followed by stop()
+
+IMPROVEMENTS IN 2.3:
+
+ * [LANG-258] - Enum Javadoc
+ * [LANG-266] - Wish for StringUtils.join(Collection, *)
+ * [LANG-268] - StringUtils.join should allow you to pass a range for it (so it only joins a part of the array)
+ * [LANG-275] - StringUtils substringsBetween
+ * [LANG-282] - Create more tests to test out the +=31 replacement code in DurationFormatUtils.
+ * [LANG-287] - Optimize StringEscapeUtils.unescapeXml(String)
+ * [LANG-289] - NumberUtils.max(byte[]) and NumberUtils.min(byte[]) are missing
+ * [LANG-291] - Null-safe comparison methods for finding the most recent / least recent dates.
+ * [LANG-306] - StrBuilder appendln/appendAll/appendSeparator
+ * [LANG-310] - BooleanUtils isNotTrue/isNotFalse
+ * [LANG-314] - Tests fail to pass when building with Maven 2
+