From 0de11ca950661b64f1034e9bc8ebc796ef15f0a0 Mon Sep 17 00:00:00 2001
From: Kalle Sommer Nielsen <kalle@php.net>
Date: Tue, 19 Aug 2008 13:03:09 +0000
Subject: [PATCH] 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
---
 reference/filesystem/functions/stat.xml  | 17 +++++++------
 reference/filesystem/functions/touch.xml | 31 +++++++++++++++++++++---
 2 files changed, 38 insertions(+), 10 deletions(-)

diff --git a/reference/filesystem/functions/stat.xml b/reference/filesystem/functions/stat.xml
index 5a2ea6b2b4..257b8f2415 100644
--- a/reference/filesystem/functions/stat.xml
+++ b/reference/filesystem/functions/stat.xml
@@ -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>
diff --git a/reference/filesystem/functions/touch.xml b/reference/filesystem/functions/touch.xml
index a124724efd..80db6ef47b 100644
--- a/reference/filesystem/functions/touch.xml
+++ b/reference/filesystem/functions/touch.xml
@@ -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>