xref: /aosp_15_r20/external/apache-commons-lang/src/site/resources/release-notes/RELEASE-NOTES-3.3.2.txt (revision 455610af95f3bf5f4bc8a9eda520f57e389a4c42)
1*455610afSAndroid Build Coastguard WorkerLicensed to the Apache Software Foundation (ASF) under one or more
2*455610afSAndroid Build Coastguard Workercontributor license agreements.  See the NOTICE file distributed with
3*455610afSAndroid Build Coastguard Workerthis work for additional information regarding copyright ownership.
4*455610afSAndroid Build Coastguard WorkerThe ASF licenses this file to You under the Apache License, Version 2.0
5*455610afSAndroid Build Coastguard Worker(the "License"); you may not use this file except in compliance with
6*455610afSAndroid Build Coastguard Workerthe License.  You may obtain a copy of the License at
7*455610afSAndroid Build Coastguard Worker
8*455610afSAndroid Build Coastguard Workerhttp://www.apache.org/licenses/LICENSE-2.0
9*455610afSAndroid Build Coastguard Worker
10*455610afSAndroid Build Coastguard WorkerUnless required by applicable law or agreed to in writing, software
11*455610afSAndroid Build Coastguard Workerdistributed under the License is distributed on an "AS IS" BASIS,
12*455610afSAndroid Build Coastguard WorkerWITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13*455610afSAndroid Build Coastguard WorkerSee the License for the specific language governing permissions and
14*455610afSAndroid Build Coastguard Workerlimitations under the License.
15*455610afSAndroid Build Coastguard Worker
16*455610afSAndroid Build Coastguard Worker=============================================================================
17*455610afSAndroid Build Coastguard Worker
18*455610afSAndroid Build Coastguard Worker                           Apache Commons Lang
19*455610afSAndroid Build Coastguard Worker                               Version 3.3.2
20*455610afSAndroid Build Coastguard Worker                              Release Notes
21*455610afSAndroid Build Coastguard Worker
22*455610afSAndroid Build Coastguard Worker
23*455610afSAndroid Build Coastguard WorkerINTRODUCTION:
24*455610afSAndroid Build Coastguard Worker
25*455610afSAndroid Build Coastguard WorkerThis document contains the release notes for the 3.3.2 version of
26*455610afSAndroid Build Coastguard WorkerApache Commons Lang. Commons Lang is a set of utility functions and reusable
27*455610afSAndroid Build Coastguard Workercomponents that should be of use in any Java environment. Commons Lang 3.3.2
28*455610afSAndroid Build Coastguard Workerat least requires Java 6.0.
29*455610afSAndroid Build Coastguard Worker
30*455610afSAndroid Build Coastguard WorkerFor the advice on upgrading from 2.x to 3.x, see the following page:
31*455610afSAndroid Build Coastguard Worker
32*455610afSAndroid Build Coastguard Worker    https://commons.apache.org/lang/article3_0.html
33*455610afSAndroid Build Coastguard Worker
34*455610afSAndroid Build Coastguard Worker
35*455610afSAndroid Build Coastguard WorkerNEW FEATURES
36*455610afSAndroid Build Coastguard Worker==============
37*455610afSAndroid Build Coastguard Worker
38*455610afSAndroid Build Coastguard Workero LANG-989:  Add org.apache.commons.lang3.SystemUtils.IS_JAVA_1_8
39*455610afSAndroid Build Coastguard Worker
40*455610afSAndroid Build Coastguard WorkerFIXED BUGS
41*455610afSAndroid Build Coastguard Worker============
42*455610afSAndroid Build Coastguard Worker
43*455610afSAndroid Build Coastguard Workero LANG-992:  NumberUtils#isNumber() returns false for "0.0", "0.4790", et al
44*455610afSAndroid Build Coastguard Worker
45*455610afSAndroid Build Coastguard Worker                        Release Notes for version 3.3.1
46*455610afSAndroid Build Coastguard Worker
47*455610afSAndroid Build Coastguard WorkerFIXED BUGS
48*455610afSAndroid Build Coastguard Worker============
49*455610afSAndroid Build Coastguard Worker
50*455610afSAndroid Build Coastguard Workero LANG-987:  DateUtils.getFragmentInDays(Date, Calendar.MONTH) returns wrong
51*455610afSAndroid Build Coastguard Worker             days
52*455610afSAndroid Build Coastguard Workero LANG-983:  DurationFormatUtils does not describe format string fully
53*455610afSAndroid Build Coastguard Workero LANG-981:  DurationFormatUtils#lexx does not detect unmatched quote char
54*455610afSAndroid Build Coastguard Workero LANG-984:  DurationFormatUtils does not handle large durations correctly
55*455610afSAndroid Build Coastguard Workero LANG-982:  DurationFormatUtils.formatDuration(61999, "s.SSSS") - ms field
56*455610afSAndroid Build Coastguard Worker             size should be 4 digits
57*455610afSAndroid Build Coastguard Workero LANG-978:  Failing tests with Java 8 b128
58*455610afSAndroid Build Coastguard Worker
59*455610afSAndroid Build Coastguard Worker                        Release Notes for version 3.3
60*455610afSAndroid Build Coastguard Worker
61*455610afSAndroid Build Coastguard WorkerNEW FEATURES
62*455610afSAndroid Build Coastguard Worker==============
63*455610afSAndroid Build Coastguard Worker
64*455610afSAndroid Build Coastguard Workero LANG-955:  Add methods for removing all invalid characters according to
65*455610afSAndroid Build Coastguard Worker             XML 1.0 and XML 1.1 in an input string to StringEscapeUtils.
66*455610afSAndroid Build Coastguard Worker             Thanks to Adam Hooper.
67*455610afSAndroid Build Coastguard Workero LANG-970:  Add APIs MutableBoolean setTrue() and setFalse()
68*455610afSAndroid Build Coastguard Workero LANG-962:  Add SerializationUtils.roundtrip(T extends Serializable) to
69*455610afSAndroid Build Coastguard Worker             serialize then deserialize
70*455610afSAndroid Build Coastguard Workero LANG-637:  There should be a DifferenceBuilder with a
71*455610afSAndroid Build Coastguard Worker             ReflectionDifferenceBuilder implementation
72*455610afSAndroid Build Coastguard Workero LANG-944:  Add the Jaro-Winkler string distance algorithm to StringUtils.
73*455610afSAndroid Build Coastguard Worker             Thanks to Rekha Joshi.
74*455610afSAndroid Build Coastguard Workero LANG-417:  New class ClassPathUtils with methods for turning FQN into
75*455610afSAndroid Build Coastguard Worker             resource path
76*455610afSAndroid Build Coastguard Workero LANG-834:  Validate: add inclusiveBetween and exclusiveBetween overloads
77*455610afSAndroid Build Coastguard Worker             for primitive types
78*455610afSAndroid Build Coastguard Workero LANG-900:  New RandomUtils class. Thanks to Duncan Jones.
79*455610afSAndroid Build Coastguard Workero LANG-966:  Add IBM OS/400 detection
80*455610afSAndroid Build Coastguard Worker
81*455610afSAndroid Build Coastguard WorkerFIXED BUGS
82*455610afSAndroid Build Coastguard Worker============
83*455610afSAndroid Build Coastguard Worker
84*455610afSAndroid Build Coastguard Workero LANG-621:  ReflectionToStringBuilder.toString does not debug 3rd party object
85*455610afSAndroid Build Coastguard Worker             fields within 3rd party object. Thanks to Philip Hodges,
86*455610afSAndroid Build Coastguard Worker             Thomas Neidhart.
87*455610afSAndroid Build Coastguard Workero LANG-977:  NumericEntityEscaper incorrectly encodes supplementary characters.
88*455610afSAndroid Build Coastguard Worker             Thanks to Chris Karcher.
89*455610afSAndroid Build Coastguard Workero LANG-973:  Make some private fields final
90*455610afSAndroid Build Coastguard Workero LANG-971:  NumberUtils#isNumber(String) fails to reject invalid Octal numbers
91*455610afSAndroid Build Coastguard Workero LANG-972:  NumberUtils#isNumber does not allow for hex 0XABCD
92*455610afSAndroid Build Coastguard Workero LANG-969:  StringUtils.toEncodedString(byte[], Charset) needlessly throws
93*455610afSAndroid Build Coastguard Worker             UnsupportedEncodingException. Thanks to Matt Bishop.
94*455610afSAndroid Build Coastguard Workero LANG-946:  ConstantInitializerTest fails when building with IBM JDK 7
95*455610afSAndroid Build Coastguard Workero LANG-954:  uncaught PatternSyntaxException in FastDateFormat on Android.
96*455610afSAndroid Build Coastguard Worker             Thanks to Michael Keppler.
97*455610afSAndroid Build Coastguard Workero LANG-936:  StringUtils.getLevenshteinDistance with too big of a threshold
98*455610afSAndroid Build Coastguard Worker             returns wrong result. Thanks to Yaniv Kunda, Eli Lindsey.
99*455610afSAndroid Build Coastguard Workero LANG-943:  Test DurationFormatUtilsTest.testEdgeDuration fails in
100*455610afSAndroid Build Coastguard Worker             JDK 1.6, 1.7 and 1.8, BRST time zone
101*455610afSAndroid Build Coastguard Workero LANG-613:  ConstructorUtils.getAccessibleConstructor() Does Not Check the
102*455610afSAndroid Build Coastguard Worker             Accessibility of Enclosing Classes
103*455610afSAndroid Build Coastguard Workero LANG-951:  Fragments are wrong by 1 day when using fragment YEAR or MONTH.
104*455610afSAndroid Build Coastguard Worker             Thanks to Sebastian Götz.
105*455610afSAndroid Build Coastguard Workero LANG-950:  FastDateParser does not handle two digit year parsing like
106*455610afSAndroid Build Coastguard Worker             SimpleDateFormat
107*455610afSAndroid Build Coastguard Workero LANG-949:  FastDateParserTest.testParses does not test FastDateParser
108*455610afSAndroid Build Coastguard Workero LANG-915:  Wrong locale handling in LocaleUtils.toLocale().
109*455610afSAndroid Build Coastguard Worker             Thanks to Sergio Fernández.
110*455610afSAndroid Build Coastguard Worker
111*455610afSAndroid Build Coastguard WorkerCHANGES
112*455610afSAndroid Build Coastguard Worker=========
113*455610afSAndroid Build Coastguard Worker
114*455610afSAndroid Build Coastguard Workero LANG-961:  org.apache.commons.lang3.reflect.FieldUtils.removeFinalModifier(Field)
115*455610afSAndroid Build Coastguard Worker             does not clean up after itself
116*455610afSAndroid Build Coastguard Workero LANG-958:  FastDateParser javadoc incorrectly states that SimpleDateFormat
117*455610afSAndroid Build Coastguard Worker             is used internally
118*455610afSAndroid Build Coastguard Workero LANG-956:  Improve Javadoc of WordUtils.wrap methods
119*455610afSAndroid Build Coastguard Workero LANG-939:  Move Documentation from user guide to package-info files
120*455610afSAndroid Build Coastguard Workero LANG-953:  Convert package.html files to package-info.java files
121*455610afSAndroid Build Coastguard Workero LANG-940:  Fix deprecation warnings
122*455610afSAndroid Build Coastguard Workero LANG-819:  EnumUtils.generateBitVector needs a "? extends"
123*455610afSAndroid Build Coastguard Worker
124*455610afSAndroid Build Coastguard Worker                        Release Notes for version 3.2.1
125*455610afSAndroid Build Coastguard Worker
126*455610afSAndroid Build Coastguard WorkerBUG FIXES
127*455610afSAndroid Build Coastguard Worker===========
128*455610afSAndroid Build Coastguard Worker
129*455610afSAndroid Build Coastguard Workero LANG-937:  Fix missing Hamcrest dependency in Ant Build
130*455610afSAndroid Build Coastguard Workero LANG-941:  Test failure in LocaleUtilsTest when building with JDK 8
131*455610afSAndroid Build Coastguard Workero LANG-942:  Test failure in FastDateParserTest and FastDateFormat_ParserTest
132*455610afSAndroid Build Coastguard Worker             when building with JDK8. Thanks to Bruno P. Kinoshita,
133*455610afSAndroid Build Coastguard Worker             Henri Yandell.
134*455610afSAndroid Build Coastguard Workero LANG-938:  Build fails with test failures when building with JDK 8
135*455610afSAndroid Build Coastguard Worker
136*455610afSAndroid Build Coastguard Worker                        Release Notes for version 3.2
137*455610afSAndroid Build Coastguard Worker
138*455610afSAndroid Build Coastguard WorkerCOMPATIBILITY WITH 3.1
139*455610afSAndroid Build Coastguard Worker========================
140*455610afSAndroid Build Coastguard Worker
141*455610afSAndroid Build Coastguard WorkerThis release introduces backwards incompatible changes in
142*455610afSAndroid Build Coastguard Workerorg.apache.commons.lang3.time.FastDateFormat:
143*455610afSAndroid Build Coastguard Workero Method 'protected java.util.List parsePattern()' has been removed
144*455610afSAndroid Build Coastguard Workero Method 'protected java.lang.String parseToken(java.lang.String, int[])' has
145*455610afSAndroid Build Coastguard Worker  been removed
146*455610afSAndroid Build Coastguard Workero Method 'protected org.apache.commons.lang3.time.FastDateFormat$NumberRule
147*455610afSAndroid Build Coastguard Worker  selectNumberRule(int, int)' has been removed
148*455610afSAndroid Build Coastguard Worker
149*455610afSAndroid Build Coastguard WorkerThese changes were the result of [LANG-462]. It is assumed that this change
150*455610afSAndroid Build Coastguard Workerwill not break clients as Charles Honton pointed out on 25/Jan/12:
151*455610afSAndroid Build Coastguard Worker"
152*455610afSAndroid Build Coastguard Worker 1. Methods "FastDateFormat$NumberRule selectNumberRule(int, int)" and
153*455610afSAndroid Build Coastguard Worker    "List<Rule> parsePattern()" couldn't have been overridden because
154*455610afSAndroid Build Coastguard Worker    NumberRule and Rule were private to FastDateFormat.
155*455610afSAndroid Build Coastguard Worker 2. Due to the factory pattern used, it's unlikely other two methods would have
156*455610afSAndroid Build Coastguard Worker    been overridden.
157*455610afSAndroid Build Coastguard Worker 3. The four methods are highly implementation specific. I consider it a
158*455610afSAndroid Build Coastguard Worker    mistake that the methods were exposed.
159*455610afSAndroid Build Coastguard Worker"
160*455610afSAndroid Build Coastguard WorkerFor more information see https://issues.apache.org/jira/browse/LANG-462.
161*455610afSAndroid Build Coastguard Worker
162*455610afSAndroid Build Coastguard WorkerNEW FEATURES
163*455610afSAndroid Build Coastguard Worker==============
164*455610afSAndroid Build Coastguard Worker
165*455610afSAndroid Build Coastguard Workero LANG-934:  Add removeFinalModifier to FieldUtils
166*455610afSAndroid Build Coastguard Workero LANG-863:  Method returns number of inheritance hops between parent and
167*455610afSAndroid Build Coastguard Worker             subclass. Thanks to Daneel S. Yaitskov.
168*455610afSAndroid Build Coastguard Workero LANG-774:  Added isStarted, isSuspended and isStopped to StopWatch.
169*455610afSAndroid Build Coastguard Worker             Thanks to Erhan Bagdemir.
170*455610afSAndroid Build Coastguard Workero LANG-848:  Added StringUtils.isBlank/isEmpty CharSequence... methods.
171*455610afSAndroid Build Coastguard Worker             Thanks to Alexander Muthmann.
172*455610afSAndroid Build Coastguard Workero LANG-926:  Added ArrayUtils.reverse(array, from, to) methods.
173*455610afSAndroid Build Coastguard Workero LANG-795:  StringUtils.toString(byte[], String) deprecated in favour of a new
174*455610afSAndroid Build Coastguard Worker             StringUtils.toString(byte[], CharSet). Thanks to Aaron Digulla.
175*455610afSAndroid Build Coastguard Workero LANG-893:  StrSubstitutor now supports default values for variables.
176*455610afSAndroid Build Coastguard Worker             Thanks to Woonsan Ko.
177*455610afSAndroid Build Coastguard Workero LANG-913:  Adding .gitignore to commons-lang. Thanks to Allon Mureinik.
178*455610afSAndroid Build Coastguard Workero LANG-837:  Add ObjectUtils.toIdentityString methods that support
179*455610afSAndroid Build Coastguard Worker             StringBuilder, StrBuilder, and Appendable.
180*455610afSAndroid Build Coastguard Workero LANG-886:  Added CharSetUtils.containsAny(String, String).
181*455610afSAndroid Build Coastguard Workero LANG-797:  Added escape/unescapeJson to StringEscapeUtils.
182*455610afSAndroid Build Coastguard Workero LANG-875:  Added appendIfMissing and prependIfMissing methods to StringUtils.
183*455610afSAndroid Build Coastguard Workero LANG-870:  Add StringUtils.LF and StringUtils.CR values.
184*455610afSAndroid Build Coastguard Workero LANG-873:  Add FieldUtils getAllFields() to return all the fields defined in
185*455610afSAndroid Build Coastguard Worker             the given class and super classes.
186*455610afSAndroid Build Coastguard Workero LANG-835:  StrBuilder should support StringBuilder as an input parameter.
187*455610afSAndroid Build Coastguard Workero LANG-857:  StringIndexOutOfBoundsException in CharSequenceTranslator.
188*455610afSAndroid Build Coastguard Workero LANG-856:  Code refactoring in NumberUtils.
189*455610afSAndroid Build Coastguard Workero LANG-855:  NumberUtils#createBigInteger does not allow for hex and octal
190*455610afSAndroid Build Coastguard Worker             numbers.
191*455610afSAndroid Build Coastguard Workero LANG-854:  NumberUtils#createNumber - does not allow for hex numbers to be
192*455610afSAndroid Build Coastguard Worker             larger than Long.
193*455610afSAndroid Build Coastguard Workero LANG-853:  StringUtils join APIs for primitives.
194*455610afSAndroid Build Coastguard Workero LANG-841:  Add StringUtils API to call String.replaceAll in DOTALL a.k.a.
195*455610afSAndroid Build Coastguard Worker             single-line mode.
196*455610afSAndroid Build Coastguard Workero LANG-825:  Create StrBuilder APIs similar to
197*455610afSAndroid Build Coastguard Worker             String.format(String, Object...).
198*455610afSAndroid Build Coastguard Workero LANG-675:  Add Triple class (ternary version of Pair).
199*455610afSAndroid Build Coastguard Workero LANG-462:  FastDateFormat supports parse methods.
200*455610afSAndroid Build Coastguard Worker
201*455610afSAndroid Build Coastguard WorkerBUG FIXES
202*455610afSAndroid Build Coastguard Worker===========
203*455610afSAndroid Build Coastguard Worker
204*455610afSAndroid Build Coastguard Workero LANG-932:  Spelling fixes. Thanks to Ville Skyttä.
205*455610afSAndroid Build Coastguard Workero LANG-929:  OctalUnescaper tried to parse all of \279.
206*455610afSAndroid Build Coastguard Workero LANG-928:  OctalUnescaper had bugs when parsing octals starting with a zero.
207*455610afSAndroid Build Coastguard Workero LANG-905:  EqualsBuilder returned true when comparing arrays, even when the
208*455610afSAndroid Build Coastguard Worker             elements are different.
209*455610afSAndroid Build Coastguard Workero LANG-917:  Fixed exception when combining custom and choice format in
210*455610afSAndroid Build Coastguard Worker             ExtendedMessageFormat. Thanks to Arne Burmeister.
211*455610afSAndroid Build Coastguard Workero LANG-902:  RandomStringUtils.random javadoc was incorrectly promising letters
212*455610afSAndroid Build Coastguard Worker             and numbers would, as opposed to may, appear  Issue:. Thanks to
213*455610afSAndroid Build Coastguard Worker             Andrzej Winnicki.
214*455610afSAndroid Build Coastguard Workero LANG-921:  BooleanUtils.xor(boolean...) produces wrong results.
215*455610afSAndroid Build Coastguard Workero LANG-896:  BooleanUtils.toBoolean(String str) javadoc is not updated. Thanks
216*455610afSAndroid Build Coastguard Worker             to Mark Bryan Yu.
217*455610afSAndroid Build Coastguard Workero LANG-879:  LocaleUtils test fails with new Locale "ja_JP_JP_#u-ca-japanese"
218*455610afSAndroid Build Coastguard Worker             of JDK7.
219*455610afSAndroid Build Coastguard Workero LANG-836:  StrSubstitutor does not support StringBuilder or CharSequence.
220*455610afSAndroid Build Coastguard Worker             Thanks to Arnaud Brunet.
221*455610afSAndroid Build Coastguard Workero LANG-693:  Method createNumber from NumberUtils doesn't work for floating
222*455610afSAndroid Build Coastguard Worker             point numbers other than Float  Issue: LANG-693. Thanks to
223*455610afSAndroid Build Coastguard Worker             Calvin Echols.
224*455610afSAndroid Build Coastguard Workero LANG-887:  FastDateFormat does not use the locale specific cache correctly.
225*455610afSAndroid Build Coastguard Workero LANG-754:  ClassUtils.getShortName(String) will now only do a reverse lookup
226*455610afSAndroid Build Coastguard Worker             for array types.
227*455610afSAndroid Build Coastguard Workero LANG-881:  NumberUtils.createNumber() Javadoc says it does not work for octal
228*455610afSAndroid Build Coastguard Worker             numbers.
229*455610afSAndroid Build Coastguard Workero LANG-865:  LocaleUtils.toLocale does not parse strings starting with an
230*455610afSAndroid Build Coastguard Worker             underscore.
231*455610afSAndroid Build Coastguard Workero LANG-858:  StringEscapeUtils.escapeJava() and escapeEcmaScript() do not
232*455610afSAndroid Build Coastguard Worker             output the escaped surrogate pairs that are Java parsable.
233*455610afSAndroid Build Coastguard Workero LANG-849:  FastDateFormat and FastDatePrinter generates Date objects
234*455610afSAndroid Build Coastguard Worker             wastefully.
235*455610afSAndroid Build Coastguard Workero LANG-845:  Spelling fixes.
236*455610afSAndroid Build Coastguard Workero LANG-844:  Fix examples contained in javadoc of StringUtils.center methods.
237*455610afSAndroid Build Coastguard Workero LANG-832:  FastDateParser does not handle unterminated quotes correctly.
238*455610afSAndroid Build Coastguard Workero LANG-831:  FastDateParser does not handle white-space properly.
239*455610afSAndroid Build Coastguard Workero LANG-830:  FastDateParser could use \Q \E to quote regexes.
240*455610afSAndroid Build Coastguard Workero LANG-828:  FastDateParser does not handle non-Gregorian calendars properly.
241*455610afSAndroid Build Coastguard Workero LANG-826:  FastDateParser does not handle non-ASCII digits correctly.
242*455610afSAndroid Build Coastguard Workero LANG-822:  NumberUtils#createNumber - bad behavior for leading "--".
243*455610afSAndroid Build Coastguard Workero LANG-818:  FastDateFormat's "z" pattern does not respect timezone of Calendar
244*455610afSAndroid Build Coastguard Worker             instances passed to format().
245*455610afSAndroid Build Coastguard Workero LANG-817:  Add org.apache.commons.lang3.SystemUtils.IS_OS_WINDOWS_8.
246*455610afSAndroid Build Coastguard Workero LANG-813:  StringUtils.equalsIgnoreCase doesn't check string reference
247*455610afSAndroid Build Coastguard Worker             equality.
248*455610afSAndroid Build Coastguard Workero LANG-810:  StringUtils.join() endIndex, bugged for loop.
249*455610afSAndroid Build Coastguard Workero LANG-807:  RandomStringUtils throws confusing IAE when end <= start.
250*455610afSAndroid Build Coastguard Workero LANG-805:  RandomStringUtils.random(count, 0, 0, false, false, universe,
251*455610afSAndroid Build Coastguard Worker             random) always throws java.lang.ArrayIndexOutOfBoundsException.
252*455610afSAndroid Build Coastguard Workero LANG-802:  LocaleUtils - unnecessary recursive call in SyncAvoid class.
253*455610afSAndroid Build Coastguard Workero LANG-800:  Javadoc bug in DateUtils#ceiling for Calendar and Object versions.
254*455610afSAndroid Build Coastguard Workero LANG-788:  SerializationUtils throws ClassNotFoundException when cloning
255*455610afSAndroid Build Coastguard Worker             primitive classes.
256*455610afSAndroid Build Coastguard Workero LANG-786:  StringUtils equals() relies on undefined behavior.
257*455610afSAndroid Build Coastguard Workero LANG-783:  Documentation bug: StringUtils.split.
258*455610afSAndroid Build Coastguard Workero LANG-777:  jar contains velocity template of release notes.
259*455610afSAndroid Build Coastguard Workero LANG-776:  TypeUtilsTest contains incorrect type assignability assertion.
260*455610afSAndroid Build Coastguard Workero LANG-775:  TypeUtils.getTypeArguments() misses type arguments for
261*455610afSAndroid Build Coastguard Worker             partially-assigned classes.
262*455610afSAndroid Build Coastguard Workero LANG-773:  ImmutablePair doc contains nonsense text.
263*455610afSAndroid Build Coastguard Workero LANG-772:  ClassUtils.PACKAGE_SEPARATOR Javadoc contains garbage text.
264*455610afSAndroid Build Coastguard Workero LANG-765:  EventListenerSupport.ProxyInvocationHandler no longer defines
265*455610afSAndroid Build Coastguard Worker             serialVersionUID.
266*455610afSAndroid Build Coastguard Workero LANG-764:  StrBuilder is now serializable.
267*455610afSAndroid Build Coastguard Workero LANG-761:  Fix Javadoc Ant warnings.
268*455610afSAndroid Build Coastguard Workero LANG-747:  NumberUtils does not handle Long Hex numbers.
269*455610afSAndroid Build Coastguard Workero LANG-743:  Javadoc bug in static inner class DateIterator.
270*455610afSAndroid Build Coastguard Worker
271*455610afSAndroid Build Coastguard WorkerCHANGES
272*455610afSAndroid Build Coastguard Worker=========
273*455610afSAndroid Build Coastguard Worker
274*455610afSAndroid Build Coastguard Workero LANG-931:  Misleading Javadoc comment in StrBuilderReader class. Thanks
275*455610afSAndroid Build Coastguard Worker             to Christoph Schneegans.
276*455610afSAndroid Build Coastguard Workero LANG-910:  StringUtils.normalizeSpace now handles non-breaking spaces
277*455610afSAndroid Build Coastguard Worker             (Unicode 00A0). Thanks to Timur Yarosh.
278*455610afSAndroid Build Coastguard Workero LANG-804:  Redundant check for zero in HashCodeBuilder ctor. Thanks to
279*455610afSAndroid Build Coastguard Worker             Allon Mureinik.
280*455610afSAndroid Build Coastguard Workero LANG-884:  Simplify FastDateFormat; eliminate boxing.
281*455610afSAndroid Build Coastguard Workero LANG-882:  LookupTranslator now works with implementations of CharSequence
282*455610afSAndroid Build Coastguard Worker             other than String.
283*455610afSAndroid Build Coastguard Workero LANG-846:  Provide CharSequenceUtils.regionMatches with a proper green
284*455610afSAndroid Build Coastguard Worker             implementation instead of inefficiently converting to Strings.
285*455610afSAndroid Build Coastguard Workero LANG-839:  ArrayUtils removeElements methods use unnecessary HashSet.
286*455610afSAndroid Build Coastguard Workero LANG-838:  ArrayUtils removeElements methods clone temporary index arrays
287*455610afSAndroid Build Coastguard Worker             unnecessarily.
288*455610afSAndroid Build Coastguard Workero LANG-799:  DateUtils#parseDate uses default locale; add Locale support.
289*455610afSAndroid Build Coastguard Workero LANG-798:  Use generics in SerializationUtils.
290*455610afSAndroid Build Coastguard Worker
291*455610afSAndroid Build Coastguard WorkerCHANGES WITHOUT TICKET
292*455610afSAndroid Build Coastguard Worker========================
293*455610afSAndroid Build Coastguard Worker
294*455610afSAndroid Build Coastguard Workero Fixed URLs in javadoc to point to new oracle.com pages
295*455610afSAndroid Build Coastguard Worker
296*455610afSAndroid Build Coastguard Worker
297*455610afSAndroid Build Coastguard Worker                        Release Notes for version 3.1
298*455610afSAndroid Build Coastguard Worker
299*455610afSAndroid Build Coastguard WorkerNEW FEATURES
300*455610afSAndroid Build Coastguard Worker==============
301*455610afSAndroid Build Coastguard Worker
302*455610afSAndroid Build Coastguard Workero LANG-801:  Add Conversion utility to convert between data types on byte level
303*455610afSAndroid Build Coastguard Workero LANG-760:  Add API StringUtils.toString(byte[] input, String charsetName)
304*455610afSAndroid Build Coastguard Workero LANG-756:  Add APIs ClassUtils.isPrimitiveWrapper(Class<?>) and
305*455610afSAndroid Build Coastguard Worker             isPrimitiveOrWrapper(Class<?>)
306*455610afSAndroid Build Coastguard Workero LANG-695:  SystemUtils.IS_OS_UNIX doesn't recognize FreeBSD as a Unix system
307*455610afSAndroid Build Coastguard Worker
308*455610afSAndroid Build Coastguard WorkerBUG FIXES
309*455610afSAndroid Build Coastguard Worker===========
310*455610afSAndroid Build Coastguard Worker
311*455610afSAndroid Build Coastguard Workero LANG-749:  Incorrect Bundle-SymbolicName in Manifest
312*455610afSAndroid Build Coastguard Workero LANG-746:  NumberUtils does not handle upper-case hex: 0X and -0X
313*455610afSAndroid Build Coastguard Workero LANG-744:  StringUtils throws java.security.AccessControlException on Google
314*455610afSAndroid Build Coastguard Worker             App Engine
315*455610afSAndroid Build Coastguard Workero LANG-741:  Ant build has wrong component.name
316*455610afSAndroid Build Coastguard Workero LANG-698:  Document that the Mutable numbers don't work as expected with
317*455610afSAndroid Build Coastguard Worker             String.format
318*455610afSAndroid Build Coastguard Worker
319*455610afSAndroid Build Coastguard WorkerCHANGES
320*455610afSAndroid Build Coastguard Worker=========
321*455610afSAndroid Build Coastguard Worker
322*455610afSAndroid Build Coastguard Workero LANG-758:  Add an example with whitespace in StringUtils.defaultIfEmpty
323*455610afSAndroid Build Coastguard Workero LANG-752:  Fix createLong() so it behaves like createInteger()
324*455610afSAndroid Build Coastguard Workero LANG-751:  Include the actual type in the Validate.isInstance and
325*455610afSAndroid Build Coastguard Worker             isAssignableFrom exception messages
326*455610afSAndroid Build Coastguard Workero LANG-748:  Deprecating chomp(String, String)
327*455610afSAndroid Build Coastguard Workero LANG-736:  CharUtils static final array CHAR_STRING is not needed to compute
328*455610afSAndroid Build Coastguard Worker             CHAR_STRING_ARRAY
329*455610afSAndroid Build Coastguard Worker
330*455610afSAndroid Build Coastguard Worker
331*455610afSAndroid Build Coastguard Worker                        Release Notes for version 3.0
332*455610afSAndroid Build Coastguard Worker
333*455610afSAndroid Build Coastguard WorkerADDITIONS
334*455610afSAndroid Build Coastguard Worker===========
335*455610afSAndroid Build Coastguard Worker
336*455610afSAndroid Build Coastguard Workero LANG-276:  MutableBigDecimal and MutableBigInteger.
337*455610afSAndroid Build Coastguard Workero LANG-285:  Wish : method unaccent.
338*455610afSAndroid Build Coastguard Workero LANG-358:  ObjectUtils.coalesce.
339*455610afSAndroid Build Coastguard Workero LANG-386:  LeftOf/RightOfNumber in Range convenience methods necessary.
340*455610afSAndroid Build Coastguard Workero LANG-435:  Add ClassUtils.isAssignable() variants with autoboxing.
341*455610afSAndroid Build Coastguard Workero LANG-444:  StringUtils.emptyToNull.
342*455610afSAndroid Build Coastguard Workero LANG-482:  Enhance StrSubstitutor to support nested ${var-${subvr}} expansion
343*455610afSAndroid Build Coastguard Workero LANG-482:  StrSubstitutor now supports substitution in variable names.
344*455610afSAndroid Build Coastguard Workero LANG-496:  A generic implementation of the Lazy initialization pattern.
345*455610afSAndroid Build Coastguard Workero LANG-497:  Addition of ContextedException and ContextedRuntimeException.
346*455610afSAndroid Build Coastguard Workero LANG-498:  Add StringEscapeUtils.escapeText() methods.
347*455610afSAndroid Build Coastguard Workero LANG-499:  Add support for the handling of ExecutionExceptions.
348*455610afSAndroid Build Coastguard Workero LANG-501:  Add support for background initialization.
349*455610afSAndroid Build Coastguard Workero LANG-529:  Add a concurrent package.
350*455610afSAndroid Build Coastguard Workero LANG-533:  Validate: support for validating blank strings.
351*455610afSAndroid Build Coastguard Workero LANG-537:  Add ArrayUtils.toArray to create generic arrays.
352*455610afSAndroid Build Coastguard Workero LANG-545:  Add ability to create a Future for a constant.
353*455610afSAndroid Build Coastguard Workero LANG-546:  Add methods to Validate to check whether the index is valid for
354*455610afSAndroid Build Coastguard Worker             the array/list/string.
355*455610afSAndroid Build Coastguard Workero LANG-553:  Add TypeUtils class to provide utility code for working with generic
356*455610afSAndroid Build Coastguard Worker             types.
357*455610afSAndroid Build Coastguard Workero LANG-559:  Added isAssignableFrom and isInstanceOf validation methods.
358*455610afSAndroid Build Coastguard Workero LANG-559:  Added validState validation method.
359*455610afSAndroid Build Coastguard Workero LANG-560:  New TimedSemaphore class.
360*455610afSAndroid Build Coastguard Workero LANG-582:  Provide an implementation of the ThreadFactory interface.
361*455610afSAndroid Build Coastguard Workero LANG-588:  Create a basic Pair<L, R> class.
362*455610afSAndroid Build Coastguard Workero LANG-594:  DateUtils equal & compare functions up to most significant field.
363*455610afSAndroid Build Coastguard Workero LANG-601:  Add Builder Interface / Update Builders to Implement It.
364*455610afSAndroid Build Coastguard Workero LANG-609:  Support lazy initialization using atomic variables
365*455610afSAndroid Build Coastguard Workero LANG-610:  Extend exception handling in ConcurrentUtils to runtime exceptions.
366*455610afSAndroid Build Coastguard Workero LANG-614:  StringUtils.endsWithAny method
367*455610afSAndroid Build Coastguard Workero LANG-640:  Add normalizeSpace to StringUtils
368*455610afSAndroid Build Coastguard Workero LANG-644:  Provide documentation about the new concurrent package
369*455610afSAndroid Build Coastguard Workero LANG-649:  BooleanUtils.toBooleanObject to support single character input
370*455610afSAndroid Build Coastguard Workero LANG-651:  Add AnnotationUtils
371*455610afSAndroid Build Coastguard Workero LANG-653:  Provide a very basic ConcurrentInitializer implementation
372*455610afSAndroid Build Coastguard Workero LANG-655:  Add StringUtils.defaultIfBlank()
373*455610afSAndroid Build Coastguard Workero LANG-667:  Add a Null-safe compare() method to ObjectUtils
374*455610afSAndroid Build Coastguard Workero LANG-676:  Documented potential NPE if auto-boxing occurs for some BooleanUtils
375*455610afSAndroid Build Coastguard Worker             methods
376*455610afSAndroid Build Coastguard Workero LANG-678:  Add support for ConcurrentMap.putIfAbsent()
377*455610afSAndroid Build Coastguard Workero LANG-692:  Add hashCodeMulti varargs method
378*455610afSAndroid Build Coastguard Workero LANG-697:  Add FormattableUtils class
379*455610afSAndroid Build Coastguard Workero LANG-684:  Levenshtein Distance Within a Given Threshold
380*455610afSAndroid Build Coastguard Worker
381*455610afSAndroid Build Coastguard WorkerREMOVALS
382*455610afSAndroid Build Coastguard Worker==========
383*455610afSAndroid Build Coastguard Worker
384*455610afSAndroid Build Coastguard Workero LANG-438:  Remove @deprecateds.
385*455610afSAndroid Build Coastguard Workero LANG-492:  Remove code handled now by the JDK.
386*455610afSAndroid Build Coastguard Workero LANG-493:  Remove code that does not hold enough value to remain.
387*455610afSAndroid Build Coastguard Workero LANG-590:  Remove JDK 1.2/1.3 bug handling in
388*455610afSAndroid Build Coastguard Worker             StringUtils.indexOf(String, String, int).
389*455610afSAndroid Build Coastguard Workero LANG-673:  WordUtils.abbreviate() removed
390*455610afSAndroid Build Coastguard Workero LANG-691:  Removed DateUtils.UTC_TIME_ZONE
391*455610afSAndroid Build Coastguard Worker
392*455610afSAndroid Build Coastguard WorkerIMPROVEMENTS
393*455610afSAndroid Build Coastguard Worker==============
394*455610afSAndroid Build Coastguard Worker
395*455610afSAndroid Build Coastguard Workero LANG-290:  EnumUtils for JDK 5.0.
396*455610afSAndroid Build Coastguard Workero LANG-336:  Finally start using generics.
397*455610afSAndroid Build Coastguard Workero LANG-355:  StrBuilder should implement CharSequence and Appendable.
398*455610afSAndroid Build Coastguard Workero LANG-396:  Investigate for vararg usages.
399*455610afSAndroid Build Coastguard Workero LANG-424:  Improve Javadoc for StringUtils class.
400*455610afSAndroid Build Coastguard Workero LANG-458:  Refactor Validate.java to eliminate code redundancy.
401*455610afSAndroid Build Coastguard Workero LANG-479:  Document where in SVN trunk is.
402*455610afSAndroid Build Coastguard Workero LANG-504:  bring ArrayUtils.isEmpty to the generics world.
403*455610afSAndroid Build Coastguard Workero LANG-505:  Rewrite StringEscapeUtils.
404*455610afSAndroid Build Coastguard Workero LANG-507:  StringEscapeUtils.unescapeJava should support \u+ notation.
405*455610afSAndroid Build Coastguard Workero LANG-510:  Convert StringUtils API to take CharSequence.
406*455610afSAndroid Build Coastguard Workero LANG-513:  Better EnumUtils.
407*455610afSAndroid Build Coastguard Workero LANG-528:  Mutable classes should implement an appropriately typed Mutable
408*455610afSAndroid Build Coastguard Worker             interface.
409*455610afSAndroid Build Coastguard Workero LANG-539:  Compile commons.lang for CDC 1.1/Foundation 1.1.
410*455610afSAndroid Build Coastguard Workero LANG-540:  Make NumericEntityEscaper immutable.
411*455610afSAndroid Build Coastguard Workero LANG-541:  Replace StringBuffer with StringBuilder.
412*455610afSAndroid Build Coastguard Workero LANG-548:  Use Iterable on API instead of Collection.
413*455610afSAndroid Build Coastguard Workero LANG-551:  Replace Range classes with generic version.
414*455610afSAndroid Build Coastguard Workero LANG-562:  Change Maven groupId.
415*455610afSAndroid Build Coastguard Workero LANG-563:  Change Java package name.
416*455610afSAndroid Build Coastguard Workero LANG-570:  Do the test cases really still require main() and suite() methods?
417*455610afSAndroid Build Coastguard Workero LANG-579:  Add new Validate methods.
418*455610afSAndroid Build Coastguard Workero LANG-599:  ClassUtils.getClass(): Allow Dots as Inner Class Separators.
419*455610afSAndroid Build Coastguard Workero LANG-605:  DefaultExceptionContext overwrites values in recursive situations.
420*455610afSAndroid Build Coastguard Workero LANG-668:  Change ObjectUtils min() & max() functions to use varargs rather
421*455610afSAndroid Build Coastguard Worker             than just two parameters
422*455610afSAndroid Build Coastguard Workero LANG-681:  Push down WordUtils to "text" sub-package.
423*455610afSAndroid Build Coastguard Workero LANG-711:  Add includeantruntime=false to javac targets to quell warnings in
424*455610afSAndroid Build Coastguard Worker             ant 1.8.1 and better (and modest performance gain).
425*455610afSAndroid Build Coastguard Workero LANG-713:  Increase test coverage of FieldUtils read methods and tweak
426*455610afSAndroid Build Coastguard Worker             javadoc.
427*455610afSAndroid Build Coastguard Workero LANG-718:  build.xml Java 1.5+ updates.
428*455610afSAndroid Build Coastguard Worker
429*455610afSAndroid Build Coastguard WorkerBUG FIXES
430*455610afSAndroid Build Coastguard Worker===========
431*455610afSAndroid Build Coastguard Worker
432*455610afSAndroid Build Coastguard Workero LANG-11:   Depend on JDK 1.5+.
433*455610afSAndroid Build Coastguard Workero LANG-302:  StrBuilder does not implement clone().
434*455610afSAndroid Build Coastguard Workero LANG-339:  StringEscapeUtils.escapeHtml() escapes multibyte characters like
435*455610afSAndroid Build Coastguard Worker             Chinese, Japanese, etc.
436*455610afSAndroid Build Coastguard Workero LANG-369:  ExceptionUtils not thread-safe.
437*455610afSAndroid Build Coastguard Workero LANG-418:  Javadoc incorrect for StringUtils.endsWithIgnoreCase.
438*455610afSAndroid Build Coastguard Workero LANG-428:  StringUtils.isAlpha, isAlphanumeric and isNumeric now return false
439*455610afSAndroid Build Coastguard Worker             for ""
440*455610afSAndroid Build Coastguard Workero LANG-439:  StringEscapeUtils.escapeHTML() does not escape chars (0x00-0x20).
441*455610afSAndroid Build Coastguard Workero LANG-448:  Lower Ascii Characters don't get encoded by Entities.java.
442*455610afSAndroid Build Coastguard Workero LANG-468:  JDK 1.5 build/runtime failure on LANG-393 (EqualsBuilder).
443*455610afSAndroid Build Coastguard Workero LANG-474:  Fixes for thread safety.
444*455610afSAndroid Build Coastguard Workero LANG-478:  StopWatch does not resist to system time changes.
445*455610afSAndroid Build Coastguard Workero LANG-480:  StringEscapeUtils.escapeHtml incorrectly converts unicode
446*455610afSAndroid Build Coastguard Worker             characters above U+00FFFF into 2 characters.
447*455610afSAndroid Build Coastguard Workero LANG-481:  Possible race-conditions in hashCode of the range classes.
448*455610afSAndroid Build Coastguard Workero LANG-564:  Improve StrLookup API documentation.
449*455610afSAndroid Build Coastguard Workero LANG-568:  @SuppressWarnings("unchecked") is used too generally.
450*455610afSAndroid Build Coastguard Workero LANG-571:  ArrayUtils.add(T[:  array, T element) can create unexpected
451*455610afSAndroid Build Coastguard Worker             ClassCastException.
452*455610afSAndroid Build Coastguard Workero LANG-585:  exception.DefaultExceptionContext.getFormattedExceptionMessage
453*455610afSAndroid Build Coastguard Worker             catches Throwable.
454*455610afSAndroid Build Coastguard Workero LANG-596:  StrSubstitutor should also handle the default properties of a
455*455610afSAndroid Build Coastguard Worker             java.util.Properties class
456*455610afSAndroid Build Coastguard Workero LANG-600:  Javadoc is incorrect for public static int
457*455610afSAndroid Build Coastguard Worker             lastIndexOf(String str, String searchStr).
458*455610afSAndroid Build Coastguard Workero LANG-602:  ContextedRuntimeException no longer an 'unchecked' exception.
459*455610afSAndroid Build Coastguard Workero LANG-606:  EqualsBuilder causes StackOverflowException.
460*455610afSAndroid Build Coastguard Workero LANG-608:  Some StringUtils methods should take an int character instead of
461*455610afSAndroid Build Coastguard Worker             char to use String API features.
462*455610afSAndroid Build Coastguard Workero LANG-617:  StringEscapeUtils.escapeXML() can't process UTF-16 supplementary
463*455610afSAndroid Build Coastguard Worker             characters
464*455610afSAndroid Build Coastguard Workero LANG-624:  SystemUtils.getJavaVersionAsFloat throws
465*455610afSAndroid Build Coastguard Worker             StringIndexOutOfBoundsException on Android runtime/Dalvik VM
466*455610afSAndroid Build Coastguard Workero LANG-629:  Charset may not be threadsafe, because the HashSet is not synch.
467*455610afSAndroid Build Coastguard Workero LANG-638:  NumberUtils createNumber throws a StringIndexOutOfBoundsException
468*455610afSAndroid Build Coastguard Worker             when argument containing "e" and "E" is passed in
469*455610afSAndroid Build Coastguard Workero LANG-643:  Javadoc StringUtils.left() claims to throw on negative len, but
470*455610afSAndroid Build Coastguard Worker             doesn't
471*455610afSAndroid Build Coastguard Workero LANG-645:  FastDateFormat.format() outputs incorrect week of year because
472*455610afSAndroid Build Coastguard Worker             locale isn't respected
473*455610afSAndroid Build Coastguard Workero LANG-646:  StringEscapeUtils.unescapeJava doesn't handle octal escapes and
474*455610afSAndroid Build Coastguard Worker             Unicode with extra u
475*455610afSAndroid Build Coastguard Workero LANG-656:  Example StringUtils.indexOfAnyBut("zzabyycdxx", '') = 0 incorrect
476*455610afSAndroid Build Coastguard Workero LANG-658:  Some entities like &Ouml; are not matched properly against its
477*455610afSAndroid Build Coastguard Worker             ISO8859-1 representation
478*455610afSAndroid Build Coastguard Workero LANG-659:  EntityArrays typo: {"\u2122", "&minus;"}, // minus sign, U+2212
479*455610afSAndroid Build Coastguard Worker             ISOtech
480*455610afSAndroid Build Coastguard Workero LANG-66:   StringEscaper.escapeXml() escapes characters > 0x7f.
481*455610afSAndroid Build Coastguard Workero LANG-662:  org.apache.commons.lang3.math.Fraction does not reduce
482*455610afSAndroid Build Coastguard Worker             (Integer.MIN_VALUE, 2^k)
483*455610afSAndroid Build Coastguard Workero LANG-663:  org.apache.commons.lang3.math.Fraction does not always succeed in
484*455610afSAndroid Build Coastguard Worker             multiplyBy and divideBy
485*455610afSAndroid Build Coastguard Workero LANG-664:  NumberUtils.isNumber(String) is not right when the String is
486*455610afSAndroid Build Coastguard Worker             "1.1L"
487*455610afSAndroid Build Coastguard Workero LANG-672:  Doc bug in DateUtils#ceiling
488*455610afSAndroid Build Coastguard Workero LANG-677:  DateUtils.isSameLocalTime compares using 12-hour clock and not
489*455610afSAndroid Build Coastguard Worker             24-hour
490*455610afSAndroid Build Coastguard Workero LANG-685:  EqualsBuilder synchronizes on HashCodeBuilder.
491*455610afSAndroid Build Coastguard Workero LANG-703:  StringUtils.join throws NPE when toString returns null for one of
492*455610afSAndroid Build Coastguard Worker             objects in collection
493*455610afSAndroid Build Coastguard Workero LANG-710:  StringIndexOutOfBoundsException when calling unescapeHtml4("&#03")
494*455610afSAndroid Build Coastguard Workero LANG-714:  StringUtils doc/comment spelling fixes.
495*455610afSAndroid Build Coastguard Workero LANG-715:  CharSetUtils.squeeze() speedup.
496*455610afSAndroid Build Coastguard Workero LANG-716:  swapCase and *capitalize speedups.
497*455610afSAndroid Build Coastguard Worker
498*455610afSAndroid Build Coastguard Worker
499*455610afSAndroid Build Coastguard WorkerHistorical list of changes: https://commons.apache.org/lang/changes-report.html
500*455610afSAndroid Build Coastguard Worker
501*455610afSAndroid Build Coastguard WorkerFor complete information on Commons Lang, including instructions on how to
502*455610afSAndroid Build Coastguard Workersubmit bug reports, patches, or suggestions for improvement, see the
503*455610afSAndroid Build Coastguard WorkerApache Commons Lang website:
504*455610afSAndroid Build Coastguard Worker
505*455610afSAndroid Build Coastguard Workerhttps://commons.apache.org/lang/
506*455610afSAndroid Build Coastguard Worker
507*455610afSAndroid Build Coastguard WorkerHave fun!
508*455610afSAndroid Build Coastguard Worker-Apache Commons Lang team
509*455610afSAndroid Build Coastguard Worker
510