You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@commons.apache.org by gg...@apache.org on 2012/03/28 17:31:09 UTC

svn commit: r1306421 - in /commons/proper/codec/trunk/src/main/java/org/apache/commons/codec: DecoderException.java EncoderException.java binary/BinaryCodec.java binary/StringUtils.java net/RFC1522Codec.java

Author: ggregory
Date: Wed Mar 28 15:31:08 2012
New Revision: 1306421

URL: http://svn.apache.org/viewvc?rev=1306421&view=rev
Log:
Replace "<code>null</code>" with "{@code null}"

Modified:
    commons/proper/codec/trunk/src/main/java/org/apache/commons/codec/DecoderException.java
    commons/proper/codec/trunk/src/main/java/org/apache/commons/codec/EncoderException.java
    commons/proper/codec/trunk/src/main/java/org/apache/commons/codec/binary/BinaryCodec.java
    commons/proper/codec/trunk/src/main/java/org/apache/commons/codec/binary/StringUtils.java
    commons/proper/codec/trunk/src/main/java/org/apache/commons/codec/net/RFC1522Codec.java

Modified: commons/proper/codec/trunk/src/main/java/org/apache/commons/codec/DecoderException.java
URL: http://svn.apache.org/viewvc/commons/proper/codec/trunk/src/main/java/org/apache/commons/codec/DecoderException.java?rev=1306421&r1=1306420&r2=1306421&view=diff
==============================================================================
--- commons/proper/codec/trunk/src/main/java/org/apache/commons/codec/DecoderException.java (original)
+++ commons/proper/codec/trunk/src/main/java/org/apache/commons/codec/DecoderException.java Wed Mar 28 15:31:08 2012
@@ -34,7 +34,7 @@ public class DecoderException extends Ex
     private static final long serialVersionUID = 1L;
 
     /**
-     * Constructs a new exception with <code>null</code> as its detail message. The cause is not initialized, and may
+     * Constructs a new exception with {@code null} as its detail message. The cause is not initialized, and may
      * subsequently be initialized by a call to {@link #initCause}.
      * 
      * @since 1.4
@@ -65,7 +65,7 @@ public class DecoderException extends Ex
      * @param message
      *            The detail message which is saved for later retrieval by the {@link #getMessage()} method.
      * @param cause
-     *            The cause which is saved for later retrieval by the {@link #getCause()} method. A <code>null</code>
+     *            The cause which is saved for later retrieval by the {@link #getCause()} method. A {@code null}
      *            value is permitted, and indicates that the cause is nonexistent or unknown.
      * @since 1.4
      */
@@ -79,7 +79,7 @@ public class DecoderException extends Ex
      * This constructor is useful for exceptions that are little more than wrappers for other throwables.
      * 
      * @param cause
