[CODEC-209] Javadoc for SHA-224 DigestUtils methods should mention Java 1.8.0 restriction instead of 1.4.0.

git-svn-id: https://svn.apache.org/repos/asf/commons/proper/codec/trunk@1743772 13f79535-47bb-0310-9956-ffa450edef68

Author: garydgregory

src/changes/changes.xml

@@ -46,6 +46,7 @@ The <action> type attribute can be add,update,fix,remove.
       <action dev="sebb" type="fix" issue="CODEC-200" due-to="Luciano Vernaschi">Base32.HEX_DECODE_TABLE contains the wrong value 32</action>   
       <action dev="ggregory" type="fix" issue="CODEC-207" due-to="Gary Gregory">Charsets Javadoc breaks build when using Java 8</action>         
       <action dev="ggregory" type="fix" issue="CODEC-199" due-to="Yossi Tamari">Bug in HW rule in Soundex</action>         
+      <action dev="ggregory" type="fix" issue="CODEC-209" due-to="Gary Gregory">Javadoc for SHA-224 DigestUtils methods should mention Java 1.8.0 restriction instead of 1.4.0.</action>         
       <action dev="ggregory" type="add" issue="CODEC-208" due-to="Gary Gregory">Make some DigestUtils APIs public</action>         
       <action dev="ggregory" type="add" issue="CODEC-206" due-to="Gary Gregory">Add java.io.File APIs to DigestUtils</action>         
       <action dev="ggregory" type="add" issue="CODEC-183" due-to="Steven Wurster">BaseNCodecOutputStream only supports writing EOF on close()</action>         

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

@@ -703,14 +703,15 @@ public static byte[] sha224(final ByteBuffer data) {
     /**
      * Calculates the SHA-224 digest and returns the value as a <code>byte[]</code>.
      * <p>
-     * Throws a <code>RuntimeException</code> on JRE versions prior to 1.4.0.
+     * Throws a <code>RuntimeException</code> on JRE versions prior to 1.8.0.
      * </p>
      *
      * @param data
      *            File to digest
      * @return SHA-224 digest
      * @throws IOException
      *             On error reading from the stream
+     * @throws IllegalArgumentException thrown on JRE versions prior to 1.8.0.
      * @since 1.11
      */
     public static byte[] sha224(final File data) throws IOException {
@@ -720,7 +721,7 @@ public static byte[] sha224(final File data) throws IOException {
     /**
      * Calculates the SHA-224 digest and returns the value as a <code>byte[]</code>.
      * <p>
-     * Throws a {@link IllegalArgumentException} on JRE versions prior to 1.4.0.
+     * Throws a {@link IllegalArgumentException} on JRE versions prior to 1.8.0.
      * </p>
      *
      * @param data
@@ -738,7 +739,7 @@ public static byte[] sha224(final InputStream data) throws IOException {
     /**
      * Calculates the SHA-224 digest and returns the value as a <code>byte[]</code>.
      * <p>
-     * Throws a {@link IllegalArgumentException} on JRE versions prior to 1.4.0.
+     * Throws a {@link IllegalArgumentException} on JRE versions prior to 1.8.0.
      * </p>
      *
      * @param data
@@ -754,7 +755,7 @@ public static byte[] sha224(final String data) {
     /**
      * Calculates the SHA-224 digest and returns the value as a hex string.
      * <p>
-     * Throws a {@link IllegalArgumentException} on JRE versions prior to 1.4.0.
+     * Throws a {@link IllegalArgumentException} on JRE versions prior to 1.8.0.
      * </p>
      *
      * @param data
@@ -770,7 +771,7 @@ public static String sha224Hex(final byte[] data) {
     /**
      * Calculates the SHA-224 digest and returns the value as a hex string.
      * <p>
-     * Throws a {@link IllegalArgumentException} on JRE versions prior to 1.4.0.
+     * Throws a {@link IllegalArgumentException} on JRE versions prior to 1.8.0.
      * </p>
      *
      * @param data
@@ -786,7 +787,7 @@ public static String sha224Hex(final ByteBuffer data) {
     /**
      * Calculates the SHA-224 digest and returns the value as a hex string.
      * <p>
-     * Throws a {@link IllegalArgumentException} on JRE versions prior to 1.4.0.
+     * Throws a {@link IllegalArgumentException} on JRE versions prior to 1.8.0.
      * </p>
      *
      * @param data
@@ -804,7 +805,7 @@ public static String sha224Hex(final File data) throws IOException {
     /**
      * Calculates the SHA-224 digest and returns the value as a hex string.
      * <p>
-     * Throws a {@link IllegalArgumentException} on JRE versions prior to 1.4.0.
+     * Throws a {@link IllegalArgumentException} on JRE versions prior to 1.8.0.
      * </p>
      *
      * @param data
@@ -822,7 +823,7 @@ public static String sha224Hex(final InputStream data) throws IOException {
     /**
      * Calculates the SHA-224 digest and returns the value as a hex string.
      * <p>
-     * Throws a {@link IllegalArgumentException} on JRE versions prior to 1.4.0.
+     * Throws a {@link IllegalArgumentException} on JRE versions prior to 1.8.0.
      * </p>
      *
      * @param data