aboutsummaryrefslogtreecommitdiff
path: root/RELEASE-NOTES.txt
diff options
context:
space:
mode:
authorNiall Pemberton <niallp@apache.org>2010-02-25 01:29:36 +0000
committerNiall Pemberton <niallp@apache.org>2010-02-25 01:29:36 +0000
commitcf7486556173620fccd26758aee9a99313c54843 (patch)
tree7e36986e26c61eaba65062857e3ec170ede664c0 /RELEASE-NOTES.txt
parent43fca0d7499c99f9e82e0ee2e52b81acdc954f2c (diff)
downloadapache-commons-lang-cf7486556173620fccd26758aee9a99313c54843.tar.gz
Update site for 2.5 release
git-svn-id: https://svn.apache.org/repos/asf/commons/proper/lang/trunk@916082 13f79535-47bb-0310-9956-ffa450edef68
Diffstat (limited to 'RELEASE-NOTES.txt')
-rw-r--r--RELEASE-NOTES.txt183
1 files changed, 71 insertions, 112 deletions
diff --git a/RELEASE-NOTES.txt b/RELEASE-NOTES.txt
index 5a5159f1e..603225c35 100644
--- a/RELEASE-NOTES.txt
+++ b/RELEASE-NOTES.txt
@@ -1,124 +1,83 @@
$Id$
Commons Lang Package
- Version 2.4
+ Version 2.5
Release Notes
INTRODUCTION:
-This document contains the release notes for the 2.4 version of Apache Commons Lang.
+This document contains the release notes for the 2.5 version of Apache Commons Lang.
Commons Lang is a set of utility functions and reusable components that should be of use in any Java environment.
-Lang 2.4 no longer attempts to target the Java 1.1 environment and now targets Java 1.2. While previous versions
-were built for 1.1, some parts were using methods that were only available in 1.2, and the Enum class had
-become dependent on Java 1.3.
-INCOMPATIBLE CHANGES WITH VERSION 2.3:
+COMPATIBILITY WITH 2.4
+======================
+Lang 2.5 is binary compatible release with Lang 2.4, containing bug fixes and small enhancements.
+
+Lang 2.5 requires a minimum of JDK 1.3.
+
+
+IMPROVEMENTS IN 2.5
+===================
+
+ * [LANG-583] - ArrayUtils - add isNotEmpty() methods
+ * [LANG-534] - ArrayUtils - add nullToEmpty() methods
+ * [LANG-454] - CharRange - provide an iterator that lets you walk the chars in the range
+ * [LANG-514] - CharRange - add more readable static builder methods
+ * [ ] - ClassUtils - new isAssignable() methods with autoboxing
+ * [LANG-535] - ClassUtils - add support to getShortClassName and getPackageName for arrays
+ * [LANG-434] - DateUtils - add ceiling() method
+ * [LANG-486] - DateUtils - add parseDateStrictly() method
+ * [LANG-466] - EqualsBuilder - add reset() method
+ * [LANG-461] - NumberUtils - add toByte() and toShort() methods
+ * [LANG-522] - Mutable numbers - add string constructors
+ * [ ] - MutableBoolean - add toBoolean(), isTrue() and isFalse() methods
+ * [LANG-422] - StrBuilder - add appendSeparator() methods with an alternative default separator if the StrBuilder is currently empty
+ * [LANG-555] - SystemUtils - add IS_OS_WINDOWS_7 constant
+ * [LANG-554] - SystemUtils - add IS_JAVA_1_7 constant for JDK 1.7
+ * [LANG-405] - StringUtils - add abbreviateMiddle() method
+ * [LANG-569] - StringUtils - add indexOfIgnoreCase() and lastIndexOfIgnoreCase() methods
+ * [LANG-471] - StringUtils - add isAllUpperCase() and isAllLowerCase() methods
+ * [LANG-469] - StringUtils - add lastOrdinalIndexOf() method to complement the existing ordinalIndexOf() method
+ * [LANG-438] - StringUtils - add repeat() method
+ * [LANG-445] - StringUtils - add startsWithAny() method
+ * [LANG-430] - StringUtils - add upperCase(String, Locale) and lowerCase(String, Locale) methods
+ * [LANG-416] - New Reflection package containing ConstructorUtils, FieldUtils, MemberUtils and MethodUtils
+
+BUG FIXES IN 2.5
+================
+
+ * [LANG-494] - CharSet - Synchronizing the COMMON Map so that getInstance doesn't miss a put from a subclass in another thread
+ * [LANG-500] - ClassUtils - improving performance of getAllInterfaces
+ * [LANG-587] - ClassUtils - toClass() throws NullPointerException on null array element
+ * [LANG-530] - DateUtils - Fix parseDate() cannot parse ISO8601 dates produced by FastDateFormat
+ * [LANG-440] - DateUtils - round() doesn't work correct for Calendar.AM_PM
+ * [LANG-443] - DateUtils - improve tests
+ * [LANG-204] - Entities - multithreaded initialization
+ * [LANG-506] - Entities - missing final modifiers; thread-safety issues
+ * [LANG-76] - EnumUtils - getEnum() doesn't work well in 1.5+
+ * [LANG-584] - ExceptionUtils - use immutable lock target
+ * [LANG-477] - ExtendedMessageFormat - OutOfMemory with a pattern containing single quotes
+ * [LANG-538] - FastDateFormat - call getTime() on a calendar to ensure timezone is in the right state
+ * [LANG-547] - FastDateFormat - Remove unused field
+ * [LANG-511] - LocaleUtils - initialization of available locales can be deferred
+ * [LANG-457] - NumberUtils - createNumber() thows a StringIndexOutOfBoundsException for "l"
+ * [LANG-521] - NumberUtils - isNumber(String) and createNumber(String) both modified to support '2.'
+ * [LANG-432] - StringUtils - improve handling of case-insensitive Strings
+ * [LANG-552] - StringUtils - replaceEach() no longer NPEs when null appears in the last String[]
+ * [LANG-460] - StringUtils - correct JavaDocs for startsWith() and startsWithIgnoreCase()
+ * [LANG-421] - StringEscapeUtils - escapeJava() escapes '/' characters
+ * [LANG-450] - StringEscapeUtils - change escapeJavaStyleString() to throw UnhandledException instead swallowing IOException
+ * [LANG-419] - WordUtils - fix StringIndexOutOfBoundsException when lower is greater than the String length
+ * [LANG-523] - StrBuilder - Performance improvement by doubling the size of the String in ensureCapacity
+ * [LANG-575] - Compare, Equals and HashCode builders - use ArrayUtils to avoid creating a temporary List
+ * [LANG-467] - EqualsBuilder - removing the special handling of BigDecimal (LANG-393) to use compareTo
+ * [LANG-574] - HashCodeBuilder - Performance improvement: check for isArray to short-circuit the 9 instanceof checks
+ * [LANG-520] - HashCodeBuilder - Changing the hashCode() method to return toHashCode()
+ * [LANG-459] - HashCodeBuilder - reflectionHashCode() can generate incorrect hashcodes
+ * [LANG-586] - HashCodeBuilder and ToStringStyle - use of ThreadLocal causes memory leaks in container environments
+ * [LANG-487] - ToStringBuilder - make default style thread-safe
+ * [LANG-472] - RandomUtils - nextLong() always produces even numbers
+ * [LANG-592] - RandomUtils - RandomUtils tests are failing frequently
-- None
-
-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 behaviour (ie. it is 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 http://www.junit.org. See the developer's guide
-for more details.
-
-DEPRECATIONS FROM 2.3 to 2.4:
-
-- ObjectUtils.appendIdentityToString(StringBuffer, Object) - has very odd semantics, use
- ObjectUtils.identityToString(StringBuffer, Object) instead.
-
-- public static java.util.Date add(java.util.Date, int, int) - it is not intended for this
- method to be public. Please let us know if you use this.
-
-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 JDK1.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.4:
-
- * [LANG-76 ] - EnumUtils.getEnum() doesn't work well in 1.5
- * [LANG-328] - LocaleUtils.toLocale() rejects strings with only language+variant
- * [LANG-334] - Enum is not thread-safe
- * [LANG-346] - Dates.round() behaves incorrectly for minutes and seconds
- * [LANG-349] - Deadlock using ReflectionToStringBuilder
- * [LANG-353] - Javadoc Example for EqualsBuilder is questionable
- * [LANG-360] - Why does appendIdentityToString return null?
- * [LANG-361] - BooleanUtils toBooleanObject javadoc does not match implementation
- * [LANG-363] - StringEscapeUtils.escapeJavaScript() method did not escape '/' into '\/', it will make IE render page incorrectly
- * [LANG-364] - Documentation bug for ignoreEmptyTokens accessors in StrTokenizer
- * [LANG-365] - BooleanUtils.toBoolean() - invalid drop-thru in case statement causes StringIndexOutOfBoundsException
- * [LANG-367] - FastDateFormat thread safety
- * [LANG-368] - FastDateFormat getDateInstance() and getDateTimeInstance() assume Locale.getDefault() won't change
- * [LANG-369] - ExceptionUtils not thread-safe
- * [LANG-372] - ToStringBuilder: MULTI_LINE_STYLE does not print anything from appendToString methods.
- * [LANG-380] - infinite loop in Fraction.reduce when numerator == 0
- * [LANG-381] - NumberUtils.min(floatArray) returns wrong value if floatArray[0] happens to be Float.NaN
- * [LANG-385] - http://commons.apache.org/lang/developerguide.html "Building" section is incorrect and incomplete
- * [LANG-393] - EqualsBuilder don't compare BigDecimals correctly
- * [LANG-399] - Javadoc bugs - cannot find object
- * [LANG-410] - Ambiguous / confusing names in StringUtils replace* methods
- * [LANG-412] - StrBuilder appendFixedWidth does not handle nulls
- * [LANG-414] - DateUtils.round() often fails
-
-IMPROVEMENTS IN 2.4:
-
- * [LANG-180] - adding a StringUtils.replace method that takes an array or List of replacement strings
- * [LANG-192] - Split camel case strings
- * [LANG-257] - Add new splitByWholeSeparatorPreserveAllTokens() methods to StringUtils
- * [LANG-269] - Shouldn't Commons Lang's StringUtils have a "common" string method?
- * [LANG-298] - ClassUtils.getShortClassName and ClassUtils.getPackageName and class of array
- * [LANG-321] - Add toArray() method to IntRange and LongRange classes
- * [LANG-322] - ClassUtils.getShortClassName(String) inefficient
- * [LANG-326] - StringUtils: startsWith / endsWith / startsWithIgnoreCase / endsWithIgnoreCase / removeStartIgnoreCase / removeEndIgnoreCase methods
- * [LANG-329] - Pointless synchronized in ThreadLocal.initialValue should be removed
- * [LANG-333] - ArrayUtils.toClass
- * [LANG-337] - Utility class constructor javadocs should acknowledge that they may sometimes be used, e.g. with Velocity.
- * [LANG-338] - truncateNicely method which avoids truncating in the middle of a word
- * [LANG-345] - Optimize HashCodeBuilder.append(Object)
- * [LANG-351] - Extension to ClassUtils: Obtain the primitive class from a wrapper
- * [LANG-356] - Add getStartTime to StopWatch
- * [LANG-362] - Add ExtendedMessageFormat to org.apache.commons.lang.text
- * [LANG-371] - ToStringStyle javadoc should show examples of styles
- * [LANG-374] - Add escaping for CSV columns to StringEscapeUtils
- * [LANG-375] - add SystemUtils.IS_OS_WINDOWS_VISTA field
- * [LANG-379] - Calculating A date fragment in any time-unit
- * [LANG-383] - Adding functionality to DateUtils to allow direct setting of various fields.
- * [LANG-402] - OSGi-ify Lang
- * [LANG-404] - Add Calendar flavour format methods to DateFormatUtils
- * [LANG-407] - StringUtils.length(String) returns null-safe length
- * [LANG-413] - Memory usage improvement for StringUtils#getLevenshteinDistance()