Author: bayard
Date: Wed Mar 16 04:26:58 2011
New Revision: 1082044
URL: http://svn.apache.org/viewvc?rev=1082044&view=rev
Log:
Adding lots of @since 3.0s
Modified:
commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/ObjectUtils.java
commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/StringEscapeUtils.java
commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/Validate.java
commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/builder/ReflectionToStringBuilder.java
commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/concurrent/AtomicInitializer.java
commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/concurrent/AtomicSafeInitializer.java
commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/concurrent/BackgroundInitializer.java
commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/concurrent/CallableBackgroundInitializer.java
commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/concurrent/ConcurrentException.java
commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/concurrent/ConcurrentInitializer.java
commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/concurrent/ConcurrentRuntimeException.java
commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/concurrent/ConcurrentUtils.java
commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/concurrent/ConstantInitializer.java
commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/concurrent/LazyInitializer.java
commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/concurrent/MultiBackgroundInitializer.java
commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/concurrent/TimedSemaphore.java
commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/text/StrBuilder.java
Modified:
commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/ObjectUtils.java
URL:
http://svn.apache.org/viewvc/commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/ObjectUtils.java?rev=1082044&r1=1082043&r2=1082044&view=diff
==============================================================================
---
commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/ObjectUtils.java
(original)
+++
commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/ObjectUtils.java
Wed Mar 16 04:26:58 2011
@@ -113,6 +113,7 @@ public class ObjectUtils {
* @param values the values to test, may be {@code null} or empty
* @return the first value from {@code values} which is not {@code null},
* or {@code null} if there are no non-null values
+ * @since 3.0
*/
public static <T> T firstNonNull(T... values) {
if (values != null) {
Modified:
commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/StringEscapeUtils.java
URL:
http://svn.apache.org/viewvc/commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/StringEscapeUtils.java?rev=1082044&r1=1082043&r2=1082044&view=diff
==============================================================================
---
commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/StringEscapeUtils.java
(original)
+++
commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/StringEscapeUtils.java
Wed Mar 16 04:26:58 2011
@@ -56,6 +56,8 @@ public class StringEscapeUtils {
* While {@link #escapeJava(String)} is the expected method of use, this
* object allows the Java escaping functionality to be used
* as the foundation for a custom translator.
+ *
+ * @since 3.0
*/
public static final CharSequenceTranslator ESCAPE_JAVA =
new LookupTranslator(
@@ -74,6 +76,8 @@ public class StringEscapeUtils {
* While {@link #escapeEcmaScript(String)} is the expected method of use,
this
* object allows the EcmaScript escaping functionality to be used
* as the foundation for a custom translator.
+ *
+ * @since 3.0
*/
public static final CharSequenceTranslator ESCAPE_ECMASCRIPT =
new AggregateTranslator(
@@ -94,6 +98,8 @@ public class StringEscapeUtils {
* While {@link #escapeXml(String)} is the expected method of use, this
* object allows the XML escaping functionality to be used
* as the foundation for a custom translator.
+ *
+ * @since 3.0
*/
public static final CharSequenceTranslator ESCAPE_XML =
new AggregateTranslator(
@@ -107,6 +113,8 @@ public class StringEscapeUtils {
* While {@link #escapeHtml3(String)} is the expected method of use, this
* object allows the HTML escaping functionality to be used
* as the foundation for a custom translator.
+ *
+ * @since 3.0
*/
public static final CharSequenceTranslator ESCAPE_HTML3 =
new AggregateTranslator(
@@ -120,6 +128,8 @@ public class StringEscapeUtils {
* While {@link #escapeHtml4(String)} is the expected method of use, this
* object allows the HTML escaping functionality to be used
* as the foundation for a custom translator.
+ *
+ * @since 3.0
*/
public static final CharSequenceTranslator ESCAPE_HTML4 =
new AggregateTranslator(
@@ -134,6 +144,8 @@ public class StringEscapeUtils {
* While {@link #escapeCsv(String)} is the expected method of use, this
* object allows the CSV escaping functionality to be used
* as the foundation for a custom translator.
+ *
+ * @since 3.0
*/
public static final CharSequenceTranslator ESCAPE_CSV = new CsvEscaper();
@@ -174,6 +186,8 @@ public class StringEscapeUtils {
* While {@link #unescapeJava(String)} is the expected method of use, this
* object allows the Java unescaping functionality to be used
* as the foundation for a custom translator.
+ *
+ * @since 3.0
*/
// TODO: throw "illegal character: \92" as an Exception if a \ on the end
of the Java (as per the compiler)?
public static final CharSequenceTranslator UNESCAPE_JAVA =
@@ -196,6 +210,8 @@ public class StringEscapeUtils {
* While {@link #unescapeEcmaScript(String)} is the expected method of
use, this
* object allows the EcmaScript unescaping functionality to be used
* as the foundation for a custom translator.
+ *
+ * @since 3.0
*/
public static final CharSequenceTranslator UNESCAPE_ECMASCRIPT =
UNESCAPE_JAVA;
@@ -205,6 +221,8 @@ public class StringEscapeUtils {
* While {@link #unescapeHtml3(String)} is the expected method of use,
this
* object allows the HTML unescaping functionality to be used
* as the foundation for a custom translator.
+ *
+ * @since 3.0
*/
public static final CharSequenceTranslator UNESCAPE_HTML3 =
new AggregateTranslator(
@@ -219,6 +237,8 @@ public class StringEscapeUtils {
* While {@link #unescapeHtml4(String)} is the expected method of use,
this
* object allows the HTML unescaping functionality to be used
* as the foundation for a custom translator.
+ *
+ * @since 3.0
*/
public static final CharSequenceTranslator UNESCAPE_HTML4 =
new AggregateTranslator(
@@ -234,6 +254,8 @@ public class StringEscapeUtils {
* While {@link #unescapeXml(String)} is the expected method of use, this
* object allows the XML unescaping functionality to be used
* as the foundation for a custom translator.
+ *
+ * @since 3.0
*/
public static final CharSequenceTranslator UNESCAPE_XML =
new AggregateTranslator(
@@ -248,6 +270,8 @@ public class StringEscapeUtils {
* While {@link #unescapeCsv(String)} is the expected method of use, this
* object allows the CSV unescaping functionality to be used
* as the foundation for a custom translator.
+ *
+ * @since 3.0
*/
public static final CharSequenceTranslator UNESCAPE_CSV = new
CsvUnescaper();
@@ -349,6 +373,8 @@ public class StringEscapeUtils {
*
* @param input String to escape values in, may be null
* @return String with escaped values, {@code null} if null string input
+ *
+ * @since 3.0
*/
public static final String escapeEcmaScript(String input) {
return ESCAPE_ECMASCRIPT.translate(input);
@@ -377,6 +403,8 @@ public class StringEscapeUtils {
* @see #unescapeJava(String)
* @param input the {@code String} to unescape, may be null
* @return A new unescaped {@code String}, {@code null} if null string
input
+ *
+ * @since 3.0
*/
public static final String unescapeEcmaScript(String input) {
return UNESCAPE_ECMASCRIPT.translate(input);
@@ -408,6 +436,8 @@ public class StringEscapeUtils {
* @see <a href="http://www.w3.org/TR/REC-html40/sgml/entities.html";>HTML
4.0 Character entity references</a>
* @see <a href="http://www.w3.org/TR/html401/charset.html#h-5.3";>HTML
4.01 Character References</a>
* @see <a
href="http://www.w3.org/TR/html401/charset.html#code-position";>HTML 4.01 Code
positions</a>
+ *
+ * @since 3.0
*/
public static final String escapeHtml4(String input) {
return ESCAPE_HTML4.translate(input);
@@ -420,6 +450,7 @@ public class StringEscapeUtils {
* @param input the {@code String} to escape, may be null
* @return a new escaped {@code String}, {@code null} if null string input
*
+ * @since 3.0
*/
public static final String escapeHtml3(String input) {
return ESCAPE_HTML3.translate(input);
@@ -440,6 +471,8 @@ public class StringEscapeUtils {
*
* @param input the {@code String} to unescape, may be null
* @return a new unescaped {@code String}, {@code null} if null string
input
+ *
+ * @since 3.0
*/
public static final String unescapeHtml4(String input) {
return UNESCAPE_HTML4.translate(input);
@@ -452,6 +485,8 @@ public class StringEscapeUtils {
*
* @param input the {@code String} to unescape, may be null
* @return a new unescaped {@code String}, {@code null} if null string
input
+ *
+ * @since 3.0
*/
public static final String unescapeHtml3(String input) {
return UNESCAPE_HTML3.translate(input);
Modified:
commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/Validate.java
URL:
http://svn.apache.org/viewvc/commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/Validate.java?rev=1082044&r1=1082043&r2=1082044&view=diff
==============================================================================
---
commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/Validate.java
(original)
+++
commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/Validate.java
Wed Mar 16 04:26:58 2011
@@ -437,6 +437,8 @@ public class Validate {
* @throws NullPointerException if the character sequence is {@code null}
* @throws IllegalArgumentException if the character sequence is blank
* @see #notBlank(CharSequence)
+ *
+ * @since 3.0
*/
public static <T extends CharSequence> T notBlank(T chars, String message,
Object... values) {
if (chars == null) {
@@ -464,6 +466,8 @@ public class Validate {
* @throws NullPointerException if the character sequence is {@code null}
* @throws IllegalArgumentException if the character sequence is blank
* @see #notBlank(CharSequence, String, Object...)
+ *
+ * @since 3.0
*/
public static <T extends CharSequence> T notBlank(T chars) {
return notBlank(chars, DEFAULT_NOT_BLANK_EX_MESSAGE);
@@ -615,6 +619,8 @@ public class Validate {
* @throws NullPointerException if the array is {@code null}
* @throws IndexOutOfBoundsException if the index is invalid
* @see #validIndex(Object[], int)
+ *
+ * @since 3.0
*/
public static <T> T[] validIndex(T[] array, int index, String message,
Object... values) {
Validate.notNull(array);
@@ -644,6 +650,8 @@ public class Validate {
* @throws NullPointerException if the array is {@code null}
* @throws IndexOutOfBoundsException if the index is invalid
* @see #validIndex(Object[], int, String, Object...)
+ *
+ * @since 3.0
*/
public static <T> T[] validIndex(T[] array, int index) {
return validIndex(array, index, DEFAULT_VALID_INDEX_ARRAY_EX_MESSAGE,
Integer.valueOf(index));
@@ -670,6 +678,8 @@ public class Validate {
* @throws NullPointerException if the collection is {@code null}
* @throws IndexOutOfBoundsException if the index is invalid
* @see #validIndex(Collection, int)
+ *
+ * @since 3.0
*/
public static <T extends Collection<?>> T validIndex(T collection, int
index, String message, Object... values) {
Validate.notNull(collection);
@@ -696,6 +706,8 @@ public class Validate {
* @throws NullPointerException if the collection is {@code null}
* @throws IndexOutOfBoundsException if the index is invalid
* @see #validIndex(Collection, int, String, Object...)
+ *
+ * @since 3.0
*/
public static <T extends Collection<?>> T validIndex(T collection, int
index) {
return validIndex(collection, index,
DEFAULT_VALID_INDEX_COLLECTION_EX_MESSAGE, Integer.valueOf(index));
@@ -723,6 +735,8 @@ public class Validate {
* @throws NullPointerException if the character sequence is {@code null}
* @throws IndexOutOfBoundsException if the index is invalid
* @see #validIndex(CharSequence, int)
+ *
+ * @since 3.0
*/
public static <T extends CharSequence> T validIndex(T chars, int index,
String message, Object... values) {
Validate.notNull(chars);
@@ -753,6 +767,8 @@ public class Validate {
* @throws NullPointerException if the character sequence is {@code null}
* @throws IndexOutOfBoundsException if the index is invalid
* @see #validIndex(CharSequence, int, String, Object...)
+ *
+ * @since 3.0
*/
public static <T extends CharSequence> T validIndex(T chars, int index) {
return validIndex(chars, index,
DEFAULT_VALID_INDEX_CHAR_SEQUENCE_EX_MESSAGE, Integer.valueOf(index));
@@ -777,6 +793,8 @@ public class Validate {
* @param expression the boolean expression to check
* @throws IllegalStateException if expression is {@code false}
* @see #validState(boolean, String, Object...)
+ *
+ * @since 3.0
*/
public static void validState(boolean expression) {
if (expression == false) {
@@ -797,6 +815,8 @@ public class Validate {
* @param values the optional values for the formatted exception message,
null array not recommended
* @throws IllegalStateException if expression is {@code false}
* @see #validState(boolean)
+ *
+ * @since 3.0
*/
public static void validState(boolean expression, String message,
Object... values) {
if (expression == false) {
@@ -819,6 +839,8 @@ public class Validate {
* @param pattern the regular expression pattern, not null
* @throws IllegalArgumentException if the character sequence does not
match the pattern
* @see #matchesPattern(CharSequence, String, String, Object...)
+ *
+ * @since 3.0
*/
public static void matchesPattern(CharSequence input, String pattern) {
if (Pattern.matches(pattern, input) == false) {
@@ -840,6 +862,8 @@ public class Validate {
* @param values the optional values for the formatted exception message,
null array not recommended
* @throws IllegalArgumentException if the character sequence does not
match the pattern
* @see #matchesPattern(CharSequence, String)
+ *
+ * @since 3.0
*/
public static void matchesPattern(CharSequence input, String pattern,
String message, Object... values) {
if (Pattern.matches(pattern, input) == false) {
@@ -861,6 +885,8 @@ public class Validate {
* @param value the object to validate, not null
* @throws IllegalArgumentException if the value falls out of the
boundaries
* @see #inclusiveBetween(Object, Object, Comparable, String, Object...)
+ *
+ * @since 3.0
*/
public static <T> void inclusiveBetween(T start, T end, Comparable<T>
value) {
if (value.compareTo(start) < 0 || value.compareTo(end) > 0) {
@@ -882,6 +908,8 @@ public class Validate {
* @param values the optional values for the formatted exception message,
null array not recommended
* @throws IllegalArgumentException if the value falls out of the
boundaries
* @see #inclusiveBetween(Object, Object, Comparable)
+ *
+ * @since 3.0
*/
public static <T> void inclusiveBetween(T start, T end, Comparable<T>
value, String message, Object... values) {
if (value.compareTo(start) < 0 || value.compareTo(end) > 0) {
@@ -903,6 +931,8 @@ public class Validate {
* @param value the object to validate, not null
* @throws IllegalArgumentException if the value falls out of the
boundaries
* @see #exclusiveBetween(Object, Object, Comparable, String, Object...)
+ *
+ * @since 3.0
*/
public static <T> void exclusiveBetween(T start, T end, Comparable<T>
value) {
if (value.compareTo(start) <= 0 || value.compareTo(end) >= 0) {
@@ -924,6 +954,8 @@ public class Validate {
* @param values the optional values for the formatted exception message,
null array not recommended
* @throws IllegalArgumentException if the value falls out of the
boundaries
* @see #exclusiveBetween(Object, Object, Comparable)
+ *
+ * @since 3.0
*/
public static <T> void exclusiveBetween(T start, T end, Comparable<T>
value, String message, Object... values) {
if (value.compareTo(start) <= 0 || value.compareTo(end) >= 0) {
@@ -948,6 +980,8 @@ public class Validate {
* @param obj the object to check, null throws an exception
* @throws IllegalArgumentException if argument is not of specified class
* @see #isInstanceOf(Class, Object, String, Object...)
+ *
+ * @since 3.0
*/
public static void isInstanceOf(Class<?> type, Object obj) {
if (type.isInstance(obj) == false) {
@@ -968,6 +1002,8 @@ public class Validate {
* @param values the optional values for the formatted exception message,
null array not recommended
* @throws IllegalArgumentException if argument is not of specified class
* @see #isInstanceOf(Class, Object)
+ *
+ * @since 3.0
*/
public static void isInstanceOf(Class<?> type, Object obj, String message,
Object... values) {
if (type.isInstance(obj) == false) {
@@ -992,6 +1028,8 @@ public class Validate {
* @param type the class to check, not null
* @throws IllegalArgumentException if argument can not be converted to
the specified class
* @see #isAssignableFrom(Class, Class, String, Object...)
+ *
+ * @since 3.0
*/
public static void isAssignableFrom(Class<?> superType, Class<?> type) {
if (superType.isAssignableFrom(type) == false) {
Modified:
commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/builder/ReflectionToStringBuilder.java
URL:
http://svn.apache.org/viewvc/commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/builder/ReflectionToStringBuilder.java?rev=1082044&r1=1082043&r2=1082044&view=diff
==============================================================================
---
commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/builder/ReflectionToStringBuilder.java
(original)
+++
commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/builder/ReflectionToStringBuilder.java
Wed Mar 16 04:26:58 2011
@@ -377,6 +377,8 @@ public class ReflectionToStringBuilder e
/**
* Which field names to exclude from output. Intended for fields like
<code>"password"</code>.
+ *
+ * @since 3.0 this is protected instead of private
*/
protected String[] excludeFieldNames;
Modified:
commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/concurrent/AtomicInitializer.java
URL:
http://svn.apache.org/viewvc/commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/concurrent/AtomicInitializer.java?rev=1082044&r1=1082043&r2=1082044&view=diff
==============================================================================
---
commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/concurrent/AtomicInitializer.java
(original)
+++
commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/concurrent/AtomicInitializer.java
Wed Mar 16 04:26:58 2011
@@ -61,6 +61,7 @@ import java.util.concurrent.atomic.Atomi
* </p>
*
* @author Apache Software Foundation
+ * @since 3.0
* @version $Id$
* @param <T> the type of the object managed by this initializer class
*/
Modified:
commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/concurrent/AtomicSafeInitializer.java
URL:
http://svn.apache.org/viewvc/commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/concurrent/AtomicSafeInitializer.java?rev=1082044&r1=1082043&r2=1082044&view=diff
==============================================================================
---
commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/concurrent/AtomicSafeInitializer.java
(original)
+++
commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/concurrent/AtomicSafeInitializer.java
Wed Mar 16 04:26:58 2011
@@ -50,6 +50,7 @@ import java.util.concurrent.atomic.Atomi
* </p>
*
* @author Apache Software Foundation
+ * @since 3.0
* @version $Id$
* @param <T> the type of the object managed by this initializer class
*/
Modified:
commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/concurrent/BackgroundInitializer.java
URL:
http://svn.apache.org/viewvc/commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/concurrent/BackgroundInitializer.java?rev=1082044&r1=1082043&r2=1082044&view=diff
==============================================================================
---
commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/concurrent/BackgroundInitializer.java
(original)
+++
commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/concurrent/BackgroundInitializer.java
Wed Mar 16 04:26:58 2011
@@ -79,6 +79,7 @@ import java.util.concurrent.Future;
* operation is complete or to cancel the operation.
* </p>
*
+ * @since 3.0
* @version $Id$
* @param <T> the type of the object managed by this initializer class
*/
Modified:
commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/concurrent/CallableBackgroundInitializer.java
URL:
http://svn.apache.org/viewvc/commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/concurrent/CallableBackgroundInitializer.java?rev=1082044&r1=1082043&r2=1082044&view=diff
==============================================================================
---
commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/concurrent/CallableBackgroundInitializer.java
(original)
+++
commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/concurrent/CallableBackgroundInitializer.java
Wed Mar 16 04:26:58 2011
@@ -61,6 +61,7 @@ import java.util.concurrent.ExecutorServ
*
* </p>
*
+ * @since 3.0
* @version $Id$
* @param <T> the type of the object managed by this initializer class
*/
Modified:
commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/concurrent/ConcurrentException.java
URL:
http://svn.apache.org/viewvc/commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/concurrent/ConcurrentException.java?rev=1082044&r1=1082043&r2=1082044&view=diff
==============================================================================
---
commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/concurrent/ConcurrentException.java
(original)
+++
commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/concurrent/ConcurrentException.java
Wed Mar 16 04:26:58 2011
@@ -30,6 +30,7 @@ package org.apache.commons.lang3.concurr
* </p>
*
* @author Apache Software Foundation
+ * @since 3.0
* @version $Id$
*/
public class ConcurrentException extends Exception {
Modified:
commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/concurrent/ConcurrentInitializer.java
URL:
http://svn.apache.org/viewvc/commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/concurrent/ConcurrentInitializer.java?rev=1082044&r1=1082043&r2=1082044&view=diff
==============================================================================
---
commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/concurrent/ConcurrentInitializer.java
(original)
+++
commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/concurrent/ConcurrentInitializer.java
Wed Mar 16 04:26:58 2011
@@ -35,6 +35,7 @@ package org.apache.commons.lang3.concurr
* </p>
*
* @author Apache Software Foundation
+ * @since 3.0
* @version $Id$
* @param <T> the type of the object managed by this initializer class
*/
Modified:
commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/concurrent/ConcurrentRuntimeException.java
URL:
http://svn.apache.org/viewvc/commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/concurrent/ConcurrentRuntimeException.java?rev=1082044&r1=1082043&r2=1082044&view=diff
==============================================================================
---
commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/concurrent/ConcurrentRuntimeException.java
(original)
+++
commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/concurrent/ConcurrentRuntimeException.java
Wed Mar 16 04:26:58 2011
@@ -31,6 +31,7 @@ package org.apache.commons.lang3.concurr
* </p>
*
* @author Apache Software Foundation
+ * @since 3.0
* @version $Id$
*/
public class ConcurrentRuntimeException extends RuntimeException {
Modified:
commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/concurrent/ConcurrentUtils.java
URL:
http://svn.apache.org/viewvc/commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/concurrent/ConcurrentUtils.java?rev=1082044&r1=1082043&r2=1082044&view=diff
==============================================================================
---
commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/concurrent/ConcurrentUtils.java
(original)
+++
commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/concurrent/ConcurrentUtils.java
Wed Mar 16 04:26:58 2011
@@ -28,6 +28,7 @@ import java.util.concurrent.TimeUnit;
* </p>
*
* @author Apache Software Foundation
+ * @since 3.0
* @version $Id$
*/
public class ConcurrentUtils {
Modified:
commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/concurrent/ConstantInitializer.java
URL:
http://svn.apache.org/viewvc/commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/concurrent/ConstantInitializer.java?rev=1082044&r1=1082043&r2=1082044&view=diff
==============================================================================
---
commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/concurrent/ConstantInitializer.java
(original)
+++
commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/concurrent/ConstantInitializer.java
Wed Mar 16 04:26:58 2011
@@ -35,6 +35,7 @@ import org.apache.commons.lang3.ObjectUt
* </p>
*
* @author Apache Software Foundation
+ * @since 3.0
* @version $Id$
* @param <T> the type of the object managed by this initializer
*/
Modified:
commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/concurrent/LazyInitializer.java
URL:
http://svn.apache.org/viewvc/commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/concurrent/LazyInitializer.java?rev=1082044&r1=1082043&r2=1082044&view=diff
==============================================================================
---
commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/concurrent/LazyInitializer.java
(original)
+++
commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/concurrent/LazyInitializer.java
Wed Mar 16 04:26:58 2011
@@ -73,6 +73,7 @@ package org.apache.commons.lang3.concurr
* </p>
*
* @author Apache Software Foundation
+ * @since 3.0
* @version $Id$
* @param <T> the type of the object managed by this initializer class
*/
Modified:
commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/concurrent/MultiBackgroundInitializer.java
URL:
http://svn.apache.org/viewvc/commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/concurrent/MultiBackgroundInitializer.java?rev=1082044&r1=1082043&r2=1082044&view=diff
==============================================================================
---
commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/concurrent/MultiBackgroundInitializer.java
(original)
+++
commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/concurrent/MultiBackgroundInitializer.java
Wed Mar 16 04:26:58 2011
@@ -91,6 +91,7 @@ import java.util.concurrent.ExecutorServ
* by {@code MultiBackgroundInitializer} waits forever.
* </p>
*
+ * @since 3.0
* @version $Id$
*/
public class MultiBackgroundInitializer
Modified:
commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/concurrent/TimedSemaphore.java
URL:
http://svn.apache.org/viewvc/commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/concurrent/TimedSemaphore.java?rev=1082044&r1=1082043&r2=1082044&view=diff
==============================================================================
---
commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/concurrent/TimedSemaphore.java
(original)
+++
commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/concurrent/TimedSemaphore.java
Wed Mar 16 04:26:58 2011
@@ -122,7 +122,8 @@ import java.util.concurrent.TimeUnit;
* resources. After that {@link #acquire()} must not be called any more.
* </p>
*
- * @version $Id:$
+ * @since 3.0
+ * @version $Id$
*/
public class TimedSemaphore {
/**
Modified:
commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/text/StrBuilder.java
URL:
http://svn.apache.org/viewvc/commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/text/StrBuilder.java?rev=1082044&r1=1082043&r2=1082044&view=diff
==============================================================================
---
commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/text/StrBuilder.java
(original)
+++
commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/text/StrBuilder.java
Wed Mar 16 04:26:58 2011
@@ -468,6 +468,7 @@ public class StrBuilder implements CharS
*
* @param seq the CharSequence to append
* @return this, to enable chaining
+ * @since 3.0
*/
public StrBuilder append(CharSequence seq) {
if (seq == null) {
@@ -484,6 +485,7 @@ public class StrBuilder implements CharS
* @param startIndex the start index, inclusive, must be valid
* @param length the length to append, must be valid
* @return this, to enable chaining
+ * @since 3.0
*/
public StrBuilder append(CharSequence seq, int startIndex, int length) {
if (seq == null) {
@@ -717,6 +719,7 @@ public class StrBuilder implements CharS
*
* @param ch the value to append
* @return this, to enable chaining
+ * @since 3.0
*/
public StrBuilder append(char ch) {
int len = length();
@@ -2000,6 +2003,7 @@ public class StrBuilder implements CharS
//-----------------------------------------------------------------------
/**
* {@inheritDoc}
+ * @since 3.0
*/
public CharSequence subSequence(int startIndex, int endIndex) {
if (startIndex < 0) {
