Javadoc: Sentences end in a period.

Author: Gary Gregory

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

@@ -1852,7 +1852,7 @@ public static List<String> readLines(final Reader reader) throws IOException {
      *
      * @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 static byte[] resourceToByteArray(final String name) throws IOException {
      * @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 static byte[] resourceToByteArray(final String name, final ClassLoader cl
      * @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 static String resourceToString(final String name, final Charset charset)
      * @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 static String resourceToString(final String name, final Charset charset,
      *
      * @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 static URL resourceToURL(final String name) throws IOException {
      * @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 static void skipFully(final Reader reader, final long toSkip) throws IOEx
      *
      * @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 static InputStream toBufferedInputStream(final InputStream input) throws
      * @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 {

src/main/java/org/apache/commons/io/file/PathUtils.java

@@ -236,7 +236,7 @@ public static PathCounters copyDirectory(final Path sourceDirectory, final Path
      * @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 static Path copyFile(final URL sourceFile, final Path targetFile, final C
      * @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 static Path copyFileToDirectory(final Path sourceFile, final Path targetD
      * @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 static PathCounters countDirectory(final Path directory) throws IOExcepti
      * @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 static List<AclEntry> getAclEntryList(final Path sourcePath) throws IOExc
      *
      * @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 static boolean isEmpty(final Path path) throws IOException {
      *
      * @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 static boolean isEmptyDirectory(final Path directory) throws IOException
      *
      * @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 static boolean isEmptyFile(final Path file) throws IOException {
      * @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 @@ private static boolean overrideReadOnly(final DeleteOption... deleteOptions) {
      *
      * @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 {

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

@@ -80,7 +80,7 @@ public BoundedInputStream(final InputStream in) {
      * 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 int read() throws IOException {
      * @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 int read(final byte[] b) throws IOException {
      * @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 int read(final byte[] b, final int off, final int len) throws IOException
      * 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 String toString() {
     /**
      * 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 void close() throws IOException {
 
     /**
      * 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 {

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

@@ -51,7 +51,7 @@ public CountingInputStream(final InputStream in) {
      *
      * @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

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

@@ -53,7 +53,7 @@ public ProxyInputStream(final InputStream proxy) {
     /**
      * 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 int read() throws IOException {
      * 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 int read(final byte[] bts) throws IOException {
      * @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 int read(final byte[] bts, final int off, final int len) throws IOExcepti
      * 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 long skip(final long ln) throws IOException {
     /**
      * 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 int available() throws IOException {
 
     /**
      * 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 synchronized void mark(final int readlimit) {
 
     /**
      * 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 @@ protected void afterRead(final int n) throws IOException {
      * 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 {

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

@@ -50,7 +50,7 @@ public ProxyReader(final Reader proxy) {
     /**
      * 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 int read() throws IOException {
      * 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 int read(final char[] chr) throws IOException {
      * @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 int read(final char[] chr, final int st, final int len) throws IOExceptio
      * 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 int read(final CharBuffer target) throws IOException {
      * 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 long skip(final long ln) throws IOException {
     /**
      * 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 boolean ready() throws IOException {
 
     /**
      * 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 void close() throws IOException {
     /**
      * 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 synchronized void mark(final int idx) throws IOException {
 
     /**
      * 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 @@ protected void afterRead(final int n) throws IOException {
      * 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 {