[IO-694] Behaviour change in FileUtils.copyDirectory() file last

modified date/times preservation.

Javadoc.

Author: garydgregory

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

@@ -462,7 +462,7 @@ public static File[] convertFileCollectionToFileArray(final Collection<File> fil
      * <strong>Note:</strong> This method tries to preserve the files' last
      * modified date/times using {@link File#setLastModified(long)}, however
      * it is not guaranteed that those operations will succeed.
-     * If the modification operation fails, no indication is provided.
+     * If the modification operation fails, the methods throws IOException.
      * </p>
      *
      * @param srcDir  an existing directory to copy, must not be {@code null}
@@ -493,7 +493,7 @@ public static void copyDirectory(final File srcDir, final File destDir) throws I
      * {@code true} tries to preserve the files' last modified
      * date/times using {@link File#setLastModified(long)}, however it is
      * not guaranteed that those operations will succeed.
-     * If the modification operation fails, no indication is provided.
+     * If the modification operation fails, the methods throws IOException.
      * </p>
      *
      * @param srcDir           an existing directory to copy, must not be {@code null}
@@ -526,7 +526,7 @@ public static void copyDirectory(final File srcDir, final File destDir,
      * <strong>Note:</strong> This method tries to preserve the files' last
      * modified date/times using {@link File#setLastModified(long)}, however
      * it is not guaranteed that those operations will succeed.
-     * If the modification operation fails, no indication is provided.
+     * If the modification operation fails, the methods throws IOException.
      * </p>
      * <b>Example: Copy directories only</b>
      * <pre>
@@ -578,7 +578,7 @@ public static void copyDirectory(final File srcDir, final File destDir,
      * {@code true} tries to preserve the files' last modified
      * date/times using {@link File#setLastModified(long)}, however it is
      * not guaranteed that those operations will succeed.
-     * If the modification operation fails, no indication is provided.
+     * If the modification operation fails, the methods throws IOException.
      * </p>
      * <b>Example: Copy directories only</b>
      * <pre>
@@ -706,7 +706,7 @@ public static void copyDirectory(final File srcDir, final File destDir, final Fi
      * <strong>Note:</strong> This method tries to preserve the files' last
      * modified date/times using {@link File#setLastModified(long)}, however
      * it is not guaranteed that those operations will succeed.
-     * If the modification operation fails, no indication is provided.
+     * If the modification operation fails, the methods throws IOException.
      * </p>
      *
      * @param sourceDir  an existing directory to copy, must not be {@code null}
@@ -742,7 +742,7 @@ public static void copyDirectoryToDirectory(final File sourceDir, final File des
      * <strong>Note:</strong> This method tries to preserve the file's last
      * modified date/times using {@link File#setLastModified(long)}, however
      * it is not guaranteed that the operation will succeed.
-     * If the modification operation fails, no indication is provided.
+     * If the modification operation fails, the methods throws IOException.
      * </p>
      *
      * @param srcFile  an existing file to copy, must not be {@code null}
@@ -773,7 +773,7 @@ public static void copyFile(final File srcFile, final File destFile) throws IOEx
      * {@code true} tries to preserve the file's last modified
      * date/times using {@link File#setLastModified(long)}, however it is
      * not guaranteed that the operation will succeed.
-     * If the modification operation fails, no indication is provided.
+     * If the modification operation fails, the methods throws IOException.
      * </p>
      *
      * @param srcFile          an existing file to copy, must not be {@code null}
@@ -874,7 +874,7 @@ public static long copyFile(final File input, final OutputStream output) throws
      * <strong>Note:</strong> This method tries to preserve the file's last
      * modified date/times using {@link File#setLastModified(long)}, however
      * it is not guaranteed that the operation will succeed.
-     * If the modification operation fails, no indication is provided.
+     * If the modification operation fails, the methods throws IOException.
      * </p>
      *
      * @param srcFile an existing file to copy, must not be {@code null}
@@ -902,7 +902,7 @@ public static void copyFileToDirectory(final File srcFile, final File destDir) t
      * {@code true} tries to preserve the file's last modified
      * date/times using {@link File#setLastModified(long)}, however it is
      * not guaranteed that the operation will succeed.
-     * If the modification operation fails, no indication is provided.
+     * If the modification operation fails, the methods throws IOException.
      * </p>
      *
      * @param sourceFile          an existing file to copy, must not be {@code null}
@@ -966,7 +966,7 @@ public static void copyInputStreamToFile(final InputStream source, final File de
      * <strong>Note:</strong> This method tries to preserve the files' last
      * modified date/times using {@link File#setLastModified(long)}, however
      * it is not guaranteed that those operations will succeed.
-     * If the modification operation fails, no indication is provided.
+     * If the modification operation fails, the methods throws IOException.
      * </p>
      *
      * @param sourceFile      an existing file or directory to copy, must not be {@code null}
@@ -1002,7 +1002,7 @@ public static void copyToDirectory(final File sourceFile, final File destination
      * <strong>Note:</strong> This method tries to preserve the file's last
      * modified date/times using {@link File#setLastModified(long)}, however
      * it is not guaranteed that the operation will succeed.
-     * If the modification operation fails, no indication is provided.
+     * If the modification operation fails, the methods throws IOException.
      * </p>
      *
      * @param sourceIterable     a existing files to copy, must not be {@code null}