diff --git a/reference/password/functions/password-hash.xml b/reference/password/functions/password-hash.xml
index ce36d0ae33..b81722f7de 100644
--- a/reference/password/functions/password-hash.xml
+++ b/reference/password/functions/password-hash.xml
@@ -231,7 +231,7 @@ $2y$12$QjSH496pcT5CEbzjD/vtVeH03tfHKFy36d4J0Ltp3lRtee9HDxY3K
  */
 $options = [
     'cost' => 11,
-    'salt' => mcrypt_create_iv(22, MCRYPT_DEV_URANDOM),
+    'salt' => random_bytes(22),
 ];
 echo password_hash("rasmuslerdorf", PASSWORD_BCRYPT, $options);
 ?>
@@ -381,6 +381,7 @@ Argon2 hash: $argon2i$v=19$m=1024,t=2,p=2$YzJBSzV4TUhkMzc3d3laeg$zqU/1IN0/AogfP4
     <member><function>password_verify</function></member>
     <member><function>crypt</function></member>
     <member><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&url.password.compat;">userland implementation</link></member>
+    <member><function>sodium_crypto_pwhash_str</function></member>
    </simplelist>
   </para>
  </refsect1>