Document recent changes to the file system portability:

* touch($dir) works on Windows as of 5.3
* ino, uid & gid is always 0 on Windows


git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@265125 c90b9560-bf6c-de11-be94-00142212c4b1
This commit is contained in:
Kalle Sommer Nielsen 2008-08-19 13:03:09 +00:00
parent 6fd6778920
commit 0de11ca950
2 changed files with 38 additions and 10 deletions

View file

@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.18 $ -->
<!-- $Revision: 1.19 $ -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.stat">
<refnamediv>
<refname>stat</refname>
@ -62,7 +62,7 @@
<row>
<entry>1</entry>
<entry>ino</entry>
<entry>inode number</entry>
<entry>inode number *</entry>
</row>
<row>
<entry>2</entry>
@ -77,12 +77,12 @@
<row>
<entry>4</entry>
<entry>uid</entry>
<entry>userid of owner</entry>
<entry>userid of owner *</entry>
</row>
<row>
<entry>5</entry>
<entry>gid</entry>
<entry>groupid of owner</entry>
<entry>groupid of owner *</entry>
</row>
<row>
<entry>6</entry>
@ -112,17 +112,20 @@
<row>
<entry>11</entry>
<entry>blksize</entry>
<entry>blocksize of filesystem IO *</entry>
<entry>blocksize of filesystem IO **</entry>
</row>
<row>
<entry>12</entry>
<entry>blocks</entry>
<entry>number of blocks allocated *</entry>
<entry>number of blocks allocated **</entry>
</row>
</tbody>
</tgroup>
</table>
* Only valid on systems supporting the st_blksize type - other
* On Windows this will always be 0.
</para>
<para>
** Only valid on systems supporting the st_blksize type - other
systems (e.g. Windows) return -1.
</para>
<para>

View file

@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.14 $ -->
<!-- $Revision: 1.15 $ -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.touch">
<refnamediv>
<refname>touch</refname>
@ -67,6 +67,31 @@
</para>
</refsect1>
<refsect1 role="changelog">
&reftitle.changelog;
<para>
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
<row>
<entry>5.3.0</entry>
<entry>
It became possible to change the modification time of a directory
under Windows.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</para>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
@ -91,8 +116,8 @@ if (touch($FileName)) {
&reftitle.notes;
<warning>
<para>
It is not currently possible to change the modification time of a
directory with this function under Windows.
Prior to PHP 5.3.0 it was not possible to change the modification time
of a directory with this function under Windows.
</para>
</warning>
</refsect1>