Javadoc. Close HTML tags. Use paragraph tags.
MODIFY
src/main/java/org/apache/commons/io/input/AutoCloseInputStream.java
src/main/java/org/apache/commons/io/input/AutoCloseInputStream.java
* stream as soon as possible even if the client application (by not explicitly
* closing the stream when no longer needed) or the underlying stream (by not
* releasing resources once the last byte has been read) do not do that.
+ * </p>
*
* @since 1.4
*/

MODIFY
src/main/java/org/apache/commons/io/input/BOMInputStream.java
src/main/java/org/apache/commons/io/input/BOMInputStream.java
/**
* This class is used to wrap a stream that includes an encoded {@link ByteOrderMark} as its first bytes.
- *
+ * <p>
* This class detects these bytes and, if required, can automatically skip them and return the subsequent byte as the
* first byte in the stream.
- *
+ * </p>
+ * <p>
* The {@link ByteOrderMark} implementation has the following pre-defined BOMs:
+ * </p>
* <ul>
* <li>UTF-8 - {@link ByteOrderMark#UTF_8}</li>
* <li>UTF-16BE - {@link ByteOrderMark#UTF_16LE}</li>
* <li>UTF-32LE - {@link ByteOrderMark#UTF_32BE}</li>
* </ul>
*
- *
* <h2>Example 1 - Detect and exclude a UTF-8 BOM</h2>
*
* <pre>

MODIFY
src/main/java/org/apache/commons/io/input/BoundedInputStream.java
src/main/java/org/apache/commons/io/input/BoundedInputStream.java
* So, one of these, initialized with the Content-length sent in the
* ServletInputStream's header, will stop it blocking, providing it's been sent
* with a correct content length.
+ * </p>
*
* @since 2.0
*/

MODIFY
src/main/java/org/apache/commons/io/input/BrokenInputStream.java
src/main/java/org/apache/commons/io/input/BrokenInputStream.java
* <p>
* This class is mostly useful for testing error handling in code that uses an
* input stream.
+ * </p>
*
* @since 2.0
*/

MODIFY
src/main/java/org/apache/commons/io/input/CharSequenceInputStream.java
src/main/java/org/apache/commons/io/input/CharSequenceInputStream.java
* StringBuilder or CharBuffer.
* <p>
* <strong>Note:</strong> Supports {@link #mark(int)} and {@link #reset()}.
+ * </p>
*
* @since 2.2
*/

MODIFY
src/main/java/org/apache/commons/io/input/ClassLoaderObjectInputStream.java
src/main/java/org/apache/commons/io/input/ClassLoaderObjectInputStream.java
* {@code ClassLoader} rather than the system default.
* <p>
* This is useful in dynamic container environments.
+ * </p>
*
* @since 1.1
*/

MODIFY
src/main/java/org/apache/commons/io/input/NullInputStream.java
src/main/java/org/apache/commons/io/input/NullInputStream.java
* This implementation provides a light weight
* object for testing with an {@link InputStream}
* where the contents don't matter.
+ * </p>
* <p>
* One use case would be for testing the handling of
* large {@link InputStream} as it can emulate that
* scenario without the overhead of actually processing
* large numbers of bytes - significantly speeding up
* test execution times.
+ * </p>
* <p>
* This implementation returns zero from the method that
* reads a byte and leaves the array unchanged in the read
* If alternative data is required the {@code processByte()} and
* {@code processBytes()} methods can be implemented to generate
* data, for example:
+ * </p>
*
* <pre>
* public class TestInputStream extends NullInputStream {

MODIFY
src/main/java/org/apache/commons/io/input/QueueInputStream.java
src/main/java/org/apache/commons/io/input/QueueInputStream.java
* <p>
* Example usage:
* </p>
- *
* <pre>
* QueueInputStream inputStream = new QueueInputStream();
* QueueOutputStream outputStream = inputStream.newQueueOutputStream();
* outputStream.write("hello world".getBytes(UTF_8));
* inputStream.read();
* </pre>
- *
+ * <p>
* Unlike JDK {@link PipedInputStream} and {@link PipedOutputStream}, queue input/output streams may be used safely in a
* single thread or multiple threads. Also, unlike JDK classes, no special meaning is attached to initial or current
* thread. Instances can be used longer after initial threads exited.
- *
+ * </p>
* <p>
* Closing a {@code QueueInputStream} has no effect. The methods in this class can be called after the stream has been
* closed without generating an {@code IOException}.

MODIFY
src/main/java/org/apache/commons/io/input/TaggedInputStream.java
src/main/java/org/apache/commons/io/input/TaggedInputStream.java
* used to let higher levels of code handle the exception caused by this
* stream while other processing errors are being taken care of at this
* lower level.
+ * </p>
* <pre>
* TaggedInputStream stream = new TaggedInputStream(...);
* try {

MODIFY
src/main/java/org/apache/commons/io/input/UnsupportedOperationExceptions.java
src/main/java/org/apache/commons/io/input/UnsupportedOperationExceptions.java
/**
* Package-private factory for {@link UnsupportedOperationException} to provide messages with consistent formatting.
*
+ * <p>
* TODO Consider making this public and use from LineIterator but this feels like it belongs in LANG rather than IO.
+ * </p>
*/
class UnsupportedOperationExceptions {

MODIFY
src/test/java/org/apache/commons/io/input/compatibility/XmlStreamReader.java
src/test/java/org/apache/commons/io/input/compatibility/XmlStreamReader.java
* <p>
* IMPORTANT: This class is not related in any way to the org.xml.sax.XMLReader.
* This one IS a character stream.
+ * </p>
* <p>
* All this has to be done without consuming characters from the stream, if not
* the XML parser will not recognized the document as a valid XML. This is not
* 100% true, but it's close enough (UTF-8 BOM is not handled by all parsers
* right now, XmlStreamReader handles it and things work in all parsers).
+ * </p>
* <p>
* The XmlStreamReader class handles the charset encoding of XML documents in
* Files, raw streams and HTTP streams by offering a wide set of constructors.
+ * </p>
* <p>
* By default the charset encoding detection is lenient, the constructor with
* the lenient flag can be used for a script (following HTTP MIME and XML
* specifications). All this is nicely explained by Mark Pilgrim in his blog, <a
* href="http://diveintomark.org/archives/2004/02/13/xml-media-types">
* Determining the character encoding of a feed</a>.
+ * </p>
* <p>
* Originally developed for <a href="http://rome.dev.java.net">ROME</a> under
* Apache License 2.0.
+ * </p>
*
* @see XmlStreamWriter
*/

MODIFY
src/test/java/org/apache/commons/io/input/compatibility/XmlStreamReaderException.java
src/test/java/org/apache/commons/io/input/compatibility/XmlStreamReaderException.java
* do an alternate processing with the stream. Note that the original
* InputStream given to the XmlStreamReader cannot be used as that one has been
* already read.
+ * </p>
*
*/
public class XmlStreamReaderException extends org.apache.commons.io.input.XmlStreamReaderException {

Javadoc. Close HTML tags. Use paragraph tags.