diff --git a/reference/filesystem/functions/rename.xml b/reference/filesystem/functions/rename.xml
index 1f6d848c14..644d72aff2 100644
--- a/reference/filesystem/functions/rename.xml
+++ b/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>