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>