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


The following commit(s) were added to refs/heads/master by this push:
     new 9ca232d  Javadoc.
9ca232d is described below

commit 9ca232df5d0e5437b1a775f45c1f1c5183051a81
Author: Gary Gregory <garydgreg...@gmail.com>
AuthorDate: Wed Jan 27 14:30:50 2021 -0500

    Javadoc.
---
 src/main/java/org/apache/commons/io/file/PathUtils.java | 13 +++++++++++--
 1 file changed, 11 insertions(+), 2 deletions(-)

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 e0a3af6..8f573a9 100644
--- a/src/main/java/org/apache/commons/io/file/PathUtils.java
+++ b/src/main/java/org/apache/commons/io/file/PathUtils.java
@@ -30,6 +30,7 @@ import java.nio.file.FileVisitor;
 import java.nio.file.Files;
 import java.nio.file.LinkOption;
 import java.nio.file.NoSuchFileException;
+import java.nio.file.NotDirectoryException;
 import java.nio.file.OpenOption;
 import java.nio.file.Path;
 import java.nio.file.Paths;
@@ -732,7 +733,12 @@ 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 NotDirectoryException if the file could not otherwise be opened 
because it is not a directory
+     *                               <i>(optional specific exception)</i>.
+     * @throws IOException           if an I/O error occurs.
+     * @throws SecurityException     In the case of the default provider, and 
a security manager is installed, the
+     *                               {@link SecurityManager#checkRead(String) 
checkRead} method is invoked to check read
+     *                               access to the directory.
      */
     public static boolean isEmptyDirectory(final Path directory) throws 
IOException {
         try (DirectoryStream<Path> directoryStream = 
Files.newDirectoryStream(directory)) {
@@ -745,7 +751,10 @@ 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.
+     * @throws SecurityException In the case of the default provider, and a 
security manager is installed, its
+     *                           {@link SecurityManager#checkRead(String) 
checkRead} method denies read access to the
+     *                           file.
      */
     public static boolean isEmptyFile(final Path file) throws IOException {
         return Files.size(file) <= 0;

Reply via email to