Author: niallp
Date: Tue Feb 2 16:59:59 2010
New Revision: 905707
URL: http://svn.apache.org/viewvc?rev=905707&view=rev
Log:
Add @since 2.5 tags
Modified:
commons/proper/lang/branches/LANG_2_X/src/main/java/org/apache/commons/lang/CharRange.java
commons/proper/lang/branches/LANG_2_X/src/main/java/org/apache/commons/lang/ClassUtils.java
commons/proper/lang/branches/LANG_2_X/src/main/java/org/apache/commons/lang/StringUtils.java
commons/proper/lang/branches/LANG_2_X/src/main/java/org/apache/commons/lang/SystemUtils.java
commons/proper/lang/branches/LANG_2_X/src/main/java/org/apache/commons/lang/builder/EqualsBuilder.java
commons/proper/lang/branches/LANG_2_X/src/main/java/org/apache/commons/lang/builder/HashCodeBuilder.java
commons/proper/lang/branches/LANG_2_X/src/main/java/org/apache/commons/lang/math/NumberUtils.java
commons/proper/lang/branches/LANG_2_X/src/main/java/org/apache/commons/lang/mutable/MutableBoolean.java
commons/proper/lang/branches/LANG_2_X/src/main/java/org/apache/commons/lang/mutable/MutableByte.java
commons/proper/lang/branches/LANG_2_X/src/main/java/org/apache/commons/lang/mutable/MutableDouble.java
commons/proper/lang/branches/LANG_2_X/src/main/java/org/apache/commons/lang/mutable/MutableFloat.java
commons/proper/lang/branches/LANG_2_X/src/main/java/org/apache/commons/lang/mutable/MutableInt.java
commons/proper/lang/branches/LANG_2_X/src/main/java/org/apache/commons/lang/mutable/MutableLong.java
commons/proper/lang/branches/LANG_2_X/src/main/java/org/apache/commons/lang/mutable/MutableShort.java
commons/proper/lang/branches/LANG_2_X/src/main/java/org/apache/commons/lang/text/StrBuilder.java
commons/proper/lang/branches/LANG_2_X/src/main/java/org/apache/commons/lang/time/DateUtils.java
Modified:
commons/proper/lang/branches/LANG_2_X/src/main/java/org/apache/commons/lang/CharRange.java
URL:
http://svn.apache.org/viewvc/commons/proper/lang/branches/LANG_2_X/src/main/java/org/apache/commons/lang/CharRange.java?rev=905707&r1=905706&r2=905707&view=diff
==============================================================================
---
commons/proper/lang/branches/LANG_2_X/src/main/java/org/apache/commons/lang/CharRange.java
(original)
+++
commons/proper/lang/branches/LANG_2_X/src/main/java/org/apache/commons/lang/CharRange.java
Tue Feb 2 16:59:59 2010
@@ -56,6 +56,7 @@
* @param ch only character in this range
* @return the new CharRange object
* @see CharRange#CharRange(char, char, boolean)
+ * @since 2.5
*/
public static CharRange is(char ch) {
return new CharRange(ch, ch, false);
@@ -67,6 +68,7 @@
* @param ch only character in this range
* @return the new CharRange object
* @see CharRange#CharRange(char, char, boolean)
+ * @since 2.5
*/
public static CharRange isNot(char ch) {
return new CharRange(ch, ch, true);
@@ -79,6 +81,7 @@
* @param end last character, inclusive, in this range
* @return the new CharRange object
* @see CharRange#CharRange(char, char, boolean)
+ * @since 2.5
*/
public static CharRange isIn(char start, char end) {
return new CharRange(start, end, false);
@@ -91,6 +94,7 @@
* @param end last character, inclusive, in this range
* @return the new CharRange object
* @see CharRange#CharRange(char, char, boolean)
+ * @since 2.5
*/
public static CharRange isNotIn(char start, char end) {
return new CharRange(start, end, true);
Modified:
commons/proper/lang/branches/LANG_2_X/src/main/java/org/apache/commons/lang/ClassUtils.java
URL:
http://svn.apache.org/viewvc/commons/proper/lang/branches/LANG_2_X/src/main/java/org/apache/commons/lang/ClassUtils.java?rev=905707&r1=905706&r2=905707&view=diff
==============================================================================
---
commons/proper/lang/branches/LANG_2_X/src/main/java/org/apache/commons/lang/ClassUtils.java
(original)
+++
commons/proper/lang/branches/LANG_2_X/src/main/java/org/apache/commons/lang/ClassUtils.java
Tue Feb 2 16:59:59 2010
@@ -468,6 +468,7 @@
* @param toClassArray the array of Classes to try to assign into, may be
<code>null</code>
* @param autoboxing whether to use implicit autoboxing/unboxing between
primitives and wrappers
* @return <code>true</code> if assignment possible
+ * @since 2.5
*/
public static boolean isAssignable(Class[] classArray, Class[]
toClassArray, boolean autoboxing) {
if (ArrayUtils.isSameLength(classArray, toClassArray) == false) {
@@ -543,6 +544,7 @@
* @param toClass the Class to try to assign into, returns false if null
* @param autoboxing whether to use implicit autoboxing/unboxing between
primitives and wrappers
* @return <code>true</code> if assignment possible
+ * @since 2.5
*/
public static boolean isAssignable(Class cls, Class toClass, boolean
autoboxing) {
if (toClass == null) {
Modified:
commons/proper/lang/branches/LANG_2_X/src/main/java/org/apache/commons/lang/StringUtils.java
URL:
http://svn.apache.org/viewvc/commons/proper/lang/branches/LANG_2_X/src/main/java/org/apache/commons/lang/StringUtils.java?rev=905707&r1=905706&r2=905707&view=diff
==============================================================================
---
commons/proper/lang/branches/LANG_2_X/src/main/java/org/apache/commons/lang/StringUtils.java
(original)
+++
commons/proper/lang/branches/LANG_2_X/src/main/java/org/apache/commons/lang/StringUtils.java
Tue Feb 2 16:59:59 2010
@@ -895,7 +895,7 @@
* @param searchStr the String to find, may be null
* @return the first index of the search String,
* -1 if no match or <code>null</code> string input
- * @since 3.0
+ * @since 2.5
*/
public static int indexOfIgnoreCase(String str, String searchStr) {
return indexOfIgnoreCase(str, searchStr, 0);
@@ -930,7 +930,7 @@
* @param startPos the start position, negative treated as zero
* @return the first index of the search String,
* -1 if no match or <code>null</code> string input
- * @since 3.0
+ * @since 2.5
*/
public static int indexOfIgnoreCase(String str, String searchStr, int
startPos) {
if (str == null || searchStr == null) {
@@ -1076,7 +1076,7 @@
* @param ordinal the n-th last <code>searchStr</code> to find
* @return the n-th last index of the search String,
* <code>-1</code> (<code>INDEX_NOT_FOUND</code>) if no match or
<code>null</code> string input
- * @since 3.0
+ * @since 2.5
*/
public static int lastOrdinalIndexOf(String str, String searchStr, int
ordinal) {
return ordinalIndexOf(str, searchStr, ordinal, true);
@@ -1137,7 +1137,7 @@
* @param searchStr the String to find, may be null
* @return the first index of the search String,
* -1 if no match or <code>null</code> string input
- * @since 3.0
+ * @since 2.5
*/
public static int lastIndexOfIgnoreCase(String str, String searchStr) {
if (str == null || searchStr == null) {
@@ -1172,7 +1172,7 @@
* @param startPos the start position
* @return the first index of the search String,
* -1 if no match or <code>null</code> string input
- * @since 3.0
+ * @since 2.5
*/
public static int lastIndexOfIgnoreCase(String str, String searchStr, int
startPos) {
if (str == null || searchStr == null) {
@@ -4503,6 +4503,7 @@
* @param repeat number of times to repeat str, negative treated as zero
* @return a new String consisting of the original String repeated,
* <code>null</code> if null String input
+ * @since 2.5
*/
public static String repeat(String str, int repeat) {
// Performance tuned for 2.0 (JDK1.4)
@@ -4999,7 +5000,7 @@
* @param str the String to upper case, may be null
* @param locale the locale that defines the case transformation rules,
must not be null
* @return the upper cased String, <code>null</code> if null String input
- * @since 3.0
+ * @since 2.5
*/
public static String upperCase(String str, Locale locale) {
if (str == null) {
@@ -5048,7 +5049,7 @@
* @param str the String to lower case, may be null
* @param locale the locale that defines the case transformation rules,
must not be null
* @return the lower cased String, <code>null</code> if null String input
- * @since 3.0
+ * @since 2.5
*/
public static String lowerCase(String str, Locale locale) {
if (str == null) {
@@ -5534,6 +5535,7 @@
*
* @param str the String to check, may be null
* @return <code>true</code> if only contains lowercase characters, and is
non-null
+ * @since 2.5
*/
public static boolean isAllLowerCase(String str) {
if (str == null || isEmpty(str)) {
@@ -5564,6 +5566,7 @@
*
* @param str the String to check, may be null
* @return <code>true</code> if only contains uppercase characters, and is
non-null
+ * @since 2.5
*/
public static boolean isAllUpperCase(String str) {
if (str == null || isEmpty(str)) {
@@ -5859,6 +5862,7 @@
* @param middle the String to replace the middle characters with, may be
null
* @param length the length to abbreviate <code>str</code> to.
* @return the abbreviated String if the above criteria is met, or the
original String supplied for abbreviation.
+ * @since 2.5
*/
public static String abbreviateMiddle(String str, String middle, int
length) {
if (isEmpty(str) || isEmpty(middle)) {
@@ -6331,7 +6335,7 @@
* @param searchStrings the Strings to find, may be null or empty
* @return <code>true</code> if the String starts with any of the the
prefixes, case insensitive, or
* both <code>null</code>
- * @since 3.0
+ * @since 2.5
*/
public static boolean startsWithAny(String string, String[] searchStrings)
{
if (isEmpty(string) || ArrayUtils.isEmpty(searchStrings)) {
Modified:
commons/proper/lang/branches/LANG_2_X/src/main/java/org/apache/commons/lang/SystemUtils.java
URL:
http://svn.apache.org/viewvc/commons/proper/lang/branches/LANG_2_X/src/main/java/org/apache/commons/lang/SystemUtils.java?rev=905707&r1=905706&r2=905707&view=diff
==============================================================================
---
commons/proper/lang/branches/LANG_2_X/src/main/java/org/apache/commons/lang/SystemUtils.java
(original)
+++
commons/proper/lang/branches/LANG_2_X/src/main/java/org/apache/commons/lang/SystemUtils.java
Tue Feb 2 16:59:59 2010
@@ -891,7 +891,7 @@
* <p>The field will return <code>false</code> if {...@link #JAVA_VERSION}
is
* <code>null</code>.</p>
*
- * @since 3.0
+ * @since 2.5
*/
public static final boolean IS_JAVA_1_7 = getJavaVersionMatches("1.7");
@@ -1097,7 +1097,7 @@
* <p>The field will return <code>false</code> if <code>OS_NAME</code> is
* <code>null</code>.</p>
*
- * @since 3.0
+ * @since 2.5
*/
public static final boolean IS_OS_WINDOWS_7 =
getOSMatches(OS_NAME_WINDOWS_PREFIX, "6.1");
Modified:
commons/proper/lang/branches/LANG_2_X/src/main/java/org/apache/commons/lang/builder/EqualsBuilder.java
URL:
http://svn.apache.org/viewvc/commons/proper/lang/branches/LANG_2_X/src/main/java/org/apache/commons/lang/builder/EqualsBuilder.java?rev=905707&r1=905706&r2=905707&view=diff
==============================================================================
---
commons/proper/lang/branches/LANG_2_X/src/main/java/org/apache/commons/lang/builder/EqualsBuilder.java
(original)
+++
commons/proper/lang/branches/LANG_2_X/src/main/java/org/apache/commons/lang/builder/EqualsBuilder.java
Tue Feb 2 16:59:59 2010
@@ -841,6 +841,7 @@
/**
* Reset the EqualsBuilder so you can use the same object again
+ * @since 2.5
*/
public void reset() {
this.isEquals = true;
Modified:
commons/proper/lang/branches/LANG_2_X/src/main/java/org/apache/commons/lang/builder/HashCodeBuilder.java
URL:
http://svn.apache.org/viewvc/commons/proper/lang/branches/LANG_2_X/src/main/java/org/apache/commons/lang/builder/HashCodeBuilder.java?rev=905707&r1=905706&r2=905707&view=diff
==============================================================================
---
commons/proper/lang/branches/LANG_2_X/src/main/java/org/apache/commons/lang/builder/HashCodeBuilder.java
(original)
+++
commons/proper/lang/branches/LANG_2_X/src/main/java/org/apache/commons/lang/builder/HashCodeBuilder.java
Tue Feb 2 16:59:59 2010
@@ -975,6 +975,7 @@
* HashCodeBuilder itself is.
*
* @return <code>hashCode</code> based on the fields appended
+ * @since 2.5
*/
public int hashCode() {
return toHashCode();
Modified:
commons/proper/lang/branches/LANG_2_X/src/main/java/org/apache/commons/lang/math/NumberUtils.java
URL:
http://svn.apache.org/viewvc/commons/proper/lang/branches/LANG_2_X/src/main/java/org/apache/commons/lang/math/NumberUtils.java?rev=905707&r1=905706&r2=905707&view=diff
==============================================================================
---
commons/proper/lang/branches/LANG_2_X/src/main/java/org/apache/commons/lang/math/NumberUtils.java
(original)
+++
commons/proper/lang/branches/LANG_2_X/src/main/java/org/apache/commons/lang/math/NumberUtils.java
Tue Feb 2 16:59:59 2010
@@ -348,6 +348,7 @@
* @param str the string to convert, may be null
* @return the byte represented by the string, or <code>zero</code> if
* conversion fails
+ * @since 2.5
*/
public static byte toByte(String str) {
return toByte(str, (byte) 0);
@@ -368,6 +369,7 @@
* @param str the string to convert, may be null
* @param defaultValue the default value
* @return the byte represented by the string, or the default if
conversion fails
+ * @since 2.5
*/
public static byte toByte(String str, byte defaultValue) {
if(str == null) {
@@ -395,6 +397,7 @@
* @param str the string to convert, may be null
* @return the short represented by the string, or <code>zero</code> if
* conversion fails
+ * @since 2.5
*/
public static short toShort(String str) {
return toShort(str, (short) 0);
@@ -415,6 +418,7 @@
* @param str the string to convert, may be null
* @param defaultValue the default value
* @return the short represented by the string, or the default if
conversion fails
+ * @since 2.5
*/
public static short toShort(String str, short defaultValue) {
if(str == null) {
Modified:
commons/proper/lang/branches/LANG_2_X/src/main/java/org/apache/commons/lang/mutable/MutableBoolean.java
URL:
http://svn.apache.org/viewvc/commons/proper/lang/branches/LANG_2_X/src/main/java/org/apache/commons/lang/mutable/MutableBoolean.java?rev=905707&r1=905706&r2=905707&view=diff
==============================================================================
---
commons/proper/lang/branches/LANG_2_X/src/main/java/org/apache/commons/lang/mutable/MutableBoolean.java
(original)
+++
commons/proper/lang/branches/LANG_2_X/src/main/java/org/apache/commons/lang/mutable/MutableBoolean.java
Tue Feb 2 16:59:59 2010
@@ -103,6 +103,7 @@
* Checks if the current value is <code>true</code>.
*
* @return <code>true</code> if the current value is <code>true</code>
+ * @since 2.5
*/
public boolean isTrue() {
return value == true;
@@ -112,6 +113,7 @@
* Checks if the current value is <code>false</code>.
*
* @return <code>true</code> if the current value is <code>false</code>
+ * @since 2.5
*/
public boolean isFalse() {
return value == false;
@@ -132,6 +134,7 @@
* Gets this mutable as an instance of Boolean.
*
* @return a Boolean instance containing the value from this mutable,
never null
+ * @since 2.5
*/
public Boolean toBoolean() {
return BooleanUtils.toBooleanObject(this.value);
Modified:
commons/proper/lang/branches/LANG_2_X/src/main/java/org/apache/commons/lang/mutable/MutableByte.java
URL:
http://svn.apache.org/viewvc/commons/proper/lang/branches/LANG_2_X/src/main/java/org/apache/commons/lang/mutable/MutableByte.java?rev=905707&r1=905706&r2=905707&view=diff
==============================================================================
---
commons/proper/lang/branches/LANG_2_X/src/main/java/org/apache/commons/lang/mutable/MutableByte.java
(original)
+++
commons/proper/lang/branches/LANG_2_X/src/main/java/org/apache/commons/lang/mutable/MutableByte.java
Tue Feb 2 16:59:59 2010
@@ -69,6 +69,7 @@
*
* @param value the string to parse, not null
* @throws NumberFormatException if the string cannot be parsed into a byte
+ * @since 2.5
*/
public MutableByte(String value) throws NumberFormatException {
super();
Modified:
commons/proper/lang/branches/LANG_2_X/src/main/java/org/apache/commons/lang/mutable/MutableDouble.java
URL:
http://svn.apache.org/viewvc/commons/proper/lang/branches/LANG_2_X/src/main/java/org/apache/commons/lang/mutable/MutableDouble.java?rev=905707&r1=905706&r2=905707&view=diff
==============================================================================
---
commons/proper/lang/branches/LANG_2_X/src/main/java/org/apache/commons/lang/mutable/MutableDouble.java
(original)
+++
commons/proper/lang/branches/LANG_2_X/src/main/java/org/apache/commons/lang/mutable/MutableDouble.java
Tue Feb 2 16:59:59 2010
@@ -71,6 +71,7 @@
*
* @param value the string to parse, not null
* @throws NumberFormatException if the string cannot be parsed into a
double
+ * @since 2.5
*/
public MutableDouble(String value) throws NumberFormatException {
super();
Modified:
commons/proper/lang/branches/LANG_2_X/src/main/java/org/apache/commons/lang/mutable/MutableFloat.java
URL:
http://svn.apache.org/viewvc/commons/proper/lang/branches/LANG_2_X/src/main/java/org/apache/commons/lang/mutable/MutableFloat.java?rev=905707&r1=905706&r2=905707&view=diff
==============================================================================
---
commons/proper/lang/branches/LANG_2_X/src/main/java/org/apache/commons/lang/mutable/MutableFloat.java
(original)
+++
commons/proper/lang/branches/LANG_2_X/src/main/java/org/apache/commons/lang/mutable/MutableFloat.java
Tue Feb 2 16:59:59 2010
@@ -71,6 +71,7 @@
*
* @param value the string to parse, not null
* @throws NumberFormatException if the string cannot be parsed into a
float
+ * @since 2.5
*/
public MutableFloat(String value) throws NumberFormatException {
super();
Modified:
commons/proper/lang/branches/LANG_2_X/src/main/java/org/apache/commons/lang/mutable/MutableInt.java
URL:
http://svn.apache.org/viewvc/commons/proper/lang/branches/LANG_2_X/src/main/java/org/apache/commons/lang/mutable/MutableInt.java?rev=905707&r1=905706&r2=905707&view=diff
==============================================================================
---
commons/proper/lang/branches/LANG_2_X/src/main/java/org/apache/commons/lang/mutable/MutableInt.java
(original)
+++
commons/proper/lang/branches/LANG_2_X/src/main/java/org/apache/commons/lang/mutable/MutableInt.java
Tue Feb 2 16:59:59 2010
@@ -69,6 +69,7 @@
*
* @param value the string to parse, not null
* @throws NumberFormatException if the string cannot be parsed into an int
+ * @since 2.5
*/
public MutableInt(String value) throws NumberFormatException {
super();
Modified:
commons/proper/lang/branches/LANG_2_X/src/main/java/org/apache/commons/lang/mutable/MutableLong.java
URL:
http://svn.apache.org/viewvc/commons/proper/lang/branches/LANG_2_X/src/main/java/org/apache/commons/lang/mutable/MutableLong.java?rev=905707&r1=905706&r2=905707&view=diff
==============================================================================
---
commons/proper/lang/branches/LANG_2_X/src/main/java/org/apache/commons/lang/mutable/MutableLong.java
(original)
+++
commons/proper/lang/branches/LANG_2_X/src/main/java/org/apache/commons/lang/mutable/MutableLong.java
Tue Feb 2 16:59:59 2010
@@ -69,6 +69,7 @@
*
* @param value the string to parse, not null
* @throws NumberFormatException if the string cannot be parsed into a long
+ * @since 2.5
*/
public MutableLong(String value) throws NumberFormatException {
super();
Modified:
commons/proper/lang/branches/LANG_2_X/src/main/java/org/apache/commons/lang/mutable/MutableShort.java
URL:
http://svn.apache.org/viewvc/commons/proper/lang/branches/LANG_2_X/src/main/java/org/apache/commons/lang/mutable/MutableShort.java?rev=905707&r1=905706&r2=905707&view=diff
==============================================================================
---
commons/proper/lang/branches/LANG_2_X/src/main/java/org/apache/commons/lang/mutable/MutableShort.java
(original)
+++
commons/proper/lang/branches/LANG_2_X/src/main/java/org/apache/commons/lang/mutable/MutableShort.java
Tue Feb 2 16:59:59 2010
@@ -69,6 +69,7 @@
*
* @param value the string to parse, not null
* @throws NumberFormatException if the string cannot be parsed into a
short
+ * @since 2.5
*/
public MutableShort(String value) throws NumberFormatException {
super();
Modified:
commons/proper/lang/branches/LANG_2_X/src/main/java/org/apache/commons/lang/text/StrBuilder.java
URL:
http://svn.apache.org/viewvc/commons/proper/lang/branches/LANG_2_X/src/main/java/org/apache/commons/lang/text/StrBuilder.java?rev=905707&r1=905706&r2=905707&view=diff
==============================================================================
---
commons/proper/lang/branches/LANG_2_X/src/main/java/org/apache/commons/lang/text/StrBuilder.java
(original)
+++
commons/proper/lang/branches/LANG_2_X/src/main/java/org/apache/commons/lang/text/StrBuilder.java
Tue Feb 2 16:59:59 2010
@@ -1094,7 +1094,7 @@
* @param standard the separator if builder is not empty, null means no
separator
* @param defaultIfEmpty the separator if builder is empty, null means no
separator
* @return this, to enable chaining
- * @since 3.0
+ * @since 2.5
*/
public StrBuilder appendSeparator(String standard, String defaultIfEmpty) {
String str = isEmpty() ? defaultIfEmpty : standard;
@@ -1139,7 +1139,7 @@
* @param standard the separator if builder is not empty
* @param defaultIfEmpty the separator if builder is empty
* @return this, to enable chaining
- * @since 3.0
+ * @since 2.5
*/
public StrBuilder appendSeparator(char standard, char defaultIfEmpty) {
if (size() > 0) {
Modified:
commons/proper/lang/branches/LANG_2_X/src/main/java/org/apache/commons/lang/time/DateUtils.java
URL:
http://svn.apache.org/viewvc/commons/proper/lang/branches/LANG_2_X/src/main/java/org/apache/commons/lang/time/DateUtils.java?rev=905707&r1=905706&r2=905707&view=diff
==============================================================================
---
commons/proper/lang/branches/LANG_2_X/src/main/java/org/apache/commons/lang/time/DateUtils.java
(original)
+++
commons/proper/lang/branches/LANG_2_X/src/main/java/org/apache/commons/lang/time/DateUtils.java
Tue Feb 2 16:59:59 2010
@@ -302,6 +302,7 @@
* @return the parsed date
* @throws IllegalArgumentException if the date string or pattern array is
null
* @throws ParseException if none of the date patterns were suitable
+ * @since 2.5
*/
public static Date parseDateStrictly(String str, String[] parsePatterns)
throws ParseException {
return parseDateWithLeniency(str, parsePatterns, false);
@@ -874,6 +875,7 @@
* @return the rounded date
* @throws IllegalArgumentException if the date is <code>null</code>
* @throws ArithmeticException if the year is over 280 million
+ * @since 2.5
*/
public static Date ceiling(Date date, int field) {
if (date == null) {
@@ -900,6 +902,7 @@
* @return the rounded date (a different object)
* @throws IllegalArgumentException if the date is <code>null</code>
* @throws ArithmeticException if the year is over 280 million
+ * @since 2.5
*/
public static Calendar ceiling(Calendar date, int field) {
if (date == null) {
@@ -929,6 +932,7 @@
* @throws ClassCastException if the object type is not a
* <code>Date</code> or <code>Calendar</code>
* @throws ArithmeticException if the year is over 280 million
+ * @since 2.5
*/
public static Date ceiling(Object date, int field) {
if (date == null) {
