Fix malformed Javadoc comments

Author: garydgregory

src/changes/changes.xml

@@ -47,6 +47,7 @@ The <action> type attribute can be add,update,fix,remove.
       <!-- FIX -->
       <action type="fix" dev="ggregory" due-to="Gary Gregory">Fix oak leaf icon references in overview.html when running `mvn clean javadoc:javadoc`.</action>
       <action type="fix" dev="ggregory" due-to="Gary Gregory">Fix Apache RAT plugin console warnings.</action>
+      <action type="fix" dev="ggregory" due-to="Gary Gregory">Fix malformed Javadoc comments.</action>
       <!-- ADD -->
       <!-- UPDATE -->
       <action type="update" dev="ggregory" due-to="Gary Gregory, Dependabot">Bump org.apache.commons:commons-parent from 91 to 93 #415, #418.</action>

src/main/java/org/apache/commons/codec/binary/Base32InputStream.java

@@ -38,9 +38,9 @@
  * unused from the final character or entire characters. The default mode is lenient decoding.
  * </p>
  * <ul>
- * <li>Lenient: Any trailing bits are composed into 8-bit bytes where possible. The remainder are discarded.
+ * <li>Lenient: Any trailing bits are composed into 8-bit bytes where possible. The remainder are discarded.</li>
  * <li>Strict: The decoding will raise an {@link IllegalArgumentException} if trailing bits are not part of a valid encoding. Any unused bits from the final
- * character must be zero. Impossible counts of entire final characters are not allowed.
+ * character must be zero. Impossible counts of entire final characters are not allowed.</li>
  * </ul>
  * <p>
  * When strict decoding is enabled it is expected that the decoded bytes will be re-encoded to a byte array that matches the original, i.e. no changes occur on

src/main/java/org/apache/commons/codec/binary/Base32OutputStream.java

@@ -42,9 +42,9 @@
  * unused from the final character or entire characters. The default mode is lenient decoding.
  * </p>
  * <ul>
- * <li>Lenient: Any trailing bits are composed into 8-bit bytes where possible. The remainder are discarded.
+ * <li>Lenient: Any trailing bits are composed into 8-bit bytes where possible. The remainder are discarded.</li>
  * <li>Strict: The decoding will raise an {@link IllegalArgumentException} if trailing bits are not part of a valid encoding. Any unused bits from the final
- * character must be zero. Impossible counts of entire final characters are not allowed.
+ * character must be zero. Impossible counts of entire final characters are not allowed.</li>
  * </ul>
  * <p>
  * When strict decoding is enabled it is expected that the decoded bytes will be re-encoded to a byte array that matches the original, i.e. no changes occur on

src/main/java/org/apache/commons/codec/binary/Base64InputStream.java

@@ -42,9 +42,9 @@
  * unused from the final character or entire characters. The default mode is lenient decoding.
  * </p>
  * <ul>
- * <li>Lenient: Any trailing bits are composed into 8-bit bytes where possible. The remainder are discarded.
+ * <li>Lenient: Any trailing bits are composed into 8-bit bytes where possible. The remainder are discarded.</li>
  * <li>Strict: The decoding will raise an {@link IllegalArgumentException} if trailing bits are not part of a valid encoding. Any unused bits from the final
- * character must be zero. Impossible counts of entire final characters are not allowed.
+ * character must be zero. Impossible counts of entire final characters are not allowed.</li>
  * </ul>
  * <p>
  * When strict decoding is enabled it is expected that the decoded bytes will be re-encoded to a byte array that matches the original, i.e. no changes occur on

src/main/java/org/apache/commons/codec/binary/Base64OutputStream.java

@@ -46,9 +46,9 @@
  * unused from the final character or entire characters. The default mode is lenient decoding.
  * </p>
  * <ul>
- * <li>Lenient: Any trailing bits are composed into 8-bit bytes where possible. The remainder are discarded.
+ * <li>Lenient: Any trailing bits are composed into 8-bit bytes where possible. The remainder are discarded.</li>
  * <li>Strict: The decoding will raise an {@link IllegalArgumentException} if trailing bits are not part of a valid encoding. Any unused bits from the final
- * character must be zero. Impossible counts of entire final characters are not allowed.
+ * character must be zero. Impossible counts of entire final characters are not allowed.</li>
  * </ul>
  * <p>
  * When strict decoding is enabled it is expected that the decoded bytes will be re-encoded to a byte array that matches the original, i.e. no changes occur on

src/main/java/org/apache/commons/codec/binary/BaseNCodec.java

@@ -38,9 +38,9 @@
  * unused from the final character or entire characters. The default mode is lenient decoding.
  * </p>
  * <ul>
