rename can move files across *nix partitions as of PHP 4.3.3, which closes

the doc part of bug #23913.  Also fixed the example spacing, and added see alsos.


git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@129540 c90b9560-bf6c-de11-be94-00142212c4b1

reference/filesystem/functions/rename.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.4 $ -->
+<!-- $Revision: 1.5 $ -->
 <!-- splitted from ./en/functions/filesystem.xml, last change in rev 1.2 -->
   <refentry id="function.rename">
    <refnamediv>
@@ -19,16 +19,30 @@
     </para> 
     <para> 
      &return.success;
-    <example>
-     <title>Example with <function>rename</function></title>
-     <programlisting role="php">
+    </para>
+    <para>
+     <example>
+      <title>Example with <function>rename</function></title>
+      <programlisting role="php">
 <![CDATA[
 <?php
-  rename("/tmp/tmp_file.txt", "/home/user/login/docs/my_file.txt");
+rename("/tmp/tmp_file.txt", "/home/user/login/docs/my_file.txt");
 ?>
 ]]>
-     </programlisting>
-    </example>
+      </programlisting>
+     </example>
+    </para>
+    <note>
+     <title>New feature note</title>
+     <para>
+      Prior to PHP 4.3.3, <function>rename</function> could not rename files
+      across partitions on *nix based systems. 
+     </para>
+    </note>
+    <para>
+     See also <function>copy</function>, 
+     <function>unlink</function>, and
+     <function>move_uploaded_file</function>.
     </para>
    </refsect1>
   </refentry>