vrana Fri Jan 13 10:45:47 2006 UTC
Modified files:
/phpdoc/en/reference/filesystem/functions touch.xml
Log:
Directories under Windows (bug #35980)
http://cvs.php.net/viewcvs.cgi/phpdoc/en/reference/filesystem/functions/touch.xml?r1=1.9&r2=1.10&diff_format=u
Index: phpdoc/en/reference/filesystem/functions/touch.xml
diff -u phpdoc/en/reference/filesystem/functions/touch.xml:1.9
phpdoc/en/reference/filesystem/functions/touch.xml:1.10
--- phpdoc/en/reference/filesystem/functions/touch.xml:1.9 Tue Nov 9
07:59:34 2004
+++ phpdoc/en/reference/filesystem/functions/touch.xml Fri Jan 13 10:45:47 2006
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.9 $ -->
+<!-- $Revision: 1.10 $ -->
<!-- splitted from ./en/functions/filesystem.xml, last change in rev 1.2 -->
<refentry id="function.touch">
<refnamediv>
@@ -16,10 +16,10 @@
</methodsynopsis>
<para>
Attempts to set the access and modification time of the file named by
- <parameter>filename</parameter> to the value given by
- <parameter>time</parameter>. If the parameter <parameter>time</parameter>
- is not given, uses the present time. This is equivalent to what utime
- (sometimes referred to as utimes) does. If the third parameter
+ <parameter>filename</parameter> to the value given by
+ <parameter>time</parameter>. If the parameter <parameter>time</parameter>
+ is not given, uses the present time. This is equivalent to what utime
+ (sometimes referred to as utimes) does. If the third parameter
<parameter>atime</parameter> is present, the access time of the given
filename is set to the value of <parameter>atime</parameter>.
Note that the access time is always modified, regardless of the number
@@ -28,6 +28,12 @@
<para>
If the file does not exist, it is created. &return.success;
</para>
+ <warning>
+ <para>
+ It's not currently possible to change the modification time of a
+ directory with this function under Windows.
+ </para>
+ </warning>
<para>
<example>
<title><function>touch</function> example</title>
@@ -35,9 +41,9 @@
<![CDATA[
<?php
if (touch($FileName)) {
- echo "$FileName modification time has been changed to present time";
+ echo "$FileName modification time has been changed to present time";
} else {
- echo "Sorry, could not change modification time of $FileName";
+ echo "Sorry, could not change modification time of $FileName";
}
?>
]]>
