random: mt_rand() may throw ValueError since PHP 8.0 (#4660)

Co-authored-by: Tim Düsterhus <[email protected]>

Author: takaram

reference/random/functions/mt-rand.xml

@@ -63,10 +63,20 @@
   &reftitle.returnvalues;
   <para>
    A random integer value between <parameter>min</parameter> (or 0)
-   and <parameter>max</parameter> (or <function>mt_getrandmax</function>, inclusive),
-   or &false; if <parameter>max</parameter> is less than <parameter>min</parameter>.
+   and <parameter>max</parameter> (or <function>mt_getrandmax</function>, inclusive).
   </para>
  </refsect1>
+ <refsect1 role="errors">
+  &reftitle.errors;
+  <itemizedlist>
+   <listitem>
+    <simpara>
+     If <parameter>max</parameter> is less than <parameter>min</parameter>, a
+     <classname>ValueError</classname> will be thrown.
+    </simpara>
+   </listitem>
+  </itemizedlist>
+ </refsect1>
  <refsect1 role="changelog">
   &reftitle.changelog;
   <para>
@@ -79,6 +89,13 @@
       </row>
      </thead>
      <tbody>
+      <row>
+      <entry>8.0.0</entry>
+      <entry>
+       A <classname>ValueError</classname> will be thrown if <parameter>max</parameter> is less than <parameter>min</parameter>;
+       previously an <constant>E_WARNING</constant> was raised, and the function returned &false;.
+      </entry>
+     </row>
       <row>
        <entry>7.2.0</entry>
        <entry>