Fix Javadoc error and warnings

Author: garydgregory

src/main/java/org/apache/commons/io/StreamIterator.java

@@ -36,7 +36,7 @@ public final class StreamIterator<E> implements Iterator<E>, AutoCloseable {
 
     /**
      * Wraps and presents a stream as a closable resource that automatically closes itself when reaching the end of stream.
-     * <h2>Warning</h2>
+     * <h4>Warning</h4>
      * <p>
      * In order to close the stream, the call site MUST either close the stream it allocated OR call this iterator until the end.
      * </p>

src/main/java/org/apache/commons/io/build/AbstractStreamBuilder.java

@@ -154,6 +154,11 @@ protected InputStream getInputStream() throws IOException {
         return checkOrigin().getInputStream(getOpenOptions());
     }
 
+    /**
+     * Gets the OpenOption.
+     *
+     * @return the OpenOption.
+     */
     protected OpenOption[] getOpenOptions() {
         return openOptions;
     }

src/main/java/org/apache/commons/io/input/MemoryMappedFileInputStream.java

@@ -87,6 +87,9 @@ public final class MemoryMappedFileInputStream extends InputStream {
      */
     public static class Builder extends AbstractStreamBuilder<MemoryMappedFileInputStream, Builder> {
 
+        /**
+         * Constructs a new Builder.
+         */
         public Builder() {
             setBufferSizeDefault(DEFAULT_BUFFER_SIZE);
             setBufferSize(DEFAULT_BUFFER_SIZE);

src/main/java/org/apache/commons/io/input/MessageDigestCalculatingInputStream.java

@@ -61,6 +61,9 @@ public static class Builder extends AbstractStreamBuilder<MessageDigestCalculati
 
         private MessageDigest messageDigest;
 
+        /**
+         * Constructs a new Builder.
+         */
         public Builder() {
             try {
                 this.messageDigest = getDefaultMessageDigest();

src/main/java/org/apache/commons/io/input/UnsynchronizedByteArrayInputStream.java

@@ -106,6 +106,12 @@ public Builder setByteArray(final byte[] origin) {
             return super.setByteArray(origin);
         }
 
+        /**
+         * Sets the length.
+         *
+         * @param length Must be greater or equal to 0.
+         * @return this.
+         */
         public Builder setLength(final int length) {
             if (length < 0) {
                 throw new IllegalArgumentException("length cannot be negative");
@@ -114,6 +120,12 @@ public Builder setLength(final int length) {
             return this;
         }
 
+        /**
+         * Sets the offset.
+         *
+         * @param offset Must be greater or equal to 0.
+         * @return this.
+         */
         public Builder setOffset(final int offset) {
             if (offset < 0) {
                 throw new IllegalArgumentException("offset cannot be negative");

src/main/java/org/apache/commons/io/input/XmlStreamReader.java

@@ -157,11 +157,23 @@ public Builder setCharset(final String charset) {
             return super.setCharset(Charsets.toCharset(charset, getCharsetDefault()));
         }
 
+        /**
+         * Sets the HTTP content type.
+         *
+         * @param httpContentType the HTTP content type.
+         * @return this.
+         */
         public Builder setHttpContentType(final String httpContentType) {
             this.httpContentType = httpContentType;
             return this;
         }
 
+        /**
+         * Sets the lenient toggle.
+         *
+         * @param lenient the lenient toggle.
+         * @return this.
+         */
         public Builder setLenient(final boolean lenient) {
             this.lenient = lenient;
             return this;

src/main/java/org/apache/commons/io/output/LockableFileWriter.java

@@ -70,6 +70,9 @@ public static class Builder extends AbstractStreamBuilder<LockableFileWriter, Bu
         private boolean append;
         private AbstractOrigin<?, ?> lockDirectory = AbstractOriginSupplier.newFileOrigin(FileUtils.getTempDirectoryPath());
 
+        /**
+         * Constructs a new Builder.
+         */
         public Builder() {
             setBufferSizeDefault(AbstractByteArrayOutputStream.DEFAULT_SIZE);
             setBufferSize(AbstractByteArrayOutputStream.DEFAULT_SIZE);

src/main/java/org/apache/commons/io/output/WriterOutputStream.java

@@ -99,6 +99,9 @@ public static class Builder extends AbstractStreamBuilder<WriterOutputStream, Bu
         private CharsetDecoder charsetDecoder;
         private boolean writeImmediately;
 
+        /**
+         * Constructs a new Builder.
+         */
         public Builder() {
             this.charsetDecoder = getCharset().newDecoder();
         }

src/main/java/org/apache/commons/io/output/XmlStreamWriter.java

@@ -62,6 +62,9 @@ public class XmlStreamWriter extends Writer {
      */
     public static class Builder extends AbstractStreamBuilder<XmlStreamWriter, Builder> {
 
+        /**
+         * Constructs a new Builder.
+         */
         public Builder() {
             setCharsetDefault(StandardCharsets.UTF_8);
             setCharset(StandardCharsets.UTF_8);