From 7e086502636df8e3a54f344e025f059c8206f3ae Mon Sep 17 00:00:00 2001
From: Stefan Bodewig <bodewig@apache.org>
Date: Thu, 24 Jun 2010 07:51:34 +0000
Subject: [PATCH] document <touch>'s limitations.  PR 47821

git-svn-id: https://svn.apache.org/repos/asf/ant/core/trunk@957444 13f79535-47bb-0310-9956-ffa450edef68
---
 docs/manual/Tasks/touch.html | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/docs/manual/Tasks/touch.html b/docs/manual/Tasks/touch.html
index 290d3e718..8dbbb137d 100644
--- a/docs/manual/Tasks/touch.html
+++ b/docs/manual/Tasks/touch.html
@@ -34,6 +34,18 @@ resource collections (which also includes directories).  Prior to Ant
 1.7 only FileSet or <a href="../Types/filelist.html">Filelist</a>
 (since Ant 1.6) have been supported.</p>
 
+<p>Ant uses the API of <code>java.io.File</code> to set the last
+  modification time which has some limitations.  For example the
+  timestamp granularity depends on the operating system and sometimes
+  the operating system may allow a granularity smaller than
+  milliseconds.  If you need more control you have to fall back to
+  the <code>&lt;exec&gt;</code> task and native commands.</p>
+
+<p>Starting with Ant 1.8.2 Ant will log a warning message if it fails
+  to change the file modification time.  This will happen if you try
+  to change the modification time of a file you do not own on many
+  Unix systems, for example.</p>
+
 <h3>Parameters</h3>
 <table border="1" cellpadding="2" cellspacing="0">
   <tr>