Update Javadoc reference to point to Java 1.4.2 Javadoc on Sun's site (from 1.3.)

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

Author: garydgregory

src/java/org/apache/commons/codec/RequiredCharsetNames.java

@@ -21,8 +21,7 @@
  * Character encoding names required of every implementation of the Java platform.
  * 
  * From the Java documentation <a
- * href="http://java.sun.com/j2se/1.3/docs/api/java/lang/package-summary.html#charenc">JRE character encoding names
- * </a>:
+ * href="http://java.sun.com/j2se/1.4.2/docs/api/java/nio/charset/Charset.html">Standard charsets</a>:
  * <p>
  * <cite>Every implementation of the Java platform is required to support the following character encodings. Consult the
  * release documentation for your implementation to see if any other encodings are supported. Consult the release
@@ -48,8 +47,7 @@
  * This perhaps would best belong in the [lang] project. Even if a similar interface is defined in [lang], it is not
  * forseen that [codec] would be made to depend on [lang].
  * 
- * @see <a href="http://java.sun.com/j2se/1.3/docs/api/java/lang/package-summary.html#charenc">JRE character encoding
- *      names </a>
+ * @see <a href="http://java.sun.com/j2se/1.4.2/docs/api/java/nio/charset/Charset.html">Standard charsets</a>
  * @author Apache Software Foundation
  * @since 1.4
  * @version $Id$
