diff --git a/reference/password/functions/password-hash.xml b/reference/password/functions/password-hash.xml
index 7443cf7d67..16ff6e1fb8 100644
--- a/reference/password/functions/password-hash.xml
+++ b/reference/password/functions/password-hash.xml
@@ -17,7 +17,9 @@
   </methodsynopsis>
   <para>
    <function>password_hash</function> creates a new password hash using a strong one-way hashing
-   algorithm.
+   algorithm. <function>password_hash</function> is compatible with <function>crypt</function>.
+   Therefore, password hashes created by <function>crypt</function> can be used with
+   <function>password_hash</function>.
   </para>
   <simpara>
    The following algorithms are currently supported: