svn commit: r957444 - /ant/core/trunk/docs/manual/Tasks/touch.html

[bodewig]

Author: bodewig
Date: Thu Jun 24 07:51:34 2010
New Revision: 957444

URL: http://svn.apache.org/viewvc?rev=957444&view=rev
Log:
document <touch>'s limitations.  PR 47821

Modified:
    ant/core/trunk/docs/manual/Tasks/touch.html

Modified: ant/core/trunk/docs/manual/Tasks/touch.html
URL: 
http://svn.apache.org/viewvc/ant/core/trunk/docs/manual/Tasks/touch.html?rev=957444&r1=957443&r2=957444&view=diff
==============================================================================
--- ant/core/trunk/docs/manual/Tasks/touch.html (original)
+++ ant/core/trunk/docs/manual/Tasks/touch.html Thu Jun 24 07:51:34 2010
@@ -34,6 +34,18 @@ resource collections (which also include
 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>