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

@@ -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>
 

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>
 

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>
 

functions/session.xml

@@ -371,6 +371,7 @@ close
 $previous_name = session_name ("WebsiteID");
 
 echo "The previous session name was $previous_name<p>";
+?>
      </programlisting>
     </example>
     <note>