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-codec.git
The following commit(s) were added to refs/heads/master by this push: new 914807a4 No need for blank Javadoc lines between Javadoc @ tags 914807a4 is described below commit 914807a40afc1519a9e3a1fcd8e35b77e0ad273b Author: Gary Gregory <garydgreg...@gmail.com> AuthorDate: Thu Nov 28 12:10:33 2024 -0500 No need for blank Javadoc lines between Javadoc @ tags --- src/main/java/org/apache/commons/codec/binary/Base16.java | 2 -- src/main/java/org/apache/commons/codec/binary/Base32.java | 1 - src/main/java/org/apache/commons/codec/binary/Base64.java | 1 - src/main/java/org/apache/commons/codec/binary/BaseNCodec.java | 3 --- src/main/java/org/apache/commons/codec/digest/DigestUtils.java | 3 --- .../java/org/apache/commons/codec/language/DaitchMokotoffSoundex.java | 3 --- src/main/java/org/apache/commons/codec/language/Soundex.java | 1 - src/main/java/org/apache/commons/codec/net/BCodec.java | 1 - src/main/java/org/apache/commons/codec/net/URLCodec.java | 1 - src/main/java/org/apache/commons/codec/net/Utils.java | 1 - src/test/java/org/apache/commons/codec/binary/BaseNTestData.java | 3 --- 11 files changed, 20 deletions(-) diff --git a/src/main/java/org/apache/commons/codec/binary/Base16.java b/src/main/java/org/apache/commons/codec/binary/Base16.java index 29689442..c1d01508 100644 --- a/src/main/java/org/apache/commons/codec/binary/Base16.java +++ b/src/main/java/org/apache/commons/codec/binary/Base16.java @@ -37,7 +37,6 @@ import org.apache.commons.codec.CodecPolicy; * </p> * * @see <a href="https://tools.ietf.org/html/rfc4648#section-8">RFC 4648 - 8. Base 16 Encoding</a> - * * @since 1.15 */ public class Base16 extends BaseNCodec { @@ -227,7 +226,6 @@ public class Base16 extends BaseNCodec { * Returns whether or not the {@code octet} is in the Base16 alphabet. * * @param octet The value to test. - * * @return {@code true} if the value is defined in the Base16 alphabet {@code false} otherwise. */ @Override diff --git a/src/main/java/org/apache/commons/codec/binary/Base32.java b/src/main/java/org/apache/commons/codec/binary/Base32.java index 06ecec47..8e061fe3 100644 --- a/src/main/java/org/apache/commons/codec/binary/Base32.java +++ b/src/main/java/org/apache/commons/codec/binary/Base32.java @@ -628,7 +628,6 @@ public class Base32 extends BaseNCodec { * * @param emptyBitsMask The mask of the lower bits that should be empty * @param context the context to be used - * * @throws IllegalArgumentException if the bits being checked contain any non-zero value */ private void validateCharacter(final long emptyBitsMask, final Context context) { diff --git a/src/main/java/org/apache/commons/codec/binary/Base64.java b/src/main/java/org/apache/commons/codec/binary/Base64.java index e26a0625..3d7e879c 100644 --- a/src/main/java/org/apache/commons/codec/binary/Base64.java +++ b/src/main/java/org/apache/commons/codec/binary/Base64.java @@ -935,7 +935,6 @@ public class Base64 extends BaseNCodec { * * @param emptyBitsMask The mask of the lower bits that should be empty * @param context the context to be used - * * @throws IllegalArgumentException if the bits being checked contain any non-zero value */ private void validateCharacter(final int emptyBitsMask, final Context context) { diff --git a/src/main/java/org/apache/commons/codec/binary/BaseNCodec.java b/src/main/java/org/apache/commons/codec/binary/BaseNCodec.java index 4889c960..c9eb2fd0 100644 --- a/src/main/java/org/apache/commons/codec/binary/BaseNCodec.java +++ b/src/main/java/org/apache/commons/codec/binary/BaseNCodec.java @@ -715,7 +715,6 @@ public abstract class BaseNCodec implements BinaryEncoder, BinaryDecoder { * Calculates the amount of space needed to encode the supplied array. * * @param pArray byte[] array which will later be encoded - * * @return amount of space needed to encode the supplied array. * Returns a long since a max-len array will require > Integer.MAX_VALUE */ @@ -745,7 +744,6 @@ public abstract class BaseNCodec implements BinaryEncoder, BinaryDecoder { * Does not allow whitespace or pad. * * @param value The value to test - * * @return {@code true} if the value is defined in the current alphabet, {@code false} otherwise. */ protected abstract boolean isInAlphabet(byte value); @@ -756,7 +754,6 @@ public abstract class BaseNCodec implements BinaryEncoder, BinaryDecoder { * * @param arrayOctet byte array to test * @param allowWSPad if {@code true}, then whitespace and PAD are also allowed - * * @return {@code true} if all bytes are valid characters in the alphabet or if the byte array is empty; * {@code false}, otherwise */ diff --git a/src/main/java/org/apache/commons/codec/digest/DigestUtils.java b/src/main/java/org/apache/commons/codec/digest/DigestUtils.java index 7e31a730..40ff4c6b 100644 --- a/src/main/java/org/apache/commons/codec/digest/DigestUtils.java +++ b/src/main/java/org/apache/commons/codec/digest/DigestUtils.java @@ -80,7 +80,6 @@ public class DigestUtils { * @param messageDigest The MessageDigest to use (e.g. MD5) * @param data Data to digest * @return the digest - * * @since 1.11 */ public static byte[] digest(final MessageDigest messageDigest, final ByteBuffer data) { @@ -1424,7 +1423,6 @@ public class DigestUtils { * * @param data Data to digest * @return the digest - * * @since 1.11 */ public byte[] digest(final ByteBuffer data) { @@ -1495,7 +1493,6 @@ public class DigestUtils { * * @param data Data to digest * @return the digest as a hexadecimal string - * * @since 1.11 */ public String digestAsHex(final ByteBuffer data) { diff --git a/src/main/java/org/apache/commons/codec/language/DaitchMokotoffSoundex.java b/src/main/java/org/apache/commons/codec/language/DaitchMokotoffSoundex.java index 9fcf2887..35a2b52e 100644 --- a/src/main/java/org/apache/commons/codec/language/DaitchMokotoffSoundex.java +++ b/src/main/java/org/apache/commons/codec/language/DaitchMokotoffSoundex.java @@ -64,7 +64,6 @@ import org.apache.commons.codec.StringEncoder; * @see Soundex * @see <a href="https://en.wikipedia.org/wiki/Daitch%E2%80%93Mokotoff_Soundex"> Wikipedia - Daitch-Mokotoff Soundex</a> * @see <a href="http://www.avotaynu.com/soundex.htm">Avotaynu - Soundexing and Genealogy</a> - * * @since 1.10 */ public class DaitchMokotoffSoundex implements StringEncoder { @@ -379,7 +378,6 @@ public class DaitchMokotoffSoundex implements StringEncoder { * </p> * * @see #soundex(String) - * * @param obj * Object to encode * @return An object (of type {@link String}) containing the DM soundex code, which corresponds to the String @@ -402,7 +400,6 @@ public class DaitchMokotoffSoundex implements StringEncoder { * Encodes a String using the Daitch-Mokotoff soundex algorithm without branching. * * @see #soundex(String) - * * @param source * A String object to encode * @return A DM Soundex code corresponding to the String supplied diff --git a/src/main/java/org/apache/commons/codec/language/Soundex.java b/src/main/java/org/apache/commons/codec/language/Soundex.java index c5159c39..b541cf6b 100644 --- a/src/main/java/org/apache/commons/codec/language/Soundex.java +++ b/src/main/java/org/apache/commons/codec/language/Soundex.java @@ -204,7 +204,6 @@ public class Soundex implements StringEncoder { * @param s2 * A String that will be encoded and compared. * @return The number of characters in the two encoded Strings that are the same from 0 to 4. - * * @see SoundexUtils#difference(StringEncoder,String,String) * @see <a href="https://msdn.microsoft.com/library/default.asp?url=/library/en-us/tsqlref/ts_de-dz_8co5.asp"> MS * T-SQL DIFFERENCE</a> diff --git a/src/main/java/org/apache/commons/codec/net/BCodec.java b/src/main/java/org/apache/commons/codec/net/BCodec.java index fae4520e..cf9e137f 100644 --- a/src/main/java/org/apache/commons/codec/net/BCodec.java +++ b/src/main/java/org/apache/commons/codec/net/BCodec.java @@ -86,7 +86,6 @@ public class BCodec extends RFC1522Codec implements StringEncoder, StringDecoder * @param charset * the default string Charset to use. * @param decodingPolicy The decoding policy. - * * @see Charset * @since 1.15 */ diff --git a/src/main/java/org/apache/commons/codec/net/URLCodec.java b/src/main/java/org/apache/commons/codec/net/URLCodec.java index 9abe9381..2178ce4b 100644 --- a/src/main/java/org/apache/commons/codec/net/URLCodec.java +++ b/src/main/java/org/apache/commons/codec/net/URLCodec.java @@ -360,7 +360,6 @@ public class URLCodec implements BinaryEncoder, BinaryDecoder, StringEncoder, St * The {@code String} encoding used for decoding and encoding. * * @return Returns the encoding. - * * @deprecated Use {@link #getDefaultCharset()}, will be removed in 2.0. */ @Deprecated diff --git a/src/main/java/org/apache/commons/codec/net/Utils.java b/src/main/java/org/apache/commons/codec/net/Utils.java index e19d0e5d..7ea78c15 100644 --- a/src/main/java/org/apache/commons/codec/net/Utils.java +++ b/src/main/java/org/apache/commons/codec/net/Utils.java @@ -39,7 +39,6 @@ final class Utils { * @param b * The byte to be converted. * @return The numeric value represented by the character in radix 16. - * * @throws DecoderException * Thrown when the byte is not valid per {@link Character#digit(char,int)} */ diff --git a/src/test/java/org/apache/commons/codec/binary/BaseNTestData.java b/src/test/java/org/apache/commons/codec/binary/BaseNTestData.java index cc5b8e93..6347b17b 100644 --- a/src/test/java/org/apache/commons/codec/binary/BaseNTestData.java +++ b/src/test/java/org/apache/commons/codec/binary/BaseNTestData.java @@ -134,7 +134,6 @@ public class BaseNTestData { * * @param in the input stream. * @return the byte array - * * @throws IOException if an error occurs whilst reading the input stream */ static byte[] streamToBytes(final InputStream in) throws IOException { @@ -153,9 +152,7 @@ public class BaseNTestData { * * @param in the input stream. * @param buf the byte array to use for chunking - * * @return the bytes read from the input stream - * * @throws IOException if an error occurs whilst reading the input stream */ static byte[] streamToBytes(final InputStream in, byte[] buf) throws IOException {