@@ -63,8 +61,7 @@ public class RequiredCharsetNames {
      * Every implementation of the Java platform is required to support this character encoding.
      * </p>
      * 
-     * @see <a href="http://java.sun.com/j2se/1.3/docs/api/java/lang/package-summary.html#charenc">JRE character
-     *      encoding names </a>
+     * @see <a href="http://java.sun.com/j2se/1.4.2/docs/api/java/nio/charset/Charset.html">Standard charsets</a>
      */
     public static final String ISO_8859_1 = "ISO-8859-1";
 
@@ -76,8 +73,7 @@ public class RequiredCharsetNames {
      * Every implementation of the Java platform is required to support this character encoding.
      * </p>
      * 
-     * @see <a href="http://java.sun.com/j2se/1.3/docs/api/java/lang/package-summary.html#charenc">JRE character
-     *      encoding names </a>
+     * @see <a href="http://java.sun.com/j2se/1.4.2/docs/api/java/nio/charset/Charset.html">Standard charsets</a>
      */
     public static final String US_ASCII = "US-ASCII";
 
@@ -90,8 +86,7 @@ public class RequiredCharsetNames {
      * Every implementation of the Java platform is required to support this character encoding.
      * </p>
      * 
-     * @see <a href="http://java.sun.com/j2se/1.3/docs/api/java/lang/package-summary.html#charenc">JRE character
-     *      encoding names </a>
+     * @see <a href="http://java.sun.com/j2se/1.4.2/docs/api/java/nio/charset/Charset.html">Standard charsets</a>
      */
     public static final String UTF_16 = "UTF-16";
 
@@ -103,8 +98,7 @@ public class RequiredCharsetNames {
      * Every implementation of the Java platform is required to support this character encoding.
      * </p>
      * 
-     * @see <a href="http://java.sun.com/j2se/1.3/docs/api/java/lang/package-summary.html#charenc">JRE character
-     *      encoding names </a>
+     * @see <a href="http://java.sun.com/j2se/1.4.2/docs/api/java/nio/charset/Charset.html">Standard charsets</a>
      */
     public static final String UTF_16BE = "UTF-16BE";
 
@@ -116,8 +110,7 @@ public class RequiredCharsetNames {
      * Every implementation of the Java platform is required to support this character encoding.
      * </p>
      * 
-     * @see <a href="http://java.sun.com/j2se/1.3/docs/api/java/lang/package-summary.html#charenc">JRE character
-     *      encoding names </a>
+     * @see <a href="http://java.sun.com/j2se/1.4.2/docs/api/java/nio/charset/Charset.html">Standard charsets</a>
      */
     public static final String UTF_16LE = "UTF-16LE";
 
@@ -129,8 +122,7 @@ public class RequiredCharsetNames {
      * Every implementation of the Java platform is required to support this character encoding.
      * </p>
      * 
-     * @see <a href="http://java.sun.com/j2se/1.3/docs/api/java/lang/package-summary.html#charenc">JRE character
-     *      encoding names </a>
+     * @see <a href="http://java.sun.com/j2se/1.4.2/docs/api/java/nio/charset/Charset.html">Standard charsets</a>
      */
     public static final String UTF_8 = "UTF-8";
 }

src/java/org/apache/commons/codec/binary/StringBytesUtils.java

@@ -23,11 +23,10 @@
 
 /**
  * Converts String to bytes using the encodings required by the Java specification. These encodings are specified in <a
- * href="http://java.sun.com/j2se/1.3/docs/api/java/lang/package-summary.html#charenc">JRE character encoding names</a>
+ * href="http://java.sun.com/j2se/1.4.2/docs/api/java/nio/charset/Charset.html">Standard charsets</a>
  * 
  * @see RequiredCharsetNames
- * @see <a href="http://java.sun.com/j2se/1.3/docs/api/java/lang/package-summary.html#charenc">JRE character encoding
- *      names </a>
+ * @see <a href="http://java.sun.com/j2se/1.4.2/docs/api/java/nio/charset/Charset.html">Standard charsets</a>
  * @author <a href="mailto:ggregory@seagullsw.com">Gary Gregory</a>
  * @version $Id: $
  * @since 1.4
@@ -43,8 +42,7 @@ public class StringBytesUtils {
      * @return encoded bytes
      * @throws IllegalStateException
      *             Thrown when the charset is missing, which should be never according the the Java specification.
-     * @see <a href="http://java.sun.com/j2se/1.3/docs/api/java/lang/package-summary.html#charenc">JRE character
-     *      encoding names </a>
+     * @see <a href="http://java.sun.com/j2se/1.4.2/docs/api/java/nio/charset/Charset.html">Standard charsets</a>
      * @see #getSupportedBytes(String, String)
      */
     public static byte[] getBytesIso8859_1(String string) {
@@ -60,8 +58,7 @@ public static byte[] getBytesIso8859_1(String string) {
      * @return encoded bytes
      * @throws IllegalStateException
      *             Thrown when the charset is missing, which should be never according the the Java specification.
-     * @see <a href="http://java.sun.com/j2se/1.3/docs/api/java/lang/package-summary.html#charenc">JRE character
-     *      encoding names </a>
+     * @see <a href="http://java.sun.com/j2se/1.4.2/docs/api/java/nio/charset/Charset.html">Standard charsets</a>
      * @see #getSupportedBytes(String, String)
      */
     public static byte[] getBytesUsAscii(String string) {
@@ -77,8 +74,7 @@ public static byte[] getBytesUsAscii(String string) {
      * @return encoded bytes
      * @throws IllegalStateException
      *             Thrown when the charset is missing, which should be never according the the Java specification.
-     * @see <a href="http://java.sun.com/j2se/1.3/docs/api/java/lang/package-summary.html#charenc">JRE character
-     *      encoding names </a>
+     * @see <a href="http://java.sun.com/j2se/1.4.2/docs/api/java/nio/charset/Charset.html">Standard charsets</a>
      * @see #getSupportedBytes(String, String)
      */
     public static byte[] getBytesUtf16(String string) {
@@ -94,8 +90,7 @@ public static byte[] getBytesUtf16(String string) {
      * @return encoded bytes
      * @throws IllegalStateException
      *             Thrown when the charset is missing, which should be never according the the Java specification.
-     * @see <a href="http://java.sun.com/j2se/1.3/docs/api/java/lang/package-summary.html#charenc">JRE character
-     *      encoding names </a>
+     * @see <a href="http://java.sun.com/j2se/1.4.2/docs/api/java/nio/charset/Charset.html">Standard charsets</a>
      * @see #getSupportedBytes(String, String)
      */
     public static byte[] getBytesUtf16Be(String string) {
@@ -111,8 +106,7 @@ public static byte[] getBytesUtf16Be(String string) {
      * @return encoded bytes
      * @throws IllegalStateException
      *             Thrown when the charset is missing, which should be never according the the Java specification.
-     * @see <a href="http://java.sun.com/j2se/1.3/docs/api/java/lang/package-summary.html#charenc">JRE character
-     *      encoding names </a>
+     * @see <a href="http://java.sun.com/j2se/1.4.2/docs/api/java/nio/charset/Charset.html">Standard charsets</a>
      * @see #getSupportedBytes(String, String)
      */
     public static byte[] getBytesUtf16Le(String string) {
@@ -128,8 +122,7 @@ public static byte[] getBytesUtf16Le(String string) {
      * @return encoded bytes
      * @throws IllegalStateException
      *             Thrown when the charset is missing, which should be never according the the Java specification.
-     * @see <a href="http://java.sun.com/j2se/1.3/docs/api/java/lang/package-summary.html#charenc">JRE character
-     *      encoding names </a>
+     * @see <a href="http://java.sun.com/j2se/1.4.2/docs/api/java/nio/charset/Charset.html">Standard charsets</a>
      * @see #getSupportedBytes(String, String)
      */
     public static byte[] getBytesUtf8(String string) {

src/java/org/apache/commons/codec/net/BCodec.java

@@ -64,8 +64,7 @@ public BCodec() {
      * @param charset
      *                  the default string charset to use.
      * 
-     * @see <a href="http://java.sun.com/j2se/1.3/docs/api/java/lang/package-summary.html#charenc">JRE character
-     *          encoding names</a>
+     * @see <a href="http://java.sun.com/j2se/1.4.2/docs/api/java/nio/charset/Charset.html">Standard charsets</a>
      */
     public BCodec(final String charset) {
         super();

src/java/org/apache/commons/codec/net/QCodec.java

@@ -119,8 +119,7 @@ public QCodec() {
      * @param charset
      *                  the default string charset to use.
      * 
-     * @see <a href="http://java.sun.com/j2se/1.3/docs/api/java/lang/package-summary.html#charenc">JRE character
-     *          encoding names</a>
+     * @see <a href="http://java.sun.com/j2se/1.4.2/docs/api/java/nio/charset/Charset.html">Standard charsets</a>
      */
     public QCodec(final String charset) {
         super();

src/java/org/apache/commons/codec/net/RFC1522Codec.java

@@ -61,8 +61,7 @@ abstract class RFC1522Codec {
      *  process.
      * @throws UnsupportedEncodingException thrown if charset is not supported 
      * 
-     * @see <a href="http://java.sun.com/j2se/1.3/docs/api/java/lang/package-summary.html#charenc">JRE character
-     *          encoding names</a>
+     * @see <a href="http://java.sun.com/j2se/1.4.2/docs/api/java/nio/charset/Charset.html">Standard charsets</a>
      */
     protected String encodeText(final String text, final String charset)
      throws EncoderException, UnsupportedEncodingException