diff --git a/reference/strings/functions/crypt.xml b/reference/strings/functions/crypt.xml
index 7871d96403..130b5f77f8 100644
--- a/reference/strings/functions/crypt.xml
+++ b/reference/strings/functions/crypt.xml
@@ -18,6 +18,12 @@
    standard Unix <abbrev>DES</abbrev>-based algorithm or
    alternative algorithms that may be available on the system.
   </para>
+  <para>
+   The <parameter>salt</parameter> parameter is optional. However, <function>crypt</function> creates weak password without <parameter>salt</parameter>. PHP 5.6 or later raise E_NOTICE error without it. Make sure specify strong enough salt for better security. 
+  </para>
+  <para>
+   <function>password_hash</function> uses strong hash, generates strong salt, applies proper rounds automatically. <function>password_hash</function> is simple <function>crypt</function> wrapper and compatible with existing password hashes. Use of <function>password_hash</function> is encouraged.
+  </para>
   <para>
    Some operating systems support more than one type of hash.  In
    fact, sometimes the standard DES-based algorithm is replaced by an
@@ -156,6 +162,12 @@
       </row>
      </thead>
      <tbody>
+      <row>
+       <entry>5.6.0</entry>
+       <entry>
+        Raise E_NOTICE security warning if <parameter>salt</parameter> is omitted.
+       </entry>
+      </row>
       <row>
        <entry>5.3.7</entry>
        <entry>
@@ -293,6 +305,7 @@ SHA-512:      $6$rounds=5000$usesomesillystri$D4IrlXatmP7rx3P3InaxBeoomnAihCKRVQ
   &reftitle.seealso;
   <para>
    <simplelist>
+    <member><function>password_hash</function></member>
     <member><function>md5</function></member>
     <member>The <link linkend="ref.mcrypt">Mcrypt</link> extension</member>
     <member>The Unix man page for your crypt function for more information</member>