diff --git a/reference/math/functions/mt-rand.xml b/reference/math/functions/mt-rand.xml
index bb8091fe0b..47a2843155 100644
--- a/reference/math/functions/mt-rand.xml
+++ b/reference/math/functions/mt-rand.xml
@@ -62,7 +62,8 @@
   &reftitle.returnvalues;
   <para>
    A random integer value between <parameter>min</parameter> (or 0)
-   and <parameter>max</parameter> (or <function>mt_getrandmax</function>, inclusive)
+   and <parameter>max</parameter> (or <function>mt_getrandmax</function>, inclusive),
+   or &false; if <parameter>max</parameter> is less than <parameter>min</parameter>.
   </para>
  </refsect1>
  <refsect1 role="changelog">
@@ -77,6 +78,13 @@
       </row>
      </thead>
      <tbody>
+      <row>
+       <entry>5.3.4</entry>
+       <entry>
+        Issues an <constant>E_WARNING</constant> and returns &false; if
+        <parameter>max</parameter> &lt; <parameter>min</parameter>.
+       </entry>
+      </row>
       &changelog.randomseed;
      </tbody>
     </tgroup>