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
commit ecc97cdafd0179a0fe1513dd8452268a5de7c801 Author: Gary Gregory <garydgreg...@gmail.com> AuthorDate: Thu Sep 18 09:50:29 2025 -0400 Javadoc --- .../apache/commons/lang3/RandomStringUtils.java | 36 +++++++++++----------- .../java/org/apache/commons/lang3/RandomUtils.java | 20 ++++++------ 2 files changed, 28 insertions(+), 28 deletions(-) diff --git a/src/main/java/org/apache/commons/lang3/RandomStringUtils.java b/src/main/java/org/apache/commons/lang3/RandomStringUtils.java index 6f415f679..0c5eb4301 100644 --- a/src/main/java/org/apache/commons/lang3/RandomStringUtils.java +++ b/src/main/java/org/apache/commons/lang3/RandomStringUtils.java @@ -129,7 +129,7 @@ public static RandomStringUtils insecure() { * @param count the length of random string to create * @return the random string * @throws IllegalArgumentException if {@code count} < 0. - * @deprecated Use {@link #secure()}, {@link #secureStrong()},or {@link #insecure()}. + * @deprecated Use {@link #secure()}, {@link #secureStrong()}, or {@link #insecure()}. */ @Deprecated public static String random(final int count) { @@ -148,7 +148,7 @@ public static String random(final int count) { * @param numbers if {@code true}, generated string may include numeric characters * @return the random string * @throws IllegalArgumentException if {@code count} < 0. - * @deprecated Use {@link #secure()}, {@link #secureStrong()},or {@link #insecure()}. + * @deprecated Use {@link #secure()}, {@link #secureStrong()}, or {@link #insecure()}. */ @Deprecated public static String random(final int count, final boolean letters, final boolean numbers) { @@ -166,7 +166,7 @@ public static String random(final int count, final boolean letters, final boolea * @param chars the character array containing the set of characters to use, may be null * @return the random string * @throws IllegalArgumentException if {@code count} < 0. - * @deprecated Use {@link #secure()}, {@link #secureStrong()},or {@link #insecure()}. + * @deprecated Use {@link #secure()}, {@link #secureStrong()}, or {@link #insecure()}. */ @Deprecated public static String random(final int count, final char... chars) { @@ -187,7 +187,7 @@ public static String random(final int count, final char... chars) { * @param numbers if {@code true}, generated string may include numeric characters * @return the random string * @throws IllegalArgumentException if {@code count} < 0. - * @deprecated Use {@link #secure()}, {@link #secureStrong()},or {@link #insecure()}. + * @deprecated Use {@link #secure()}, {@link #secureStrong()}, or {@link #insecure()}. */ @Deprecated public static String random(final int count, final int start, final int end, final boolean letters, @@ -213,7 +213,7 @@ public static String random(final int count, final int start, final int end, fin * @return the random string * @throws ArrayIndexOutOfBoundsException if there are not {@code (end - start) + 1} characters in the set array. * @throws IllegalArgumentException if {@code count} < 0. - * @deprecated Use {@link #secure()}, {@link #secureStrong()},or {@link #insecure()}. + * @deprecated Use {@link #secure()}, {@link #secureStrong()}, or {@link #insecure()}. */ @Deprecated public static String random(final int count, final int start, final int end, final boolean letters, @@ -402,7 +402,7 @@ public static String random(int count, int start, int end, final boolean letters * @param chars the String containing the set of characters to use, may be null, but must not be empty * @return the random string * @throws IllegalArgumentException if {@code count} < 0 or the string is empty. - * @deprecated Use {@link #secure()}, {@link #secureStrong()},or {@link #insecure()}. + * @deprecated Use {@link #secure()}, {@link #secureStrong()}, or {@link #insecure()}. */ @Deprecated public static String random(final int count, final String chars) { @@ -419,7 +419,7 @@ public static String random(final int count, final String chars) { * @param count the length of random string to create * @return the random string * @throws IllegalArgumentException if {@code count} < 0. - * @deprecated Use {@link #secure()}, {@link #secureStrong()},or {@link #insecure()}. + * @deprecated Use {@link #secure()}, {@link #secureStrong()}, or {@link #insecure()}. */ @Deprecated public static String randomAlphabetic(final int count) { @@ -437,7 +437,7 @@ public static String randomAlphabetic(final int count) { * @param maxLengthExclusive the exclusive maximum length of the string to generate * @return the random string * @since 3.5 - * @deprecated Use {@link #secure()}, {@link #secureStrong()},or {@link #insecure()}. + * @deprecated Use {@link #secure()}, {@link #secureStrong()}, or {@link #insecure()}. */ @Deprecated public static String randomAlphabetic(final int minLengthInclusive, final int maxLengthExclusive) { @@ -454,7 +454,7 @@ public static String randomAlphabetic(final int minLengthInclusive, final int ma * @param count the length of random string to create * @return the random string * @throws IllegalArgumentException if {@code count} < 0. - * @deprecated Use {@link #secure()}, {@link #secureStrong()},or {@link #insecure()}. + * @deprecated Use {@link #secure()}, {@link #secureStrong()}, or {@link #insecure()}. */ @Deprecated public static String randomAlphanumeric(final int count) { @@ -472,7 +472,7 @@ public static String randomAlphanumeric(final int count) { * @param maxLengthExclusive the exclusive maximum length of the string to generate * @return the random string * @since 3.5 - * @deprecated Use {@link #secure()}, {@link #secureStrong()},or {@link #insecure()}. + * @deprecated Use {@link #secure()}, {@link #secureStrong()}, or {@link #insecure()}. */ @Deprecated public static String randomAlphanumeric(final int minLengthInclusive, final int maxLengthExclusive) { @@ -490,7 +490,7 @@ public static String randomAlphanumeric(final int minLengthInclusive, final int * @param count the length of random string to create * @return the random string * @throws IllegalArgumentException if {@code count} < 0. - * @deprecated Use {@link #secure()}, {@link #secureStrong()},or {@link #insecure()}. + * @deprecated Use {@link #secure()}, {@link #secureStrong()}, or {@link #insecure()}. */ @Deprecated public static String randomAscii(final int count) { @@ -509,7 +509,7 @@ public static String randomAscii(final int count) { * @param maxLengthExclusive the exclusive maximum length of the string to generate * @return the random string * @since 3.5 - * @deprecated Use {@link #secure()}, {@link #secureStrong()},or {@link #insecure()}. + * @deprecated Use {@link #secure()}, {@link #secureStrong()}, or {@link #insecure()}. */ @Deprecated public static String randomAscii(final int minLengthInclusive, final int maxLengthExclusive) { @@ -528,7 +528,7 @@ public static String randomAscii(final int minLengthInclusive, final int maxLeng * @return the random string * @throws IllegalArgumentException if {@code count} < 0. * @since 3.5 - * @deprecated Use {@link #secure()}, {@link #secureStrong()},or {@link #insecure()}. + * @deprecated Use {@link #secure()}, {@link #secureStrong()}, or {@link #insecure()}. */ @Deprecated public static String randomGraph(final int count) { @@ -546,7 +546,7 @@ public static String randomGraph(final int count) { * @param maxLengthExclusive the exclusive maximum length of the string to generate * @return the random string * @since 3.5 - * @deprecated Use {@link #secure()}, {@link #secureStrong()},or {@link #insecure()}. + * @deprecated Use {@link #secure()}, {@link #secureStrong()}, or {@link #insecure()}. */ @Deprecated public static String randomGraph(final int minLengthInclusive, final int maxLengthExclusive) { @@ -563,7 +563,7 @@ public static String randomGraph(final int minLengthInclusive, final int maxLeng * @param count the length of random string to create * @return the random string * @throws IllegalArgumentException if {@code count} < 0. - * @deprecated Use {@link #secure()}, {@link #secureStrong()},or {@link #insecure()}. + * @deprecated Use {@link #secure()}, {@link #secureStrong()}, or {@link #insecure()}. */ @Deprecated public static String randomNumeric(final int count) { @@ -581,7 +581,7 @@ public static String randomNumeric(final int count) { * @param maxLengthExclusive the exclusive maximum length of the string to generate * @return the random string * @since 3.5 - * @deprecated Use {@link #secure()}, {@link #secureStrong()},or {@link #insecure()}. + * @deprecated Use {@link #secure()}, {@link #secureStrong()}, or {@link #insecure()}. */ @Deprecated public static String randomNumeric(final int minLengthInclusive, final int maxLengthExclusive) { @@ -600,7 +600,7 @@ public static String randomNumeric(final int minLengthInclusive, final int maxLe * @return the random string * @throws IllegalArgumentException if {@code count} < 0. * @since 3.5 - * @deprecated Use {@link #secure()}, {@link #secureStrong()},or {@link #insecure()}. + * @deprecated Use {@link #secure()}, {@link #secureStrong()}, or {@link #insecure()}. */ @Deprecated public static String randomPrint(final int count) { @@ -618,7 +618,7 @@ public static String randomPrint(final int count) { * @param maxLengthExclusive the exclusive maximum length of the string to generate * @return the random string * @since 3.5 - * @deprecated Use {@link #secure()}, {@link #secureStrong()},or {@link #insecure()}. + * @deprecated Use {@link #secure()}, {@link #secureStrong()}, or {@link #insecure()}. */ @Deprecated public static String randomPrint(final int minLengthInclusive, final int maxLengthExclusive) { diff --git a/src/main/java/org/apache/commons/lang3/RandomUtils.java b/src/main/java/org/apache/commons/lang3/RandomUtils.java index 172cde72f..b1d4d7f7c 100644 --- a/src/main/java/org/apache/commons/lang3/RandomUtils.java +++ b/src/main/java/org/apache/commons/lang3/RandomUtils.java @@ -108,7 +108,7 @@ public static RandomUtils insecure() { * * @return the random boolean * @since 3.5 - * @deprecated Use {@link #secure()}, {@link #secureStrong()},or {@link #insecure()}. + * @deprecated Use {@link #secure()}, {@link #secureStrong()}, or {@link #insecure()}. */ @Deprecated public static boolean nextBoolean() { @@ -121,7 +121,7 @@ public static boolean nextBoolean() { * @param count the size of the returned array * @return the random byte array * @throws IllegalArgumentException if {@code count} is negative - * @deprecated Use {@link #secure()}, {@link #secureStrong()},or {@link #insecure()}. + * @deprecated Use {@link #secure()}, {@link #secureStrong()}, or {@link #insecure()}. */ @Deprecated public static byte[] nextBytes(final int count) { @@ -134,7 +134,7 @@ public static byte[] nextBytes(final int count) { * @return the random double * @see #nextDouble(double, double) * @since 3.5 - * @deprecated Use {@link #secure()}, {@link #secureStrong()},or {@link #insecure()}. + * @deprecated Use {@link #secure()}, {@link #secureStrong()}, or {@link #insecure()}. */ @Deprecated public static double nextDouble() { @@ -149,7 +149,7 @@ public static double nextDouble() { * @throws IllegalArgumentException if {@code startInclusive > endExclusive} or if {@code startInclusive} is * negative * @return the random double - * @deprecated Use {@link #secure()}, {@link #secureStrong()},or {@link #insecure()}. + * @deprecated Use {@link #secure()}, {@link #secureStrong()}, or {@link #insecure()}. */ @Deprecated public static double nextDouble(final double startInclusive, final double endExclusive) { @@ -162,7 +162,7 @@ public static double nextDouble(final double startInclusive, final double endExc * @return the random float * @see #nextFloat(float, float) * @since 3.5 - * @deprecated Use {@link #secure()}, {@link #secureStrong()},or {@link #insecure()}. + * @deprecated Use {@link #secure()}, {@link #secureStrong()}, or {@link #insecure()}. */ @Deprecated public static float nextFloat() { @@ -177,7 +177,7 @@ public static float nextFloat() { * @throws IllegalArgumentException if {@code startInclusive > endExclusive} or if {@code startInclusive} is * negative * @return the random float - * @deprecated Use {@link #secure()}, {@link #secureStrong()},or {@link #insecure()}. + * @deprecated Use {@link #secure()}, {@link #secureStrong()}, or {@link #insecure()}. */ @Deprecated public static float nextFloat(final float startInclusive, final float endExclusive) { @@ -190,7 +190,7 @@ public static float nextFloat(final float startInclusive, final float endExclusi * @return the random integer * @see #nextInt(int, int) * @since 3.5 - * @deprecated Use {@link #secure()}, {@link #secureStrong()},or {@link #insecure()}. + * @deprecated Use {@link #secure()}, {@link #secureStrong()}, or {@link #insecure()}. */ @Deprecated public static int nextInt() { @@ -205,7 +205,7 @@ public static int nextInt() { * @throws IllegalArgumentException if {@code startInclusive > endExclusive} or if {@code startInclusive} is * negative * @return the random integer - * @deprecated Use {@link #secure()}, {@link #secureStrong()},or {@link #insecure()}. + * @deprecated Use {@link #secure()}, {@link #secureStrong()}, or {@link #insecure()}. */ @Deprecated public static int nextInt(final int startInclusive, final int endExclusive) { @@ -218,7 +218,7 @@ public static int nextInt(final int startInclusive, final int endExclusive) { * @return the random long * @see #nextLong(long, long) * @since 3.5 - * @deprecated Use {@link #secure()}, {@link #secureStrong()},or {@link #insecure()}. + * @deprecated Use {@link #secure()}, {@link #secureStrong()}, or {@link #insecure()}. */ @Deprecated public static long nextLong() { @@ -233,7 +233,7 @@ public static long nextLong() { * @throws IllegalArgumentException if {@code startInclusive > endExclusive} or if {@code startInclusive} is * negative * @return the random long - * @deprecated Use {@link #secure()}, {@link #secureStrong()},or {@link #insecure()}. + * @deprecated Use {@link #secure()}, {@link #secureStrong()}, or {@link #insecure()}. */ @Deprecated public static long nextLong(final long startInclusive, final long endExclusive) {