random: lcg_value() is deprecated (#3992)

Author: TimWolla

reference/random/functions/lcg-value.xml

@@ -5,6 +5,11 @@
   <refname>lcg_value</refname>
   <refpurpose>Combined linear congruential generator</refpurpose>
  </refnamediv>
+
+ <refsynopsisdiv>
+  &warn.deprecated.function-8-4-0;
+ </refsynopsisdiv>
+
  <refsect1 role="description">
   &reftitle.description;
    <methodsynopsis>
@@ -46,6 +51,29 @@
    A pseudo random float value between 0.0 and 1.0, inclusive.
   </para>
  </refsect1>
+
+ <refsect1 role="changelog">
+  &reftitle.changelog;
+  <informaltable>
+   <tgroup cols="2">
+    <thead>
+     <row>
+      <entry>&Version;</entry>
+      <entry>&Description;</entry>
+     </row>
+    </thead>
+    <tbody>
+     <row>
+      <entry>8.4.0</entry>
+      <entry>
+       This function has been deprecated.
+      </entry>
+     </row>
+    </tbody>
+   </tgroup>
+  </informaltable>
+ </refsect1>
+
  <refsect1 role="seealso">
   &reftitle.seealso;
   <para>

reference/random/versions.xml

@@ -2,7 +2,7 @@
 <!-- Do NOT translate this file -->
 <versions>
  <!-- Functions -->
- <function name="lcg_value" from="PHP 4, PHP 5, PHP 7, PHP 8"/>
+ <function name="lcg_value" from="PHP 4, PHP 5, PHP 7, PHP 8" deprecated="PHP 8.4.0"/>
  <function name="mt_srand" from="PHP 4, PHP 5, PHP 7, PHP 8"/>
  <function name="srand" from="PHP 4, PHP 5, PHP 7, PHP 8"/>
  <function name="rand" from="PHP 4, PHP 5, PHP 7, PHP 8"/>