Javadoc cleanup, removal of leading paragraph.

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

Author: netomi

src/main/java/org/apache/commons/codec/Decoder.java

@@ -18,14 +18,12 @@
 package org.apache.commons.codec;
 
 /**
- * <p>Provides the highest level of abstraction for Decoders.
- * This is the sister interface of {@link Encoder}.  All
- * Decoders implement this common generic interface.</p>
- *
- * <p>Allows a user to pass a generic Object to any Decoder
- * implementation in the codec package.</p>
- *
- * <p>One of the two interfaces at the center of the codec package.</p>
+ * Provides the highest level of abstraction for Decoders.
+ * <p>
+ * This is the sister interface of {@link Encoder}. All Decoders implement this common generic interface.
+ * Allows a user to pass a generic Object to any Decoder implementation in the codec package.
+ * <p>
+ * One of the two interfaces at the center of the codec package.
  *
  * @version $Id$
  */

src/main/java/org/apache/commons/codec/Encoder.java

@@ -18,10 +18,11 @@
 package org.apache.commons.codec;
 
 /**
- * <p>Provides the highest level of abstraction for Encoders.
- * This is the sister interface of {@link Decoder}.  Every implementation of
- * Encoder provides this common generic interface which allows a user to pass a
- * generic Object to any Encoder implementation in the codec package.</p>
+ * Provides the highest level of abstraction for Encoders.
+ * <p>
+ * This is the sister interface of {@link Decoder}.  Every implementation of Encoder provides this
+ * common generic interface which allows a user to pass a generic Object to any Encoder implementation
+ * in the codec package.
  *
  * @version $Id$
  */

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

