From 8eaf0dfc82f3d97241e96712cdea7870ce268c8d Mon Sep 17 00:00:00 2001
From: Sterling Hughes <sterling@php.net>
Date: Fri, 25 Feb 2000 00:02:34 +0000
Subject: [PATCH] Added notes saying what functions are not supported on
 windows systems

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@20417 c90b9560-bf6c-de11-be94-00142212c4b1
---
 functions/filesystem.xml | 63 ++++++++++++++++++++++++++++++++++++++--
 functions/info.xml       |  5 ++++
 functions/misc.xml       |  5 ++++
 functions/session.xml    |  1 +
 4 files changed, 71 insertions(+), 3 deletions(-)

diff --git a/functions/filesystem.xml b/functions/filesystem.xml
index 06c497360d..6e57bde2f3 100644
--- a/functions/filesystem.xml
+++ b/functions/filesystem.xml
@@ -61,13 +61,15 @@ $file = basename($path); // $file is set to "index.php3"
     <para>
      Returns true on success; otherwise returns false.
     </para>
-    <para>
-     On Windows, does nothing and returns true.
-    </para>
     <para>
      See also <function>chown</function> and
      <function>chmod</function>.
     </para>
+    <note>
+     <simpara>
+     This function does not work on Windows systems
+     </simpara>
+    </note>
    </refsect1>
   </refentry>
 
@@ -106,6 +108,11 @@ chmod( "/somedir/somefile", 0755 );  // octal; correct value of mode
      See also <function>chown</function> and
      <function>chgrp</function>.
     </para>
+    <note>
+     <simpara>
+     This function does not work on Windows systems
+     </simpara>
+    </note>
    </refsect1>
   </refentry>
 
@@ -136,6 +143,11 @@ chmod( "/somedir/somefile", 0755 );  // octal; correct value of mode
      See also <function>chown</function> and
      <function>chmod</function>.
     </para>
+    <note>
+     <simpara>
+     This function does not work on Windows systems
+     </simpara>
+    </note>
    </refsect1>
   </refentry>
 
@@ -691,6 +703,11 @@ $fcontents = join( '', file( 'http://www.php.net' ) );
      The results of this function are cached. See
      <function>clearstatcache</function> for more details.
     </para>
+    <note>
+     <simpara>
+     This function does not work on Windows systems
+     </simpara>
+    </note>
    </refsect1>
   </refentry>
 
@@ -712,6 +729,11 @@ $fcontents = join( '', file( 'http://www.php.net' ) );
      The results of this function are cached. See
      <function>clearstatcache</function> for more details.
     </para>
+    <note>
+     <simpara>
+     This function does not work on Windows systems
+     </simpara>
+    </note>
    </refsect1>
   </refentry>
 
@@ -757,6 +779,11 @@ $fcontents = join( '', file( 'http://www.php.net' ) );
      The results of this function are cached. See
      <function>clearstatcache</function> for more details.
     </para>
+    <note>
+     <simpara>
+     This function does not work on Windows systems
+     </simpara>
+    </note>
    </refsect1>
   </refentry>
 
@@ -1370,6 +1397,11 @@ fclose ($fd);
      See also <function>is_dir</function> and
      <function>is_file</function>.
     </para>
+    <note>
+     <simpara>
+     This function does not work on Windows systems
+     </simpara>
+    </note>
    </refsect1>
   </refentry>
 
@@ -1454,6 +1486,11 @@ fclose ($fd);
      and <function>readlink</function> along with
      <function>linkinfo</function>.
     </para>
+    <note>
+     <simpara>
+     This function does not work on Windows systems
+     </simpara>
+    </note>
    </refsect1>
   </refentry>
 
@@ -1480,6 +1517,11 @@ fclose ($fd);
      See also <function>symlink</function>, <function>link</function>,
      and <function>readlink</function>.
     </para>
+    <note>
+     <simpara>
+     This function does not work on Windows systems
+     </simpara>
+    </note>
    </refsect1>
   </refentry>
 
@@ -1665,6 +1707,11 @@ $fp = popen ("/bin/ls", "r");
      <function>readlink</function> and
      <function>linkinfo</function>.
     </para>
+    <note>
+     <simpara>
+     This function does not work on Windows systems
+     </simpara>
+    </note>
    </refsect1>
   </refentry>
 
@@ -1849,6 +1896,11 @@ $fp = popen ("/bin/ls", "r");
      and <function>readlink</function> along with
      <function>linkinfo</function>.
     </para>
+    <note>
+     <simpara>
+     This function does not work on Windows systems
+     </simpara>
+    </note>
    </refsect1>
   </refentry>
 
@@ -1971,6 +2023,11 @@ if ( touch($FileName) ) {
     <para>
      See also <function>rmdir</function> for removing directories.
     </para>
+    <note>
+     <simpara>
+     This function may not work on Windows systems.
+     </simpara>
+    </note>
    </refsect1>
   </refentry>
 
diff --git a/functions/info.xml b/functions/info.xml
index a0c8bd1064..10946f2272 100644
--- a/functions/info.xml
+++ b/functions/info.xml
@@ -392,6 +392,11 @@ echo "Last modified: ".date( "F d Y H:i:s.", getlastmod() );
      <function>getmypid</function>, and
      <function>getlastmod</function>.
     </para>
+    <note>
+     <simpara>
+     This function is not supported on Windows systems.
+     </simpara>
+    </note>
    </refsect1>
   </refentry>
 
diff --git a/functions/misc.xml b/functions/misc.xml
index 27fd1a7a75..ba78e25438 100644
--- a/functions/misc.xml
+++ b/functions/misc.xml
@@ -1062,6 +1062,11 @@ if (!odbc_execute ($stmt, &$sqldata) || !odbc_fetch_into ($stmt, &$tmp)) {
     <simpara>
      See also <function>sleep</function>.
     </simpara>
+    <note>
+     <simpara>
+     This function does not work on Windows systems
+     </simpara>
+    </note>
    </refsect1>
   </refentry>
 
diff --git a/functions/session.xml b/functions/session.xml
index 40b5bb5e77..523190cee7 100644
--- a/functions/session.xml
+++ b/functions/session.xml
@@ -371,6 +371,7 @@ close
 $previous_name = session_name ("WebsiteID");
 
 echo "The previous session name was $previous_name&lt;p&gt;";
+?&gt;
      </programlisting>
     </example>
     <note>