diff --git a/reference/filesystem/functions/rename.xml b/reference/filesystem/functions/rename.xml
index e41bc2841c..1dd4b06037 100644
--- a/reference/filesystem/functions/rename.xml
+++ b/reference/filesystem/functions/rename.xml
@@ -16,7 +16,8 @@
   </methodsynopsis>
   <para>
    Attempts to rename <parameter>oldname</parameter> to
-   <parameter>newname</parameter>.
+   <parameter>newname</parameter>, moving it between directories if necessary.
+   If <parameter>newname</parameter> exists, it will be overwritten.
   </para>
  </refsect1>