@@ -29,18 +29,14 @@
 import org.apache.commons.codec.binary.Base64;
 
 /**
- * <p>
- * Identical to the Base64 encoding defined by <a href="http://www.ietf.org/rfc/rfc1521.txt">RFC
- * 1521</a> and allows a character set to be specified.
- * </p>
- *
+ * Identical to the Base64 encoding defined by <a href="http://www.ietf.org/rfc/rfc1521.txt">RFC 1521</a>
+ * and allows a character set to be specified.
  * <p>
  * <a href="http://www.ietf.org/rfc/rfc1522.txt">RFC 1522</a> describes techniques to allow the encoding of non-ASCII
  * text in various portions of a RFC 822 [2] message header, in a manner which is unlikely to confuse existing message
  * handling software.
- * </p>
- *
- * <p>This class is immutable and thread-safe.</p>
+ * <p>
+ * This class is immutable and thread-safe.
  *
  * @see <a href="http://www.ietf.org/rfc/rfc1522.txt">MIME (Multipurpose Internet Mail Extensions) Part Two: Message
  *          Header Extensions for Non-ASCII Text</a>

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

@@ -29,18 +29,14 @@
 import org.apache.commons.codec.StringEncoder;
 
 /**
- * <p>
- * Similar to the Quoted-Printable content-transfer-encoding defined in <a
- * href="http://www.ietf.org/rfc/rfc1521.txt">RFC 1521</a> and designed to allow text containing mostly ASCII
+ * Similar to the Quoted-Printable content-transfer-encoding defined in
+ * <a href="http://www.ietf.org/rfc/rfc1521.txt">RFC 1521</a> and designed to allow text containing mostly ASCII
  * characters to be decipherable on an ASCII terminal without decoding.
- * </p>
- *
  * <p>
  * <a href="http://www.ietf.org/rfc/rfc1522.txt">RFC 1522</a> describes techniques to allow the encoding of non-ASCII
  * text in various portions of a RFC 822 [2] message header, in a manner which is unlikely to confuse existing message
  * handling software.
- * </p>
- *
+ * <p>
  * This class is conditionally thread-safe.
  * The instance field {@link #encodeBlanks} is mutable {@link #setEncodeBlanks(boolean)}
  * but is not volatile, and accesses are not synchronised.

src/main/java/org/apache/commons/codec/net/QuotedPrintableCodec.java

@@ -33,29 +33,23 @@
 import org.apache.commons.codec.binary.StringUtils;
 
 /**
- * <p>
  * Codec for the Quoted-Printable section of <a href="http://www.ietf.org/rfc/rfc1521.txt">RFC 1521</a>.
- * </p>
  * <p>
  * The Quoted-Printable encoding is intended to represent data that largely consists of octets that correspond to
  * printable characters in the ASCII character set. It encodes the data in such a way that the resulting octets are
  * unlikely to be modified by mail transport. If the data being encoded are mostly ASCII text, the encoded form of the
  * data remains largely recognizable by humans. A body which is entirely ASCII may also be encoded in Quoted-Printable
  * to ensure the integrity of the data should the message pass through a character- translating, and/or line-wrapping
  * gateway.
- * </p>
- *
  * <p>
  * Note:
- * </p>
  * <p>
  * Rules #3, #4, and #5 of the quoted-printable spec are not implemented yet because the complete quoted-printable spec
  * does not lend itself well into the byte[] oriented codec framework. Complete the codec once the streamable codec
  * framework is ready. The motivation behind providing the codec in a partial form is that it can already come in handy
  * for those applications that do not require quoted-printable line formatting (rules #3, #4, #5), for instance Q codec.
- * </p>
- *
- * <p>This class is immutable and thread-safe.</p>
+ * <p>
+ * This class is immutable and thread-safe.
  *
  * @see <a href="http://www.ietf.org/rfc/rfc1521.txt"> RFC 1521 MIME (Multipurpose Internet Mail Extensions) Part One:
  *          Mechanisms for Specifying and Describing the Format of Internet Message Bodies </a>

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

@@ -25,23 +25,16 @@
 import org.apache.commons.codec.binary.StringUtils;
 
 /**
- * <p>
  * Implements methods common to all codecs defined in RFC 1522.
- * </p>
- *
  * <p>
- * <a href="http://www.ietf.org/rfc/rfc1522.txt">RFC 1522</a>
- * describes techniques to allow the encoding of non-ASCII text in
- * various portions of a RFC 822 [2] message header, in a manner which
+ * <a href="http://www.ietf.org/rfc/rfc1522.txt">RFC 1522</a> describes techniques to allow the
+ * encoding of non-ASCII text in various portions of a RFC 822 [2] message header, in a manner which
  * is unlikely to confuse existing message handling software.
- * </p>
-
- * @see <a href="http://www.ietf.org/rfc/rfc1522.txt">
- * MIME (Multipurpose Internet Mail Extensions) Part Two:
- * Message Header Extensions for Non-ASCII Text</a>
- * </p>
+ * <p>
+ * This class is immutable and thread-safe.
  *
- * <p>This class is immutable and thread-safe.</p>
+ * @see <a href="http://www.ietf.org/rfc/rfc1522.txt">MIME (Multipurpose Internet Mail Extensions) Part Two:
+ *          Message Header Extensions for Non-ASCII Text</a>
  *
  * @since 1.3
  * @version $Id$

src/main/java/org/apache/commons/codec/net/URLCodec.java

@@ -31,22 +31,16 @@
 import org.apache.commons.codec.binary.StringUtils;
 
 /**
- * <p>Implements the 'www-form-urlencoded' encoding scheme,
- * also misleadingly known as URL encoding.</p>
- *
- * <p>For more detailed information please refer to
- * <a href="http://www.w3.org/TR/html4/interact/forms.html#h-17.13.4.1">
- * Chapter 17.13.4 'Form content types'</a> of the
- * <a href="http://www.w3.org/TR/html4/">HTML 4.01 Specification<a></p>
- *
+ * Implements the 'www-form-urlencoded' encoding scheme, also misleadingly known as URL encoding.
  * <p>
- * This codec is meant to be a replacement for standard Java classes
- * {@link java.net.URLEncoder} and {@link java.net.URLDecoder}
- * on older Java platforms, as these classes in Java versions below
+ * This codec is meant to be a replacement for standard Java classes {@link java.net.URLEncoder} and
+ * {@link java.net.URLDecoder} on older Java platforms, as these classes in Java versions below
  * 1.4 rely on the platform's default charset encoding.
- * </p>
+ * <p>
+ * This class is immutable and thread-safe.
  *
- * <p>This class is immutable and thread-safe.</p>
+ * @see <a href="http://www.w3.org/TR/html4/interact/forms.html#h-17.13.4.1">Chapter 17.13.4 'Form content types'</a>
+ *           of the <a href="http://www.w3.org/TR/html4/">HTML 4.01 Specification<a>
  *
  * @since 1.2
  * @version $Id$