This is an automated email from the ASF dual-hosted git repository.
bodewig pushed a commit to branch 1.9.x
in repository https://gitbox.apache.org/repos/asf/ant.git
The following commit(s) were added to refs/heads/1.9.x by this push:
new 033f8dc BZ 65497 - improve documentation around file time granularity
033f8dc is described below
commit 033f8dc250b23a66dc3e70612607e1f0752c792d
Author: Stefan Bodewig <[email protected]>
AuthorDate: Thu Aug 19 14:25:21 2021 +0200
BZ 65497 - improve documentation around file time granularity
---
manual/Tasks/copy.html | 5 ++++-
manual/Tasks/move.html | 4 +++-
src/main/org/apache/tools/ant/types/selectors/SelectorUtils.java | 6 +++---
3 files changed, 10 insertions(+), 5 deletions(-)
diff --git a/manual/Tasks/copy.html b/manual/Tasks/copy.html
index d1b8ff2..2e39116 100644
--- a/manual/Tasks/copy.html
+++ b/manual/Tasks/copy.html
@@ -28,7 +28,10 @@
<h3>Description</h3>
<p>Copies a file or resource collection to a new file or directory. By
default, files are
only copied if the source file is newer than the destination file,
-or when the destination file does not exist. However, you can explicitly
+or when the destination file does not exist - please see
+the <code>granularity</code> attribute for Ant's idea
+of <em>newer</em>.
+However, you can explicitly
overwrite files with the <code>overwrite</code> attribute.</p>
<p><a href="../Types/resources.html#collection">Resource
diff --git a/manual/Tasks/move.html b/manual/Tasks/move.html
index c4f931a..3692c9d 100644
--- a/manual/Tasks/move.html
+++ b/manual/Tasks/move.html
@@ -30,7 +30,9 @@
a new directory. By default, the
destination file is overwritten if it already exists. When
<var>overwrite</var> is
turned off, then files are only moved if the source file is newer than
-the destination file, or when the destination file does not exist.</p>
+the destination file, or when the destination file does not exist
+- please see the <code>granularity</code> attribute for Ant's idea
+of <em>newer</em>.</p>
<p><a href="../Types/resources.html#collection">Resource
Collection</a>s are used to select a group of files to move. Only
diff --git a/src/main/org/apache/tools/ant/types/selectors/SelectorUtils.java
b/src/main/org/apache/tools/ant/types/selectors/SelectorUtils.java
index a2804c2..9b37490 100644
--- a/src/main/org/apache/tools/ant/types/selectors/SelectorUtils.java
+++ b/src/main/org/apache/tools/ant/types/selectors/SelectorUtils.java
@@ -595,7 +595,7 @@ public final class SelectorUtils {
*
* @param src the original file
* @param target the file being compared against
- * @param granularity the amount in seconds of slack we will give in
+ * @param granularity the amount in milliseconds of slack we will give in
* determining out of dateness
* @return whether the target is out of date
*/
@@ -622,7 +622,7 @@ public final class SelectorUtils {
*
* @param src the original resource
* @param target the resource being compared against
- * @param granularity the int amount in seconds of slack we will give in
+ * @param granularity the int amount in milliseconds of slack we will give
in
* determining out of dateness
* @return whether the target is out of date
*/
@@ -641,7 +641,7 @@ public final class SelectorUtils {
*
* @param src the original resource
* @param target the resource being compared against
- * @param granularity the long amount in seconds of slack we will give in
+ * @param granularity the long amount in milliseconds of slack we will
give in
* determining out of dateness
* @return whether the target is out of date
*/
