From 1774335e56fb8837d34258f29b6ac1f536c8f456 Mon Sep 17 00:00:00 2001 From: Marc Wrobel Date: Fri, 15 Jul 2022 19:51:03 +0200 Subject: [PATCH] (doc) Fix typos in project documentations (#923) --- RELEASE-NOTES.txt | 16 +++---- src/changes/changes.xml | 42 +++++++++---------- src/conf/spotbugs-exclude-filter.xml | 2 +- .../release-notes/RELEASE-NOTES-2.0.txt | 2 +- .../release-notes/RELEASE-NOTES-2.1.txt | 6 +-- .../release-notes/RELEASE-NOTES-2.2.txt | 6 +-- .../release-notes/RELEASE-NOTES-2.3.txt | 8 ++-- .../release-notes/RELEASE-NOTES-2.4.txt | 6 +-- .../release-notes/RELEASE-NOTES-2.5.txt | 2 +- .../release-notes/RELEASE-NOTES-2.6.txt | 2 +- .../release-notes/RELEASE-NOTES-3.0.txt | 4 +- .../release-notes/RELEASE-NOTES-3.1.txt | 2 +- .../release-notes/RELEASE-NOTES-3.10.txt | 4 +- .../release-notes/RELEASE-NOTES-3.2.1.txt | 8 ++-- .../release-notes/RELEASE-NOTES-3.2.txt | 8 ++-- .../release-notes/RELEASE-NOTES-3.3.1.txt | 8 ++-- .../release-notes/RELEASE-NOTES-3.3.2.txt | 8 ++-- .../release-notes/RELEASE-NOTES-3.3.txt | 8 ++-- .../release-notes/RELEASE-NOTES-3.4.txt | 14 +++---- .../release-notes/RELEASE-NOTES-3.5.txt | 28 ++++++------- .../release-notes/RELEASE-NOTES-3.6.txt | 16 +++---- .../release-notes/RELEASE-NOTES-3.7.txt | 16 +++---- .../release-notes/RELEASE-NOTES-3.8.1.txt | 16 +++---- .../release-notes/RELEASE-NOTES-3.8.txt | 16 +++---- .../release-notes/RELEASE-NOTES-3.9.txt | 16 +++---- src/site/xdoc/article2_4.xml | 2 +- src/site/xdoc/article2_5.xml | 6 +-- src/site/xdoc/article3_0.xml | 6 +-- src/site/xdoc/mail-lists.xml | 2 +- src/site/xdoc/upgradeto2_0.xml | 2 +- src/site/xdoc/upgradeto2_1.xml | 6 +-- src/site/xdoc/upgradeto2_3.xml | 6 +-- src/site/xdoc/upgradeto2_4.xml | 6 +-- src/site/xdoc/upgradeto2_5.xml | 2 +- src/site/xdoc/upgradeto2_6.xml | 2 +- src/site/xdoc/upgradeto3_0.xml | 4 +- 36 files changed, 154 insertions(+), 154 deletions(-) diff --git a/RELEASE-NOTES.txt b/RELEASE-NOTES.txt index 8828a1141..b0a025ddb 100644 --- a/RELEASE-NOTES.txt +++ b/RELEASE-NOTES.txt @@ -605,7 +605,7 @@ o LANG-660: Add methods to insert arrays into arrays at an index. o LANG-1034: Add support for recursive comparison to EqualsBuilder#reflectionEquals. Thanks to Yathos UG. o LANG-1067: Add a reflection-based variant of DiffBuilder. -o LANG-740: Implementation of a Memomizer. Thanks to James Sawle. +o LANG-740: Implementation of a Memoizer. Thanks to James Sawle. o LANG-1258: Add ArrayUtils#toStringArray method. Thanks to IG, Grzegorz Ro?niecki. o LANG-1160: StringUtils#abbreviate should support 'custom ellipses' parameter. @@ -705,7 +705,7 @@ o Numerous extensions to org.apache.commons.lang3.StringUtils including truncation. o Added org.apache.commons.lang3.ThreadUtils - a utility class to work with instances of java.lang.Thread and java.lang.ThreadGroup. -o Added annotations @EqualsExclude, @HashCodeExclude and @ToStringEclude to +o Added annotations @EqualsExclude, @HashCodeExclude and @ToStringExclude to mark fields which should be ignored by the reflective builders in the org.apache.commons.lang3.builder package. o Support for various modify and retrieve value use cases added to the classes @@ -803,7 +803,7 @@ o LANG-1168: Add SystemUtils.IS_OS_WINDOWS_10 property. Thanks to Pascal Schumacher. o LANG-1115: Add support for varargs in ConstructorUtils, MemberUtils, and MethodUtils. Thanks to Jim Lloyd and Joe Ferner. -o LANG-1134: Add methods to check numbers against NaN and inifinite to +o LANG-1134: Add methods to check numbers against NaN and infinite to Validate. Thanks to Alan Smithee. o LANG-1220: Add tests for missed branches in DateUtils. Thanks to Casey Scarborough. @@ -887,7 +887,7 @@ o LANG-1205: NumberUtils.createNumber() behaves inconsistently with o LANG-1222: Fix for incorrect comment on StringUtils.containsIgnoreCase method. Thanks to Adam J. o LANG-1221: Fix typo on appendIfMissing javadoc. Thanks to Pierre Templier. -o LANG-1202: parseDateStrictly does't pass specified locale. Thanks to +o LANG-1202: parseDateStrictly doesn't pass specified locale. Thanks to Markus Jelsma. o LANG-1219: FastDateFormat doesn't respect summer daylight in some localized strings. Thanks to Jarek. @@ -1039,7 +1039,7 @@ o LANG-794: SystemUtils.IS_OS_WINDOWS_2008, VISTA are incorrect. Thanks to o LANG-1104: Parse test fails for TimeZone America/Sao_Paulo o LANG-948: Exception while using ExtendedMessageFormat and escaping braces. Thanks to Andrey Khobnya. -o LANG-1092: Wrong formating of time zones with daylight saving time in +o LANG-1092: Wrong formatting of time zones with daylight saving time in FastDatePrinter o LANG-1090: FastDateParser does not set error indication in ParsePosition o LANG-1089: FastDateParser does not handle excess hours as per @@ -1079,7 +1079,7 @@ CHANGES o LANG-1102: Make logic for comparing OS versions in SystemUtils smarter o LANG-1091: Shutdown thread pools in test cases. Thanks to Fabian Lange. o LANG-1101: FastDateParser and FastDatePrinter support 'X' format -o LANG-1100: Avoid memory allocation when using date formating to StringBuffer. +o LANG-1100: Avoid memory allocation when using date formatting to StringBuffer. Thanks to mbracher. o LANG-935: Possible performance improvement on string escape functions. Thanks to Fabian Lange, Thomas Neidhart. @@ -1400,7 +1400,7 @@ NEW FEATURES ============== o LANG-801: Add Conversion utility to convert between data types on byte level -o LANG-760: Add API StringUtils.toString(byte[] intput, String charsetName) +o LANG-760: Add API StringUtils.toString(byte[] input, String charsetName) o LANG-756: Add APIs ClassUtils.isPrimitiveWrapper(Class) and isPrimitiveOrWrapper(Class) o LANG-695: SystemUtils.IS_OS_UNIX doesn't recognize FreeBSD as a Unix system @@ -1574,7 +1574,7 @@ o LANG-645: FastDateFormat.format() outputs incorrect week of year because o LANG-646: StringEscapeUtils.unescapeJava doesn't handle octal escapes and Unicode with extra u o LANG-656: Example StringUtils.indexOfAnyBut("zzabyycdxx", '') = 0 incorrect -o LANG-658: Some Entitys like Ö are not matched properly against its +o LANG-658: Some entities like Ö are not matched properly against its ISO8859-1 representation o LANG-659: EntityArrays typo: {"\u2122", "−"}, // minus sign, U+2212 ISOtech diff --git a/src/changes/changes.xml b/src/changes/changes.xml index e63d263ce..15d4b14eb 100644 --- a/src/changes/changes.xml +++ b/src/changes/changes.xml @@ -296,7 +296,7 @@ The type attribute can be add,update,fix,remove. Add ObjectUtils.toString(Object, Supplier<String>). Fixed Javadocs for setTestRecursive() #556. ToStringBuilder.reflectionToString - Wrong JSON format when object has a List of Enum. - [JSON string for maps] ToStringBuilder.reflectionToString doesnt render nested maps correctly. + [JSON string for maps] ToStringBuilder.reflectionToString doesn't render nested maps correctly. Make org.apache.commons.lang3.CharSequenceUtils.toCharArray(CharSequence) public. Add org.apache.commons.lang3.StringUtils.substringAfter(String, int). Add org.apache.commons.lang3.StringUtils.substringAfterLast(String, int). @@ -373,7 +373,7 @@ The type attribute can be add,update,fix,remove. Avoid unnecessary allocation in StringUtils.wrapIfMissing. #496. Internally use Validate.notNull(foo, ...) instead of Validate.isTrue(foo != null, ...). Add 1 and 0 in toBooleanObject(final String str) #502. - Remove an redundant argument check in NumberUtils #504. + Remove a redundant argument check in NumberUtils #504. Deprecate org.apache.commons.lang3.ArrayUtils.removeAllOccurences(*) for org.apache.commons.lang3.ArrayUtils.removeAllOccurrences(*). @@ -421,7 +421,7 @@ The type attribute can be add,update,fix,remove. org.apache.commons.lang3.SystemUtils should not write to System.err. Add RegexUtils class instead of overloading methods in StringUtils that take a regex to take precompiled Pattern. StringUtils.join() with support for List<?> with configurable start/end indices. - Methods for getting first non empty or non blank value + Methods for getting first non-empty or non-blank value Remove checks for java versions below the minimum supported one Null/index safe get methods for ArrayUtils Rounding utilities for converting to BigDecimal @@ -456,7 +456,7 @@ The type attribute can be add,update,fix,remove. LocaleUtils#toLocale does not support language followed by UN M.49 numeric-3 area code followed by variant Clarify or improve behavior of int-based indexOf methods in StringUtils Add method for converting string to an array of code points - RandomStringUtils random method can overflow and return characters outside of specified range + RandomStringUtils random method can overflow and return characters outside the specified range Add methods to insert arrays into arrays at an index WordUtils.wrap throws StringIndexOutOfBoundsException RandomStringUtils#random can enter infinite loop if end parameter is to small @@ -471,7 +471,7 @@ The type attribute can be add,update,fix,remove. Add StringUtils#unwrap Add support for recursive comparison to EqualsBuilder#reflectionEquals Add a reflection-based variant of DiffBuilder - Implementation of a Memomizer + Implementation of a Memoizer Add ArrayUtils#toStringArray method StringUtils#abbreviate should support 'custom ellipses' parameter Add StringUtils#isAllEmpty and #isAllBlank methods @@ -530,7 +530,7 @@ The type attribute can be add,update,fix,remove. Optimize BitField constructor implementation Improve CharSetUtils.squeeze() performance Add RandomStringUtils#randomGraph and #randomPrint which match corresponding regular expression class - StringUtils#startsWithAny/endsWithAny is case sensitive - documented as case insensitive + StringUtils#startsWithAny/endsWithAny is case-sensitive - documented as case insensitive Add StopWatch#getTime(TimeUnit) Add methods to ObjectUtils class to check for null elements in the array Prefer Throwable.getCause() in ExceptionUtils.getCause() @@ -545,11 +545,11 @@ The type attribute can be add,update,fix,remove. EqualsBuilder.append(Object,Object) is too big to be inlined, which prevents whole builder to be scalarized NumberUtils.createNumber() behaves inconsistently with NumberUtils.isNumber() Add support for varargs in ConstructorUtils, MemberUtils, and MethodUtils - Add methods to check numbers against NaN and inifinite to Validate + Add methods to check numbers against NaN and infinite to Validate Fix for incorrect comment on StringUtils.containsIgnoreCase method Fix typo on appendIfMissing javadoc Add tests for missed branches in DateUtils - parseDateStrictly does't pass specified locale + parseDateStrictly doesn't pass specified locale FastDateFormat doesn't respect summer daylight in some localized strings z/OS identification in SystemUtils StringUtils#startsWithAny has error in Javadoc @@ -619,7 +619,7 @@ The type attribute can be add,update,fix,remove. Make logic for comparing OS versions in SystemUtils smarter Shutdown thread pools in test cases FastDateParser and FastDatePrinter support 'X' format - Avoid memory allocation when using date formating to StringBuffer + Avoid memory allocation when using date formatting to StringBuffer Possible performance improvement on string escape functions Exception while using ExtendedMessageFormat and escaping braces Avoid String allocation in StrBuilder.append(CharSequence) @@ -627,7 +627,7 @@ The type attribute can be add,update,fix,remove. Update org.easymock:easymock to 3.3.1 Update maven-pmd-plugin to 3.4 Update maven-antrun-plugin to 1.8 - Wrong formating of time zones with daylight saving time in FastDatePrinter + Wrong formatting of time zones with daylight saving time in FastDatePrinter Performance improvements for StringEscapeUtils Add ClassUtils.getAbbreviatedName() FastDateParser does not set error indication in ParsePosition @@ -817,7 +817,7 @@ The type attribute can be add,update,fix,remove. - Add API StringUtils.toString(byte[] intput, String charsetName) + Add API StringUtils.toString(byte[] input, String charsetName) Add an example with whitespace in StringUtils.defaultIfEmpty Add APIs ClassUtils.isPrimitiveWrapper(Class<?>) and isPrimitiveOrWrapper(Class<?>) Fix createLong() so it behaves like createInteger() @@ -870,7 +870,7 @@ The type attribute can be add,update,fix,remove. StringUtils.isAlpha, isAlphanumeric and isNumeric now return false for "". Add support for ConcurrentMap.putIfAbsent(). Documented potential NPE if auto-boxing occurs for some BooleanUtils methods. - DateUtils.isSameLocalTime compares using 12 hour clock and not 24 hour. + DateUtils.isSameLocalTime compares using 12-hour clock and not 24-hour. Extend exception handling in ConcurrentUtils to runtime exceptions. SystemUtils.getJavaVersionAsFloat throws StringIndexOutOfBoundsException on Android runtime/Dalvik VM. WordUtils.abbreviate() removed. @@ -882,7 +882,7 @@ The type attribute can be add,update,fix,remove. Add a Null-safe compare() method to ObjectUtils. NumberUtils.isNumber(String) is not right when the String is "1.1L". EntityArrays typo: {"\u2122", "&minus;"}, // minus sign, U+2212 ISOtech. - Some Entitys like &Ouml; are not matched properly against its ISO8859-1 representation. + Some entities like &Ouml; are not matched properly against its ISO8859-1 representation. Example StringUtils.indexOfAnyBut("zzabyycdxx", '') = 0 incorrect. Add StringUtils.defaultIfBlank(). Provide a very basic ConcurrentInitializer implementation. @@ -1004,7 +1004,7 @@ The type attribute can be add,update,fix,remove. MemberUtils: getMatchingAccessibleMethod does not correctly handle inheritance and method overloading. Javadoc is incorrect for lastIndexOf() method. Javadoc for HashCodeBuilder.append(boolean) does not match implementation. - Javadoc StringUtils.left() claims to throw an exception on negative lenth, but doesn't. + Javadoc StringUtils.left() claims to throw an exception on negative length, but doesn't. Javadoc - document thread safety. Test for StringUtils replaceChars() icelandic characters. @@ -1048,7 +1048,7 @@ The type attribute can be add,update,fix,remove. FastDateFormat - call getTime() on a calendar to ensure timezone is in the right state. FastDateFormat - Remove unused field. LocaleUtils - Initialization of available locales in LocaleUtils can be deferred. - NumberUtils - createNumber() thows a StringIndexOutOfBoundsException when only an "l" is passed in. + NumberUtils - createNumber() throws a StringIndexOutOfBoundsException when only an "l" is passed in. NumberUtils - isNumber(String) and createNumber(String) both modified to support '2.'. StringUtils - improve handling of case-insensitive Strings. StringUtils - replaceEach() no longer NPEs when null appears in the last String[]. @@ -1104,7 +1104,7 @@ The type attribute can be add,update,fix,remove. Calculating A date fragment in any time-unit. Memory usage improvement for StringUtils#getLevenshteinDistance(). Add ExtendedMessageFormat to org.apache.commons.lang.text. - StringEscapeUtils.escapeJavaScript() method did not escape '/' into '\/', it will make IE render page uncorrectly. + StringEscapeUtils.escapeJavaScript() method did not escape '/' into '\/', it will make IE render page incorrectly. Add toArray() method to IntRange and LongRange classes. add SystemUtils.IS_OS_WINDOWS_VISTA field. Pointless synchronized in ThreadLocal.initialValue should be removed. @@ -1115,9 +1115,9 @@ The type attribute can be add,update,fix,remove. - Use of enum prevents a classloader from being garbage collected resuling in out of memory exceptions. + Use of enum prevents a classloader from being garbage collected resulting in out of memory exceptions. NumberUtils.max(byte[]) and NumberUtils.min(byte[]) are missing. - Null-safe comparison methods for finding most recent / least recent dates. + Null-safe comparison methods for finding the most recent / least recent dates. StopWatch: suspend() acts as split(), if followed by stop(). StrBuilder.replaceAll and StrBuilder.deleteAll can throw ArrayIndexOutOfBoundsException. Bug in method appendFixedWidthPadRight of class StrBuilder causes an ArrayIndexOutOfBoundsException. @@ -1207,7 +1207,7 @@ The type attribute can be add,update,fix,remove. New class proposal: CharacterEncoding. SystemUtils fails init on HP-UX. Javadoc - 'four basic XML entities' should be 5 (apos is missing). - o.a.c.lang.enum.ValuedEnum: 'enum'is a keyword in JDK1.5.0. + o.a.c.lang.enum.ValuedEnum: 'enum' is a keyword in JDK 1.5.0. StringEscapeUtils.unescapeHtml() doesn't handle an empty entity. EqualsBuilder.append(Object[], Object[]) incorrectly checks that rhs[i] is instance of lhs[i]'s class. Method enums.Enum.equals(Object o) doesn't work correctly. @@ -1244,7 +1244,7 @@ The type attribute can be add,update,fix,remove. Add convenience format(long) methods to FastDateFormat. Enum's outer class may not be loaded for EnumUtils. WordUtils.capitalizeFully(String str) should take a delimiter. - Make Javadoc crosslinking configurable. + Make Javadoc cross-linking configurable. Minor Javadoc fixes for StringUtils.contains(String, String). Error in Javadoc for StringUtils.chomp(String, String). StringUtils.defaultString: Documentation error. @@ -1293,7 +1293,7 @@ The type attribute can be add,update,fix,remove. test.time fails in Japanese (non-us) locale. NumberUtils.isNumber allows illegal trailing characters. Improve Javadoc and overflow behavior of Fraction. - RandomStringUtils infloops with length > 1. + RandomStringUtils infinite loop with length > 1. test.lang fails if compiled with non iso-8859-1 locales. SystemUtils does not play nice in an Applet. time unit tests fail on Sundays. diff --git a/src/conf/spotbugs-exclude-filter.xml b/src/conf/spotbugs-exclude-filter.xml index 592381ba3..4d609e71e 100644 --- a/src/conf/spotbugs-exclude-filter.xml +++ b/src/conf/spotbugs-exclude-filter.xml @@ -134,7 +134,7 @@ + in switch statements. All the excluded methods have switch statements that contain a default case. --> diff --git a/src/site/resources/release-notes/RELEASE-NOTES-2.0.txt b/src/site/resources/release-notes/RELEASE-NOTES-2.0.txt index c17c04f8b..000c90c8a 100644 --- a/src/site/resources/release-notes/RELEASE-NOTES-2.0.txt +++ b/src/site/resources/release-notes/RELEASE-NOTES-2.0.txt @@ -156,7 +156,7 @@ ID Sev Pri Plt Owner State Result Summary 17654 EnumUtils nit: The import java.io.Serializable is never used 17882 Add join(..., char c) to StringUtils (and some performance f 18077 StringUtils.chomp does not match Perl -18723 RandomStringUtils infloops with length < 1 +18723 RandomStringUtils infinite loop with length < 1 18836 test.lang fails if compiled with non iso-8859-1 locales 18948 Resurrect the WordWrapUtils from commons-sandbox/utils 19296 [Lang] What to do with FastDateFormat unused private constru diff --git a/src/site/resources/release-notes/RELEASE-NOTES-2.1.txt b/src/site/resources/release-notes/RELEASE-NOTES-2.1.txt index 3c363258f..6f7cb1b99 100644 --- a/src/site/resources/release-notes/RELEASE-NOTES-2.1.txt +++ b/src/site/resources/release-notes/RELEASE-NOTES-2.1.txt @@ -32,7 +32,7 @@ INCOMPATIBLE CHANGES: - 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 (ie. its a bug fix). +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. @@ -48,7 +48,7 @@ for more details. DEPRECATIONS: -- The enum package has been renamed to enums for JDK1.5 compilance. +- 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. @@ -139,7 +139,7 @@ BUG FIXES: 30929 Nestable.indexOfThrowable(Class) uses Class.equals() to match 31395 DateUtils.truncate oddity at the far end of the Date spectrum 31478 Compile error with JDK 5 "enum" is a keyword -31572 o.a.c.lang.enum.ValuedEnum: 'enum'is a keyword in JDK1.5.0 +31572 o.a.c.lang.enum.ValuedEnum: 'enum' is a keyword in JDK 1.5.0 31933 ToStringStyle setArrayEnd handled null incorrectly 32133 SystemUtils fails init on HP-UX 32198 Error in Javadoc for StringUtils.chomp(String, String) diff --git a/src/site/resources/release-notes/RELEASE-NOTES-2.2.txt b/src/site/resources/release-notes/RELEASE-NOTES-2.2.txt index 38e701710..7e19a18fe 100644 --- a/src/site/resources/release-notes/RELEASE-NOTES-2.2.txt +++ b/src/site/resources/release-notes/RELEASE-NOTES-2.2.txt @@ -35,7 +35,7 @@ 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 (ie. its a bug fix). +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. @@ -54,7 +54,7 @@ DEPRECATIONS FROM 2.1 to 2.2: DEPRECATIONS FROM 2.0 to 2.1: -- The enum package has been renamed to enums for JDK1.5 compilance. +- 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. @@ -78,7 +78,7 @@ LANG-50 Replace Clover with Cobertura LANG-59 DateUtils.truncate method is buggy when dealing with DST switching hours LANG-100 RandomStringUtils.random() family of methods create invalid unicode sequences LANG-105 ExceptionUtils goes into infinite loop in getThrowables is throwable.getCause() == throwable -LANG-106 StringUtils#getLevenshteinDistance() performance is sub-optimal +LANG-106 StringUtils#getLevenshteinDistance() performance is suboptimal LANG-112 Wrong length check in StrTokenizer.StringMatcher LANG-117 FastDateFormat: wrong format for date "01.01.1000" LANG-122 EscapeUtil.escapeHtml() should clarify that it does not escape ' chars to ' diff --git a/src/site/resources/release-notes/RELEASE-NOTES-2.3.txt b/src/site/resources/release-notes/RELEASE-NOTES-2.3.txt index f3e774eb9..94d2a069d 100644 --- a/src/site/resources/release-notes/RELEASE-NOTES-2.3.txt +++ b/src/site/resources/release-notes/RELEASE-NOTES-2.3.txt @@ -37,7 +37,7 @@ 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 (ie. its a bug fix). +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. @@ -60,7 +60,7 @@ DEPRECATIONS FROM 2.1 to 2.2: DEPRECATIONS FROM 2.0 to 2.1: -- The enum package has been renamed to enums for JDK1.5 compilance. +- 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. @@ -75,7 +75,7 @@ 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 resuling in out of memory exceptions. + * [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 @@ -98,7 +98,7 @@ IMPROVEMENTS IN 2.3: * [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 most recent / least recent dates. + * [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 diff --git a/src/site/resources/release-notes/RELEASE-NOTES-2.4.txt b/src/site/resources/release-notes/RELEASE-NOTES-2.4.txt index a54b34143..8eeea67a6 100644 --- a/src/site/resources/release-notes/RELEASE-NOTES-2.4.txt +++ b/src/site/resources/release-notes/RELEASE-NOTES-2.4.txt @@ -43,7 +43,7 @@ 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 (ie. its a bug fix). +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. @@ -74,7 +74,7 @@ DEPRECATIONS FROM 2.1 to 2.2: DEPRECATIONS FROM 2.0 to 2.1: -- The enum package has been renamed to enums for JDK1.5 compilance. +- 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. @@ -94,7 +94,7 @@ BUG FIXES IN 2.4: * [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 uncorrectly + * [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 diff --git a/src/site/resources/release-notes/RELEASE-NOTES-2.5.txt b/src/site/resources/release-notes/RELEASE-NOTES-2.5.txt index 6fe9ebd26..c489ae479 100644 --- a/src/site/resources/release-notes/RELEASE-NOTES-2.5.txt +++ b/src/site/resources/release-notes/RELEASE-NOTES-2.5.txt @@ -77,7 +77,7 @@ BUG FIXES IN 2.5 * [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-457] - NumberUtils - createNumber() throws 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[] diff --git a/src/site/resources/release-notes/RELEASE-NOTES-2.6.txt b/src/site/resources/release-notes/RELEASE-NOTES-2.6.txt index a48d9d120..3f4674830 100644 --- a/src/site/resources/release-notes/RELEASE-NOTES-2.6.txt +++ b/src/site/resources/release-notes/RELEASE-NOTES-2.6.txt @@ -68,7 +68,7 @@ OTHER CHANGES IN 2.6 * [LANG-600] - Javadoc is incorrect for lastIndexOf() method * [LANG-628] - Javadoc for HashCodeBuilder.append(boolean) does not match implementation - * [LANG-643] - Javadoc StringUtils.left() claims to throw an exception on negative lenth, but doesn't + * [LANG-643] - Javadoc StringUtils.left() claims to throw an exception on negative length, but doesn't * [LANG-370] - Javadoc - document thread safety * [LANG-623] - Test for StringUtils replaceChars() icelandic characters diff --git a/src/site/resources/release-notes/RELEASE-NOTES-3.0.txt b/src/site/resources/release-notes/RELEASE-NOTES-3.0.txt index 9a3e12373..b6b0e13b0 100644 --- a/src/site/resources/release-notes/RELEASE-NOTES-3.0.txt +++ b/src/site/resources/release-notes/RELEASE-NOTES-3.0.txt @@ -154,14 +154,14 @@ BUG FIXES IN 3.0 [LANG-645] FastDateFormat.format() outputs incorrect week of year because locale isn't respected [LANG-646] StringEscapeUtils.unescapeJava doesn't handle octal escapes and Unicode with extra u [LANG-656] Example StringUtils.indexOfAnyBut("zzabyycdxx", '') = 0 incorrect - [LANG-658] Some Entitys like Ö are not matched properly against its ISO8859-1 representation + [LANG-658] Some entities like Ö are not matched properly against its ISO8859-1 representation [LANG-659] EntityArrays typo: {"\u2122", "−"}, // minus sign, U+2212 ISOtech [LANG-66] StringEscaper.escapeXml() escapes characters > 0x7f. [LANG-662] org.apache.commons.lang3.math.Fraction does not reduce (Integer.MIN_VALUE, 2^k) [LANG-663] org.apache.commons.lang3.math.Fraction does not always succeed in multiplyBy and divideBy [LANG-664] NumberUtils.isNumber(String) is not right when the String is "1.1L" [LANG-672] Doc bug in DateUtils#ceiling - [LANG-677] DateUtils.isSameLocalTime compares using 12 hour clock and not 24 hour + [LANG-677] DateUtils.isSameLocalTime compares using 12-hour clock and not 24-hour [LANG-685] EqualsBuilder synchronizes on HashCodeBuilder. [LANG-703] StringUtils.join throws NPE when toString returns null for one of objects in collection [LANG-710] StringIndexOutOfBoundsException when calling unescapeHtml4("") diff --git a/src/site/resources/release-notes/RELEASE-NOTES-3.1.txt b/src/site/resources/release-notes/RELEASE-NOTES-3.1.txt index c8d4ffd67..c20d3cc96 100644 --- a/src/site/resources/release-notes/RELEASE-NOTES-3.1.txt +++ b/src/site/resources/release-notes/RELEASE-NOTES-3.1.txt @@ -36,7 +36,7 @@ For the advice on upgrading from 2.x to 3.x, see the following page: CHANGES IN 3.1 ================ - [LANG-760] Add API StringUtils.toString(byte[] intput, String charsetName) + [LANG-760] Add API StringUtils.toString(byte[] input, String charsetName) [LANG-756] Add APIs ClassUtils.isPrimitiveWrapper(Class) and isPrimitiveOrWrapper(Class) [LANG-758] Add an example with whitespace in StringUtils.defaultIfEmpty [LANG-752] Fix createLong() so it behaves like createInteger() diff --git a/src/site/resources/release-notes/RELEASE-NOTES-3.10.txt b/src/site/resources/release-notes/RELEASE-NOTES-3.10.txt index ba8b6bf5e..c77df7fa2 100644 --- a/src/site/resources/release-notes/RELEASE-NOTES-3.10.txt +++ b/src/site/resources/release-notes/RELEASE-NOTES-3.10.txt @@ -107,14 +107,14 @@ o Reuse own code in Functions.java #493. Thanks to Peter Verhas. o LANG-1523: Avoid unnecessary allocation in StringUtils.wrapIfMissing. #496. Thanks to Edgar Asatryan, Bruno P. Kinoshita, Gary Gregory. o LANG-1525: Internally use Validate.notNull(foo, ...) instead of Validate.isTrue(foo != null, ...). Thanks to Edgar Asatryan, Bruno P. Kinoshita, Gary Gregory. o LANG-1526: Add 1 and 0 in toBooleanObject(final String str) #502. Thanks to Dominik Schramm. -o LANG-1527: Remove an redundant argument check in NumberUtils #504. Thanks to Pengyu Nie. +o LANG-1527: Remove a redundant argument check in NumberUtils #504. Thanks to Pengyu Nie. o LANG-1529: Deprecate org.apache.commons.lang3.ArrayUtils.removeAllOccurences(*) for org.apache.commons.lang3.ArrayUtils.removeAllOccurrences(*). Thanks to Gary Gregory, BillCindy, Bruno P. Kinoshita. Historical list of changes: https://commons.apache.org/proper/commons-lang/changes-report.html For complete information on Apache Commons Lang, including instructions on how to submit bug reports, -patches, or suggestions for improvement, see the Apache Apache Commons Lang website: +patches, or suggestions for improvement, see the Apache Commons Lang website: https://commons.apache.org/proper/commons-lang/ diff --git a/src/site/resources/release-notes/RELEASE-NOTES-3.2.1.txt b/src/site/resources/release-notes/RELEASE-NOTES-3.2.1.txt index 3cfdb8366..bb554a629 100644 --- a/src/site/resources/release-notes/RELEASE-NOTES-3.2.1.txt +++ b/src/site/resources/release-notes/RELEASE-NOTES-3.2.1.txt @@ -208,7 +208,7 @@ NEW FEATURES ============== o LANG-801: Add Conversion utility to convert between data types on byte level -o LANG-760: Add API StringUtils.toString(byte[] intput, String charsetName) +o LANG-760: Add API StringUtils.toString(byte[] input, String charsetName) o LANG-756: Add APIs ClassUtils.isPrimitiveWrapper(Class) and isPrimitiveOrWrapper(Class) o LANG-695: SystemUtils.IS_OS_UNIX doesn't recognize FreeBSD as a Unix system @@ -381,7 +381,7 @@ o LANG-645: FastDateFormat.format() outputs incorrect week of year because o LANG-646: StringEscapeUtils.unescapeJava doesn't handle octal escapes and Unicode with extra u o LANG-656: Example StringUtils.indexOfAnyBut("zzabyycdxx", '') = 0 incorrect -o LANG-658: Some Entitys like Ö are not matched properly against its +o LANG-658: Some entities like Ö are not matched properly against its ISO8859-1 representation o LANG-659: EntityArrays typo: {"\u2122", "−"}, // minus sign, U+2212 ISOtech @@ -393,8 +393,8 @@ o LANG-663: org.apache.commons.lang3.math.Fraction does not always succeed in o LANG-664: NumberUtils.isNumber(String) is not right when the String is "1.1L" o LANG-672: Doc bug in DateUtils#ceiling -o LANG-677: DateUtils.isSameLocalTime compares using 12 hour clock and not - 24 hour +o LANG-677: DateUtils.isSameLocalTime compares using 12-hour clock and not + 24-hour o LANG-685: EqualsBuilder synchronizes on HashCodeBuilder. o LANG-703: StringUtils.join throws NPE when toString returns null for one of objects in collection diff --git a/src/site/resources/release-notes/RELEASE-NOTES-3.2.txt b/src/site/resources/release-notes/RELEASE-NOTES-3.2.txt index c19d4c2df..f686b0852 100644 --- a/src/site/resources/release-notes/RELEASE-NOTES-3.2.txt +++ b/src/site/resources/release-notes/RELEASE-NOTES-3.2.txt @@ -196,7 +196,7 @@ NEW FEATURES ============== o LANG-801: Add Conversion utility to convert between data types on byte level -o LANG-760: Add API StringUtils.toString(byte[] intput, String charsetName) +o LANG-760: Add API StringUtils.toString(byte[] input, String charsetName) o LANG-756: Add APIs ClassUtils.isPrimitiveWrapper(Class) and isPrimitiveOrWrapper(Class) o LANG-695: SystemUtils.IS_OS_UNIX doesn't recognize FreeBSD as a Unix system @@ -369,7 +369,7 @@ o LANG-645: FastDateFormat.format() outputs incorrect week of year because o LANG-646: StringEscapeUtils.unescapeJava doesn't handle octal escapes and Unicode with extra u o LANG-656: Example StringUtils.indexOfAnyBut("zzabyycdxx", '') = 0 incorrect -o LANG-658: Some Entitys like Ö are not matched properly against its +o LANG-658: Some entities like Ö are not matched properly against its ISO8859-1 representation o LANG-659: EntityArrays typo: {"\u2122", "−"}, // minus sign, U+2212 ISOtech @@ -381,8 +381,8 @@ o LANG-663: org.apache.commons.lang3.math.Fraction does not always succeed in o LANG-664: NumberUtils.isNumber(String) is not right when the String is "1.1L" o LANG-672: Doc bug in DateUtils#ceiling -o LANG-677: DateUtils.isSameLocalTime compares using 12 hour clock and not - 24 hour +o LANG-677: DateUtils.isSameLocalTime compares using 12-hour clock and not + 24-hour o LANG-685: EqualsBuilder synchronizes on HashCodeBuilder. o LANG-703: StringUtils.join throws NPE when toString returns null for one of objects in collection diff --git a/src/site/resources/release-notes/RELEASE-NOTES-3.3.1.txt b/src/site/resources/release-notes/RELEASE-NOTES-3.3.1.txt index 20d195a69..0a42081ff 100644 --- a/src/site/resources/release-notes/RELEASE-NOTES-3.3.1.txt +++ b/src/site/resources/release-notes/RELEASE-NOTES-3.3.1.txt @@ -287,7 +287,7 @@ NEW FEATURES ============== o LANG-801: Add Conversion utility to convert between data types on byte level -o LANG-760: Add API StringUtils.toString(byte[] intput, String charsetName) +o LANG-760: Add API StringUtils.toString(byte[] input, String charsetName) o LANG-756: Add APIs ClassUtils.isPrimitiveWrapper(Class) and isPrimitiveOrWrapper(Class) o LANG-695: SystemUtils.IS_OS_UNIX doesn't recognize FreeBSD as a Unix system @@ -460,7 +460,7 @@ o LANG-645: FastDateFormat.format() outputs incorrect week of year because o LANG-646: StringEscapeUtils.unescapeJava doesn't handle octal escapes and Unicode with extra u o LANG-656: Example StringUtils.indexOfAnyBut("zzabyycdxx", '') = 0 incorrect -o LANG-658: Some Entitys like Ö are not matched properly against its +o LANG-658: Some entities like Ö are not matched properly against its ISO8859-1 representation o LANG-659: EntityArrays typo: {"\u2122", "−"}, // minus sign, U+2212 ISOtech @@ -472,8 +472,8 @@ o LANG-663: org.apache.commons.lang3.math.Fraction does not always succeed in o LANG-664: NumberUtils.isNumber(String) is not right when the String is "1.1L" o LANG-672: Doc bug in DateUtils#ceiling -o LANG-677: DateUtils.isSameLocalTime compares using 12 hour clock and not - 24 hour +o LANG-677: DateUtils.isSameLocalTime compares using 12-hour clock and not + 24-hour o LANG-685: EqualsBuilder synchronizes on HashCodeBuilder. o LANG-703: StringUtils.join throws NPE when toString returns null for one of objects in collection diff --git a/src/site/resources/release-notes/RELEASE-NOTES-3.3.2.txt b/src/site/resources/release-notes/RELEASE-NOTES-3.3.2.txt index 364f20f2a..fb498b2ef 100644 --- a/src/site/resources/release-notes/RELEASE-NOTES-3.3.2.txt +++ b/src/site/resources/release-notes/RELEASE-NOTES-3.3.2.txt @@ -300,7 +300,7 @@ NEW FEATURES ============== o LANG-801: Add Conversion utility to convert between data types on byte level -o LANG-760: Add API StringUtils.toString(byte[] intput, String charsetName) +o LANG-760: Add API StringUtils.toString(byte[] input, String charsetName) o LANG-756: Add APIs ClassUtils.isPrimitiveWrapper(Class) and isPrimitiveOrWrapper(Class) o LANG-695: SystemUtils.IS_OS_UNIX doesn't recognize FreeBSD as a Unix system @@ -473,7 +473,7 @@ o LANG-645: FastDateFormat.format() outputs incorrect week of year because o LANG-646: StringEscapeUtils.unescapeJava doesn't handle octal escapes and Unicode with extra u o LANG-656: Example StringUtils.indexOfAnyBut("zzabyycdxx", '') = 0 incorrect -o LANG-658: Some Entitys like Ö are not matched properly against its +o LANG-658: Some entities like Ö are not matched properly against its ISO8859-1 representation o LANG-659: EntityArrays typo: {"\u2122", "−"}, // minus sign, U+2212 ISOtech @@ -485,8 +485,8 @@ o LANG-663: org.apache.commons.lang3.math.Fraction does not always succeed in o LANG-664: NumberUtils.isNumber(String) is not right when the String is "1.1L" o LANG-672: Doc bug in DateUtils#ceiling -o LANG-677: DateUtils.isSameLocalTime compares using 12 hour clock and not - 24 hour +o LANG-677: DateUtils.isSameLocalTime compares using 12-hour clock and not + 24-hour o LANG-685: EqualsBuilder synchronizes on HashCodeBuilder. o LANG-703: StringUtils.join throws NPE when toString returns null for one of objects in collection diff --git a/src/site/resources/release-notes/RELEASE-NOTES-3.3.txt b/src/site/resources/release-notes/RELEASE-NOTES-3.3.txt index 69d30764c..77a28fb19 100644 --- a/src/site/resources/release-notes/RELEASE-NOTES-3.3.txt +++ b/src/site/resources/release-notes/RELEASE-NOTES-3.3.txt @@ -273,7 +273,7 @@ NEW FEATURES ============== o LANG-801: Add Conversion utility to convert between data types on byte level -o LANG-760: Add API StringUtils.toString(byte[] intput, String charsetName) +o LANG-760: Add API StringUtils.toString(byte[] input, String charsetName) o LANG-756: Add APIs ClassUtils.isPrimitiveWrapper(Class) and isPrimitiveOrWrapper(Class) o LANG-695: SystemUtils.IS_OS_UNIX doesn't recognize FreeBSD as a Unix system @@ -446,7 +446,7 @@ o LANG-645: FastDateFormat.format() outputs incorrect week of year because o LANG-646: StringEscapeUtils.unescapeJava doesn't handle octal escapes and Unicode with extra u o LANG-656: Example StringUtils.indexOfAnyBut("zzabyycdxx", '') = 0 incorrect -o LANG-658: Some Entitys like Ö are not matched properly against its +o LANG-658: Some entities like Ö are not matched properly against its ISO8859-1 representation o LANG-659: EntityArrays typo: {"\u2122", "−"}, // minus sign, U+2212 ISOtech @@ -458,8 +458,8 @@ o LANG-663: org.apache.commons.lang3.math.Fraction does not always succeed in o LANG-664: NumberUtils.isNumber(String) is not right when the String is "1.1L" o LANG-672: Doc bug in DateUtils#ceiling -o LANG-677: DateUtils.isSameLocalTime compares using 12 hour clock and not - 24 hour +o LANG-677: DateUtils.isSameLocalTime compares using 12-hour clock and not + 24-hour o LANG-685: EqualsBuilder synchronizes on HashCodeBuilder. o LANG-703: StringUtils.join throws NPE when toString returns null for one of objects in collection diff --git a/src/site/resources/release-notes/RELEASE-NOTES-3.4.txt b/src/site/resources/release-notes/RELEASE-NOTES-3.4.txt index 43b059e29..afbcc4a1d 100644 --- a/src/site/resources/release-notes/RELEASE-NOTES-3.4.txt +++ b/src/site/resources/release-notes/RELEASE-NOTES-3.4.txt @@ -83,7 +83,7 @@ o LANG-794: SystemUtils.IS_OS_WINDOWS_2008, VISTA are incorrect. Thanks to o LANG-1104: Parse test fails for TimeZone America/Sao_Paulo o LANG-948: Exception while using ExtendedMessageFormat and escaping braces. Thanks to Andrey Khobnya. -o LANG-1092: Wrong formating of time zones with daylight saving time in +o LANG-1092: Wrong formatting of time zones with daylight saving time in FastDatePrinter o LANG-1090: FastDateParser does not set error indication in ParsePosition o LANG-1089: FastDateParser does not handle excess hours as per @@ -113,7 +113,7 @@ o LANG-1000: ParseException when trying to parse UTC dates with Z as zone o LANG-1035: Javadoc for EqualsBuilder.reflectionEquals() is unclear o LANG-1001: ISO 8601 misspelled throughout the Javadocs. Thanks to Michael Osipov. -o LANG-1088: FastDateParser should be case insensitive +o LANG-1088: FastDateParser should be case-insensitive o LANG-995: Fix bug with stripping spaces on last line in WordUtils.wrap(). Thanks to Andrey Khobnya. @@ -123,7 +123,7 @@ CHANGES o LANG-1102: Make logic for comparing OS versions in SystemUtils smarter o LANG-1091: Shutdown thread pools in test cases. Thanks to Fabian Lange. o LANG-1101: FastDateParser and FastDatePrinter support 'X' format -o LANG-1100: Avoid memory allocation when using date formating to StringBuffer. +o LANG-1100: Avoid memory allocation when using date formatting to StringBuffer. Thanks to mbracher. o LANG-935: Possible performance improvement on string escape functions. Thanks to Fabian Lange, Thomas Neidhart. @@ -433,7 +433,7 @@ NEW FEATURES ============== o LANG-801: Add Conversion utility to convert between data types on byte level -o LANG-760: Add API StringUtils.toString(byte[] intput, String charsetName) +o LANG-760: Add API StringUtils.toString(byte[] input, String charsetName) o LANG-756: Add APIs ClassUtils.isPrimitiveWrapper(Class) and isPrimitiveOrWrapper(Class) o LANG-695: SystemUtils.IS_OS_UNIX doesn't recognize FreeBSD as a Unix system @@ -606,7 +606,7 @@ o LANG-645: FastDateFormat.format() outputs incorrect week of year because o LANG-646: StringEscapeUtils.unescapeJava doesn't handle octal escapes and Unicode with extra u o LANG-656: Example StringUtils.indexOfAnyBut("zzabyycdxx", '') = 0 incorrect -o LANG-658: Some Entitys like Ö are not matched properly against its +o LANG-658: Some entities like Ö are not matched properly against its ISO8859-1 representation o LANG-659: EntityArrays typo: {"\u2122", "−"}, // minus sign, U+2212 ISOtech @@ -618,8 +618,8 @@ o LANG-663: org.apache.commons.lang3.math.Fraction does not always succeed in o LANG-664: NumberUtils.isNumber(String) is not right when the String is "1.1L" o LANG-672: Doc bug in DateUtils#ceiling -o LANG-677: DateUtils.isSameLocalTime compares using 12 hour clock and not - 24 hour +o LANG-677: DateUtils.isSameLocalTime compares using 12-hour clock and not + 24-hour o LANG-685: EqualsBuilder synchronizes on HashCodeBuilder. o LANG-703: StringUtils.join throws NPE when toString returns null for one of objects in collection diff --git a/src/site/resources/release-notes/RELEASE-NOTES-3.5.txt b/src/site/resources/release-notes/RELEASE-NOTES-3.5.txt index fd14babeb..424585a48 100644 --- a/src/site/resources/release-notes/RELEASE-NOTES-3.5.txt +++ b/src/site/resources/release-notes/RELEASE-NOTES-3.5.txt @@ -28,14 +28,14 @@ o Added Java 9 detection to org.apache.commons.lang3.SystemUtils. o Support for shifting and swapping elements in org.apache.commons.lang3.ArrayUtils. o New methods for generating random strings from different character classes - including alphabetic, alpha-numeric and ASCII added to + including alphabetic, alphanumeric and ASCII added to org.apache.commons.lang3.RandomStringUtils. o Numerous extensions to org.apache.commons.lang3.StringUtils including null safe compare variants, more remove and replace variants, rotation and truncation. o Added org.apache.commons.lang3.ThreadUtils - a utility class to work with instances of java.lang.Thread and java.lang.ThreadGroup. -o Added annotations @EqualsExclude, @HashCodeExclude and @ToStringEclude to +o Added annotations @EqualsExclude, @HashCodeExclude and @ToStringExclude to mark fields which should be ignored by the reflective builders in the org.apache.commons.lang3.builder package. o Support for various modify and retrieve value use cases added to the classes @@ -87,7 +87,7 @@ BUILDING ON JAVA 9 Java 8 introduced the Unicode Consortium's Common Locale Data Repository as alternative source for locale data. Java 9 will use the CLDR provider as default provider for locale data (see http://openjdk.java.net/jeps/252). This -causes an number of locale-sensitive test in Commons Lang to fail. In order +causes a number of locale-sensitive test in Commons Lang to fail. In order to build Commons Lang 3.5 on Java 9, the locale provider has to be set to 'JRE': @@ -133,7 +133,7 @@ o LANG-1168: Add SystemUtils.IS_OS_WINDOWS_10 property. Thanks to Pascal Schumacher. o LANG-1115: Add support for varargs in ConstructorUtils, MemberUtils, and MethodUtils. Thanks to Jim Lloyd and Joe Ferner. -o LANG-1134: Add methods to check numbers against NaN and inifinite to +o LANG-1134: Add methods to check numbers against NaN and infinite to Validate. Thanks to Alan Smithee. o LANG-1220: Add tests for missed branches in DateUtils. Thanks to Casey Scarborough. @@ -204,8 +204,8 @@ o LANG-1244: Fix dead links in StringUtils.getLevenshteinDistance() javadoc. Thanks to jjbankert. o LANG-1242: "\u2284":"?" mapping missing from EntityArrays#HTML40_EXTENDED_ESCAPE. Thanks to Neal Stewart. -o LANG-901: StringUtils#startsWithAny/endsWithAny is case sensitive - - documented as case insensitive. Thanks to Matthew Bartenschlag. +o LANG-901: StringUtils#startsWithAny/endsWithAny is case-sensitive - + documented as case-insensitive. Thanks to Matthew Bartenschlag. o LANG-1232: DiffBuilder: Add null check on fieldName when appending Object or Object[]. Thanks to Nick Manley. o LANG-1178: ArrayUtils.removeAll(Object array, int... indices) should do the @@ -217,7 +217,7 @@ o LANG-1205: NumberUtils.createNumber() behaves inconsistently with o LANG-1222: Fix for incorrect comment on StringUtils.containsIgnoreCase method. Thanks to Adam J. o LANG-1221: Fix typo on appendIfMissing javadoc. Thanks to Pierre Templier. -o LANG-1202: parseDateStrictly does't pass specified locale. Thanks to +o LANG-1202: parseDateStrictly doesn't pass specified locale. Thanks to Markus Jelsma. o LANG-1219: FastDateFormat doesn't respect summer daylight in some localized strings. Thanks to Jarek. @@ -369,7 +369,7 @@ o LANG-794: SystemUtils.IS_OS_WINDOWS_2008, VISTA are incorrect. Thanks to o LANG-1104: Parse test fails for TimeZone America/Sao_Paulo o LANG-948: Exception while using ExtendedMessageFormat and escaping braces. Thanks to Andrey Khobnya. -o LANG-1092: Wrong formating of time zones with daylight saving time in +o LANG-1092: Wrong formatting of time zones with daylight saving time in FastDatePrinter o LANG-1090: FastDateParser does not set error indication in ParsePosition o LANG-1089: FastDateParser does not handle excess hours as per @@ -399,7 +399,7 @@ o LANG-1000: ParseException when trying to parse UTC dates with Z as zone o LANG-1035: Javadoc for EqualsBuilder.reflectionEquals() is unclear o LANG-1001: ISO 8601 misspelled throughout the Javadocs. Thanks to Michael Osipov. -o LANG-1088: FastDateParser should be case insensitive +o LANG-1088: FastDateParser should be case-insensitive o LANG-995: Fix bug with stripping spaces on last line in WordUtils.wrap(). Thanks to Andrey Khobnya. @@ -409,7 +409,7 @@ CHANGES o LANG-1102: Make logic for comparing OS versions in SystemUtils smarter o LANG-1091: Shutdown thread pools in test cases. Thanks to Fabian Lange. o LANG-1101: FastDateParser and FastDatePrinter support 'X' format -o LANG-1100: Avoid memory allocation when using date formating to StringBuffer. +o LANG-1100: Avoid memory allocation when using date formatting to StringBuffer. Thanks to mbracher. o LANG-935: Possible performance improvement on string escape functions. Thanks to Fabian Lange, Thomas Neidhart. @@ -730,7 +730,7 @@ NEW FEATURES ============== o LANG-801: Add Conversion utility to convert between data types on byte level -o LANG-760: Add API StringUtils.toString(byte[] intput, String charsetName) +o LANG-760: Add API StringUtils.toString(byte[] input, String charsetName) o LANG-756: Add APIs ClassUtils.isPrimitiveWrapper(Class) and isPrimitiveOrWrapper(Class) o LANG-695: SystemUtils.IS_OS_UNIX doesn't recognize FreeBSD as a Unix system @@ -904,7 +904,7 @@ o LANG-645: FastDateFormat.format() outputs incorrect week of year because o LANG-646: StringEscapeUtils.unescapeJava doesn't handle octal escapes and Unicode with extra u o LANG-656: Example StringUtils.indexOfAnyBut("zzabyycdxx", '') = 0 incorrect -o LANG-658: Some Entitys like Ö are not matched properly against its +o LANG-658: Some entities like Ö are not matched properly against its ISO8859-1 representation o LANG-659: EntityArrays typo: {"\u2122", "−"}, // minus sign, U+2212 ISOtech @@ -916,8 +916,8 @@ o LANG-663: org.apache.commons.lang3.math.Fraction does not always succeed in o LANG-664: NumberUtils.isNumber(String) is not right when the String is "1.1L" o LANG-672: Doc bug in DateUtils#ceiling -o LANG-677: DateUtils.isSameLocalTime compares using 12 hour clock and not - 24 hour +o LANG-677: DateUtils.isSameLocalTime compares using 12-hour clock and not + 24-hour o LANG-685: EqualsBuilder synchronizes on HashCodeBuilder. o LANG-703: StringUtils.join throws NPE when toString returns null for one of objects in collection diff --git a/src/site/resources/release-notes/RELEASE-NOTES-3.6.txt b/src/site/resources/release-notes/RELEASE-NOTES-3.6.txt index 87a738bfc..a6e545c3f 100644 --- a/src/site/resources/release-notes/RELEASE-NOTES-3.6.txt +++ b/src/site/resources/release-notes/RELEASE-NOTES-3.6.txt @@ -119,7 +119,7 @@ o LANG-660: Add methods to insert arrays into arrays at an index. o LANG-1034: Add support for recursive comparison to EqualsBuilder#reflectionEquals. Thanks to Yathos UG. o LANG-1067: Add a reflection-based variant of DiffBuilder. -o LANG-740: Implementation of a Memomizer. Thanks to James Sawle. +o LANG-740: Implementation of a Memoizer. Thanks to James Sawle. o LANG-1258: Add ArrayUtils#toStringArray method. Thanks to IG, Grzegorz Rożniecki. o LANG-1160: StringUtils#abbreviate should support 'custom ellipses' parameter. @@ -219,7 +219,7 @@ o Numerous extensions to org.apache.commons.lang3.StringUtils including truncation. o Added org.apache.commons.lang3.ThreadUtils - a utility class to work with instances of java.lang.Thread and java.lang.ThreadGroup. -o Added annotations @EqualsExclude, @HashCodeExclude and @ToStringEclude to +o Added annotations @EqualsExclude, @HashCodeExclude and @ToStringExclude to mark fields which should be ignored by the reflective builders in the org.apache.commons.lang3.builder package. o Support for various modify and retrieve value use cases added to the classes @@ -317,7 +317,7 @@ o LANG-1168: Add SystemUtils.IS_OS_WINDOWS_10 property. Thanks to Pascal Schumacher. o LANG-1115: Add support for varargs in ConstructorUtils, MemberUtils, and MethodUtils. Thanks to Jim Lloyd and Joe Ferner. -o LANG-1134: Add methods to check numbers against NaN and inifinite to +o LANG-1134: Add methods to check numbers against NaN and infinite to Validate. Thanks to Alan Smithee. o LANG-1220: Add tests for missed branches in DateUtils. Thanks to Casey Scarborough. @@ -401,7 +401,7 @@ o LANG-1205: NumberUtils.createNumber() behaves inconsistently with o LANG-1222: Fix for incorrect comment on StringUtils.containsIgnoreCase method. Thanks to Adam J. o LANG-1221: Fix typo on appendIfMissing javadoc. Thanks to Pierre Templier. -o LANG-1202: parseDateStrictly does't pass specified locale. Thanks to +o LANG-1202: parseDateStrictly doesn't pass specified locale. Thanks to Markus Jelsma. o LANG-1219: FastDateFormat doesn't respect summer daylight in some localized strings. Thanks to Jarek. @@ -553,7 +553,7 @@ o LANG-794: SystemUtils.IS_OS_WINDOWS_2008, VISTA are incorrect. Thanks to o LANG-1104: Parse test fails for TimeZone America/Sao_Paulo o LANG-948: Exception while using ExtendedMessageFormat and escaping braces. Thanks to Andrey Khobnya. -o LANG-1092: Wrong formating of time zones with daylight saving time in +o LANG-1092: Wrong formatting of time zones with daylight saving time in FastDatePrinter o LANG-1090: FastDateParser does not set error indication in ParsePosition o LANG-1089: FastDateParser does not handle excess hours as per @@ -593,7 +593,7 @@ CHANGES o LANG-1102: Make logic for comparing OS versions in SystemUtils smarter o LANG-1091: Shutdown thread pools in test cases. Thanks to Fabian Lange. o LANG-1101: FastDateParser and FastDatePrinter support 'X' format -o LANG-1100: Avoid memory allocation when using date formating to StringBuffer. +o LANG-1100: Avoid memory allocation when using date formatting to StringBuffer. Thanks to mbracher. o LANG-935: Possible performance improvement on string escape functions. Thanks to Fabian Lange, Thomas Neidhart. @@ -914,7 +914,7 @@ NEW FEATURES ============== o LANG-801: Add Conversion utility to convert between data types on byte level -o LANG-760: Add API StringUtils.toString(byte[] intput, String charsetName) +o LANG-760: Add API StringUtils.toString(byte[] input, String charsetName) o LANG-756: Add APIs ClassUtils.isPrimitiveWrapper(Class) and isPrimitiveOrWrapper(Class) o LANG-695: SystemUtils.IS_OS_UNIX doesn't recognize FreeBSD as a Unix system @@ -1088,7 +1088,7 @@ o LANG-645: FastDateFormat.format() outputs incorrect week of year because o LANG-646: StringEscapeUtils.unescapeJava doesn't handle octal escapes and Unicode with extra u o LANG-656: Example StringUtils.indexOfAnyBut("zzabyycdxx", '') = 0 incorrect -o LANG-658: Some Entitys like Ö are not matched properly against its +o LANG-658: Some entities like Ö are not matched properly against its ISO8859-1 representation o LANG-659: EntityArrays typo: {"\u2122", "−"}, // minus sign, U+2212 ISOtech diff --git a/src/site/resources/release-notes/RELEASE-NOTES-3.7.txt b/src/site/resources/release-notes/RELEASE-NOTES-3.7.txt index 5746fb5ad..13bcf99dc 100644 --- a/src/site/resources/release-notes/RELEASE-NOTES-3.7.txt +++ b/src/site/resources/release-notes/RELEASE-NOTES-3.7.txt @@ -171,7 +171,7 @@ o LANG-660: Add methods to insert arrays into arrays at an index. o LANG-1034: Add support for recursive comparison to EqualsBuilder#reflectionEquals. Thanks to Yathos UG. o LANG-1067: Add a reflection-based variant of DiffBuilder. -o LANG-740: Implementation of a Memomizer. Thanks to James Sawle. +o LANG-740: Implementation of a Memoizer. Thanks to James Sawle. o LANG-1258: Add ArrayUtils#toStringArray method. Thanks to IG, Grzegorz Rożniecki. o LANG-1160: StringUtils#abbreviate should support 'custom ellipses' parameter. @@ -271,7 +271,7 @@ o Numerous extensions to org.apache.commons.lang3.StringUtils including truncation. o Added org.apache.commons.lang3.ThreadUtils - a utility class to work with instances of java.lang.Thread and java.lang.ThreadGroup. -o Added annotations @EqualsExclude, @HashCodeExclude and @ToStringEclude to +o Added annotations @EqualsExclude, @HashCodeExclude and @ToStringExclude to mark fields which should be ignored by the reflective builders in the org.apache.commons.lang3.builder package. o Support for various modify and retrieve value use cases added to the classes @@ -369,7 +369,7 @@ o LANG-1168: Add SystemUtils.IS_OS_WINDOWS_10 property. Thanks to Pascal Schumacher. o LANG-1115: Add support for varargs in ConstructorUtils, MemberUtils, and MethodUtils. Thanks to Jim Lloyd and Joe Ferner. -o LANG-1134: Add methods to check numbers against NaN and inifinite to +o LANG-1134: Add methods to check numbers against NaN and infinite to Validate. Thanks to Alan Smithee. o LANG-1220: Add tests for missed branches in DateUtils. Thanks to Casey Scarborough. @@ -453,7 +453,7 @@ o LANG-1205: NumberUtils.createNumber() behaves inconsistently with o LANG-1222: Fix for incorrect comment on StringUtils.containsIgnoreCase method. Thanks to Adam J. o LANG-1221: Fix typo on appendIfMissing javadoc. Thanks to Pierre Templier. -o LANG-1202: parseDateStrictly does't pass specified locale. Thanks to +o LANG-1202: parseDateStrictly doesn't pass specified locale. Thanks to Markus Jelsma. o LANG-1219: FastDateFormat doesn't respect summer daylight in some localized strings. Thanks to Jarek. @@ -605,7 +605,7 @@ o LANG-794: SystemUtils.IS_OS_WINDOWS_2008, VISTA are incorrect. Thanks to o LANG-1104: Parse test fails for TimeZone America/Sao_Paulo o LANG-948: Exception while using ExtendedMessageFormat and escaping braces. Thanks to Andrey Khobnya. -o LANG-1092: Wrong formating of time zones with daylight saving time in +o LANG-1092: Wrong formatting of time zones with daylight saving time in FastDatePrinter o LANG-1090: FastDateParser does not set error indication in ParsePosition o LANG-1089: FastDateParser does not handle excess hours as per @@ -645,7 +645,7 @@ CHANGES o LANG-1102: Make logic for comparing OS versions in SystemUtils smarter o LANG-1091: Shutdown thread pools in test cases. Thanks to Fabian Lange. o LANG-1101: FastDateParser and FastDatePrinter support 'X' format -o LANG-1100: Avoid memory allocation when using date formating to StringBuffer. +o LANG-1100: Avoid memory allocation when using date formatting to StringBuffer. Thanks to mbracher. o LANG-935: Possible performance improvement on string escape functions. Thanks to Fabian Lange, Thomas Neidhart. @@ -966,7 +966,7 @@ NEW FEATURES ============== o LANG-801: Add Conversion utility to convert between data types on byte level -o LANG-760: Add API StringUtils.toString(byte[] intput, String charsetName) +o LANG-760: Add API StringUtils.toString(byte[] input, String charsetName) o LANG-756: Add APIs ClassUtils.isPrimitiveWrapper(Class) and isPrimitiveOrWrapper(Class) o LANG-695: SystemUtils.IS_OS_UNIX doesn't recognize FreeBSD as a Unix system @@ -1140,7 +1140,7 @@ o LANG-645: FastDateFormat.format() outputs incorrect week of year because o LANG-646: StringEscapeUtils.unescapeJava doesn't handle octal escapes and Unicode with extra u o LANG-656: Example StringUtils.indexOfAnyBut("zzabyycdxx", '') = 0 incorrect -o LANG-658: Some Entitys like Ö are not matched properly against its +o LANG-658: Some entities like Ö are not matched properly against its ISO8859-1 representation o LANG-659: EntityArrays typo: {"\u2122", "−"}, // minus sign, U+2212 ISOtech diff --git a/src/site/resources/release-notes/RELEASE-NOTES-3.8.1.txt b/src/site/resources/release-notes/RELEASE-NOTES-3.8.1.txt index 5664a8678..3c02f0f7c 100644 --- a/src/site/resources/release-notes/RELEASE-NOTES-3.8.1.txt +++ b/src/site/resources/release-notes/RELEASE-NOTES-3.8.1.txt @@ -265,7 +265,7 @@ o LANG-660: Add methods to insert arrays into arrays at an index. o LANG-1034: Add support for recursive comparison to EqualsBuilder#reflectionEquals. Thanks to Yathos UG. o LANG-1067: Add a reflection-based variant of DiffBuilder. -o LANG-740: Implementation of a Memomizer. Thanks to James Sawle. +o LANG-740: Implementation of a Memoizer. Thanks to James Sawle. o LANG-1258: Add ArrayUtils#toStringArray method. Thanks to IG, Grzegorz Ro?niecki. o LANG-1160: StringUtils#abbreviate should support 'custom ellipses' parameter. @@ -365,7 +365,7 @@ o Numerous extensions to org.apache.commons.lang3.StringUtils including truncation. o Added org.apache.commons.lang3.ThreadUtils - a utility class to work with instances of java.lang.Thread and java.lang.ThreadGroup. -o Added annotations @EqualsExclude, @HashCodeExclude and @ToStringEclude to +o Added annotations @EqualsExclude, @HashCodeExclude and @ToStringExclude to mark fields which should be ignored by the reflective builders in the org.apache.commons.lang3.builder package. o Support for various modify and retrieve value use cases added to the classes @@ -463,7 +463,7 @@ o LANG-1168: Add SystemUtils.IS_OS_WINDOWS_10 property. Thanks to Pascal Schumacher. o LANG-1115: Add support for varargs in ConstructorUtils, MemberUtils, and MethodUtils. Thanks to Jim Lloyd and Joe Ferner. -o LANG-1134: Add methods to check numbers against NaN and inifinite to +o LANG-1134: Add methods to check numbers against NaN and infinite to Validate. Thanks to Alan Smithee. o LANG-1220: Add tests for missed branches in DateUtils. Thanks to Casey Scarborough. @@ -547,7 +547,7 @@ o LANG-1205: NumberUtils.createNumber() behaves inconsistently with o LANG-1222: Fix for incorrect comment on StringUtils.containsIgnoreCase method. Thanks to Adam J. o LANG-1221: Fix typo on appendIfMissing javadoc. Thanks to Pierre Templier. -o LANG-1202: parseDateStrictly does't pass specified locale. Thanks to +o LANG-1202: parseDateStrictly doesn't pass specified locale. Thanks to Markus Jelsma. o LANG-1219: FastDateFormat doesn't respect summer daylight in some localized strings. Thanks to Jarek. @@ -699,7 +699,7 @@ o LANG-794: SystemUtils.IS_OS_WINDOWS_2008, VISTA are incorrect. Thanks to o LANG-1104: Parse test fails for TimeZone America/Sao_Paulo o LANG-948: Exception while using ExtendedMessageFormat and escaping braces. Thanks to Andrey Khobnya. -o LANG-1092: Wrong formating of time zones with daylight saving time in +o LANG-1092: Wrong formatting of time zones with daylight saving time in FastDatePrinter o LANG-1090: FastDateParser does not set error indication in ParsePosition o LANG-1089: FastDateParser does not handle excess hours as per @@ -739,7 +739,7 @@ CHANGES o LANG-1102: Make logic for comparing OS versions in SystemUtils smarter o LANG-1091: Shutdown thread pools in test cases. Thanks to Fabian Lange. o LANG-1101: FastDateParser and FastDatePrinter support 'X' format -o LANG-1100: Avoid memory allocation when using date formating to StringBuffer. +o LANG-1100: Avoid memory allocation when using date formatting to StringBuffer. Thanks to mbracher. o LANG-935: Possible performance improvement on string escape functions. Thanks to Fabian Lange, Thomas Neidhart. @@ -1060,7 +1060,7 @@ NEW FEATURES ============== o LANG-801: Add Conversion utility to convert between data types on byte level -o LANG-760: Add API StringUtils.toString(byte[] intput, String charsetName) +o LANG-760: Add API StringUtils.toString(byte[] input, String charsetName) o LANG-756: Add APIs ClassUtils.isPrimitiveWrapper(Class) and isPrimitiveOrWrapper(Class) o LANG-695: SystemUtils.IS_OS_UNIX doesn't recognize FreeBSD as a Unix system @@ -1234,7 +1234,7 @@ o LANG-645: FastDateFormat.format() outputs incorrect week of year because o LANG-646: StringEscapeUtils.unescapeJava doesn't handle octal escapes and Unicode with extra u o LANG-656: Example StringUtils.indexOfAnyBut("zzabyycdxx", '') = 0 incorrect -o LANG-658: Some Entitys like Ö are not matched properly against its +o LANG-658: Some entities like Ö are not matched properly against its ISO8859-1 representation o LANG-659: EntityArrays typo: {"\u2122", "−"}, // minus sign, U+2212 ISOtech diff --git a/src/site/resources/release-notes/RELEASE-NOTES-3.8.txt b/src/site/resources/release-notes/RELEASE-NOTES-3.8.txt index cea0df264..9c74f512e 100644 --- a/src/site/resources/release-notes/RELEASE-NOTES-3.8.txt +++ b/src/site/resources/release-notes/RELEASE-NOTES-3.8.txt @@ -232,7 +232,7 @@ o LANG-660: Add methods to insert arrays into arrays at an index. o LANG-1034: Add support for recursive comparison to EqualsBuilder#reflectionEquals. Thanks to Yathos UG. o LANG-1067: Add a reflection-based variant of DiffBuilder. -o LANG-740: Implementation of a Memomizer. Thanks to James Sawle. +o LANG-740: Implementation of a Memoizer. Thanks to James Sawle. o LANG-1258: Add ArrayUtils#toStringArray method. Thanks to IG, Grzegorz Ro?niecki. o LANG-1160: StringUtils#abbreviate should support 'custom ellipses' parameter. @@ -332,7 +332,7 @@ o Numerous extensions to org.apache.commons.lang3.StringUtils including truncation. o Added org.apache.commons.lang3.ThreadUtils - a utility class to work with instances of java.lang.Thread and java.lang.ThreadGroup. -o Added annotations @EqualsExclude, @HashCodeExclude and @ToStringEclude to +o Added annotations @EqualsExclude, @HashCodeExclude and @ToStringExclude to mark fields which should be ignored by the reflective builders in the org.apache.commons.lang3.builder package. o Support for various modify and retrieve value use cases added to the classes @@ -430,7 +430,7 @@ o LANG-1168: Add SystemUtils.IS_OS_WINDOWS_10 property. Thanks to Pascal Schumacher. o LANG-1115: Add support for varargs in ConstructorUtils, MemberUtils, and MethodUtils. Thanks to Jim Lloyd and Joe Ferner. -o LANG-1134: Add methods to check numbers against NaN and inifinite to +o LANG-1134: Add methods to check numbers against NaN and infinite to Validate. Thanks to Alan Smithee. o LANG-1220: Add tests for missed branches in DateUtils. Thanks to Casey Scarborough. @@ -514,7 +514,7 @@ o LANG-1205: NumberUtils.createNumber() behaves inconsistently with o LANG-1222: Fix for incorrect comment on StringUtils.containsIgnoreCase method. Thanks to Adam J. o LANG-1221: Fix typo on appendIfMissing javadoc. Thanks to Pierre Templier. -o LANG-1202: parseDateStrictly does't pass specified locale. Thanks to +o LANG-1202: parseDateStrictly doesn't pass specified locale. Thanks to Markus Jelsma. o LANG-1219: FastDateFormat doesn't respect summer daylight in some localized strings. Thanks to Jarek. @@ -666,7 +666,7 @@ o LANG-794: SystemUtils.IS_OS_WINDOWS_2008, VISTA are incorrect. Thanks to o LANG-1104: Parse test fails for TimeZone America/Sao_Paulo o LANG-948: Exception while using ExtendedMessageFormat and escaping braces. Thanks to Andrey Khobnya. -o LANG-1092: Wrong formating of time zones with daylight saving time in +o LANG-1092: Wrong formatting of time zones with daylight saving time in FastDatePrinter o LANG-1090: FastDateParser does not set error indication in ParsePosition o LANG-1089: FastDateParser does not handle excess hours as per @@ -706,7 +706,7 @@ CHANGES o LANG-1102: Make logic for comparing OS versions in SystemUtils smarter o LANG-1091: Shutdown thread pools in test cases. Thanks to Fabian Lange. o LANG-1101: FastDateParser and FastDatePrinter support 'X' format -o LANG-1100: Avoid memory allocation when using date formating to StringBuffer. +o LANG-1100: Avoid memory allocation when using date formatting to StringBuffer. Thanks to mbracher. o LANG-935: Possible performance improvement on string escape functions. Thanks to Fabian Lange, Thomas Neidhart. @@ -1027,7 +1027,7 @@ NEW FEATURES ============== o LANG-801: Add Conversion utility to convert between data types on byte level -o LANG-760: Add API StringUtils.toString(byte[] intput, String charsetName) +o LANG-760: Add API StringUtils.toString(byte[] input, String charsetName) o LANG-756: Add APIs ClassUtils.isPrimitiveWrapper(Class) and isPrimitiveOrWrapper(Class) o LANG-695: SystemUtils.IS_OS_UNIX doesn't recognize FreeBSD as a Unix system @@ -1201,7 +1201,7 @@ o LANG-645: FastDateFormat.format() outputs incorrect week of year because o LANG-646: StringEscapeUtils.unescapeJava doesn't handle octal escapes and Unicode with extra u o LANG-656: Example StringUtils.indexOfAnyBut("zzabyycdxx", '') = 0 incorrect -o LANG-658: Some Entitys like Ö are not matched properly against its +o LANG-658: Some entities like Ö are not matched properly against its ISO8859-1 representation o LANG-659: EntityArrays typo: {"\u2122", "−"}, // minus sign, U+2212 ISOtech diff --git a/src/site/resources/release-notes/RELEASE-NOTES-3.9.txt b/src/site/resources/release-notes/RELEASE-NOTES-3.9.txt index 17d7ed363..758553619 100644 --- a/src/site/resources/release-notes/RELEASE-NOTES-3.9.txt +++ b/src/site/resources/release-notes/RELEASE-NOTES-3.9.txt @@ -288,7 +288,7 @@ o LANG-660: Add methods to insert arrays into arrays at an index. o LANG-1034: Add support for recursive comparison to EqualsBuilder#reflectionEquals. Thanks to Yathos UG. o LANG-1067: Add a reflection-based variant of DiffBuilder. -o LANG-740: Implementation of a Memomizer. Thanks to James Sawle. +o LANG-740: Implementation of a Memoizer. Thanks to James Sawle. o LANG-1258: Add ArrayUtils#toStringArray method. Thanks to IG, Grzegorz Ro?niecki. o LANG-1160: StringUtils#abbreviate should support 'custom ellipses' parameter. @@ -388,7 +388,7 @@ o Numerous extensions to org.apache.commons.lang3.StringUtils including truncation. o Added org.apache.commons.lang3.ThreadUtils - a utility class to work with instances of java.lang.Thread and java.lang.ThreadGroup. -o Added annotations @EqualsExclude, @HashCodeExclude and @ToStringEclude to +o Added annotations @EqualsExclude, @HashCodeExclude and @ToStringExclude to mark fields which should be ignored by the reflective builders in the org.apache.commons.lang3.builder package. o Support for various modify and retrieve value use cases added to the classes @@ -486,7 +486,7 @@ o LANG-1168: Add SystemUtils.IS_OS_WINDOWS_10 property. Thanks to Pascal Schumacher. o LANG-1115: Add support for varargs in ConstructorUtils, MemberUtils, and MethodUtils. Thanks to Jim Lloyd and Joe Ferner. -o LANG-1134: Add methods to check numbers against NaN and inifinite to +o LANG-1134: Add methods to check numbers against NaN and infinite to Validate. Thanks to Alan Smithee. o LANG-1220: Add tests for missed branches in DateUtils. Thanks to Casey Scarborough. @@ -570,7 +570,7 @@ o LANG-1205: NumberUtils.createNumber() behaves inconsistently with o LANG-1222: Fix for incorrect comment on StringUtils.containsIgnoreCase method. Thanks to Adam J. o LANG-1221: Fix typo on appendIfMissing javadoc. Thanks to Pierre Templier. -o LANG-1202: parseDateStrictly does't pass specified locale. Thanks to +o LANG-1202: parseDateStrictly doesn't pass specified locale. Thanks to Markus Jelsma. o LANG-1219: FastDateFormat doesn't respect summer daylight in some localized strings. Thanks to Jarek. @@ -722,7 +722,7 @@ o LANG-794: SystemUtils.IS_OS_WINDOWS_2008, VISTA are incorrect. Thanks to o LANG-1104: Parse test fails for TimeZone America/Sao_Paulo o LANG-948: Exception while using ExtendedMessageFormat and escaping braces. Thanks to Andrey Khobnya. -o LANG-1092: Wrong formating of time zones with daylight saving time in +o LANG-1092: Wrong formatting of time zones with daylight saving time in FastDatePrinter o LANG-1090: FastDateParser does not set error indication in ParsePosition o LANG-1089: FastDateParser does not handle excess hours as per @@ -762,7 +762,7 @@ CHANGES o LANG-1102: Make logic for comparing OS versions in SystemUtils smarter o LANG-1091: Shutdown thread pools in test cases. Thanks to Fabian Lange. o LANG-1101: FastDateParser and FastDatePrinter support 'X' format -o LANG-1100: Avoid memory allocation when using date formating to StringBuffer. +o LANG-1100: Avoid memory allocation when using date formatting to StringBuffer. Thanks to mbracher. o LANG-935: Possible performance improvement on string escape functions. Thanks to Fabian Lange, Thomas Neidhart. @@ -1083,7 +1083,7 @@ NEW FEATURES ============== o LANG-801: Add Conversion utility to convert between data types on byte level -o LANG-760: Add API StringUtils.toString(byte[] intput, String charsetName) +o LANG-760: Add API StringUtils.toString(byte[] input, String charsetName) o LANG-756: Add APIs ClassUtils.isPrimitiveWrapper(Class) and isPrimitiveOrWrapper(Class) o LANG-695: SystemUtils.IS_OS_UNIX doesn't recognize FreeBSD as a Unix system @@ -1257,7 +1257,7 @@ o LANG-645: FastDateFormat.format() outputs incorrect week of year because o LANG-646: StringEscapeUtils.unescapeJava doesn't handle octal escapes and Unicode with extra u o LANG-656: Example StringUtils.indexOfAnyBut("zzabyycdxx", '') = 0 incorrect -o LANG-658: Some Entitys like Ö are not matched properly against its +o LANG-658: Some entities like Ö are not matched properly against its ISO8859-1 representation o LANG-659: EntityArrays typo: {"\u2122", "−"}, // minus sign, U+2212 ISOtech diff --git a/src/site/xdoc/article2_4.xml b/src/site/xdoc/article2_4.xml index 41686abc8..bf3fdbb18 100644 --- a/src/site/xdoc/article2_4.xml +++ b/src/site/xdoc/article2_4.xml @@ -54,7 +54,7 @@ you can read more about it in CharRange class is somewhat @@ -96,7 +96,7 @@ grown and we cover its new methods in its own section.

  • abbreviateMiddle(String, String, int);String - This method turns aRatherLongNameSuchAsAFileName into 'aRatherLo...AFileName'. This is often desirable when you want to restrict the length of a name, but you can afford to have quite long names.
  • indexOfIgnoreCase(String, String);int - An indexOf method that ignores the case of what it's matching. Matching lastIndexOfIgnoreCase and 'start at index' variants were also added.
    • -
  • lastOrdinalIndexOf(String, String, int);int - A matching variant for the already exisitng ordinalIndexOf method - they +
  • lastOrdinalIndexOf(String, String, int);int - A matching variant for the already existing ordinalIndexOf method - they support finding the Nth indexOf instead of the first time the search term is found.
  • isAllLowerCase(String);boolean - Is the String all lower case.
  • isAllUpperCase(String);boolean - Is the String all upper case.
    • @@ -113,7 +113,7 @@ support finding the Nth indexOf instead of the first time the search term is fou
  • LANG-477 - fixing an OutOfMemoryError in ExtendedMessageFormat.
  • LANG-76 - EnumUtils.getEnum() doesn't work well in 1.5.
  • LANG-204 and -LANG-506 - Multithread improvements to the package private Entities +LANG-506 - Multithreading improvements to the package private Entities class, used behind the scenes by StringEscapeUtils.
  • LANG-511 - Improve performance by deferring LocaleUtils initialization.
  • LANG-523 - Two orders of magnitude performance improvement in StrBuilder.
    • diff --git a/src/site/xdoc/article3_0.xml b/src/site/xdoc/article3_0.xml index cfac368e2..ff5976d08 100644 --- a/src/site/xdoc/article3_0.xml +++ b/src/site/xdoc/article3_0.xml @@ -75,10 +75,10 @@ we will remove the related methods in Lang 4.0.

    Two new packages have shown up. org.apache.commons.lang3.concurrent, which unsurprisingly provides support classes for -multi-threaded programming, and org.apache.commons.lang3.text.translate, which provides a pluggable API for text transformation.

    +multithreaded programming, and org.apache.commons.lang3.text.translate, which provides a pluggable API for text transformation.

    concurrent.*

    -

    Java 1.5 adds a great bunch of functionality related to multi-threaded programming +

    Java 1.5 adds a great bunch of functionality related to multithreaded programming below the java.util.concurrent package. Commons Lang 3.0 provides some additional classes in this area which are intended to further simplify the development of concurrent applications.

    @@ -93,7 +93,7 @@ divided into the following categories: typically has to implement manually again and again. Examples are a configurable ThreadFactory implementation or utility methods for the handling of ExecutionExceptions thrown by Java's executor service framework.

    -

    Initializer classes deal with the creation of objects in a multi-threaded +

    Initializer classes deal with the creation of objects in a multithreaded environment. There are several variants of initializer implementations serving different purposes. For instance, there are a couple of concrete initializers supporting lazy initialization of objects in a safe way. Another example is diff --git a/src/site/xdoc/mail-lists.xml b/src/site/xdoc/mail-lists.xml index e6ca0e087..380401253 100644 --- a/src/site/xdoc/mail-lists.xml +++ b/src/site/xdoc/mail-lists.xml @@ -152,7 +152,7 @@ limitations under the License. Commons Commits List

    - Only for e-mails automatically generated by the source control sytem. + Only for e-mails automatically generated by the source control system.

    Subscribe diff --git a/src/site/xdoc/upgradeto2_0.xml b/src/site/xdoc/upgradeto2_0.xml index 02c507405..e7434f8a9 100644 --- a/src/site/xdoc/upgradeto2_0.xml +++ b/src/site/xdoc/upgradeto2_0.xml @@ -163,7 +163,7 @@ ID Sev Pri Plt Owner State Result Summary 17654 EnumUtils nit: The import java.io.Serializable is never used 17882 Add join(..., char c) to StringUtils (and some performance f 18077 StringUtils.chomp does not match Perl -18723 RandomStringUtils infloops with length < 1 +18723 RandomStringUtils infinite loop with length < 1 18836 test.lang fails if compiled with non iso-8859-1 locales 18948 Resurrect the WordWrapUtils from commons-sandbox/utils 19296 [Lang] What to do with FastDateFormat unused private constru diff --git a/src/site/xdoc/upgradeto2_1.xml b/src/site/xdoc/upgradeto2_1.xml index 05aac87d2..2e54a9f40 100644 --- a/src/site/xdoc/upgradeto2_1.xml +++ b/src/site/xdoc/upgradeto2_1.xml @@ -39,7 +39,7 @@ INCOMPATIBLE CHANGES: - 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 (ie. its a bug fix). +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. @@ -55,7 +55,7 @@ for more details. DEPRECATIONS: -- The enum package has been renamed to enums for JDK1.5 compilance. +- 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. @@ -146,7 +146,7 @@ BUG FIXES: 30929 Nestable.indexOfThrowable(Class) uses Class.equals() to match 31395 DateUtils.truncate oddity at the far end of the Date spectrum 31478 Compile error with JDK 5 "enum" is a keyword -31572 o.a.c.lang.enum.ValuedEnum: 'enum'is a keyword in JDK1.5.0 +31572 o.a.c.lang.enum.ValuedEnum: 'enum' is a keyword in JDK 1.5.0 31933 ToStringStyle setArrayEnd handled null incorrectly 32133 SystemUtils fails init on HP-UX 32198 Error in Javadoc for StringUtils.chomp(String, String) diff --git a/src/site/xdoc/upgradeto2_3.xml b/src/site/xdoc/upgradeto2_3.xml index a641befcc..851e8de07 100644 --- a/src/site/xdoc/upgradeto2_3.xml +++ b/src/site/xdoc/upgradeto2_3.xml @@ -44,7 +44,7 @@ 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 (ie. its a bug fix). +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. @@ -67,7 +67,7 @@ DEPRECATIONS FROM 2.1 to 2.2: DEPRECATIONS FROM 2.0 to 2.1: -- The enum package has been renamed to enums for JDK1.5 compilance. +- 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. @@ -82,7 +82,7 @@ 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 resuling in out of memory exceptions. + * [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 diff --git a/src/site/xdoc/upgradeto2_4.xml b/src/site/xdoc/upgradeto2_4.xml index 6e56ca46d..551c723d9 100644 --- a/src/site/xdoc/upgradeto2_4.xml +++ b/src/site/xdoc/upgradeto2_4.xml @@ -50,7 +50,7 @@ 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 (ie. its a bug fix). +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. @@ -81,7 +81,7 @@ DEPRECATIONS FROM 2.1 to 2.2: DEPRECATIONS FROM 2.0 to 2.1: -- The enum package has been renamed to enums for JDK1.5 compilance. +- 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. @@ -101,7 +101,7 @@ BUG FIXES IN 2.4: * [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 uncorrectly + * [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 diff --git a/src/site/xdoc/upgradeto2_5.xml b/src/site/xdoc/upgradeto2_5.xml index be73c0d13..38ed30fff 100644 --- a/src/site/xdoc/upgradeto2_5.xml +++ b/src/site/xdoc/upgradeto2_5.xml @@ -78,7 +78,7 @@ BUG FIXES IN 2.5 * [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-457] - NumberUtils - createNumber() throws 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[] diff --git a/src/site/xdoc/upgradeto2_6.xml b/src/site/xdoc/upgradeto2_6.xml index ef32be6f2..1f8c278e9 100644 --- a/src/site/xdoc/upgradeto2_6.xml +++ b/src/site/xdoc/upgradeto2_6.xml @@ -75,7 +75,7 @@ OTHER CHANGES IN 2.6 * [LANG-600] - Javadoc is incorrect for lastIndexOf() method * [LANG-628] - Javadoc for HashCodeBuilder.append(boolean) does not match implementation - * [LANG-643] - Javadoc StringUtils.left() claims to throw an exception on negative lenth, but doesn't + * [LANG-643] - Javadoc StringUtils.left() claims to throw an exception on negative length, but doesn't * [LANG-370] - Javadoc - document thread safety * [LANG-623] - Test for StringUtils replaceChars() icelandic characters diff --git a/src/site/xdoc/upgradeto3_0.xml b/src/site/xdoc/upgradeto3_0.xml index 9bbda8d3f..c30117246 100644 --- a/src/site/xdoc/upgradeto3_0.xml +++ b/src/site/xdoc/upgradeto3_0.xml @@ -152,14 +152,14 @@ BUG FIXES IN 3.0 [LANG-645] FastDateFormat.format() outputs incorrect week of year because locale isn't respected [LANG-646] StringEscapeUtils.unescapeJava doesn't handle octal escapes and Unicode with extra u [LANG-656] Example StringUtils.indexOfAnyBut("zzabyycdxx", '') = 0 incorrect - [LANG-658] Some Entitys like &Ouml; are not matched properly against its ISO8859-1 representation + [LANG-658] Some entities like &Ouml; are not matched properly against its ISO8859-1 representation [LANG-659] EntityArrays typo: {"\u2122", "&minus;"}, // minus sign, U+2212 ISOtech [LANG-66] StringEscaper.escapeXml() escapes characters > 0x7f. [LANG-662] org.apache.commons.lang3.math.Fraction does not reduce (Integer.MIN_VALUE, 2^k) [LANG-663] org.apache.commons.lang3.math.Fraction does not always succeed in multiplyBy and divideBy [LANG-664] NumberUtils.isNumber(String) is not right when the String is "1.1L" [LANG-672] Doc bug in DateUtils#ceiling - [LANG-677] DateUtils.isSameLocalTime compares using 12 hour clock and not 24 hour + [LANG-677] DateUtils.isSameLocalTime compares using 12-hour clock and not 24-hour [LANG-685] EqualsBuilder synchronizes on HashCodeBuilder. [LANG-703] StringUtils.join throws NPE when toString returns null for one of objects in collection [LANG-710] StringIndexOutOfBoundsException when calling unescapeHtml4("&#03")