-     *            The cause which is saved for later retrieval by the {@link #getCause()} method. A <code>null</code>
+     *            The cause which is saved for later retrieval by the {@link #getCause()} method. A {@code null}
      *            value is permitted, and indicates that the cause is nonexistent or unknown.
      * @since 1.4
      */

Modified: commons/proper/codec/trunk/src/main/java/org/apache/commons/codec/EncoderException.java
URL: http://svn.apache.org/viewvc/commons/proper/codec/trunk/src/main/java/org/apache/commons/codec/EncoderException.java?rev=1306421&r1=1306420&r2=1306421&view=diff
==============================================================================
--- commons/proper/codec/trunk/src/main/java/org/apache/commons/codec/EncoderException.java (original)
+++ commons/proper/codec/trunk/src/main/java/org/apache/commons/codec/EncoderException.java Wed Mar 28 15:31:08 2012
@@ -35,7 +35,7 @@ public class EncoderException extends Ex
     private static final long serialVersionUID = 1L;
 
     /**
-     * Constructs a new exception with <code>null</code> as its detail message. The cause is not initialized, and may
+     * Constructs a new exception with {@code null} as its detail message. The cause is not initialized, and may
      * subsequently be initialized by a call to {@link #initCause}.
      * 
      * @since 1.4
@@ -66,7 +66,7 @@ public class EncoderException extends Ex
      * @param message
      *            The detail message which is saved for later retrieval by the {@link #getMessage()} method.
      * @param cause
-     *            The cause which is saved for later retrieval by the {@link #getCause()} method. A <code>null</code>
+     *            The cause which is saved for later retrieval by the {@link #getCause()} method. A {@code null}
      *            value is permitted, and indicates that the cause is nonexistent or unknown.
      * @since 1.4
      */
@@ -80,7 +80,7 @@ public class EncoderException extends Ex
      * This constructor is useful for exceptions that are little more than wrappers for other throwables.
      * 
      * @param cause
-     *            The cause which is saved for later retrieval by the {@link #getCause()} method. A <code>null</code>
+     *            The cause which is saved for later retrieval by the {@link #getCause()} method. A {@code null}
      *            value is permitted, and indicates that the cause is nonexistent or unknown.
      * @since 1.4
      */

Modified: commons/proper/codec/trunk/src/main/java/org/apache/commons/codec/binary/BinaryCodec.java
URL: http://svn.apache.org/viewvc/commons/proper/codec/trunk/src/main/java/org/apache/commons/codec/binary/BinaryCodec.java?rev=1306421&r1=1306420&r2=1306421&view=diff
==============================================================================
--- commons/proper/codec/trunk/src/main/java/org/apache/commons/codec/binary/BinaryCodec.java (original)
+++ commons/proper/codec/trunk/src/main/java/org/apache/commons/codec/binary/BinaryCodec.java Wed Mar 28 15:31:08 2012
@@ -211,11 +211,11 @@ public class BinaryCodec implements Bina
     }
 
     /**
-     * Returns <code>true</code> if the given array is <code>null</code> or empty (size 0.)
+     * Returns <code>true</code> if the given array is {@code null} or empty (size 0.)
      * 
      * @param array
      *            the source array
-     * @return <code>true</code> if the given array is <code>null</code> or empty (size 0.)
+     * @return <code>true</code> if the given array is {@code null} or empty (size 0.)
      */
     private static boolean isEmpty(byte[] array) {
         return array == null || array.length == 0;

Modified: commons/proper/codec/trunk/src/main/java/org/apache/commons/codec/binary/StringUtils.java
URL: http://svn.apache.org/viewvc/commons/proper/codec/trunk/src/main/java/org/apache/commons/codec/binary/StringUtils.java?rev=1306421&r1=1306420&r2=1306421&view=diff
==============================================================================
--- commons/proper/codec/trunk/src/main/java/org/apache/commons/codec/binary/StringUtils.java (original)
+++ commons/proper/codec/trunk/src/main/java/org/apache/commons/codec/binary/StringUtils.java Wed Mar 28 15:31:08 2012
@@ -56,8 +56,8 @@ public class StringUtils {
      * byte array.
      * 
      * @param string
-     *            the String to encode, may be <code>null</code>
-     * @return encoded bytes, or <code>null</code> if the input string was <code>null</code>
+     *            the String to encode, may be {@code null}
+     * @return encoded bytes, or {@code null} if the input string was {@code null}
      * @throws NullPointerException
      *             Thrown if {@link Charsets#ISO_8859_1} is not initialized, which should never happen since it is
      *             required by the Java platform specification.
@@ -79,10 +79,10 @@ public class StringUtils {
      * </p>
      * 
      * @param string
-     *            the String to encode, may be <code>null</code>
+     *            the String to encode, may be {@code null}
      * @param charsetName
      *            The name of a required {@link java.nio.charset.Charset}
-     * @return encoded bytes, or <code>null</code> if the input string was <code>null</code>
+     * @return encoded bytes, or {@code null} if the input string was {@code null}
      * @throws IllegalStateException
      *             Thrown when a {@link UnsupportedEncodingException} is caught, which should never happen for a
      *             required charset name.
@@ -105,8 +105,8 @@ public class StringUtils {
      * array.
      * 
      * @param string
-     *            the String to encode, may be <code>null</code>
-     * @return encoded bytes, or <code>null</code> if the input string was <code>null</code>
+     *            the String to encode, may be {@code null}
+     * @return encoded bytes, or {@code null} if the input string was {@code null}
      * @throws NullPointerException
      *             Thrown if {@link Charsets#US_ASCII} is not initialized, which should never happen since it is
      *             required by the Java platform specification.
@@ -123,8 +123,8 @@ public class StringUtils {
      * array.
      * 
      * @param string
-     *            the String to encode, may be <code>null</code>
-     * @return encoded bytes, or <code>null</code> if the input string was <code>null</code>
+     *            the String to encode, may be {@code null}
+     * @return encoded bytes, or {@code null} if the input string was {@code null}
      * @throws NullPointerException
      *             Thrown if {@link Charsets#UTF_16} is not initialized, which should never happen since it is
      *             required by the Java platform specification.
@@ -141,8 +141,8 @@ public class StringUtils {
      * array.
      * 
      * @param string
-     *            the String to encode, may be <code>null</code>
-     * @return encoded bytes, or <code>null</code> if the input string was <code>null</code>
+     *            the String to encode, may be {@code null}
+     * @return encoded bytes, or {@code null} if the input string was {@code null}
      * @throws NullPointerException
      *             Thrown if {@link Charsets#UTF_16BE} is not initialized, which should never happen since it is
      *             required by the Java platform specification.
@@ -159,8 +159,8 @@ public class StringUtils {
      * array.
      * 
      * @param string
-     *            the String to encode, may be <code>null</code>
-     * @return encoded bytes, or <code>null</code> if the input string was <code>null</code>
+     *            the String to encode, may be {@code null}
+     * @return encoded bytes, or {@code null} if the input string was {@code null}
      * @throws NullPointerException
      *             Thrown if {@link Charsets#UTF_16LE} is not initialized, which should never happen since it is
      *             required by the Java platform specification.
@@ -177,8 +177,8 @@ public class StringUtils {
      * array.
      * 
      * @param string
-     *            the String to encode, may be <code>null</code>
-     * @return encoded bytes, or <code>null</code> if the input string was <code>null</code>
+     *            the String to encode, may be {@code null}
+     * @return encoded bytes, or {@code null} if the input string was {@code null}
      * @throws NullPointerException
      *             Thrown if {@link Charsets#UTF_8} is not initialized, which should never happen since it is
      *             required by the Java platform specification.
@@ -202,7 +202,7 @@ public class StringUtils {
      * @param charset
      *            The {@link Charset} to encode the {@code String}
      * @return A new <code>String</code> decoded from the specified array of bytes using the given charset,
-     *         or <code>null</code> if the input byte array was <code>null</code>.
+     *         or {@code null} if the input byte array was {@code null}.
      * @throws NullPointerException
      *             Thrown if {@link Charsets#UTF_8} is not initialized, which should never happen since it is
      *             required by the Java platform specification.
@@ -219,11 +219,11 @@ public class StringUtils {
      * </p>
      * 
      * @param bytes
-     *            The bytes to be decoded into characters, may be <code>null</code>
+     *            The bytes to be decoded into characters, may be {@code null}
      * @param charsetName
      *            The name of a required {@link java.nio.charset.Charset}
      * @return A new <code>String</code> decoded from the specified array of bytes using the given charset,
-     *         or <code>null</code> if the input byte array was <code>null</code>.
+     *         or {@code null} if the input byte array was {@code null}.
      * @throws IllegalStateException
      *             Thrown when a {@link UnsupportedEncodingException} is caught, which should never happen for a
      *             required charset name.
@@ -245,9 +245,9 @@ public class StringUtils {
      * Constructs a new <code>String</code> by decoding the specified array of bytes using the ISO-8859-1 charset.
      * 
      * @param bytes
-     *            The bytes to be decoded into characters, may be <code>null</code>
+     *            The bytes to be decoded into characters, may be {@code null}
      * @return A new <code>String</code> decoded from the specified array of bytes using the ISO-8859-1 charset, or
-     *         <code>null</code> if the input byte array was <code>null</code>.
+     *         {@code null} if the input byte array was {@code null}.
      * @throws NullPointerException
      *             Thrown if {@link Charsets#ISO_8859_1} is not initialized, which should never happen since it is
      *             required by the Java platform specification.
@@ -263,7 +263,7 @@ public class StringUtils {
      * @param bytes
      *            The bytes to be decoded into characters
      * @return A new <code>String</code> decoded from the specified array of bytes using the US-ASCII charset,
-     *         or <code>null</code> if the input byte array was <code>null</code>.
+     *         or {@code null} if the input byte array was {@code null}.
      * @throws NullPointerException
      *             Thrown if {@link Charsets#US_ASCII} is not initialized, which should never happen since it is
      *             required by the Java platform specification.
@@ -279,7 +279,7 @@ public class StringUtils {
      * @param bytes
      *            The bytes to be decoded into characters
      * @return A new <code>String</code> decoded from the specified array of bytes using the UTF-16 charset
-     *         or <code>null</code> if the input byte array was <code>null</code>.
+     *         or {@code null} if the input byte array was {@code null}.
      * @throws NullPointerException
      *             Thrown if {@link Charsets#UTF_16} is not initialized, which should never happen since it is
      *             required by the Java platform specification.
@@ -295,7 +295,7 @@ public class StringUtils {
      * @param bytes
      *            The bytes to be decoded into characters
      * @return A new <code>String</code> decoded from the specified array of bytes using the UTF-16BE charset,
-     *         or <code>null</code> if the input byte array was <code>null</code>.
+     *         or {@code null} if the input byte array was {@code null}.
      * @throws NullPointerException
      *             Thrown if {@link Charsets#UTF_16BE} is not initialized, which should never happen since it is
      *             required by the Java platform specification.
@@ -311,7 +311,7 @@ public class StringUtils {
      * @param bytes
      *            The bytes to be decoded into characters
      * @return A new <code>String</code> decoded from the specified array of bytes using the UTF-16LE charset,
-     *         or <code>null</code> if the input byte array was <code>null</code>.
+     *         or {@code null} if the input byte array was {@code null}.
      * @throws NullPointerException
      *             Thrown if {@link Charsets#UTF_16LE} is not initialized, which should never happen since it is
      *             required by the Java platform specification.
@@ -327,7 +327,7 @@ public class StringUtils {
      * @param bytes
      *            The bytes to be decoded into characters
      * @return A new <code>String</code> decoded from the specified array of bytes using the UTF-8 charset,
-     *         or <code>null</code> if the input byte array was <code>null</code>.
+     *         or {@code null} if the input byte array was {@code null}.
      * @throws NullPointerException
      *             Thrown if {@link Charsets#UTF_8} is not initialized, which should never happen since it is
      *             required by the Java platform specification.

Modified: commons/proper/codec/trunk/src/main/java/org/apache/commons/codec/net/RFC1522Codec.java
URL: http://svn.apache.org/viewvc/commons/proper/codec/trunk/src/main/java/org/apache/commons/codec/net/RFC1522Codec.java?rev=1306421&r1=1306420&r2=1306421&view=diff
==============================================================================
--- commons/proper/codec/trunk/src/main/java/org/apache/commons/codec/net/RFC1522Codec.java (original)
+++ commons/proper/codec/trunk/src/main/java/org/apache/commons/codec/net/RFC1522Codec.java Wed Mar 28 15:31:08 2012
@@ -127,7 +127,7 @@ abstract class RFC1522Codec {
      * {@link #doEncoding(byte [])} method of a concrete class to perform the specific decoding.
      * 
      * @param text a string to decode
-     * @return A new decoded String or <code>null</code> if the input is <code>null</code>.
+     * @return A new decoded String or {@code null} if the input is {@code null}.
      * 
      * @throws DecoderException thrown if there is an error condition during the decoding 
      *  process.