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><exec></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>
