This is an automated email from the ASF dual-hosted git repository. ggregory pushed a commit to branch master in repository https://gitbox.apache.org/repos/asf/commons-io.git
commit 7b6b6d86426c2d4063684a5ceed446f0affd42c7 Author: Gary Gregory <gardgreg...@gmail.com> AuthorDate: Sat Jan 23 09:00:46 2021 -0500 Javadoc: Sentences end in a period. --- src/main/java/org/apache/commons/io/IOUtils.java | 16 ++++++------ .../java/org/apache/commons/io/file/PathUtils.java | 18 ++++++------- .../commons/io/input/BoundedInputStream.java | 12 ++++----- .../commons/io/input/CountingInputStream.java | 2 +- .../apache/commons/io/input/ProxyInputStream.java | 16 ++++++------ .../org/apache/commons/io/input/ProxyReader.java | 20 +++++++-------- .../apache/commons/io/input/ReaderInputStream.java | 8 +++--- .../commons/io/input/ReversedLinesFileReader.java | 18 ++++++------- .../commons/io/input/SwappedDataInputStream.java | 30 +++++++++++----------- .../apache/commons/io/input/TaggedInputStream.java | 2 +- .../org/apache/commons/io/input/TaggedReader.java | 2 +- .../apache/commons/io/input/XmlStreamReader.java | 2 +- .../commons/io/output/ByteArrayOutputStream.java | 4 +-- .../commons/io/output/FileWriterWithEncoding.java | 14 +++++----- .../commons/io/output/LockableFileWriter.java | 14 +++++----- .../commons/io/output/ProxyCollectionWriter.java | 22 ++++++++-------- .../commons/io/output/ProxyOutputStream.java | 12 ++++----- .../org/apache/commons/io/output/ProxyWriter.java | 22 ++++++++-------- .../commons/io/output/TaggedOutputStream.java | 2 +- .../org/apache/commons/io/output/TaggedWriter.java | 2 +- .../apache/commons/io/output/TeeOutputStream.java | 10 ++++---- .../UnsynchronizedByteArrayOutputStream.java | 4 +-- .../commons/io/output/WriterOutputStream.java | 14 +++++----- 23 files changed, 133 insertions(+), 133 deletions(-) diff --git a/src/main/java/org/apache/commons/io/IOUtils.java b/src/main/java/org/apache/commons/io/IOUtils.java index 55c077e..2e737ef 100644 --- a/src/main/java/org/apache/commons/io/IOUtils.java +++ b/src/main/java/org/apache/commons/io/IOUtils.java @@ -1852,7 +1852,7 @@ public class IOUtils { * * @param name name of the desired resource * @return the requested byte array - * @throws IOException if an I/O error occurs + * @throws IOException if an I/O error occurs. * * @since 2.6 */ @@ -1871,7 +1871,7 @@ public class IOUtils { * @param name name of the desired resource * @param classLoader the class loader that the resolution of the resource is delegated to * @return the requested byte array - * @throws IOException if an I/O error occurs + * @throws IOException if an I/O error occurs. * * @since 2.6 */ @@ -1891,7 +1891,7 @@ public class IOUtils { * @param name name of the desired resource * @param charset the charset to use, null means platform default * @return the requested String - * @throws IOException if an I/O error occurs + * @throws IOException if an I/O error occurs. * * @since 2.6 */ @@ -1912,7 +1912,7 @@ public class IOUtils { * @param charset the charset to use, null means platform default * @param classLoader the class loader that the resolution of the resource is delegated to * @return the requested String - * @throws IOException if an I/O error occurs + * @throws IOException if an I/O error occurs. * * @since 2.6 */ @@ -1930,7 +1930,7 @@ public class IOUtils { * * @param name name of the desired resource * @return the requested URL - * @throws IOException if an I/O error occurs + * @throws IOException if an I/O error occurs. * * @since 2.6 */ @@ -1949,7 +1949,7 @@ public class IOUtils { * @param name name of the desired resource * @param classLoader the class loader that the resolution of the resource is delegated to * @return the requested URL - * @throws IOException if an I/O error occurs + * @throws IOException if an I/O error occurs. * * @since 2.6 */ @@ -2176,7 +2176,7 @@ public class IOUtils { * * @param input Stream to be fully buffered. * @return A fully buffered stream. - * @throws IOException if an I/O error occurs + * @throws IOException if an I/O error occurs. * @since 2.0 */ public static InputStream toBufferedInputStream(final InputStream input) throws IOException { @@ -2202,7 +2202,7 @@ public class IOUtils { * @param input Stream to be fully buffered. * @param size the initial buffer size * @return A fully buffered stream. - * @throws IOException if an I/O error occurs + * @throws IOException if an I/O error occurs. * @since 2.5 */ public static InputStream toBufferedInputStream(final InputStream input, final int size) throws IOException { diff --git a/src/main/java/org/apache/commons/io/file/PathUtils.java b/src/main/java/org/apache/commons/io/file/PathUtils.java index 5cba5b8..978ba5a 100644 --- a/src/main/java/org/apache/commons/io/file/PathUtils.java +++ b/src/main/java/org/apache/commons/io/file/PathUtils.java @@ -236,7 +236,7 @@ public final class PathUtils { * @param targetFile The target file. * @param copyOptions Specifies how the copying should be done. * @return The target file - * @throws IOException if an I/O error occurs + * @throws IOException if an I/O error occurs. * @see Files#copy(InputStream, Path, CopyOption...) */ public static Path copyFile(final URL sourceFile, final Path targetFile, final CopyOption... copyOptions) @@ -254,7 +254,7 @@ public final class PathUtils { * @param targetDirectory The target directory. * @param copyOptions Specifies how the copying should be done. * @return The target file - * @throws IOException if an I/O error occurs + * @throws IOException if an I/O error occurs. * @see Files#copy(Path, Path, CopyOption...) */ public static Path copyFileToDirectory(final Path sourceFile, final Path targetDirectory, @@ -269,7 +269,7 @@ public final class PathUtils { * @param targetDirectory The target directory. * @param copyOptions Specifies how the copying should be done. * @return The target file - * @throws IOException if an I/O error occurs + * @throws IOException if an I/O error occurs. * @see Files#copy(InputStream, Path, CopyOption...) */ public static Path copyFileToDirectory(final URL sourceFile, final Path targetDirectory, @@ -300,7 +300,7 @@ public final class PathUtils { * @param path The path to a file (or directory). * @param attrs An optional list of file attributes to set atomically when creating the directories. * @return The Path for the {@code path}'s parent directory or null if the given path has no parent. - * @throws IOException if an I/O error occurs + * @throws IOException if an I/O error occurs. * @since 2.9.0 */ public static Path createParentDirectories(final Path path, final FileAttribute<?>... attrs) throws IOException { @@ -727,7 +727,7 @@ public final class PathUtils { * * @param path the file or directory to query. * @return whether the file or directory is empty. - * @throws IOException if an I/O error occurs + * @throws IOException if an I/O error occurs. */ public static boolean isEmpty(final Path path) throws IOException { return Files.isDirectory(path) ? isEmptyDirectory(path) : isEmptyFile(path); @@ -738,7 +738,7 @@ public final class PathUtils { * * @param directory the directory to query. * @return whether the directory is empty. - * @throws IOException if an I/O error occurs + * @throws IOException if an I/O error occurs. */ public static boolean isEmptyDirectory(final Path directory) throws IOException { try (DirectoryStream<Path> directoryStream = Files.newDirectoryStream(directory)) { @@ -751,7 +751,7 @@ public final class PathUtils { * * @param file the file to query. * @return whether the file is empty. - * @throws IOException if an I/O error occurs + * @throws IOException if an I/O error occurs. */ public static boolean isEmptyFile(final Path file) throws IOException { return Files.size(file) <= 0; @@ -765,7 +765,7 @@ public final class PathUtils { * @param options options indicating how symbolic links are handled * @return true if the {@code Path} exists and * has been modified after the given time reference. * @return true if the {@code Path} exists and has been modified after the given time reference. - * @throws IOException if an I/O error occurs + * @throws IOException if an I/O error occurs. * @throws NullPointerException if the file is {@code null} * @since 2.9.0 */ @@ -814,7 +814,7 @@ public final class PathUtils { * * @param path the path to read. * @return the path attributes. - * @throws IOException if an I/O error occurs + * @throws IOException if an I/O error occurs. * @since 2.9.0 */ public static BasicFileAttributes readBasicFileAttributes(final Path path) throws IOException { diff --git a/src/main/java/org/apache/commons/io/input/BoundedInputStream.java b/src/main/java/org/apache/commons/io/input/BoundedInputStream.java index 031df87..5aee129 100644 --- a/src/main/java/org/apache/commons/io/input/BoundedInputStream.java +++ b/src/main/java/org/apache/commons/io/input/BoundedInputStream.java @@ -80,7 +80,7 @@ public class BoundedInputStream extends InputStream { * the current position is less than the limit. * @return the byte read or -1 if the end of stream or * the limit has been reached. - * @throws IOException if an I/O error occurs + * @throws IOException if an I/O error occurs. */ @Override public int read() throws IOException { @@ -97,7 +97,7 @@ public class BoundedInputStream extends InputStream { * @param b the buffer to read the bytes into * @return the number of bytes read or -1 if the end of stream or * the limit has been reached. - * @throws IOException if an I/O error occurs + * @throws IOException if an I/O error occurs. */ @Override public int read(final byte[] b) throws IOException { @@ -111,7 +111,7 @@ public class BoundedInputStream extends InputStream { * @param len The number of bytes to read * @return the number of bytes read or -1 if the end of stream or * the limit has been reached. - * @throws IOException if an I/O error occurs + * @throws IOException if an I/O error occurs. */ @Override public int read(final byte[] b, final int off, final int len) throws IOException { @@ -133,7 +133,7 @@ public class BoundedInputStream extends InputStream { * Invokes the delegate's {@code skip(long)} method. * @param n the number of bytes to skip * @return the actual number of bytes skipped - * @throws IOException if an I/O error occurs + * @throws IOException if an I/O error occurs. */ @Override public long skip(final long n) throws IOException { @@ -166,7 +166,7 @@ public class BoundedInputStream extends InputStream { /** * Invokes the delegate's {@code close()} method * if {@link #isPropagateClose()} is {@code true}. - * @throws IOException if an I/O error occurs + * @throws IOException if an I/O error occurs. */ @Override public void close() throws IOException { @@ -177,7 +177,7 @@ public class BoundedInputStream extends InputStream { /** * Invokes the delegate's {@code reset()} method. - * @throws IOException if an I/O error occurs + * @throws IOException if an I/O error occurs. */ @Override public synchronized void reset() throws IOException { diff --git a/src/main/java/org/apache/commons/io/input/CountingInputStream.java b/src/main/java/org/apache/commons/io/input/CountingInputStream.java index 2d18d85..2ee9d58 100644 --- a/src/main/java/org/apache/commons/io/input/CountingInputStream.java +++ b/src/main/java/org/apache/commons/io/input/CountingInputStream.java @@ -51,7 +51,7 @@ public class CountingInputStream extends ProxyInputStream { * * @param length the number of bytes to skip * @return the actual number of bytes skipped - * @throws IOException if an I/O error occurs + * @throws IOException if an I/O error occurs. * @see java.io.InputStream#skip(long) */ @Override diff --git a/src/main/java/org/apache/commons/io/input/ProxyInputStream.java b/src/main/java/org/apache/commons/io/input/ProxyInputStream.java index 6790908..b57a93b 100644 --- a/src/main/java/org/apache/commons/io/input/ProxyInputStream.java +++ b/src/main/java/org/apache/commons/io/input/ProxyInputStream.java @@ -53,7 +53,7 @@ public abstract class ProxyInputStream extends FilterInputStream { /** * Invokes the delegate's {@code read()} method. * @return the byte read or -1 if the end of stream - * @throws IOException if an I/O error occurs + * @throws IOException if an I/O error occurs. */ @Override public int read() throws IOException { @@ -72,7 +72,7 @@ public abstract class ProxyInputStream extends FilterInputStream { * Invokes the delegate's {@code read(byte[])} method. * @param bts the buffer to read the bytes into * @return the number of bytes read or EOF if the end of stream - * @throws IOException if an I/O error occurs + * @throws IOException if an I/O error occurs. */ @Override public int read(final byte[] bts) throws IOException { @@ -93,7 +93,7 @@ public abstract class ProxyInputStream extends FilterInputStream { * @param off The start offset * @param len The number of bytes to read * @return the number of bytes read or -1 if the end of stream - * @throws IOException if an I/O error occurs + * @throws IOException if an I/O error occurs. */ @Override public int read(final byte[] bts, final int off, final int len) throws IOException { @@ -112,7 +112,7 @@ public abstract class ProxyInputStream extends FilterInputStream { * Invokes the delegate's {@code skip(long)} method. * @param ln the number of bytes to skip * @return the actual number of bytes skipped - * @throws IOException if an I/O error occurs + * @throws IOException if an I/O error occurs. */ @Override public long skip(final long ln) throws IOException { @@ -127,7 +127,7 @@ public abstract class ProxyInputStream extends FilterInputStream { /** * Invokes the delegate's {@code available()} method. * @return the number of available bytes - * @throws IOException if an I/O error occurs + * @throws IOException if an I/O error occurs. */ @Override public int available() throws IOException { @@ -141,7 +141,7 @@ public abstract class ProxyInputStream extends FilterInputStream { /** * Invokes the delegate's {@code close()} method. - * @throws IOException if an I/O error occurs + * @throws IOException if an I/O error occurs. */ @Override public void close() throws IOException { @@ -159,7 +159,7 @@ public abstract class ProxyInputStream extends FilterInputStream { /** * Invokes the delegate's {@code reset()} method. - * @throws IOException if an I/O error occurs + * @throws IOException if an I/O error occurs. */ @Override public synchronized void reset() throws IOException { @@ -228,7 +228,7 @@ public abstract class ProxyInputStream extends FilterInputStream { * This method provides a point to implement custom exception * handling. The default behavior is to re-throw the exception. * @param e The IOException thrown - * @throws IOException if an I/O error occurs + * @throws IOException if an I/O error occurs. * @since 2.0 */ protected void handleIOException(final IOException e) throws IOException { diff --git a/src/main/java/org/apache/commons/io/input/ProxyReader.java b/src/main/java/org/apache/commons/io/input/ProxyReader.java index 663eb59..6f1eb19 100644 --- a/src/main/java/org/apache/commons/io/input/ProxyReader.java +++ b/src/main/java/org/apache/commons/io/input/ProxyReader.java @@ -50,7 +50,7 @@ public abstract class ProxyReader extends FilterReader { /** * Invokes the delegate's {@code read()} method. * @return the character read or -1 if the end of stream - * @throws IOException if an I/O error occurs + * @throws IOException if an I/O error occurs. */ @Override public int read() throws IOException { @@ -69,7 +69,7 @@ public abstract class ProxyReader extends FilterReader { * Invokes the delegate's {@code read(char[])} method. * @param chr the buffer to read the characters into * @return the number of characters read or -1 if the end of stream - * @throws IOException if an I/O error occurs + * @throws IOException if an I/O error occurs. */ @Override public int read(final char[] chr) throws IOException { @@ -90,7 +90,7 @@ public abstract class ProxyReader extends FilterReader { * @param st The start offset * @param len The number of bytes to read * @return the number of characters read or -1 if the end of stream - * @throws IOException if an I/O error occurs + * @throws IOException if an I/O error occurs. */ @Override public int read(final char[] chr, final int st, final int len) throws IOException { @@ -109,7 +109,7 @@ public abstract class ProxyReader extends FilterReader { * Invokes the delegate's {@code read(CharBuffer)} method. * @param target the char buffer to read the characters into * @return the number of characters read or -1 if the end of stream - * @throws IOException if an I/O error occurs + * @throws IOException if an I/O error occurs. * @since 2.0 */ @Override @@ -129,7 +129,7 @@ public abstract class ProxyReader extends FilterReader { * Invokes the delegate's {@code skip(long)} method. * @param ln the number of bytes to skip * @return the number of bytes to skipped or EOF if the end of stream - * @throws IOException if an I/O error occurs + * @throws IOException if an I/O error occurs. */ @Override public long skip(final long ln) throws IOException { @@ -144,7 +144,7 @@ public abstract class ProxyReader extends FilterReader { /** * Invokes the delegate's {@code ready()} method. * @return true if the stream is ready to be read - * @throws IOException if an I/O error occurs + * @throws IOException if an I/O error occurs. */ @Override public boolean ready() throws IOException { @@ -158,7 +158,7 @@ public abstract class ProxyReader extends FilterReader { /** * Invokes the delegate's {@code close()} method. - * @throws IOException if an I/O error occurs + * @throws IOException if an I/O error occurs. */ @Override public void close() throws IOException { @@ -172,7 +172,7 @@ public abstract class ProxyReader extends FilterReader { /** * Invokes the delegate's {@code mark(int)} method. * @param idx read ahead limit - * @throws IOException if an I/O error occurs + * @throws IOException if an I/O error occurs. */ @Override public synchronized void mark(final int idx) throws IOException { @@ -185,7 +185,7 @@ public abstract class ProxyReader extends FilterReader { /** * Invokes the delegate's {@code reset()} method. - * @throws IOException if an I/O error occurs + * @throws IOException if an I/O error occurs. */ @Override public synchronized void reset() throws IOException { @@ -254,7 +254,7 @@ public abstract class ProxyReader extends FilterReader { * This method provides a point to implement custom exception * handling. The default behavior is to re-throw the exception. * @param e The IOException thrown - * @throws IOException if an I/O error occurs + * @throws IOException if an I/O error occurs. * @since 2.0 */ protected void handleIOException(final IOException e) throws IOException { diff --git a/src/main/java/org/apache/commons/io/input/ReaderInputStream.java b/src/main/java/org/apache/commons/io/input/ReaderInputStream.java index 2a30ade..806c291 100644 --- a/src/main/java/org/apache/commons/io/input/ReaderInputStream.java +++ b/src/main/java/org/apache/commons/io/input/ReaderInputStream.java @@ -224,7 +224,7 @@ public class ReaderInputStream extends InputStream { * @param len the number of bytes to read * @return the number of bytes read or {@code -1} * if the end of the stream has been reached - * @throws IOException if an I/O error occurs + * @throws IOException if an I/O error occurs. */ @Override public int read(final byte[] array, int off, int len) throws IOException { @@ -260,7 +260,7 @@ public class ReaderInputStream extends InputStream { * @param b the byte array to read into * @return the number of bytes read or {@code -1} * if the end of the stream has been reached - * @throws IOException if an I/O error occurs + * @throws IOException if an I/O error occurs. */ @Override public int read(final byte[] b) throws IOException { @@ -272,7 +272,7 @@ public class ReaderInputStream extends InputStream { * * @return either the byte read or {@code -1} if the end of the stream * has been reached - * @throws IOException if an I/O error occurs + * @throws IOException if an I/O error occurs. */ @Override public int read() throws IOException { @@ -290,7 +290,7 @@ public class ReaderInputStream extends InputStream { /** * Close the stream. This method will cause the underlying {@link Reader} * to be closed. - * @throws IOException if an I/O error occurs + * @throws IOException if an I/O error occurs. */ @Override public void close() throws IOException { diff --git a/src/main/java/org/apache/commons/io/input/ReversedLinesFileReader.java b/src/main/java/org/apache/commons/io/input/ReversedLinesFileReader.java index 5c37baa..7a4ccfc 100644 --- a/src/main/java/org/apache/commons/io/input/ReversedLinesFileReader.java +++ b/src/main/java/org/apache/commons/io/input/ReversedLinesFileReader.java @@ -222,7 +222,7 @@ public class ReversedLinesFileReader implements Closeable { * platform's default encoding. * * @param file the file to be read - * @throws IOException if an I/O error occurs + * @throws IOException if an I/O error occurs. * @deprecated 2.5 use {@link #ReversedLinesFileReader(File, Charset)} instead */ @Deprecated @@ -236,7 +236,7 @@ public class ReversedLinesFileReader implements Closeable { * * @param file the file to be read * @param charset the charset to use, null uses the default Charset. - * @throws IOException if an I/O error occurs + * @throws IOException if an I/O error occurs. * @since 2.5 */ public ReversedLinesFileReader(final File file, final Charset charset) throws IOException { @@ -251,7 +251,7 @@ public class ReversedLinesFileReader implements Closeable { * should match with the block size of the underlying file * system). * @param charset the encoding of the file, null uses the default Charset. - * @throws IOException if an I/O error occurs + * @throws IOException if an I/O error occurs. * @since 2.3 */ public ReversedLinesFileReader(final File file, final int blockSize, final Charset charset) throws IOException { @@ -283,7 +283,7 @@ public class ReversedLinesFileReader implements Closeable { * * @param file the file to be read * @param charset the charset to use, null uses the default Charset. - * @throws IOException if an I/O error occurs + * @throws IOException if an I/O error occurs. * @since 2.7 */ public ReversedLinesFileReader(final Path file, final Charset charset) throws IOException { @@ -298,7 +298,7 @@ public class ReversedLinesFileReader implements Closeable { * should match with the block size of the underlying file * system). * @param charset the encoding of the file, null uses the default Charset. - * @throws IOException if an I/O error occurs + * @throws IOException if an I/O error occurs. * @since 2.7 */ public ReversedLinesFileReader(final Path file, final int blockSize, final Charset charset) throws IOException { @@ -385,7 +385,7 @@ public class ReversedLinesFileReader implements Closeable { /** * Closes underlying resources. * - * @throws IOException if an I/O error occurs + * @throws IOException if an I/O error occurs. */ @Override public void close() throws IOException { @@ -396,7 +396,7 @@ public class ReversedLinesFileReader implements Closeable { * Returns the lines of the file from bottom to top. * * @return the next line or null if the start of the file is reached - * @throws IOException if an I/O error occurs + * @throws IOException if an I/O error occurs. */ public String readLine() throws IOException { @@ -432,7 +432,7 @@ public class ReversedLinesFileReader implements Closeable { * * @param lineCount How many lines to read. * @return A new list - * @throws IOException if an I/O error occurs + * @throws IOException if an I/O error occurs. * @since 2.8.0 */ public List<String> readLines(final int lineCount) throws IOException { @@ -459,7 +459,7 @@ public class ReversedLinesFileReader implements Closeable { * * @param lineCount How many lines to read. * @return A String. - * @throws IOException if an I/O error occurs + * @throws IOException if an I/O error occurs. * @since 2.8.0 */ public String toString(final int lineCount) throws IOException { diff --git a/src/main/java/org/apache/commons/io/input/SwappedDataInputStream.java b/src/main/java/org/apache/commons/io/input/SwappedDataInputStream.java index 86e0286..3df793a 100644 --- a/src/main/java/org/apache/commons/io/input/SwappedDataInputStream.java +++ b/src/main/java/org/apache/commons/io/input/SwappedDataInputStream.java @@ -48,7 +48,7 @@ public class SwappedDataInputStream extends ProxyInputStream implements DataInpu * Return <code>{@link #readByte()} != 0</code> * * @return false if the byte read is zero, otherwise true - * @throws IOException if an I/O error occurs + * @throws IOException if an I/O error occurs. * @throws EOFException if an end of file is reached unexpectedly */ @Override @@ -60,7 +60,7 @@ public class SwappedDataInputStream extends ProxyInputStream implements DataInpu * Invokes the delegate's {@code read()} method. * * @return the byte read or -1 if the end of stream - * @throws IOException if an I/O error occurs + * @throws IOException if an I/O error occurs. * @throws EOFException if an end of file is reached unexpectedly */ @Override @@ -72,7 +72,7 @@ public class SwappedDataInputStream extends ProxyInputStream implements DataInpu * Reads a character delegating to {@link #readShort()}. * * @return the byte read or -1 if the end of stream - * @throws IOException if an I/O error occurs + * @throws IOException if an I/O error occurs. * @throws EOFException if an end of file is reached unexpectedly */ @Override @@ -84,7 +84,7 @@ public class SwappedDataInputStream extends ProxyInputStream implements DataInpu * Delegates to {@link EndianUtils#readSwappedDouble(InputStream)}. * * @return the read long - * @throws IOException if an I/O error occurs + * @throws IOException if an I/O error occurs. * @throws EOFException if an end of file is reached unexpectedly */ @Override @@ -96,7 +96,7 @@ public class SwappedDataInputStream extends ProxyInputStream implements DataInpu * Delegates to {@link EndianUtils#readSwappedFloat(InputStream)}. * * @return the read long - * @throws IOException if an I/O error occurs + * @throws IOException if an I/O error occurs. * @throws EOFException if an end of file is reached unexpectedly */ @Override @@ -109,7 +109,7 @@ public class SwappedDataInputStream extends ProxyInputStream implements DataInpu * * @param data the buffer to read the bytes into * @throws EOFException if an end of file is reached unexpectedly - * @throws IOException if an I/O error occurs + * @throws IOException if an I/O error occurs. */ @Override public void readFully(final byte[] data) throws IOException, EOFException { @@ -123,7 +123,7 @@ public class SwappedDataInputStream extends ProxyInputStream implements DataInpu * @param offset The start offset * @param length The number of bytes to read * @throws EOFException if an end of file is reached unexpectedly - * @throws IOException if an I/O error occurs + * @throws IOException if an I/O error occurs. */ @Override public void readFully(final byte[] data, final int offset, final int length) throws IOException, EOFException { @@ -146,7 +146,7 @@ public class SwappedDataInputStream extends ProxyInputStream implements DataInpu * * @return the read long * @throws EOFException if an end of file is reached unexpectedly - * @throws IOException if an I/O error occurs + * @throws IOException if an I/O error occurs. */ @Override public int readInt() throws IOException, EOFException { @@ -158,7 +158,7 @@ public class SwappedDataInputStream extends ProxyInputStream implements DataInpu * * @return the line read * @throws EOFException if an end of file is reached unexpectedly - * @throws IOException if an I/O error occurs + * @throws IOException if an I/O error occurs. */ @Override public String readLine() throws IOException, EOFException { @@ -170,7 +170,7 @@ public class SwappedDataInputStream extends ProxyInputStream implements DataInpu * * @return the read long * @throws EOFException if an end of file is reached unexpectedly - * @throws IOException if an I/O error occurs + * @throws IOException if an I/O error occurs. */ @Override public long readLong() throws IOException, EOFException { @@ -182,7 +182,7 @@ public class SwappedDataInputStream extends ProxyInputStream implements DataInpu * * @return the read long * @throws EOFException if an end of file is reached unexpectedly - * @throws IOException if an I/O error occurs + * @throws IOException if an I/O error occurs. */ @Override public short readShort() throws IOException, EOFException { @@ -194,7 +194,7 @@ public class SwappedDataInputStream extends ProxyInputStream implements DataInpu * * @return the byte read or -1 if the end of stream * @throws EOFException if an end of file is reached unexpectedly - * @throws IOException if an I/O error occurs + * @throws IOException if an I/O error occurs. */ @Override public int readUnsignedByte() throws IOException, EOFException { @@ -206,7 +206,7 @@ public class SwappedDataInputStream extends ProxyInputStream implements DataInpu * * @return the read long * @throws EOFException if an end of file is reached unexpectedly - * @throws IOException if an I/O error occurs + * @throws IOException if an I/O error occurs. */ @Override public int readUnsignedShort() throws IOException, EOFException { @@ -218,7 +218,7 @@ public class SwappedDataInputStream extends ProxyInputStream implements DataInpu * * @return UTF String read * @throws EOFException if an end of file is reached unexpectedly - * @throws IOException if an I/O error occurs + * @throws IOException if an I/O error occurs. */ @Override public String readUTF() throws IOException, EOFException { @@ -231,7 +231,7 @@ public class SwappedDataInputStream extends ProxyInputStream implements DataInpu * @param count the number of bytes to skip * @return the number of bytes to skipped or -1 if the end of stream * @throws EOFException if an end of file is reached unexpectedly - * @throws IOException if an I/O error occurs + * @throws IOException if an I/O error occurs. */ @Override public int skipBytes(final int count) throws IOException, EOFException { diff --git a/src/main/java/org/apache/commons/io/input/TaggedInputStream.java b/src/main/java/org/apache/commons/io/input/TaggedInputStream.java index d63ff90..eeaec7b 100644 --- a/src/main/java/org/apache/commons/io/input/TaggedInputStream.java +++ b/src/main/java/org/apache/commons/io/input/TaggedInputStream.java @@ -106,7 +106,7 @@ public class TaggedInputStream extends ProxyInputStream { * Tags any IOExceptions thrown, wrapping and re-throwing. * * @param e The IOException thrown - * @throws IOException if an I/O error occurs + * @throws IOException if an I/O error occurs. */ @Override protected void handleIOException(final IOException e) throws IOException { diff --git a/src/main/java/org/apache/commons/io/input/TaggedReader.java b/src/main/java/org/apache/commons/io/input/TaggedReader.java index 4711414..6805f87 100644 --- a/src/main/java/org/apache/commons/io/input/TaggedReader.java +++ b/src/main/java/org/apache/commons/io/input/TaggedReader.java @@ -103,7 +103,7 @@ public class TaggedReader extends ProxyReader { * Tags any IOExceptions thrown, wrapping and re-throwing. * * @param e The IOException thrown - * @throws IOException if an I/O error occurs + * @throws IOException if an I/O error occurs. */ @Override protected void handleIOException(final IOException e) throws IOException { diff --git a/src/main/java/org/apache/commons/io/input/XmlStreamReader.java b/src/main/java/org/apache/commons/io/input/XmlStreamReader.java index c015fde..c8f668e 100644 --- a/src/main/java/org/apache/commons/io/input/XmlStreamReader.java +++ b/src/main/java/org/apache/commons/io/input/XmlStreamReader.java @@ -797,7 +797,7 @@ public class XmlStreamReader extends Reader { * @param offset The start offset * @param len The number of bytes to read * @return the number of characters read or -1 if the end of stream - * @throws IOException if an I/O error occurs + * @throws IOException if an I/O error occurs. */ @Override public int read(final char[] buf, final int offset, final int len) throws IOException { diff --git a/src/main/java/org/apache/commons/io/output/ByteArrayOutputStream.java b/src/main/java/org/apache/commons/io/output/ByteArrayOutputStream.java index cffd939..fecce3a 100644 --- a/src/main/java/org/apache/commons/io/output/ByteArrayOutputStream.java +++ b/src/main/java/org/apache/commons/io/output/ByteArrayOutputStream.java @@ -114,7 +114,7 @@ public class ByteArrayOutputStream extends AbstractByteArrayOutputStream { * * @param input Stream to be fully buffered. * @return A fully buffered stream. - * @throws IOException if an I/O error occurs + * @throws IOException if an I/O error occurs. * @since 2.0 */ public static InputStream toBufferedInputStream(final InputStream input) @@ -142,7 +142,7 @@ public class ByteArrayOutputStream extends AbstractByteArrayOutputStream { * @param input Stream to be fully buffered. * @param size the initial buffer size * @return A fully buffered stream. - * @throws IOException if an I/O error occurs + * @throws IOException if an I/O error occurs. * @since 2.5 */ public static InputStream toBufferedInputStream(final InputStream input, final int size) diff --git a/src/main/java/org/apache/commons/io/output/FileWriterWithEncoding.java b/src/main/java/org/apache/commons/io/output/FileWriterWithEncoding.java index 9c66be2..12d5942 100644 --- a/src/main/java/org/apache/commons/io/output/FileWriterWithEncoding.java +++ b/src/main/java/org/apache/commons/io/output/FileWriterWithEncoding.java @@ -252,7 +252,7 @@ public class FileWriterWithEncoding extends Writer { /** * Write a character. * @param idx the character to write - * @throws IOException if an I/O error occurs + * @throws IOException if an I/O error occurs. */ @Override public void write(final int idx) throws IOException { @@ -262,7 +262,7 @@ public class FileWriterWithEncoding extends Writer { /** * Write the characters from an array. * @param chr the characters to write - * @throws IOException if an I/O error occurs + * @throws IOException if an I/O error occurs. */ @Override public void write(final char[] chr) throws IOException { @@ -274,7 +274,7 @@ public class FileWriterWithEncoding extends Writer { * @param chr the characters to write * @param st The start offset * @param end The number of characters to write - * @throws IOException if an I/O error occurs + * @throws IOException if an I/O error occurs. */ @Override public void write(final char[] chr, final int st, final int end) throws IOException { @@ -284,7 +284,7 @@ public class FileWriterWithEncoding extends Writer { /** * Write the characters from a string. * @param str the string to write - * @throws IOException if an I/O error occurs + * @throws IOException if an I/O error occurs. */ @Override public void write(final String str) throws IOException { @@ -296,7 +296,7 @@ public class FileWriterWithEncoding extends Writer { * @param str the string to write * @param st The start offset * @param end The number of characters to write - * @throws IOException if an I/O error occurs + * @throws IOException if an I/O error occurs. */ @Override public void write(final String str, final int st, final int end) throws IOException { @@ -305,7 +305,7 @@ public class FileWriterWithEncoding extends Writer { /** * Flush the stream. - * @throws IOException if an I/O error occurs + * @throws IOException if an I/O error occurs. */ @Override public void flush() throws IOException { @@ -314,7 +314,7 @@ public class FileWriterWithEncoding extends Writer { /** * Close the stream. - * @throws IOException if an I/O error occurs + * @throws IOException if an I/O error occurs. */ @Override public void close() throws IOException { diff --git a/src/main/java/org/apache/commons/io/output/LockableFileWriter.java b/src/main/java/org/apache/commons/io/output/LockableFileWriter.java index 1956c2b..252e970 100644 --- a/src/main/java/org/apache/commons/io/output/LockableFileWriter.java +++ b/src/main/java/org/apache/commons/io/output/LockableFileWriter.java @@ -280,7 +280,7 @@ public class LockableFileWriter extends Writer { /** * Closes the file writer and deletes the lock file. * - * @throws IOException if an I/O error occurs + * @throws IOException if an I/O error occurs. */ @Override public void close() throws IOException { @@ -294,7 +294,7 @@ public class LockableFileWriter extends Writer { /** * Writes a character. * @param c the character to write - * @throws IOException if an I/O error occurs + * @throws IOException if an I/O error occurs. */ @Override public void write(final int c) throws IOException { @@ -304,7 +304,7 @@ public class LockableFileWriter extends Writer { /** * Writes the characters from an array. * @param cbuf the characters to write - * @throws IOException if an I/O error occurs + * @throws IOException if an I/O error occurs. */ @Override public void write(final char[] cbuf) throws IOException { @@ -316,7 +316,7 @@ public class LockableFileWriter extends Writer { * @param cbuf the characters to write * @param off The start offset * @param len The number of characters to write - * @throws IOException if an I/O error occurs + * @throws IOException if an I/O error occurs. */ @Override public void write(final char[] cbuf, final int off, final int len) throws IOException { @@ -326,7 +326,7 @@ public class LockableFileWriter extends Writer { /** * Writes the characters from a string. * @param str the string to write - * @throws IOException if an I/O error occurs + * @throws IOException if an I/O error occurs. */ @Override public void write(final String str) throws IOException { @@ -338,7 +338,7 @@ public class LockableFileWriter extends Writer { * @param str the string to write * @param off The start offset * @param len The number of characters to write - * @throws IOException if an I/O error occurs + * @throws IOException if an I/O error occurs. */ @Override public void write(final String str, final int off, final int len) throws IOException { @@ -347,7 +347,7 @@ public class LockableFileWriter extends Writer { /** * Flushes the stream. - * @throws IOException if an I/O error occurs + * @throws IOException if an I/O error occurs. */ @Override public void flush() throws IOException { diff --git a/src/main/java/org/apache/commons/io/output/ProxyCollectionWriter.java b/src/main/java/org/apache/commons/io/output/ProxyCollectionWriter.java index 477f1ed..32dd5a7 100644 --- a/src/main/java/org/apache/commons/io/output/ProxyCollectionWriter.java +++ b/src/main/java/org/apache/commons/io/output/ProxyCollectionWriter.java @@ -73,7 +73,7 @@ public class ProxyCollectionWriter extends FilterCollectionWriter { * * @param c The character to write * @return this writer - * @throws IOException if an I/O error occurs + * @throws IOException if an I/O error occurs. * @since 2.0 */ @Override @@ -93,7 +93,7 @@ public class ProxyCollectionWriter extends FilterCollectionWriter { * * @param csq The character sequence to write * @return this writer - * @throws IOException if an I/O error occurs + * @throws IOException if an I/O error occurs. */ @Override public Writer append(final CharSequence csq) throws IOException { @@ -115,7 +115,7 @@ public class ProxyCollectionWriter extends FilterCollectionWriter { * @param start The index of the first character to write * @param end The index of the first character to write (exclusive) * @return this writer - * @throws IOException if an I/O error occurs + * @throws IOException if an I/O error occurs. */ @Override public Writer append(final CharSequence csq, final int start, final int end) throws IOException { @@ -147,7 +147,7 @@ public class ProxyCollectionWriter extends FilterCollectionWriter { /** * Invokes the delegate's {@code close()} method. * - * @throws IOException if an I/O error occurs + * @throws IOException if an I/O error occurs. */ @Override public void close() throws IOException { @@ -161,7 +161,7 @@ public class ProxyCollectionWriter extends FilterCollectionWriter { /** * Invokes the delegate's {@code flush()} method. * - * @throws IOException if an I/O error occurs + * @throws IOException if an I/O error occurs. */ @Override public void flush() throws IOException { @@ -180,7 +180,7 @@ public class ProxyCollectionWriter extends FilterCollectionWriter { * </p> * * @param e The IOException thrown - * @throws IOException if an I/O error occurs + * @throws IOException if an I/O error occurs. */ protected void handleIOException(final IOException e) throws IOException { throw e; @@ -190,7 +190,7 @@ public class ProxyCollectionWriter extends FilterCollectionWriter { * Invokes the delegate's {@code write(char[])} method. * * @param cbuf the characters to write - * @throws IOException if an I/O error occurs + * @throws IOException if an I/O error occurs. */ @Override public void write(final char[] cbuf) throws IOException { @@ -210,7 +210,7 @@ public class ProxyCollectionWriter extends FilterCollectionWriter { * @param cbuf the characters to write * @param off The start offset * @param len The number of characters to write - * @throws IOException if an I/O error occurs + * @throws IOException if an I/O error occurs. */ @Override public void write(final char[] cbuf, final int off, final int len) throws IOException { @@ -227,7 +227,7 @@ public class ProxyCollectionWriter extends FilterCollectionWriter { * Invokes the delegate's {@code write(int)} method. * * @param c the character to write - * @throws IOException if an I/O error occurs + * @throws IOException if an I/O error occurs. */ @Override public void write(final int c) throws IOException { @@ -244,7 +244,7 @@ public class ProxyCollectionWriter extends FilterCollectionWriter { * Invokes the delegate's {@code write(String)} method. * * @param str the string to write - * @throws IOException if an I/O error occurs + * @throws IOException if an I/O error occurs. */ @Override public void write(final String str) throws IOException { @@ -264,7 +264,7 @@ public class ProxyCollectionWriter extends FilterCollectionWriter { * @param str the string to write * @param off The start offset * @param len The number of characters to write - * @throws IOException if an I/O error occurs + * @throws IOException if an I/O error occurs. */ @Override public void write(final String str, final int off, final int len) throws IOException { diff --git a/src/main/java/org/apache/commons/io/output/ProxyOutputStream.java b/src/main/java/org/apache/commons/io/output/ProxyOutputStream.java index d26e413..5a53920 100644 --- a/src/main/java/org/apache/commons/io/output/ProxyOutputStream.java +++ b/src/main/java/org/apache/commons/io/output/ProxyOutputStream.java @@ -47,7 +47,7 @@ public class ProxyOutputStream extends FilterOutputStream { /** * Invokes the delegate's {@code write(int)} method. * @param idx the byte to write - * @throws IOException if an I/O error occurs + * @throws IOException if an I/O error occurs. */ @Override public void write(final int idx) throws IOException { @@ -63,7 +63,7 @@ public class ProxyOutputStream extends FilterOutputStream { /** * Invokes the delegate's {@code write(byte[])} method. * @param bts the bytes to write - * @throws IOException if an I/O error occurs + * @throws IOException if an I/O error occurs. */ @Override public void write(final byte[] bts) throws IOException { @@ -82,7 +82,7 @@ public class ProxyOutputStream extends FilterOutputStream { * @param bts the bytes to write * @param st The start offset * @param end The number of bytes to write - * @throws IOException if an I/O error occurs + * @throws IOException if an I/O error occurs. */ @Override public void write(final byte[] bts, final int st, final int end) throws IOException { @@ -97,7 +97,7 @@ public class ProxyOutputStream extends FilterOutputStream { /** * Invokes the delegate's {@code flush()} method. - * @throws IOException if an I/O error occurs + * @throws IOException if an I/O error occurs. */ @Override public void flush() throws IOException { @@ -110,7 +110,7 @@ public class ProxyOutputStream extends FilterOutputStream { /** * Invokes the delegate's {@code close()} method. - * @throws IOException if an I/O error occurs + * @throws IOException if an I/O error occurs. */ @Override public void close() throws IOException { @@ -158,7 +158,7 @@ public class ProxyOutputStream extends FilterOutputStream { * This method provides a point to implement custom exception * handling. The default behavior is to re-throw the exception. * @param e The IOException thrown - * @throws IOException if an I/O error occurs + * @throws IOException if an I/O error occurs. * @since 2.0 */ protected void handleIOException(final IOException e) throws IOException { diff --git a/src/main/java/org/apache/commons/io/output/ProxyWriter.java b/src/main/java/org/apache/commons/io/output/ProxyWriter.java index c1816ee..54a358a 100644 --- a/src/main/java/org/apache/commons/io/output/ProxyWriter.java +++ b/src/main/java/org/apache/commons/io/output/ProxyWriter.java @@ -44,7 +44,7 @@ public class ProxyWriter extends FilterWriter { * Invokes the delegate's {@code append(char)} method. * @param c The character to write * @return this writer - * @throws IOException if an I/O error occurs + * @throws IOException if an I/O error occurs. * @since 2.0 */ @Override @@ -65,7 +65,7 @@ public class ProxyWriter extends FilterWriter { * @param start The index of the first character to write * @param end The index of the first character to write (exclusive) * @return this writer - * @throws IOException if an I/O error occurs + * @throws IOException if an I/O error occurs. * @since 2.0 */ @Override @@ -84,7 +84,7 @@ public class ProxyWriter extends FilterWriter { * Invokes the delegate's {@code append(CharSequence)} method. * @param csq The character sequence to write * @return this writer - * @throws IOException if an I/O error occurs + * @throws IOException if an I/O error occurs. * @since 2.0 */ @Override @@ -103,7 +103,7 @@ public class ProxyWriter extends FilterWriter { /** * Invokes the delegate's {@code write(int)} method. * @param c the character to write - * @throws IOException if an I/O error occurs + * @throws IOException if an I/O error occurs. */ @Override public void write(final int c) throws IOException { @@ -119,7 +119,7 @@ public class ProxyWriter extends FilterWriter { /** * Invokes the delegate's {@code write(char[])} method. * @param cbuf the characters to write - * @throws IOException if an I/O error occurs + * @throws IOException if an I/O error occurs. */ @Override public void write(final char[] cbuf) throws IOException { @@ -138,7 +138,7 @@ public class ProxyWriter extends FilterWriter { * @param cbuf the characters to write * @param off The start offset * @param len The number of characters to write - * @throws IOException if an I/O error occurs + * @throws IOException if an I/O error occurs. */ @Override public void write(final char[] cbuf, final int off, final int len) throws IOException { @@ -154,7 +154,7 @@ public class ProxyWriter extends FilterWriter { /** * Invokes the delegate's {@code write(String)} method. * @param str the string to write - * @throws IOException if an I/O error occurs + * @throws IOException if an I/O error occurs. */ @Override public void write(final String str) throws IOException { @@ -173,7 +173,7 @@ public class ProxyWriter extends FilterWriter { * @param str the string to write * @param off The start offset * @param len The number of characters to write - * @throws IOException if an I/O error occurs + * @throws IOException if an I/O error occurs. */ @Override public void write(final String str, final int off, final int len) throws IOException { @@ -188,7 +188,7 @@ public class ProxyWriter extends FilterWriter { /** * Invokes the delegate's {@code flush()} method. - * @throws IOException if an I/O error occurs + * @throws IOException if an I/O error occurs. */ @Override public void flush() throws IOException { @@ -201,7 +201,7 @@ public class ProxyWriter extends FilterWriter { /** * Invokes the delegate's {@code close()} method. - * @throws IOException if an I/O error occurs + * @throws IOException if an I/O error occurs. */ @Override public void close() throws IOException { @@ -253,7 +253,7 @@ public class ProxyWriter extends FilterWriter { * </p> * * @param e The IOException thrown - * @throws IOException if an I/O error occurs + * @throws IOException if an I/O error occurs. * @since 2.0 */ protected void handleIOException(final IOException e) throws IOException { diff --git a/src/main/java/org/apache/commons/io/output/TaggedOutputStream.java b/src/main/java/org/apache/commons/io/output/TaggedOutputStream.java index d24c08c..15a95dd 100644 --- a/src/main/java/org/apache/commons/io/output/TaggedOutputStream.java +++ b/src/main/java/org/apache/commons/io/output/TaggedOutputStream.java @@ -106,7 +106,7 @@ public class TaggedOutputStream extends ProxyOutputStream { * Tags any IOExceptions thrown, wrapping and re-throwing. * * @param e The IOException thrown - * @throws IOException if an I/O error occurs + * @throws IOException if an I/O error occurs. */ @Override protected void handleIOException(final IOException e) throws IOException { diff --git a/src/main/java/org/apache/commons/io/output/TaggedWriter.java b/src/main/java/org/apache/commons/io/output/TaggedWriter.java index c086d26..24b7f88 100644 --- a/src/main/java/org/apache/commons/io/output/TaggedWriter.java +++ b/src/main/java/org/apache/commons/io/output/TaggedWriter.java @@ -106,7 +106,7 @@ public class TaggedWriter extends ProxyWriter { * Tags any IOExceptions thrown, wrapping and re-throwing. * * @param e The IOException thrown - * @throws IOException if an I/O error occurs + * @throws IOException if an I/O error occurs. */ @Override protected void handleIOException(final IOException e) throws IOException { diff --git a/src/main/java/org/apache/commons/io/output/TeeOutputStream.java b/src/main/java/org/apache/commons/io/output/TeeOutputStream.java index 4db164b..dc70af8 100644 --- a/src/main/java/org/apache/commons/io/output/TeeOutputStream.java +++ b/src/main/java/org/apache/commons/io/output/TeeOutputStream.java @@ -47,7 +47,7 @@ public class TeeOutputStream extends ProxyOutputStream { * Writes the bytes to both streams. * * @param b the bytes to write - * @throws IOException if an I/O error occurs + * @throws IOException if an I/O error occurs. */ @Override public synchronized void write(final byte[] b) throws IOException { @@ -61,7 +61,7 @@ public class TeeOutputStream extends ProxyOutputStream { * @param b the bytes to write * @param off The start offset * @param len The number of bytes to write - * @throws IOException if an I/O error occurs + * @throws IOException if an I/O error occurs. */ @Override public synchronized void write(final byte[] b, final int off, final int len) throws IOException { @@ -73,7 +73,7 @@ public class TeeOutputStream extends ProxyOutputStream { * Writes a byte to both streams. * * @param b the byte to write - * @throws IOException if an I/O error occurs + * @throws IOException if an I/O error occurs. */ @Override public synchronized void write(final int b) throws IOException { @@ -84,7 +84,7 @@ public class TeeOutputStream extends ProxyOutputStream { /** * Flushes both streams. * - * @throws IOException if an I/O error occurs + * @throws IOException if an I/O error occurs. */ @Override public void flush() throws IOException { @@ -103,7 +103,7 @@ public class TeeOutputStream extends ProxyOutputStream { * currently unspecified and subject to change. * </p> * - * @throws IOException if an I/O error occurs + * @throws IOException if an I/O error occurs. */ @Override public void close() throws IOException { diff --git a/src/main/java/org/apache/commons/io/output/UnsynchronizedByteArrayOutputStream.java b/src/main/java/org/apache/commons/io/output/UnsynchronizedByteArrayOutputStream.java index 9bdf24f..868bed4 100644 --- a/src/main/java/org/apache/commons/io/output/UnsynchronizedByteArrayOutputStream.java +++ b/src/main/java/org/apache/commons/io/output/UnsynchronizedByteArrayOutputStream.java @@ -104,7 +104,7 @@ public final class UnsynchronizedByteArrayOutputStream extends AbstractByteArray * * @param input Stream to be fully buffered. * @return A fully buffered stream. - * @throws IOException if an I/O error occurs + * @throws IOException if an I/O error occurs. */ public static InputStream toBufferedInputStream(final InputStream input) throws IOException { return toBufferedInputStream(input, DEFAULT_SIZE); @@ -126,7 +126,7 @@ public final class UnsynchronizedByteArrayOutputStream extends AbstractByteArray * @param input Stream to be fully buffered. * @param size the initial buffer size * @return A fully buffered stream. - * @throws IOException if an I/O error occurs + * @throws IOException if an I/O error occurs. */ public static InputStream toBufferedInputStream(final InputStream input, final int size) throws IOException { // It does not matter if a ByteArrayOutputStream is not closed as close() is a no-op diff --git a/src/main/java/org/apache/commons/io/output/WriterOutputStream.java b/src/main/java/org/apache/commons/io/output/WriterOutputStream.java index 40c1ec6..176c489 100644 --- a/src/main/java/org/apache/commons/io/output/WriterOutputStream.java +++ b/src/main/java/org/apache/commons/io/output/WriterOutputStream.java @@ -209,7 +209,7 @@ public class WriterOutputStream extends OutputStream { * @param b the byte array containing the bytes to write * @param off the start offset in the byte array * @param len the number of bytes to write - * @throws IOException if an I/O error occurs + * @throws IOException if an I/O error occurs. */ @Override public void write(final byte[] b, int off, int len) throws IOException { @@ -229,7 +229,7 @@ public class WriterOutputStream extends OutputStream { * Write bytes from the specified byte array to the stream. * * @param b the byte array containing the bytes to write - * @throws IOException if an I/O error occurs + * @throws IOException if an I/O error occurs. */ @Override public void write(final byte[] b) throws IOException { @@ -240,7 +240,7 @@ public class WriterOutputStream extends OutputStream { * Write a single byte to the stream. * * @param b the byte to write - * @throws IOException if an I/O error occurs + * @throws IOException if an I/O error occurs. */ @Override public void write(final int b) throws IOException { @@ -251,7 +251,7 @@ public class WriterOutputStream extends OutputStream { * Flush the stream. Any remaining content accumulated in the output buffer * will be written to the underlying {@link Writer}. After that * {@link Writer#flush()} will be called. - * @throws IOException if an I/O error occurs + * @throws IOException if an I/O error occurs. */ @Override public void flush() throws IOException { @@ -263,7 +263,7 @@ public class WriterOutputStream extends OutputStream { * Close the stream. Any remaining content accumulated in the output buffer * will be written to the underlying {@link Writer}. After that * {@link Writer#close()} will be called. - * @throws IOException if an I/O error occurs + * @throws IOException if an I/O error occurs. */ @Override public void close() throws IOException { @@ -276,7 +276,7 @@ public class WriterOutputStream extends OutputStream { * Decode the contents of the input ByteBuffer into a CharBuffer. * * @param endOfInput indicates end of input - * @throws IOException if an I/O error occurs + * @throws IOException if an I/O error occurs. */ private void processInput(final boolean endOfInput) throws IOException { // Prepare decoderIn for reading @@ -301,7 +301,7 @@ public class WriterOutputStream extends OutputStream { /** * Flush the output. * - * @throws IOException if an I/O error occurs + * @throws IOException if an I/O error occurs. */ private void flushOutput() throws IOException { if (decoderOut.position() > 0) {