diff --git a/src/main/java/org/apache/commons/lang3/ArraySorter.java b/src/main/java/org/apache/commons/lang3/ArraySorter.java index 55c53a651..2208bd902 100644 --- a/src/main/java/org/apache/commons/lang3/ArraySorter.java +++ b/src/main/java/org/apache/commons/lang3/ArraySorter.java @@ -22,7 +22,7 @@ import java.util.Comparator; /** * Sorts and returns arrays in the fluent style. * - * @since 3.12 + * @since 3.12.0 */ public class ArraySorter { diff --git a/src/main/java/org/apache/commons/lang3/BooleanUtils.java b/src/main/java/org/apache/commons/lang3/BooleanUtils.java index 1dfcdc229..f8b1e39e7 100644 --- a/src/main/java/org/apache/commons/lang3/BooleanUtils.java +++ b/src/main/java/org/apache/commons/lang3/BooleanUtils.java @@ -33,42 +33,42 @@ public class BooleanUtils { /** * The false String {@code "false"}. * - * @since 3.12 + * @since 3.12.0 */ public static final String FALSE = "false"; /** * The no String {@code "no"}. * - * @since 3.12 + * @since 3.12.0 */ public static final String NO = "no"; /** * The off String {@code "off"}. * - * @since 3.12 + * @since 3.12.0 */ public static final String OFF = "off"; /** * The on String {@code "on"}. * - * @since 3.12 + * @since 3.12.0 */ public static final String ON = "on"; /** * The true String {@code "true"}. * - * @since 3.12 + * @since 3.12.0 */ public static final String TRUE = "true"; /** * The yes String {@code "yes"}. * - * @since 3.12 + * @since 3.12.0 */ public static final String YES = "yes"; diff --git a/src/main/java/org/apache/commons/lang3/JavaVersion.java b/src/main/java/org/apache/commons/lang3/JavaVersion.java index 847be569e..7b8f729ff 100644 --- a/src/main/java/org/apache/commons/lang3/JavaVersion.java +++ b/src/main/java/org/apache/commons/lang3/JavaVersion.java @@ -139,7 +139,7 @@ public enum JavaVersion { /** * Java 17. * - * @since 3.12 + * @since 3.12.0 */ JAVA_17(17.0f, "17"), diff --git a/src/main/java/org/apache/commons/lang3/LocaleUtils.java b/src/main/java/org/apache/commons/lang3/LocaleUtils.java index f613de360..b57e3c04f 100644 --- a/src/main/java/org/apache/commons/lang3/LocaleUtils.java +++ b/src/main/java/org/apache/commons/lang3/LocaleUtils.java @@ -273,7 +273,7 @@ public class LocaleUtils { * * @param locale a locale or {@code null}. * @return the given locale if non-{@code null}, otherwise {@link Locale#getDefault()}. - * @since 3.12 + * @since 3.12.0 */ public static Locale toLocale(final Locale locale) { return locale != null ? locale : Locale.getDefault(); diff --git a/src/main/java/org/apache/commons/lang3/StringUtils.java b/src/main/java/org/apache/commons/lang3/StringUtils.java index 09450c2c0..cea878f16 100644 --- a/src/main/java/org/apache/commons/lang3/StringUtils.java +++ b/src/main/java/org/apache/commons/lang3/StringUtils.java @@ -1162,7 +1162,7 @@ public class StringUtils { * @param searchCharSequences The array of CharSequences to search for, may be null. Individual CharSequences may be * null as well. * @return {@code true} if any of the search CharSequences are found, {@code false} otherwise - * @since 3.12 + * @since 3.12.0 */ private static boolean containsAny(final ToBooleanBiFunction test, final CharSequence cs, final CharSequence... searchCharSequences) { @@ -1204,7 +1204,7 @@ public class StringUtils { * @param searchCharSequences The array of CharSequences to search for, may be null. Individual CharSequences may be * null as well. * @return {@code true} if any of the search CharSequences are found, {@code false} otherwise - * @since 3.12 + * @since 3.12.0 */ public static boolean containsAnyIgnoreCase(final CharSequence cs, final CharSequence... searchCharSequences) { return containsAny(StringUtils::containsIgnoreCase, cs, searchCharSequences); @@ -3881,7 +3881,7 @@ public class StringUtils { * @param delimiter * the separator character to use * @return the joined String, {@code null} if null array input - * @since 3.12 + * @since 3.12.0 */ public static String join(final boolean[] array, final char delimiter) { if (array == null) { @@ -3918,7 +3918,7 @@ public class StringUtils { * the index to stop joining from (exclusive). It is an error to pass in an end index past the end of * the array * @return the joined String, {@code null} if null array input - * @since 3.12 + * @since 3.12.0 */ public static String join(final boolean[] array, final char delimiter, final int startIndex, final int endIndex) { if (array == null) { diff --git a/src/main/java/org/apache/commons/lang3/SystemUtils.java b/src/main/java/org/apache/commons/lang3/SystemUtils.java index 6c21321ad..2a92a8dc2 100644 --- a/src/main/java/org/apache/commons/lang3/SystemUtils.java +++ b/src/main/java/org/apache/commons/lang3/SystemUtils.java @@ -1294,7 +1294,7 @@ public class SystemUtils { * The field will return {@code false} if {@code OS_NAME} is {@code null}. *

* - * @since 3.12 + * @since 3.12.0 */ public static final boolean IS_OS_MAC_OSX_SIERRA = getOsMatches("Mac OS X", "10.12"); @@ -1306,7 +1306,7 @@ public class SystemUtils { * The field will return {@code false} if {@code OS_NAME} is {@code null}. *

* - * @since 3.12 + * @since 3.12.0 */ public static final boolean IS_OS_MAC_OSX_HIGH_SIERRA = getOsMatches("Mac OS X", "10.13"); @@ -1318,7 +1318,7 @@ public class SystemUtils { * The field will return {@code false} if {@code OS_NAME} is {@code null}. *

* - * @since 3.12 + * @since 3.12.0 */ public static final boolean IS_OS_MAC_OSX_MOJAVE = getOsMatches("Mac OS X", "10.14"); @@ -1330,7 +1330,7 @@ public class SystemUtils { * The field will return {@code false} if {@code OS_NAME} is {@code null}. *

* - * @since 3.12 + * @since 3.12.0 */ public static final boolean IS_OS_MAC_OSX_CATALINA = getOsMatches("Mac OS X", "10.15"); @@ -1342,7 +1342,7 @@ public class SystemUtils { * The field will return {@code false} if {@code OS_NAME} is {@code null}. *

* - * @since 3.12 + * @since 3.12.0 */ public static final boolean IS_OS_MAC_OSX_BIG_SUR = getOsMatches("Mac OS X", "10.16"); diff --git a/src/main/java/org/apache/commons/lang3/function/FailableShortSupplier.java b/src/main/java/org/apache/commons/lang3/function/FailableShortSupplier.java index f27cf3430..d6731e30a 100644 --- a/src/main/java/org/apache/commons/lang3/function/FailableShortSupplier.java +++ b/src/main/java/org/apache/commons/lang3/function/FailableShortSupplier.java @@ -23,7 +23,7 @@ import java.util.function.IntSupplier; * A functional interface like {@link IntSupplier} but for {@code short} that declares a {@code Throwable}. * * @param Thrown exception. - * @since 3.12 + * @since 3.12.0 */ @FunctionalInterface public interface FailableShortSupplier { diff --git a/src/main/java/org/apache/commons/lang3/function/Objects.java b/src/main/java/org/apache/commons/lang3/function/Objects.java index 0ba8361c1..9bec191c3 100755 --- a/src/main/java/org/apache/commons/lang3/function/Objects.java +++ b/src/main/java/org/apache/commons/lang3/function/Objects.java @@ -59,7 +59,7 @@ import org.apache.commons.lang3.ObjectUtils; * would have been to change the {@code ObjectUtils} class. However, that * would mean loosing upwards compatibility, and we don't do that.) * - * @since 3.12 + * @since 3.12.0 */ public class Objects { /** 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 d6769a448..09bdb73eb 100644 --- a/src/main/java/org/apache/commons/lang3/function/ToBooleanBiFunction.java +++ b/src/main/java/org/apache/commons/lang3/function/ToBooleanBiFunction.java @@ -27,7 +27,7 @@ import java.util.function.BiFunction; * @param the type of the second argument to the function. * * @see BiFunction - * @since 3.12 + * @since 3.12.0 */ @FunctionalInterface public interface ToBooleanBiFunction { 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 d9ec85f22..7c53271f2 100644 --- a/src/main/java/org/apache/commons/lang3/text/StrBuilder.java +++ b/src/main/java/org/apache/commons/lang3/text/StrBuilder.java @@ -289,7 +289,7 @@ public class StrBuilder implements CharSequence, Appendable, Serializable, Build * API of Collections. * * @return {@code true} if the size is greater than {@code 0}. - * @since 3.12 + * @since 3.12.0 */ public boolean isNotEmpty() { return size > 0; 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 d3b939832..0912efe7e 100644 --- a/src/main/java/org/apache/commons/lang3/time/StopWatch.java +++ b/src/main/java/org/apache/commons/lang3/time/StopWatch.java @@ -368,7 +368,7 @@ public class StopWatch { * @return the time this stopwatch was started in milliseconds, between the current time and midnight, January 1, * 1970 UTC. * @throws IllegalStateException if this StopWatch has not been started - * @since 3.12 + * @since 3.12.0 */ public long getStopTime() { if (this.runningState == State.UNSTARTED) { diff --git a/src/site/site.xml b/src/site/site.xml index b1f79b9cc..a08e5f0ed 100644 --- a/src/site/site.xml +++ b/src/site/site.xml @@ -24,21 +24,21 @@ - - - - - + + + + + + - - - - - - - + + + + + + diff --git a/src/site/xdoc/index.xml b/src/site/xdoc/index.xml index 6408e4fd2..8365ca957 100644 --- a/src/site/xdoc/index.xml +++ b/src/site/xdoc/index.xml @@ -31,13 +31,14 @@ these extra methods.

-Lang provides a host of helper utilities for the java.lang API, notably +Apache Commons Lang provides a host of helper utilities for the java.lang API, notably String manipulation methods, basic numerical methods, object reflection, concurrency, creation and serialization and System properties. Additionally it contains basic enhancements to java.util.Date and a series of utilities dedicated to help with building methods, such as hashCode, toString and equals.

-Note that Lang 3.0 (and subsequent versions) use a different package (org.apache.commons.lang3) than the previous versions (org.apache.commons.lang), allowing it to be used at the same time as an earlier version. +Note that Commons Lang 3.0 (and subsequent versions) use a different package (org.apache.commons.lang3) than the previous versions (org.apache.commons.lang), +allowing Commons Lang 3 to be used at the same time as Commons Lang 2.

@@ -61,23 +62,14 @@ The git repository can be
-

The latest stable release of Lang is 3.12. You may:

+

The latest stable release of Lang is 3.12.0:

-

-Alternatively you can pull it from the central Maven repositories: -

-<dependency>
-  <groupId>org.apache.commons</groupId>
-  <artifactId>commons-lang3</artifactId>
-  <version>3.12</version>
-</dependency>
-
-

For information on previous releases see the Release History, and to download previous releases see the Commons Lang Archive.