- * <li>Lenient: Any trailing bits are composed into 8-bit bytes where possible. The remainder are discarded.
+ * <li>Lenient: Any trailing bits are composed into 8-bit bytes where possible. The remainder are discarded.</li>
  * <li>Strict: The decoding will raise an {@link IllegalArgumentException} if trailing bits are not part of a valid encoding. Any unused bits from the final
- * character must be zero. Impossible counts of entire final characters are not allowed.
+ * character must be zero. Impossible counts of entire final characters are not allowed.</li>
  * </ul>
  * <p>
  * When strict decoding is enabled it is expected that the decoded bytes will be re-encoded to a byte array that matches the original, i.e. no changes occur on
@@ -463,9 +463,9 @@ private static byte[] resizeBuffer(final Context context, final int minCapacity)
      * Defines the decoding behavior when the input bytes contain leftover trailing bits that cannot be created by a valid encoding. These can be bits that are
      * unused from the final character or entire characters. The default mode is lenient decoding. Set this to {@code true} to enable strict decoding.
      * <ul>
-     * <li>Lenient: Any trailing bits are composed into 8-bit bytes where possible. The remainder are discarded.
+     * <li>Lenient: Any trailing bits are composed into 8-bit bytes where possible. The remainder are discarded.</li>
      * <li>Strict: The decoding will raise an {@link IllegalArgumentException} if trailing bits are not part of a valid encoding. Any unused bits from the final
-     * character must be zero. Impossible counts of entire final characters are not allowed.
+     * character must be zero. Impossible counts of entire final characters are not allowed.</li>
      * </ul>
      * <p>
      * When strict decoding is enabled it is expected that the decoded bytes will be re-encoded to a byte array that matches the original, i.e. no changes occur

src/main/java/org/apache/commons/codec/digest/Crypt.java

@@ -114,11 +114,11 @@ public static String crypt(final String key) {
      * The exact algorithm depends on the format of the salt string:
      * </p>
      * <ul>
-     * <li>SHA-512 salts start with {@code $6$} and are up to 16 chars long.
-     * <li>SHA-256 salts start with {@code $5$} and are up to 16 chars long
-     * <li>MD5 salts start with {@code $1$} and are up to 8 chars long
-     * <li>DES, the traditional UnixCrypt algorithm is used with only 2 chars
-     * <li>Only the first 8 chars of the passwords are used in the DES algorithm!
+     * <li>SHA-512 salts start with {@code $6$} and are up to 16 chars long.</li>
+     * <li>SHA-256 salts start with {@code $5$} and are up to 16 chars long</li>
+     * <li>MD5 salts start with {@code $1$} and are up to 8 chars long</li>
+     * <li>DES, the traditional UnixCrypt algorithm is used with only 2 chars</li>
+     * <li>Only the first 8 chars of the passwords are used in the DES algorithm!</li>
      * </ul>
      * <p>
      * The magic strings {@code "$apr1$"} and {@code "$2a$"} are not recognized by this method as its output should be
@@ -140,10 +140,10 @@ public static String crypt(final String key) {
      * The total length is dependent on the algorithm used:
      * </p>
      * <ul>
-     * <li>SHA-512: 106 chars
-     * <li>SHA-256: 63 chars
-     * <li>MD5: 34 chars
-     * <li>DES: 13 chars
+     * <li>SHA-512: 106 chars</li>
+     * <li>SHA-256: 63 chars</li>
+     * <li>MD5: 34 chars</li>
+     * <li>DES: 13 chars</li>
      * </ul>
      * <p>
      * Example:

src/main/java/org/apache/commons/codec/language/DaitchMokotoffSoundex.java

@@ -42,16 +42,16 @@
  * The main differences compared to the other Soundex variants are:
  * </p>
  * <ul>
- * <li>coded names are 6 digits long
- * <li>the initial character of the name is coded
- * <li>rules to encoded multi-character n-grams
- * <li>multiple possible encodings for the same name (branching)
+ * <li>coded names are 6 digits long</li>
+ * <li>the initial character of the name is coded</li>
+ * <li>rules to encoded multi-character n-grams</li>
+ * <li>multiple possible encodings for the same name (branching)</li>
  * </ul>
  * <p>
  * This implementation supports branching, depending on the used method:
  * <ul>
- * <li>{@link #encode(String)} - branching disabled, only the first code will be returned
- * <li>{@link #soundex(String)} - branching enabled, all codes will be returned, separated by '|'
+ * <li>{@link #encode(String)} - branching disabled, only the first code will be returned</li>
+ * <li>{@link #soundex(String)} - branching enabled, all codes will be returned, separated by '|'</li>
  * </ul>
  * <p>
  * Note: This implementation has additional branching rules compared to the original description of the algorithm. The