This is an automated email from the ASF dual-hosted git repository. ggregory pushed a commit to branch master in repository https://gitbox.apache.org/repos/asf/commons-lang.git
The following commit(s) were added to refs/heads/master by this push: new 5e91a0f9a No need for blank Javadoc lines between Javadoc @ tags 5e91a0f9a is described below commit 5e91a0f9af3ef910ab1e17cd2f0bf45a522bedc7 Author: Gary Gregory <garydgreg...@gmail.com> AuthorDate: Thu Nov 28 12:45:20 2024 -0500 No need for blank Javadoc lines between Javadoc @ tags --- src/main/java/org/apache/commons/lang3/ArrayUtils.java | 18 ------------------ .../org/apache/commons/lang3/SerializationUtils.java | 1 - .../org/apache/commons/lang3/StringEscapeUtils.java | 9 --------- .../java/org/apache/commons/lang3/StringUtils.java | 8 -------- .../java/org/apache/commons/lang3/SystemUtils.java | 1 - .../java/org/apache/commons/lang3/ThreadUtils.java | 2 -- .../java/org/apache/commons/lang3/arch/Processor.java | 1 - .../java/org/apache/commons/lang3/builder/Builder.java | 1 - .../org/apache/commons/lang3/builder/DiffResult.java | 1 - .../apache/commons/lang3/builder/EqualsBuilder.java | 6 ------ .../lang3/builder/ReflectionToStringBuilder.java | 1 - .../apache/commons/lang3/builder/ToStringBuilder.java | 1 - .../org/apache/commons/lang3/builder/package-info.java | 1 - .../lang3/concurrent/BackgroundInitializer.java | 1 - .../org/apache/commons/lang3/concurrent/Memoizer.java | 1 - .../commons/lang3/concurrent/UncheckedFuture.java | 3 --- .../commons/lang3/event/EventListenerSupport.java | 4 ---- .../org/apache/commons/lang3/event/EventUtils.java | 1 - .../org/apache/commons/lang3/function/Consumers.java | 1 - .../org/apache/commons/lang3/function/Functions.java | 1 - .../commons/lang3/function/ToBooleanBiFunction.java | 1 - .../org/apache/commons/lang3/function/TriFunction.java | 1 - .../apache/commons/lang3/reflect/ConstructorUtils.java | 4 ---- .../org/apache/commons/lang3/reflect/MethodUtils.java | 15 --------------- .../org/apache/commons/lang3/reflect/TypeUtils.java | 1 - .../java/org/apache/commons/lang3/text/StrBuilder.java | 2 -- .../commons/lang3/text/translate/UnicodeEscaper.java | 1 - .../apache/commons/lang3/time/AbstractFormatCache.java | 1 - .../org/apache/commons/lang3/time/FastDatePrinter.java | 1 - .../java/org/apache/commons/lang3/time/StopWatch.java | 6 ------ .../org/apache/commons/lang3/tuple/ImmutablePair.java | 2 -- .../apache/commons/lang3/tuple/ImmutableTriple.java | 2 -- .../org/apache/commons/lang3/tuple/MutablePair.java | 2 -- .../org/apache/commons/lang3/tuple/MutableTriple.java | 2 -- src/main/java/org/apache/commons/lang3/tuple/Pair.java | 2 -- .../java/org/apache/commons/lang3/tuple/Triple.java | 2 -- .../concurrent/MultiBackgroundInitializerTest.java | 1 - .../apache/commons/lang3/time/FastDateParserTest.java | 1 - 38 files changed, 110 deletions(-) diff --git a/src/main/java/org/apache/commons/lang3/ArrayUtils.java b/src/main/java/org/apache/commons/lang3/ArrayUtils.java index fa90a927b..4545b18d7 100644 --- a/src/main/java/org/apache/commons/lang3/ArrayUtils.java +++ b/src/main/java/org/apache/commons/lang3/ArrayUtils.java @@ -5442,7 +5442,6 @@ public class ArrayUtils { * * @param element the element to remove * @param array the input array - * * @return A new array containing the existing elements except the occurrences of the specified element. * @since 3.5 * @deprecated Use {@link #removeAllOccurrences(boolean[], boolean)} @@ -5462,7 +5461,6 @@ public class ArrayUtils { * * @param element the element to remove * @param array the input array - * * @return A new array containing the existing elements except the occurrences of the specified element. * @since 3.5 * @deprecated Use {@link #removeAllOccurrences(byte[], byte)} @@ -5482,7 +5480,6 @@ public class ArrayUtils { * * @param element the element to remove * @param array the input array - * * @return A new array containing the existing elements except the occurrences of the specified element. * @since 3.5 * @deprecated Use {@link #removeAllOccurrences(char[], char)} @@ -5502,7 +5499,6 @@ public class ArrayUtils { * * @param element the element to remove * @param array the input array - * * @return A new array containing the existing elements except the occurrences of the specified element. * @since 3.5 * @deprecated Use {@link #removeAllOccurrences(double[], double)} @@ -5522,7 +5518,6 @@ public class ArrayUtils { * * @param element the element to remove * @param array the input array - * * @return A new array containing the existing elements except the occurrences of the specified element. * @since 3.5 * @deprecated Use {@link #removeAllOccurrences(float[], float)} @@ -5542,7 +5537,6 @@ public class ArrayUtils { * * @param element the element to remove * @param array the input array - * * @return A new array containing the existing elements except the occurrences of the specified element. * @since 3.5 * @deprecated Use {@link #removeAllOccurrences(int[], int)} @@ -5562,7 +5556,6 @@ public class ArrayUtils { * * @param element the element to remove * @param array the input array - * * @return A new array containing the existing elements except the occurrences of the specified element. * @since 3.5 * @deprecated Use {@link #removeAllOccurrences(long[], long)} @@ -5582,7 +5575,6 @@ public class ArrayUtils { * * @param element the element to remove * @param array the input array - * * @return A new array containing the existing elements except the occurrences of the specified element. * @since 3.5 * @deprecated Use {@link #removeAllOccurrences(short[], short)} @@ -5603,7 +5595,6 @@ public class ArrayUtils { * @param <T> the type of object in the array * @param element the element to remove * @param array the input array - * * @return A new array containing the existing elements except the occurrences of the specified element. * @since 3.5 * @deprecated Use {@link #removeAllOccurrences(Object[], Object)} @@ -5623,7 +5614,6 @@ public class ArrayUtils { * * @param element the element to remove * @param array the input array - * * @return A new array containing the existing elements except the occurrences of the specified element. * @since 3.10 */ @@ -5641,7 +5631,6 @@ public class ArrayUtils { * * @param element the element to remove * @param array the input array - * * @return A new array containing the existing elements except the occurrences of the specified element. * @since 3.10 */ @@ -5659,7 +5648,6 @@ public class ArrayUtils { * * @param element the element to remove * @param array the input array - * * @return A new array containing the existing elements except the occurrences of the specified element. * @since 3.10 */ @@ -5677,7 +5665,6 @@ public class ArrayUtils { * * @param element the element to remove * @param array the input array - * * @return A new array containing the existing elements except the occurrences of the specified element. * @since 3.10 */ @@ -5695,7 +5682,6 @@ public class ArrayUtils { * * @param element the element to remove * @param array the input array - * * @return A new array containing the existing elements except the occurrences of the specified element. * @since 3.10 */ @@ -5713,7 +5699,6 @@ public class ArrayUtils { * * @param element the element to remove * @param array the input array - * * @return A new array containing the existing elements except the occurrences of the specified element. * @since 3.10 */ @@ -5731,7 +5716,6 @@ public class ArrayUtils { * * @param element the element to remove * @param array the input array - * * @return A new array containing the existing elements except the occurrences of the specified element. * @since 3.10 */ @@ -5749,7 +5733,6 @@ public class ArrayUtils { * * @param element the element to remove * @param array the input array - * * @return A new array containing the existing elements except the occurrences of the specified element. * @since 3.10 */ @@ -5768,7 +5751,6 @@ public class ArrayUtils { * @param <T> the type of object in the array * @param element the element to remove * @param array the input array - * * @return A new array containing the existing elements except the occurrences of the specified element. * @since 3.10 */ diff --git a/src/main/java/org/apache/commons/lang3/SerializationUtils.java b/src/main/java/org/apache/commons/lang3/SerializationUtils.java index bffc1c252..53c695aba 100644 --- a/src/main/java/org/apache/commons/lang3/SerializationUtils.java +++ b/src/main/java/org/apache/commons/lang3/SerializationUtils.java @@ -258,7 +258,6 @@ public class SerializationUtils { * <p>This constructor is public to permit tools that require a JavaBean instance * to operate.</p> * @since 2.0 - * * @deprecated TODO Make private in 4.0. */ @Deprecated diff --git a/src/main/java/org/apache/commons/lang3/StringEscapeUtils.java b/src/main/java/org/apache/commons/lang3/StringEscapeUtils.java index bfc455ee1..dc1254f9b 100644 --- a/src/main/java/org/apache/commons/lang3/StringEscapeUtils.java +++ b/src/main/java/org/apache/commons/lang3/StringEscapeUtils.java @@ -459,7 +459,6 @@ 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(final String input) { @@ -472,7 +471,6 @@ public class StringEscapeUtils { * * @param input the {@link String} to escape, may be null * @return a new escaped {@link String}, {@code null} if null string input - * * @since 3.0 */ public static final String escapeHtml3(final String input) { @@ -497,13 +495,11 @@ public class StringEscapeUtils { * * @param input the {@link String} to escape, may be null * @return a new escaped {@link String}, {@code null} if null string input - * * @see <a href="https://web.archive.org/web/20060225074150/https://hotwired.lycos.com/webmonkey/reference/special_characters/">ISO Entities</a> * @see <a href="https://www.w3.org/TR/REC-html32#latin1">HTML 3.2 Character Entities for ISO Latin-1</a> * @see <a href="https://www.w3.org/TR/REC-html40/sgml/entities.html">HTML 4.0 Character entity references</a> * @see <a href="https://www.w3.org/TR/html401/charset.html#h-5.3">HTML 4.01 Character References</a> * @see <a href="https://www.w3.org/TR/html401/charset.html#code-position">HTML 4.01 Code positions</a> - * * @since 3.0 */ public static final String escapeHtml4(final String input) { @@ -555,7 +551,6 @@ 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.2 */ public static final String escapeJson(final String input) { @@ -684,7 +679,6 @@ public class StringEscapeUtils { * @see #unescapeJava(String) * @param input the {@link String} to unescape, may be null * @return A new unescaped {@link String}, {@code null} if null string input - * * @since 3.0 */ public static final String unescapeEcmaScript(final String input) { @@ -698,7 +692,6 @@ public class StringEscapeUtils { * * @param input the {@link String} to unescape, may be null * @return a new unescaped {@link String}, {@code null} if null string input - * * @since 3.0 */ public static final String unescapeHtml3(final String input) { @@ -719,7 +712,6 @@ public class StringEscapeUtils { * * @param input the {@link String} to unescape, may be null * @return a new unescaped {@link String}, {@code null} if null string input - * * @since 3.0 */ public static final String unescapeHtml4(final String input) { @@ -749,7 +741,6 @@ public class StringEscapeUtils { * @see #unescapeJava(String) * @param input the {@link String} to unescape, may be null * @return A new unescaped {@link String}, {@code null} if null string input - * * @since 3.2 */ public static final String unescapeJson(final String input) { diff --git a/src/main/java/org/apache/commons/lang3/StringUtils.java b/src/main/java/org/apache/commons/lang3/StringUtils.java index ec0cf5119..60ecbceea 100644 --- a/src/main/java/org/apache/commons/lang3/StringUtils.java +++ b/src/main/java/org/apache/commons/lang3/StringUtils.java @@ -5381,7 +5381,6 @@ public class StringUtils { * href="https://www.w3.org/TR/xpath/#function-normalize-space">https://www.w3.org/TR/xpath/#function-normalize-space</a> * @param str the source String to normalize whitespaces from, may be null * @return the modified string with whitespace normalized, {@code null} if null String input - * * @since 3.0 */ public static String normalizeSpace(final String str) { @@ -5752,7 +5751,6 @@ public class StringUtils { * @see java.util.regex.Pattern * @see java.util.regex.Pattern#DOTALL * @since 3.5 - * * @deprecated Moved to RegExUtils. */ @Deprecated @@ -5863,7 +5861,6 @@ public class StringUtils { * @see java.util.regex.Pattern * @see java.util.regex.Pattern#DOTALL * @since 3.5 - * * @deprecated Moved to RegExUtils. */ @Deprecated @@ -5936,7 +5933,6 @@ public class StringUtils { * @see Pattern#DOTALL * @since 3.2 * @since 3.5 Changed {@code null} reference passed to this method is a no-op. - * * @deprecated Moved to RegExUtils. */ @Deprecated @@ -6259,7 +6255,6 @@ public class StringUtils { * @see java.util.regex.Pattern * @see java.util.regex.Pattern#DOTALL * @since 3.5 - * * @deprecated Moved to RegExUtils. */ @Deprecated @@ -6657,7 +6652,6 @@ public class StringUtils { * @see java.util.regex.Pattern * @see java.util.regex.Pattern#DOTALL * @since 3.5 - * * @deprecated Moved to RegExUtils. */ @Deprecated @@ -6828,7 +6822,6 @@ public class StringUtils { * @see Pattern#DOTALL * @since 3.2 * @since 3.5 Changed {@code null} reference passed to this method is a no-op. - * * @deprecated Moved to RegExUtils. */ @Deprecated @@ -7927,7 +7920,6 @@ public class StringUtils { * * @param input String to be stripped * @return input text with diacritics removed - * * @since 3.0 */ // See also Lucene's ASCIIFoldingFilter (Lucene 2.9) that replaces accented characters by their unaccented equivalent (and uncommitted bug fix: https://issues.apache.org/jira/browse/LUCENE-1343?focusedCommentId=12858907&page=com.atlassian.jira.plugin.system.issuetabpanels%3Acomment-tabpanel#action_12858907). diff --git a/src/main/java/org/apache/commons/lang3/SystemUtils.java b/src/main/java/org/apache/commons/lang3/SystemUtils.java index 3426b17c1..726f01add 100644 --- a/src/main/java/org/apache/commons/lang3/SystemUtils.java +++ b/src/main/java/org/apache/commons/lang3/SystemUtils.java @@ -862,7 +862,6 @@ public class SystemUtils { * </p> * * @since 3.4 - * * @deprecated As of release 3.5, replaced by {@link #IS_JAVA_9} */ @Deprecated diff --git a/src/main/java/org/apache/commons/lang3/ThreadUtils.java b/src/main/java/org/apache/commons/lang3/ThreadUtils.java index 36c12b35f..a523f76a8 100644 --- a/src/main/java/org/apache/commons/lang3/ThreadUtils.java +++ b/src/main/java/org/apache/commons/lang3/ThreadUtils.java @@ -342,7 +342,6 @@ public class ThreadUtils { * * @param predicate the predicate * @return An unmodifiable {@link Collection} of active threads matching the given predicate - * * @throws NullPointerException if the predicate is null * @throws SecurityException * if the current thread cannot access the system thread group @@ -401,7 +400,6 @@ public class ThreadUtils { * * @param predicate the predicate * @return An unmodifiable {@link Collection} of active threads matching the given predicate - * * @throws NullPointerException if the predicate is null * @throws SecurityException * if the current thread cannot access the system thread group diff --git a/src/main/java/org/apache/commons/lang3/arch/Processor.java b/src/main/java/org/apache/commons/lang3/arch/Processor.java index 675e1b3c2..4d3f73f49 100644 --- a/src/main/java/org/apache/commons/lang3/arch/Processor.java +++ b/src/main/java/org/apache/commons/lang3/arch/Processor.java @@ -199,7 +199,6 @@ public class Processor { * Tests if {@link Processor} is type of Aarch64. * * @return {@code true}, if {@link Processor} is {@link Type#AARCH_64}, else {@code false}. - * * @since 3.13.0 */ public boolean isAarch64() { diff --git a/src/main/java/org/apache/commons/lang3/builder/Builder.java b/src/main/java/org/apache/commons/lang3/builder/Builder.java index e7eaf19ee..1f8cfe344 100644 --- a/src/main/java/org/apache/commons/lang3/builder/Builder.java +++ b/src/main/java/org/apache/commons/lang3/builder/Builder.java @@ -70,7 +70,6 @@ package org.apache.commons.lang3.builder; * }</pre> * * @param <T> the type of object that the builder will construct or compute. - * * @since 3.0 */ @FunctionalInterface diff --git a/src/main/java/org/apache/commons/lang3/builder/DiffResult.java b/src/main/java/org/apache/commons/lang3/builder/DiffResult.java index 3cd2699ca..73c124a55 100644 --- a/src/main/java/org/apache/commons/lang3/builder/DiffResult.java +++ b/src/main/java/org/apache/commons/lang3/builder/DiffResult.java @@ -33,7 +33,6 @@ import org.apache.commons.lang3.StringUtils; * Use a {@link DiffBuilder} to build a {@link DiffResult} comparing two objects. * </p> * @param <T> type of the left and right object. - * * @since 3.3 */ public class DiffResult<T> implements Iterable<Diff<?>> { diff --git a/src/main/java/org/apache/commons/lang3/builder/EqualsBuilder.java b/src/main/java/org/apache/commons/lang3/builder/EqualsBuilder.java index ddd7ce002..8a6a1e7d9 100644 --- a/src/main/java/org/apache/commons/lang3/builder/EqualsBuilder.java +++ b/src/main/java/org/apache/commons/lang3/builder/EqualsBuilder.java @@ -117,7 +117,6 @@ public class EqualsBuilder implements Builder<Boolean> { * * @param lhs {@code this} object * @param rhs the other object - * * @return the pair */ static Pair<IDKey, IDKey> getRegisterPair(final Object lhs, final Object rhs) { @@ -173,7 +172,6 @@ public class EqualsBuilder implements Builder<Boolean> { * @param rhs the other object * @param testTransients whether to include transient fields * @return {@code true} if the two Objects have tested equals. - * * @see EqualsExclude */ public static boolean reflectionEquals(final Object lhs, final Object rhs, final boolean testTransients) { @@ -212,7 +210,6 @@ public class EqualsBuilder implements Builder<Boolean> { * fields recursively. * @param excludeFields array of field names to exclude from testing * @return {@code true} if the two Objects have tested equals. - * * @see EqualsExclude * @since 3.6 */ @@ -260,7 +257,6 @@ public class EqualsBuilder implements Builder<Boolean> { * may be {@code null} * @param excludeFields array of field names to exclude from testing * @return {@code true} if the two Objects have tested equals. - * * @see EqualsExclude * @since 2.0 */ @@ -288,7 +284,6 @@ public class EqualsBuilder implements Builder<Boolean> { * @param rhs the other object * @param excludeFields Collection of String field names to exclude from testing * @return {@code true} if the two Objects have tested equals. - * * @see EqualsExclude */ public static boolean reflectionEquals(final Object lhs, final Object rhs, final Collection<String> excludeFields) { @@ -314,7 +309,6 @@ public class EqualsBuilder implements Builder<Boolean> { * @param rhs the other object * @param excludeFields array of field names to exclude from testing * @return {@code true} if the two Objects have tested equals. - * * @see EqualsExclude */ public static boolean reflectionEquals(final Object lhs, final Object rhs, final String... excludeFields) { diff --git a/src/main/java/org/apache/commons/lang3/builder/ReflectionToStringBuilder.java b/src/main/java/org/apache/commons/lang3/builder/ReflectionToStringBuilder.java index 31b1e1f6e..06c9be817 100644 --- a/src/main/java/org/apache/commons/lang3/builder/ReflectionToStringBuilder.java +++ b/src/main/java/org/apache/commons/lang3/builder/ReflectionToStringBuilder.java @@ -700,7 +700,6 @@ public class ReflectionToStringBuilder extends ToStringBuilder { * @param field * The Field to query. * @return The Object from the given Field. - * * @throws IllegalArgumentException * see {@link java.lang.reflect.Field#get(Object)} * @throws IllegalAccessException diff --git a/src/main/java/org/apache/commons/lang3/builder/ToStringBuilder.java b/src/main/java/org/apache/commons/lang3/builder/ToStringBuilder.java index 5bb415b2e..7bfc1f1fe 100644 --- a/src/main/java/org/apache/commons/lang3/builder/ToStringBuilder.java +++ b/src/main/java/org/apache/commons/lang3/builder/ToStringBuilder.java @@ -973,7 +973,6 @@ public class ToStringBuilder implements Builder<String> { * default implementation utilizes the {@link #toString()} implementation. * * @return the String {@code toString} - * * @see #toString() * * @since 3.0 diff --git a/src/main/java/org/apache/commons/lang3/builder/package-info.java b/src/main/java/org/apache/commons/lang3/builder/package-info.java index f080312d9..da3262b9b 100644 --- a/src/main/java/org/apache/commons/lang3/builder/package-info.java +++ b/src/main/java/org/apache/commons/lang3/builder/package-info.java @@ -28,7 +28,6 @@ * @see Object#toString() * @see Object#hashCode() * @see Comparable#compareTo(Object) - * * @since 1.0 */ package org.apache.commons.lang3.builder; diff --git a/src/main/java/org/apache/commons/lang3/concurrent/BackgroundInitializer.java b/src/main/java/org/apache/commons/lang3/concurrent/BackgroundInitializer.java index b5db2384d..69a5229b1 100644 --- a/src/main/java/org/apache/commons/lang3/concurrent/BackgroundInitializer.java +++ b/src/main/java/org/apache/commons/lang3/concurrent/BackgroundInitializer.java @@ -118,7 +118,6 @@ public class BackgroundInitializer<T> extends AbstractConcurrentInitializer<T, E * Sets the external executor service for executing tasks. null is a permitted value. * * @see org.apache.commons.lang3.concurrent.BackgroundInitializer#setExternalExecutor(ExecutorService) - * * @param externalExecutor the {@link ExecutorService} to be used. * @return {@code this} instance. */ diff --git a/src/main/java/org/apache/commons/lang3/concurrent/Memoizer.java b/src/main/java/org/apache/commons/lang3/concurrent/Memoizer.java index 0e5f38117..6bada5d86 100644 --- a/src/main/java/org/apache/commons/lang3/concurrent/Memoizer.java +++ b/src/main/java/org/apache/commons/lang3/concurrent/Memoizer.java @@ -42,7 +42,6 @@ import org.apache.commons.lang3.exception.ExceptionUtils; * * @param <I> the type of the input to the calculation * @param <O> the type of the output of the calculation - * * @since 3.6 */ public class Memoizer<I, O> implements Computable<I, O> { diff --git a/src/main/java/org/apache/commons/lang3/concurrent/UncheckedFuture.java b/src/main/java/org/apache/commons/lang3/concurrent/UncheckedFuture.java index a8cc0b77b..3a7b632fa 100644 --- a/src/main/java/org/apache/commons/lang3/concurrent/UncheckedFuture.java +++ b/src/main/java/org/apache/commons/lang3/concurrent/UncheckedFuture.java @@ -41,7 +41,6 @@ public interface UncheckedFuture<V> extends Future<V> { * Maps the given instances as unchecked. * * @param <T> The result type returned by the Futures' {@link #get()} and {@link #get(long, TimeUnit)} methods. - * * @param futures The Futures to uncheck. * @return a new stream. */ @@ -53,7 +52,6 @@ public interface UncheckedFuture<V> extends Future<V> { * Maps the given instances as unchecked. * * @param <T> The result type returned by the Futures' {@link #get()} and {@link #get(long, TimeUnit)} methods. - * * @param futures The Futures to uncheck. * @return a new collection. */ @@ -65,7 +63,6 @@ public interface UncheckedFuture<V> extends Future<V> { * Creates a new instance on the given Future. * * @param <T> The result type returned by this Future's {@link #get()} and {@link #get(long, TimeUnit)} methods. - * * @param future The Future to uncheck. * @return a new instance. */ diff --git a/src/main/java/org/apache/commons/lang3/event/EventListenerSupport.java b/src/main/java/org/apache/commons/lang3/event/EventListenerSupport.java index 349316e0e..8a74e0dce 100644 --- a/src/main/java/org/apache/commons/lang3/event/EventListenerSupport.java +++ b/src/main/java/org/apache/commons/lang3/event/EventListenerSupport.java @@ -66,7 +66,6 @@ import org.apache.commons.lang3.function.FailableConsumer; * </p> * * @param <L> the type of event listener that is supported by this proxy. - * * @since 3.0 */ public class EventListenerSupport<L> implements Serializable { @@ -204,7 +203,6 @@ public class EventListenerSupport<L> implements Serializable { * * @param listenerInterface the listener interface. * @param classLoader the class loader. - * * @throws NullPointerException if {@code listenerInterface} or * {@code classLoader} is {@code null}. * @throws IllegalArgumentException if {@code listenerInterface} is @@ -223,7 +221,6 @@ public class EventListenerSupport<L> implements Serializable { * Registers an event listener. * * @param listener the event listener (may not be {@code null}). - * * @throws NullPointerException if {@code listener} is * {@code null}. */ @@ -332,7 +329,6 @@ public class EventListenerSupport<L> implements Serializable { * Unregisters an event listener. * * @param listener the event listener (may not be {@code null}). - * * @throws NullPointerException if {@code listener} is * {@code null}. */ diff --git a/src/main/java/org/apache/commons/lang3/event/EventUtils.java b/src/main/java/org/apache/commons/lang3/event/EventUtils.java index 0708a5d41..c5a21415d 100644 --- a/src/main/java/org/apache/commons/lang3/event/EventUtils.java +++ b/src/main/java/org/apache/commons/lang3/event/EventUtils.java @@ -89,7 +89,6 @@ public class EventUtils { * @param listenerType the event listener type * @param listener the listener * @param <L> the event listener type - * * @throws IllegalArgumentException if the object doesn't support the listener type */ public static <L> void addEventListener(final Object eventSource, final Class<L> listenerType, final L listener) { diff --git a/src/main/java/org/apache/commons/lang3/function/Consumers.java b/src/main/java/org/apache/commons/lang3/function/Consumers.java index 202a024ee..fd62d299d 100644 --- a/src/main/java/org/apache/commons/lang3/function/Consumers.java +++ b/src/main/java/org/apache/commons/lang3/function/Consumers.java @@ -36,7 +36,6 @@ public class Consumers { * * @param consumer the consumer to consume. * @param object the object to be consumed. - * * @param <T> the type of the argument the consumer accepts. * @since 3.15.0 */ diff --git a/src/main/java/org/apache/commons/lang3/function/Functions.java b/src/main/java/org/apache/commons/lang3/function/Functions.java index e5c5ea546..89252c371 100644 --- a/src/main/java/org/apache/commons/lang3/function/Functions.java +++ b/src/main/java/org/apache/commons/lang3/function/Functions.java @@ -31,7 +31,6 @@ public final class Functions { * * @param function the function to apply. * @param object the object to apply the function. - * * @param <T> the type of the argument the function applies. * @param <R> the type of the result the function returns. * @return the value the function returns if the function is not {@code null}; {@code null} otherwise. diff --git a/src/main/java/org/apache/commons/lang3/function/ToBooleanBiFunction.java b/src/main/java/org/apache/commons/lang3/function/ToBooleanBiFunction.java index 09bdb73eb..cc5224558 100644 --- a/src/main/java/org/apache/commons/lang3/function/ToBooleanBiFunction.java +++ b/src/main/java/org/apache/commons/lang3/function/ToBooleanBiFunction.java @@ -25,7 +25,6 @@ import java.util.function.BiFunction; * * @param <T> the type of the first argument to the function. * @param <U> the type of the second argument to the function. - * * @see BiFunction * @since 3.12.0 */ diff --git a/src/main/java/org/apache/commons/lang3/function/TriFunction.java b/src/main/java/org/apache/commons/lang3/function/TriFunction.java index 9aa09e3ed..4c1f6c11f 100644 --- a/src/main/java/org/apache/commons/lang3/function/TriFunction.java +++ b/src/main/java/org/apache/commons/lang3/function/TriFunction.java @@ -32,7 +32,6 @@ import java.util.function.Function; * @param <U> the type of the second argument to the function * @param <V> the type of the third argument to the function * @param <R> the type of the result of the function - * * @see Function * @since 3.12.0 */ diff --git a/src/main/java/org/apache/commons/lang3/reflect/ConstructorUtils.java b/src/main/java/org/apache/commons/lang3/reflect/ConstructorUtils.java index e7fde11a6..e9972f730 100644 --- a/src/main/java/org/apache/commons/lang3/reflect/ConstructorUtils.java +++ b/src/main/java/org/apache/commons/lang3/reflect/ConstructorUtils.java @@ -152,7 +152,6 @@ public class ConstructorUtils { * @param cls the class to be constructed, not {@code null} * @param args the array of arguments, {@code null} treated as empty * @return new instance of {@code cls}, not {@code null} - * * @throws NullPointerException if {@code cls} is {@code null} * @throws NoSuchMethodException if a matching constructor cannot be found * @throws IllegalAccessException if invocation is not permitted by security @@ -179,7 +178,6 @@ public class ConstructorUtils { * @param args the array of arguments, {@code null} treated as empty * @param parameterTypes the array of parameter types, {@code null} treated as empty * @return new instance of {@code cls}, not {@code null} - * * @throws NullPointerException if {@code cls} is {@code null} * @throws NoSuchMethodException if a matching constructor cannot be found * @throws IllegalAccessException if invocation is not permitted by security @@ -215,7 +213,6 @@ public class ConstructorUtils { * @param cls the class to be constructed, not {@code null} * @param args the array of arguments, {@code null} treated as empty * @return new instance of {@code cls}, not {@code null} - * * @throws NullPointerException if {@code cls} is {@code null} * @throws NoSuchMethodException if a matching constructor cannot be found * @throws IllegalAccessException if invocation is not permitted by security @@ -242,7 +239,6 @@ public class ConstructorUtils { * @param args the array of arguments, {@code null} treated as empty * @param parameterTypes the array of parameter types, {@code null} treated as empty * @return new instance of {@code cls}, not {@code null} - * * @throws NullPointerException if {@code cls} is {@code null} * @throws NoSuchMethodException if a matching constructor cannot be found * @throws IllegalAccessException if invocation is not permitted by security diff --git a/src/main/java/org/apache/commons/lang3/reflect/MethodUtils.java b/src/main/java/org/apache/commons/lang3/reflect/MethodUtils.java index 86594fd77..f1b6e04c6 100644 --- a/src/main/java/org/apache/commons/lang3/reflect/MethodUtils.java +++ b/src/main/java/org/apache/commons/lang3/reflect/MethodUtils.java @@ -371,7 +371,6 @@ public class MethodUtils { * @throws IllegalStateException if there is no unique result * @throws NullPointerException if the class is {@code null} * @return The method - * * @since 3.5 */ public static Method getMatchingMethod(final Class<?> cls, final String methodName, @@ -618,7 +617,6 @@ public class MethodUtils { * @param object invoke method on this object * @param methodName get method with this name * @return The value returned by the invoked method - * * @throws NoSuchMethodException if there is no such accessible method * @throws InvocationTargetException wraps an exception thrown by the * method invoked @@ -642,7 +640,6 @@ public class MethodUtils { * @param methodName get method with this name * @param args use these arguments - treat null as empty array * @return The value returned by the invoked method - * * @throws NoSuchMethodException if there is no such accessible method * @throws InvocationTargetException wraps an exception thrown by the * method invoked @@ -669,7 +666,6 @@ public class MethodUtils { * @param args use these arguments - treat null as empty array * @param parameterTypes match these parameters - treat {@code null} as empty array * @return The value returned by the invoked method - * * @throws NoSuchMethodException if there is no such accessible method * @throws InvocationTargetException wraps an exception thrown by the * method invoked @@ -701,7 +697,6 @@ public class MethodUtils { * @param methodName get method with this name * @param args use these arguments - treat {@code null} as empty array * @return The value returned by the invoked method - * * @throws NoSuchMethodException if there is no such accessible method * @throws InvocationTargetException wraps an exception thrown by the * method invoked @@ -727,7 +722,6 @@ public class MethodUtils { * @param args use these arguments - treat {@code null} as empty array * @param parameterTypes match these parameters - treat {@code null} as empty array * @return The value returned by the invoked method - * * @throws NoSuchMethodException if there is no such accessible method * @throws InvocationTargetException wraps an exception thrown by the * method invoked @@ -759,11 +753,9 @@ public class MethodUtils { * @param forceAccess force access to invoke method even if it's not accessible * @param methodName get method with this name * @return The value returned by the invoked method - * * @throws NoSuchMethodException if there is no such accessible method * @throws InvocationTargetException wraps an exception thrown by the method invoked * @throws IllegalAccessException if the requested method is not accessible via reflection - * * @since 3.5 */ public static Object invokeMethod(final Object object, final boolean forceAccess, final String methodName) @@ -787,7 +779,6 @@ public class MethodUtils { * @param methodName get method with this name * @param args use these arguments - treat null as empty array * @return The value returned by the invoked method - * * @throws NoSuchMethodException if there is no such accessible method * @throws InvocationTargetException wraps an exception thrown by the method invoked * @throws IllegalAccessException if the requested method is not accessible via reflection @@ -814,7 +805,6 @@ public class MethodUtils { * @param args use these arguments - treat null as empty array * @param parameterTypes match these parameters - treat null as empty array * @return The value returned by the invoked method - * * @throws NoSuchMethodException if there is no such accessible method * @throws InvocationTargetException wraps an exception thrown by the method invoked * @throws IllegalAccessException if the requested method is not accessible via reflection @@ -862,7 +852,6 @@ public class MethodUtils { * @param object invoke method on this object * @param methodName get method with this name * @return The value returned by the invoked method - * * @throws NoSuchMethodException if there is no such accessible method * @throws InvocationTargetException wraps an exception thrown by the method invoked * @throws IllegalAccessException if the requested method is not accessible via reflection @@ -891,7 +880,6 @@ public class MethodUtils { * @param methodName get method with this name * @param args use these arguments - treat null as empty array * @return The value returned by the invoked method - * * @throws NoSuchMethodException if there is no such accessible method * @throws InvocationTargetException wraps an exception thrown by the method invoked * @throws IllegalAccessException if the requested method is not accessible via reflection @@ -918,7 +906,6 @@ public class MethodUtils { * @param args use these arguments - treat null as empty array * @param parameterTypes match these parameters - treat null as empty array * @return The value returned by the invoked method - * * @throws NoSuchMethodException if there is no such accessible method * @throws InvocationTargetException wraps an exception thrown by the method invoked * @throws IllegalAccessException if the requested method is not accessible via reflection @@ -947,7 +934,6 @@ public class MethodUtils { * @param methodName get method with this name * @param args use these arguments - treat {@code null} as empty array * @return The value returned by the invoked method - * * @throws NoSuchMethodException if there is no such accessible method * @throws InvocationTargetException wraps an exception thrown by the * method invoked @@ -975,7 +961,6 @@ public class MethodUtils { * @param args use these arguments - treat {@code null} as empty array * @param parameterTypes match these parameters - treat {@code null} as empty array * @return The value returned by the invoked method - * * @throws NoSuchMethodException if there is no such accessible method * @throws InvocationTargetException wraps an exception thrown by the * method invoked diff --git a/src/main/java/org/apache/commons/lang3/reflect/TypeUtils.java b/src/main/java/org/apache/commons/lang3/reflect/TypeUtils.java index e2dafb272..e864c8624 100644 --- a/src/main/java/org/apache/commons/lang3/reflect/TypeUtils.java +++ b/src/main/java/org/apache/commons/lang3/reflect/TypeUtils.java @@ -1561,7 +1561,6 @@ public class TypeUtils { * @param owner the owning type * @param rawClass the raw class to create a parameterized type instance for * @param typeArguments the types used for parameterization - * * @return {@link ParameterizedType} * @throws NullPointerException if {@code rawClass} is {@code null} * @since 3.2 diff --git a/src/main/java/org/apache/commons/lang3/text/StrBuilder.java b/src/main/java/org/apache/commons/lang3/text/StrBuilder.java index e70c9f3f4..a76b3857e 100644 --- a/src/main/java/org/apache/commons/lang3/text/StrBuilder.java +++ b/src/main/java/org/apache/commons/lang3/text/StrBuilder.java @@ -1372,7 +1372,6 @@ public class StrBuilder implements CharSequence, Appendable, Serializable, Build * * @param appendable the appendable to append data to * @throws IOException if an I/O error occurs - * * @since 3.4 * @see #readFrom(Readable) */ @@ -2486,7 +2485,6 @@ public class StrBuilder implements CharSequence, Appendable, Serializable, Build * @param readable object to read from * @return the number of characters read * @throws IOException if an I/O error occurs. - * * @since 3.4 * @see #appendTo(Appendable) */ diff --git a/src/main/java/org/apache/commons/lang3/text/translate/UnicodeEscaper.java b/src/main/java/org/apache/commons/lang3/text/translate/UnicodeEscaper.java index bc0d9072d..02ad79e49 100644 --- a/src/main/java/org/apache/commons/lang3/text/translate/UnicodeEscaper.java +++ b/src/main/java/org/apache/commons/lang3/text/translate/UnicodeEscaper.java @@ -105,7 +105,6 @@ public class UnicodeEscaper extends CodePointTranslator { * @param codePoint * a Unicode code point * @return the hexadecimal string for the given code point - * * @since 3.2 */ protected String toUtf16Escape(final int codePoint) { diff --git a/src/main/java/org/apache/commons/lang3/time/AbstractFormatCache.java b/src/main/java/org/apache/commons/lang3/time/AbstractFormatCache.java index 7484492bf..69bc83193 100644 --- a/src/main/java/org/apache/commons/lang3/time/AbstractFormatCache.java +++ b/src/main/java/org/apache/commons/lang3/time/AbstractFormatCache.java @@ -32,7 +32,6 @@ import org.apache.commons.lang3.LocaleUtils; * FormatCache is a cache and factory for {@link Format}s. * * @param <F> The Format type. - * * @since 3.0 */ // TODO: Before making public move from getDateTimeInstance(Integer, ...) to int; or some other approach. diff --git a/src/main/java/org/apache/commons/lang3/time/FastDatePrinter.java b/src/main/java/org/apache/commons/lang3/time/FastDatePrinter.java index 258db09d1..a922088fe 100644 --- a/src/main/java/org/apache/commons/lang3/time/FastDatePrinter.java +++ b/src/main/java/org/apache/commons/lang3/time/FastDatePrinter.java @@ -1073,7 +1073,6 @@ public class FastDatePrinter implements DatePrinter, Serializable { * @param calendar the calendar to format * @param buf the buffer to format into * @return the specified string buffer - * * @deprecated use {@link #format(Calendar)} or {@link #format(Calendar, Appendable)} */ @Deprecated diff --git a/src/main/java/org/apache/commons/lang3/time/StopWatch.java b/src/main/java/org/apache/commons/lang3/time/StopWatch.java index 819996df2..7b0dc284c 100644 --- a/src/main/java/org/apache/commons/lang3/time/StopWatch.java +++ b/src/main/java/org/apache/commons/lang3/time/StopWatch.java @@ -65,7 +65,6 @@ import org.apache.commons.lang3.function.FailableSupplier; * * @see DurationUtils#of(FailableRunnable) * @see DurationUtils#of(FailableConsumer) - * * @since 2.0 */ public class StopWatch { @@ -178,7 +177,6 @@ public class StopWatch { * Creates a StopWatch. * * @return StopWatch a StopWatch. - * * @since 3.10 */ public static StopWatch create() { @@ -189,7 +187,6 @@ public class StopWatch { * Creates and starts a StopWatch. * * @return StopWatch a started StopWatch. - * * @since 3.5 */ public static StopWatch createStarted() { @@ -363,7 +360,6 @@ public class StopWatch { * </p> * * @return the split Duration - * * @throws IllegalStateException if this StopWatch has not yet been split. * @since 3.16.0 */ @@ -379,7 +375,6 @@ public class StopWatch { * </p> * * @return the split time in nanoseconds - * * @throws IllegalStateException if this StopWatch has not yet been split. * @since 3.0 */ @@ -398,7 +393,6 @@ public class StopWatch { * </p> * * @return the split time in milliseconds - * * @throws IllegalStateException if this StopWatch has not yet been split. * @since 2.1 * @deprecated Use {@link #getSplitDuration()}. diff --git a/src/main/java/org/apache/commons/lang3/tuple/ImmutablePair.java b/src/main/java/org/apache/commons/lang3/tuple/ImmutablePair.java index e95809018..468832699 100644 --- a/src/main/java/org/apache/commons/lang3/tuple/ImmutablePair.java +++ b/src/main/java/org/apache/commons/lang3/tuple/ImmutablePair.java @@ -30,7 +30,6 @@ import java.util.Objects; * * @param <L> the left element type * @param <R> the right element type - * * @since 3.0 */ public class ImmutablePair<L, R> extends Pair<L, R> { @@ -61,7 +60,6 @@ public class ImmutablePair<L, R> extends Pair<L, R> { * @param <L> the left element type * @param <R> the right element type * @return the empty array singleton that can be assigned without compiler warning. - * * @since 3.10. */ @SuppressWarnings("unchecked") diff --git a/src/main/java/org/apache/commons/lang3/tuple/ImmutableTriple.java b/src/main/java/org/apache/commons/lang3/tuple/ImmutableTriple.java index 785d90aae..b04edb848 100644 --- a/src/main/java/org/apache/commons/lang3/tuple/ImmutableTriple.java +++ b/src/main/java/org/apache/commons/lang3/tuple/ImmutableTriple.java @@ -30,7 +30,6 @@ import java.util.Objects; * @param <L> the left element type * @param <M> the middle element type * @param <R> the right element type - * * @since 3.2 */ public class ImmutableTriple<L, M, R> extends Triple<L, M, R> { @@ -62,7 +61,6 @@ public class ImmutableTriple<L, M, R> extends Triple<L, M, R> { * @param <M> the middle element type * @param <R> the right element type * @return the empty array singleton that can be assigned without compiler warning. - * * @since 3.10. */ @SuppressWarnings("unchecked") diff --git a/src/main/java/org/apache/commons/lang3/tuple/MutablePair.java b/src/main/java/org/apache/commons/lang3/tuple/MutablePair.java index f4b5512da..6a234746e 100644 --- a/src/main/java/org/apache/commons/lang3/tuple/MutablePair.java +++ b/src/main/java/org/apache/commons/lang3/tuple/MutablePair.java @@ -26,7 +26,6 @@ import java.util.Objects; * * @param <L> the left element type * @param <R> the right element type - * * @since 3.0 */ public class MutablePair<L, R> extends Pair<L, R> { @@ -50,7 +49,6 @@ public class MutablePair<L, R> extends Pair<L, R> { * @param <L> the left element type * @param <R> the right element type * @return the empty array singleton that can be assigned without compiler warning. - * * @since 3.10. */ @SuppressWarnings("unchecked") diff --git a/src/main/java/org/apache/commons/lang3/tuple/MutableTriple.java b/src/main/java/org/apache/commons/lang3/tuple/MutableTriple.java index b446017c4..3dedb6abd 100644 --- a/src/main/java/org/apache/commons/lang3/tuple/MutableTriple.java +++ b/src/main/java/org/apache/commons/lang3/tuple/MutableTriple.java @@ -26,7 +26,6 @@ import java.util.Objects; * @param <L> the left element type * @param <M> the middle element type * @param <R> the right element type - * * @since 3.2 */ public class MutableTriple<L, M, R> extends Triple<L, M, R> { @@ -51,7 +50,6 @@ public class MutableTriple<L, M, R> extends Triple<L, M, R> { * @param <M> the middle element type * @param <R> the right element type * @return the empty array singleton that can be assigned without compiler warning. - * * @since 3.10. */ @SuppressWarnings("unchecked") diff --git a/src/main/java/org/apache/commons/lang3/tuple/Pair.java b/src/main/java/org/apache/commons/lang3/tuple/Pair.java index 6be6316fe..e8df4a95d 100644 --- a/src/main/java/org/apache/commons/lang3/tuple/Pair.java +++ b/src/main/java/org/apache/commons/lang3/tuple/Pair.java @@ -37,7 +37,6 @@ import org.apache.commons.lang3.function.FailableBiFunction; * * @param <L> the left element type * @param <R> the right element type - * * @since 3.0 */ public abstract class Pair<L, R> implements Map.Entry<L, R>, Comparable<Pair<L, R>>, Serializable { @@ -61,7 +60,6 @@ public abstract class Pair<L, R> implements Map.Entry<L, R>, Comparable<Pair<L, * @param <L> the left element type * @param <R> the right element type * @return the empty array singleton that can be assigned without compiler warning. - * * @since 3.10. */ @SuppressWarnings("unchecked") diff --git a/src/main/java/org/apache/commons/lang3/tuple/Triple.java b/src/main/java/org/apache/commons/lang3/tuple/Triple.java index 978f8229d..622607481 100644 --- a/src/main/java/org/apache/commons/lang3/tuple/Triple.java +++ b/src/main/java/org/apache/commons/lang3/tuple/Triple.java @@ -34,7 +34,6 @@ import org.apache.commons.lang3.builder.CompareToBuilder; * @param <L> the left element type * @param <M> the middle element type * @param <R> the right element type - * * @since 3.2 */ public abstract class Triple<L, M, R> implements Comparable<Triple<L, M, R>>, Serializable { @@ -59,7 +58,6 @@ public abstract class Triple<L, M, R> implements Comparable<Triple<L, M, R>>, Se * @param <M> the middle element type * @param <R> the right element type * @return the empty array singleton that can be assigned without compiler warning. - * * @since 3.10. */ @SuppressWarnings("unchecked") diff --git a/src/test/java/org/apache/commons/lang3/concurrent/MultiBackgroundInitializerTest.java b/src/test/java/org/apache/commons/lang3/concurrent/MultiBackgroundInitializerTest.java index 148813893..e5b63a8d9 100644 --- a/src/test/java/org/apache/commons/lang3/concurrent/MultiBackgroundInitializerTest.java +++ b/src/test/java/org/apache/commons/lang3/concurrent/MultiBackgroundInitializerTest.java @@ -177,7 +177,6 @@ public class MultiBackgroundInitializerTest extends AbstractLangTest { * operate with both an external and a temporary executor service. * * @return the result object produced by the initializer - * * @throws org.apache.commons.lang3.concurrent.ConcurrentException so we don't have to catch it */ private MultiBackgroundInitializer.MultiBackgroundInitializerResults checkInitialize() diff --git a/src/test/java/org/apache/commons/lang3/time/FastDateParserTest.java b/src/test/java/org/apache/commons/lang3/time/FastDateParserTest.java index 9a443644e..f6ced1d37 100644 --- a/src/test/java/org/apache/commons/lang3/time/FastDateParserTest.java +++ b/src/test/java/org/apache/commons/lang3/time/FastDateParserTest.java @@ -184,7 +184,6 @@ public class FastDateParserTest extends AbstractLangTest { * @param format the format string to use * @param timeZone the time zone to use * @param locale the locale to use - * * @return the DateParser instance to use for testing */ protected DateParser getInstance(final TriFunction<String, TimeZone, Locale, DateParser> dpProvider,