From c3fcdff0da2fb9e549258a727e99053435c655d2 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Tim=20D=C3=BCsterhus?= <tim@bastelstu.be>
Date: Tue, 25 Oct 2022 21:09:54 +0200
Subject: [PATCH 01/17] Bootstrap ext/random docs with docgen

---
 appendices/extensions.xml                     |   4 +-
 appendices/migration70/new-features.xml       |   2 +-
 appendices/migration70/new-functions.xml      |   2 +-
 reference/csprng/book.xml                     |  48 --------
 reference/math/versions.xml                   |   7 --
 reference/random/book.developer.xml           |  72 +++++++++++
 .../{csprng/constants.xml => random/book.xml} |  21 +++-
 reference/random/constants.xml                |  49 ++++++++
 .../versions.xml => random/examples.xml}      |  27 ++--
 .../{math => random}/functions/getrandmax.xml |   0
 .../{math => random}/functions/lcg-value.xml  |   0
 .../functions/mt-getrandmax.xml               |   0
 .../{math => random}/functions/mt-rand.xml    |   0
 .../{math => random}/functions/mt-srand.xml   |   0
 reference/{math => random}/functions/rand.xml |   0
 .../functions/random-bytes.xml                |   0
 .../functions/random-int.xml                  |   0
 .../{math => random}/functions/srand.xml      |   0
 .../random/random.brokenrandomengineerror.xml |  79 ++++++++++++
 reference/random/random.cryptosafeengine.xml  |  67 ++++++++++
 reference/random/random.engine.mt19937.xml    |  67 ++++++++++
 .../random.engine.pcgoneseq128xslrr64.xml     |  67 ++++++++++
 reference/random/random.engine.secure.xml     |  67 ++++++++++
 reference/random/random.engine.xml            |  63 ++++++++++
 .../random.engine.xoshiro256starstar.xml      |  67 ++++++++++
 reference/random/random.randomerror.xml       |  79 ++++++++++++
 reference/random/random.randomexception.xml   |  79 ++++++++++++
 reference/random/random.randomizer.xml        |  85 +++++++++++++
 reference/random/random/engine/generate.xml   |  77 ++++++++++++
 .../random/engine/mt19937/construct.xml       | 100 +++++++++++++++
 .../random/engine/mt19937/debuginfo.xml       |  77 ++++++++++++
 .../random/random/engine/mt19937/generate.xml |  77 ++++++++++++
 .../random/engine/mt19937/serialize.xml       |  77 ++++++++++++
 .../random/engine/mt19937/unserialize.xml     |  86 +++++++++++++
 .../engine/pcgoneseq128xslrr64/construct.xml  |  91 ++++++++++++++
 .../engine/pcgoneseq128xslrr64/debuginfo.xml  |  77 ++++++++++++
 .../engine/pcgoneseq128xslrr64/generate.xml   |  77 ++++++++++++
 .../engine/pcgoneseq128xslrr64/jump.xml       |  86 +++++++++++++
 .../engine/pcgoneseq128xslrr64/serialize.xml  |  77 ++++++++++++
 .../pcgoneseq128xslrr64/unserialize.xml       |  86 +++++++++++++
 .../random/random/engine/secure/generate.xml  |  77 ++++++++++++
 .../engine/xoshiro256starstar/construct.xml   |  91 ++++++++++++++
 .../engine/xoshiro256starstar/debuginfo.xml   |  77 ++++++++++++
 .../engine/xoshiro256starstar/generate.xml    |  77 ++++++++++++
 .../random/engine/xoshiro256starstar/jump.xml |  77 ++++++++++++
 .../engine/xoshiro256starstar/jumplong.xml    |  77 ++++++++++++
 .../engine/xoshiro256starstar/serialize.xml   |  77 ++++++++++++
 .../engine/xoshiro256starstar/unserialize.xml |  86 +++++++++++++
 .../random/random/randomizer/construct.xml    |  91 ++++++++++++++
 .../random/random/randomizer/getbytes.xml     |  86 +++++++++++++
 reference/random/random/randomizer/getint.xml |  95 +++++++++++++++
 .../random/random/randomizer/nextint.xml      |  77 ++++++++++++
 .../random/randomizer/pickarraykeys.xml       |  95 +++++++++++++++
 .../random/random/randomizer/serialize.xml    |  77 ++++++++++++
 .../random/random/randomizer/shufflearray.xml |  86 +++++++++++++
 .../random/random/randomizer/shufflebytes.xml |  86 +++++++++++++
 .../random/random/randomizer/unserialize.xml  |  86 +++++++++++++
 reference/{csprng => random}/reference.xml    |  10 +-
 reference/{csprng => random}/setup.xml        |  13 +-
 reference/random/versions.xml                 | 115 ++++++++++++++++++
 60 files changed, 3408 insertions(+), 88 deletions(-)
 delete mode 100644 reference/csprng/book.xml
 create mode 100644 reference/random/book.developer.xml
 rename reference/{csprng/constants.xml => random/book.xml} (56%)
 create mode 100644 reference/random/constants.xml
 rename reference/{csprng/versions.xml => random/examples.xml} (58%)
 rename reference/{math => random}/functions/getrandmax.xml (100%)
 rename reference/{math => random}/functions/lcg-value.xml (100%)
 rename reference/{math => random}/functions/mt-getrandmax.xml (100%)
 rename reference/{math => random}/functions/mt-rand.xml (100%)
 rename reference/{math => random}/functions/mt-srand.xml (100%)
 rename reference/{math => random}/functions/rand.xml (100%)
 rename reference/{csprng => random}/functions/random-bytes.xml (100%)
 rename reference/{csprng => random}/functions/random-int.xml (100%)
 rename reference/{math => random}/functions/srand.xml (100%)
 create mode 100644 reference/random/random.brokenrandomengineerror.xml
 create mode 100644 reference/random/random.cryptosafeengine.xml
 create mode 100644 reference/random/random.engine.mt19937.xml
 create mode 100644 reference/random/random.engine.pcgoneseq128xslrr64.xml
 create mode 100644 reference/random/random.engine.secure.xml
 create mode 100644 reference/random/random.engine.xml
 create mode 100644 reference/random/random.engine.xoshiro256starstar.xml
 create mode 100644 reference/random/random.randomerror.xml
 create mode 100644 reference/random/random.randomexception.xml
 create mode 100644 reference/random/random.randomizer.xml
 create mode 100644 reference/random/random/engine/generate.xml
 create mode 100644 reference/random/random/engine/mt19937/construct.xml
 create mode 100644 reference/random/random/engine/mt19937/debuginfo.xml
 create mode 100644 reference/random/random/engine/mt19937/generate.xml
 create mode 100644 reference/random/random/engine/mt19937/serialize.xml
 create mode 100644 reference/random/random/engine/mt19937/unserialize.xml
 create mode 100644 reference/random/random/engine/pcgoneseq128xslrr64/construct.xml
 create mode 100644 reference/random/random/engine/pcgoneseq128xslrr64/debuginfo.xml
 create mode 100644 reference/random/random/engine/pcgoneseq128xslrr64/generate.xml
 create mode 100644 reference/random/random/engine/pcgoneseq128xslrr64/jump.xml
 create mode 100644 reference/random/random/engine/pcgoneseq128xslrr64/serialize.xml
 create mode 100644 reference/random/random/engine/pcgoneseq128xslrr64/unserialize.xml
 create mode 100644 reference/random/random/engine/secure/generate.xml
 create mode 100644 reference/random/random/engine/xoshiro256starstar/construct.xml
 create mode 100644 reference/random/random/engine/xoshiro256starstar/debuginfo.xml
 create mode 100644 reference/random/random/engine/xoshiro256starstar/generate.xml
 create mode 100644 reference/random/random/engine/xoshiro256starstar/jump.xml
 create mode 100644 reference/random/random/engine/xoshiro256starstar/jumplong.xml
 create mode 100644 reference/random/random/engine/xoshiro256starstar/serialize.xml
 create mode 100644 reference/random/random/engine/xoshiro256starstar/unserialize.xml
 create mode 100644 reference/random/random/randomizer/construct.xml
 create mode 100644 reference/random/random/randomizer/getbytes.xml
 create mode 100644 reference/random/random/randomizer/getint.xml
 create mode 100644 reference/random/random/randomizer/nextint.xml
 create mode 100644 reference/random/random/randomizer/pickarraykeys.xml
 create mode 100644 reference/random/random/randomizer/serialize.xml
 create mode 100644 reference/random/random/randomizer/shufflearray.xml
 create mode 100644 reference/random/random/randomizer/shufflebytes.xml
 create mode 100644 reference/random/random/randomizer/unserialize.xml
 rename reference/{csprng => random}/reference.xml (73%)
 rename reference/{csprng => random}/setup.xml (72%)
 create mode 100644 reference/random/versions.xml

diff --git a/appendices/extensions.xml b/appendices/extensions.xml
index 86330c6e7be2..9488dc6ebba9 100644
--- a/appendices/extensions.xml
+++ b/appendices/extensions.xml
@@ -21,7 +21,6 @@
    <listitem><simpara><xref linkend="book.cmark"/></simpara></listitem>
    <listitem><simpara><xref linkend="book.com"/></simpara></listitem>
    <listitem><simpara><xref linkend="book.componere"/></simpara></listitem>
-   <listitem><simpara><xref linkend="book.csprng"/></simpara></listitem>
    <listitem><simpara><xref linkend="book.ctype"/></simpara></listitem>
    <listitem><simpara><xref linkend="book.cubrid"/></simpara></listitem>
    <listitem><simpara><xref linkend="book.curl"/></simpara></listitem>
@@ -121,6 +120,7 @@
    <listitem><simpara><xref linkend="book.pthreads"/></simpara></listitem>
    <listitem><simpara><xref linkend="book.quickhash"/></simpara></listitem>
    <listitem><simpara><xref linkend="book.radius"/></simpara></listitem>
+   <listitem><simpara><xref linkend="book.random"/></simpara></listitem>
    <listitem><simpara><xref linkend="book.rar"/></simpara></listitem>
    <listitem><simpara><xref linkend="book.readline"/></simpara></listitem>
    <listitem><simpara><xref linkend="book.recode"/></simpara></listitem>
@@ -202,7 +202,6 @@
    <itemizedlist>
     <listitem><para><xref linkend="book.array"/></para></listitem>
     <listitem><para><xref linkend="book.classobj"/></para></listitem>
-    <listitem><para><xref linkend="book.csprng"/></para></listitem>
     <listitem><para><xref linkend="book.datetime"/></para></listitem>
     <listitem><para><xref linkend="book.dir"/></para></listitem>
     <listitem><para><xref linkend="book.errorfunc"/></para></listitem>
@@ -256,6 +255,7 @@
     <listitem><para><xref linkend="book.phar"/></para></listitem>
     <listitem><para><xref linkend="book.phpdbg"/></para></listitem>
     <listitem><para><xref linkend="book.posix"/></para></listitem>
+    <listitem><para><xref linkend="book.random"/></para></listitem>
     <listitem><para><xref linkend="book.sem"/></para></listitem>
     <listitem><para><xref linkend="book.session"/></para></listitem>
     <listitem><para><xref linkend="book.shmop"/></para></listitem>
diff --git a/appendices/migration70/new-features.xml b/appendices/migration70/new-features.xml
index 7f05505b58a8..f2c1c24da7f4 100644
--- a/appendices/migration70/new-features.xml
+++ b/appendices/migration70/new-features.xml
@@ -640,7 +640,7 @@ session_start([
  </sect2>
 
  <sect2 xml:id="migration70.new-features.csprng-functions">
-  <title><link linkend="book.csprng">CSPRNG</link> Functions</title>
+  <title>CSPRNG Functions</title>
 
   <para>
    Two new functions have been added to generate cryptographically secure
diff --git a/appendices/migration70/new-functions.xml b/appendices/migration70/new-functions.xml
index e3fe3af62e78..dda54d14322f 100644
--- a/appendices/migration70/new-functions.xml
+++ b/appendices/migration70/new-functions.xml
@@ -17,7 +17,7 @@
  </sect2>
 
  <sect2 xml:id="migration70.new-functions.csprng">
-  <title><link linkend="book.csprng">CSPRNG</link></title>
+  <title>CSPRNG</title>
 
   <itemizedlist>
    <listitem>
diff --git a/reference/csprng/book.xml b/reference/csprng/book.xml
deleted file mode 100644
index 2f00ffbdc341..000000000000
--- a/reference/csprng/book.xml
+++ /dev/null
@@ -1,48 +0,0 @@
-<?xml version="1.0" encoding="utf-8"?>
-<!-- $Revision$ -->
-
-<book xml:id="book.csprng" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
- <?phpdoc extension-membership="core" ?>
- <title>CSPRNG</title>
-
- <preface xml:id="intro.csprng">
-  &reftitle.intro;
-  <para>
-   The <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&url.csprng.wiki;">cryptographically secure
-   pseudo-random number generator</link> (CSPRNG) API provides an easy and reliable way to generate crypto-strong random
-   integers and bytes for use within cryptographic contexts.
-  </para>
-  <para>
-   &version.exists.asof;7.0.0 but there is also a
-   <link xlink:href="&url.csprng.compat;">userland implementation</link>
-   for PHP &gt;= 5.2.0.
-  </para>
- </preface>
-
- &reference.csprng.setup;
- &reference.csprng.constants;
- &reference.csprng.reference;
-
-</book>
-
-<!-- Keep this comment at the end of the file
-Local variables:
-mode: sgml
-sgml-omittag:t
-sgml-shorttag:t
-sgml-minimize-attributes:nil
-sgml-always-quote-attributes:t
-sgml-indent-step:1
-sgml-indent-data:t
-indent-tabs-mode:nil
-sgml-parent-document:nil
-sgml-default-dtd-file:"~/.phpdoc/manual.ced"
-sgml-exposed-tags:nil
-sgml-local-catalogs:nil
-sgml-local-ecat-files:nil
-End:
-vim600: syn=xml fen fdm=syntax fdl=2 si
-vim: et tw=78 syn=sgml
-vi: ts=1 sw=1
--->
-
diff --git a/reference/math/versions.xml b/reference/math/versions.xml
index 34bd2fb1c69b..0429d661a3aa 100644
--- a/reference/math/versions.xml
+++ b/reference/math/versions.xml
@@ -26,31 +26,24 @@
  <function name="fdiv" from="PHP 8"/>
  <function name="floor" from="PHP 4, PHP 5, PHP 7, PHP 8"/>
  <function name="fmod" from="PHP 4 &gt;= 4.2.0, PHP 5, PHP 7, PHP 8"/>
- <function name="getrandmax" from="PHP 4, PHP 5, PHP 7, PHP 8"/>
  <function name="hexdec" from="PHP 4, PHP 5, PHP 7, PHP 8"/>
  <function name="hypot" from="PHP 4 &gt;= 4.1.0, PHP 5, PHP 7, PHP 8"/>
  <function name="is_finite" from="PHP 4 &gt;= 4.2.0, PHP 5, PHP 7, PHP 8"/>
  <function name="is_infinite" from="PHP 4 &gt;= 4.2.0, PHP 5, PHP 7, PHP 8"/>
  <function name="is_nan" from="PHP 4 &gt;= 4.2.0, PHP 5, PHP 7, PHP 8"/>
- <function name="lcg_value" from="PHP 4, PHP 5, PHP 7, PHP 8"/>
  <function name="log" from="PHP 4, PHP 5, PHP 7, PHP 8"/>
  <function name="log10" from="PHP 4, PHP 5, PHP 7, PHP 8"/>
  <function name="log1p" from="PHP 4 &gt;= 4.1.0, PHP 5, PHP 7, PHP 8"/>
  <function name="max" from="PHP 4, PHP 5, PHP 7, PHP 8"/>
  <function name="min" from="PHP 4, PHP 5, PHP 7, PHP 8"/>
- <function name="mt_getrandmax" from="PHP 4, PHP 5, PHP 7, PHP 8"/>
- <function name="mt_rand" from="PHP 4, PHP 5, PHP 7, PHP 8"/>
- <function name="mt_srand" from="PHP 4, PHP 5, PHP 7, PHP 8"/>
  <function name="octdec" from="PHP 4, PHP 5, PHP 7, PHP 8"/>
  <function name="pi" from="PHP 4, PHP 5, PHP 7, PHP 8"/>
  <function name="pow" from="PHP 4, PHP 5, PHP 7, PHP 8"/>
  <function name="rad2deg" from="PHP 4, PHP 5, PHP 7, PHP 8"/>
- <function name="rand" from="PHP 4, PHP 5, PHP 7, PHP 8"/>
  <function name="round" from="PHP 4, PHP 5, PHP 7, PHP 8"/>
  <function name="sin" from="PHP 4, PHP 5, PHP 7, PHP 8"/>
  <function name="sinh" from="PHP 4 &gt;= 4.1.0, PHP 5, PHP 7, PHP 8"/>
  <function name="sqrt" from="PHP 4, PHP 5, PHP 7, PHP 8"/>
- <function name="srand" from="PHP 4, PHP 5, PHP 7, PHP 8"/>
  <function name="tan" from="PHP 4, PHP 5, PHP 7, PHP 8"/>
  <function name="tanh" from="PHP 4 &gt;= 4.1.0, PHP 5, PHP 7, PHP 8"/>
  <function name="intdiv" from="PHP 7, PHP 8"/>
diff --git a/reference/random/book.developer.xml b/reference/random/book.developer.xml
new file mode 100644
index 000000000000..9d47536facc5
--- /dev/null
+++ b/reference/random/book.developer.xml
@@ -0,0 +1,72 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V5.0//EN"
+"{PATH_TO_DOCBASE}/docbook/docbook-xml/docbook.dtd" [
+<!-- We use xhtml entities all over the place -->
+<!ENTITY % xhtml-lat1        SYSTEM "{PATH_TO_DOCBASE}/entities/ISO/xhtml1-lat1.ent">
+<!ENTITY % xhtml-symbol      SYSTEM "{PATH_TO_DOCBASE}/entities/ISO/xhtml1-symbol.ent">
+<!ENTITY % xhtml-special     SYSTEM "{PATH_TO_DOCBASE}/entities/ISO/xhtml1-special.ent">
+<!ENTITY % isopub            SYSTEM "{PATH_TO_DOCBASE}/entities/ISO/isopub.ent">
+%xhtml-lat1;
+%xhtml-symbol;
+%xhtml-special;
+%isopub;
+
+<!-- Fallback to English definitions and snippets (in case of missing translation) -->
+<!ENTITY % language-defs.default     SYSTEM "{PATH_TO_DOC}/language-defs.ent">
+<!ENTITY % language-snippets.default SYSTEM "{PATH_TO_DOC}/language-snippets.ent">
+<!ENTITY % extensions.default        SYSTEM "{PATH_TO_DOC}/extensions.ent">
+
+%language-defs.default;
+%extensions.default;
+%language-snippets.default;
+
+<!-- All global entities for the XML files -->
+<!ENTITY % global.entities  SYSTEM "{PATH_TO_DOCBASE}/entities/global.ent">
+
+<!-- These are language independent -->
+<!ENTITY % frontpage.entities SYSTEM "{PATH_TO_DOC}/contributors.ent">
+<!ENTITY % file.entities      SYSTEM "{PATH_TO_DOCBASE}/entities/file-entities.ent">
+
+<!-- Include all external DTD parts defined previously -->
+%global.entities;
+%file.entities;
+%frontpage.entities;
+]>
+
+<book xml:id="book.random" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:lang="en">
+ <title>Random</title>
+ <titleabbrev>Random</titleabbrev>
+
+ <preface xml:id="intro.random">
+  &reftitle.intro;
+  <para>
+
+  </para>
+ </preface>
+
+ &reference.random.setup;
+ &reference.random.constants;
+ &reference.random.examples;
+ &reference.random.reference;
+
+</book>
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: sgml
+sgml-omittag:t
+sgml-shorttag:t
+sgml-minimize-attributes:nil
+sgml-always-quote-attributes:t
+sgml-indent-step:1
+sgml-indent-data:t
+indent-tabs-mode:nil
+sgml-parent-document:nil
+sgml-default-dtd-file:"~/.phpdoc/manual.ced"
+sgml-exposed-tags:nil
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+End:
+vim600: syn=xml fen fdm=syntax fdl=2 si
+vim: et tw=78 syn=sgml
+vi: ts=1 sw=1
+-->
diff --git a/reference/csprng/constants.xml b/reference/random/book.xml
similarity index 56%
rename from reference/csprng/constants.xml
rename to reference/random/book.xml
index 17955d40211d..e8e5bb245d97 100644
--- a/reference/csprng/constants.xml
+++ b/reference/random/book.xml
@@ -1,11 +1,21 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- $Revision$ -->
+<book xml:id="book.random" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
+ <title>Random</title>
+ <titleabbrev>Random</titleabbrev>
 
-<appendix xml:id="csprng.constants" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
- &reftitle.constants;
- &no.constants;
-</appendix>
+ <preface xml:id="intro.random">
+  &reftitle.intro;
+  <para>
 
+  </para>
+ </preface>
+
+ &reference.random.setup;
+ &reference.random.constants;
+ &reference.random.examples;
+ &reference.random.reference;
+
+</book>
 <!-- Keep this comment at the end of the file
 Local variables:
 mode: sgml
@@ -26,4 +36,3 @@ vim600: syn=xml fen fdm=syntax fdl=2 si
 vim: et tw=78 syn=sgml
 vi: ts=1 sw=1
 -->
-
diff --git a/reference/random/constants.xml b/reference/random/constants.xml
new file mode 100644
index 000000000000..42ec92c26f5c
--- /dev/null
+++ b/reference/random/constants.xml
@@ -0,0 +1,49 @@
+<?xml version="1.0" encoding="utf-8"?>
+<appendix xml:id="random.constants" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
+ &reftitle.constants;
+ &extension.constants;
+ <para>
+  <variablelist>
+   <varlistentry xml:id="constant.mt-rand-mt19937">
+    <term>
+     <constant>MT_RAND_MT19937</constant>
+     (<type>integer</type>)
+    </term>
+    <listitem>
+     <simpara>
+     </simpara>
+    </listitem>
+   </varlistentry>
+   <varlistentry xml:id="constant.mt-rand-php">
+    <term>
+     <constant>MT_RAND_PHP</constant>
+     (<type>integer</type>)
+    </term>
+    <listitem>
+     <simpara>
+     </simpara>
+    </listitem>
+   </varlistentry>
+  </variablelist>
+ </para>
+</appendix>
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: sgml
+sgml-omittag:t
+sgml-shorttag:t
+sgml-minimize-attributes:nil
+sgml-always-quote-attributes:t
+sgml-indent-step:1
+sgml-indent-data:t
+indent-tabs-mode:nil
+sgml-parent-document:nil
+sgml-default-dtd-file:"~/.phpdoc/manual.ced"
+sgml-exposed-tags:nil
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+End:
+vim600: syn=xml fen fdm=syntax fdl=2 si
+vim: et tw=78 syn=sgml
+vi: ts=1 sw=1
+-->
diff --git a/reference/csprng/versions.xml b/reference/random/examples.xml
similarity index 58%
rename from reference/csprng/versions.xml
rename to reference/random/examples.xml
index 764cdf851ab0..3341a7146afa 100644
--- a/reference/csprng/versions.xml
+++ b/reference/random/examples.xml
@@ -1,14 +1,25 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- $Revision$ -->
-<!--
-  Do NOT translate this file
--->
+<chapter xml:id="random.examples" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
+ &reftitle.examples;
+ <example>
+  <title>Random Example</title>
+  <programlisting role="php">
+<![CDATA[
+<?php
 
-<versions>
- <function name="random_bytes" from="PHP 7, PHP 8"/>
- <function name="random_int" from="PHP 7, PHP 8"/>
-</versions>
+/* ... */
 
+?>
+]]>
+  </programlisting>
+  &example.outputs.similar;
+  <screen>
+<![CDATA[
+...
+]]>
+  </screen>
+ </example>
+</chapter>
 <!-- Keep this comment at the end of the file
 Local variables:
 mode: sgml
diff --git a/reference/math/functions/getrandmax.xml b/reference/random/functions/getrandmax.xml
similarity index 100%
rename from reference/math/functions/getrandmax.xml
rename to reference/random/functions/getrandmax.xml
diff --git a/reference/math/functions/lcg-value.xml b/reference/random/functions/lcg-value.xml
similarity index 100%
rename from reference/math/functions/lcg-value.xml
rename to reference/random/functions/lcg-value.xml
diff --git a/reference/math/functions/mt-getrandmax.xml b/reference/random/functions/mt-getrandmax.xml
similarity index 100%
rename from reference/math/functions/mt-getrandmax.xml
rename to reference/random/functions/mt-getrandmax.xml
diff --git a/reference/math/functions/mt-rand.xml b/reference/random/functions/mt-rand.xml
similarity index 100%
rename from reference/math/functions/mt-rand.xml
rename to reference/random/functions/mt-rand.xml
diff --git a/reference/math/functions/mt-srand.xml b/reference/random/functions/mt-srand.xml
similarity index 100%
rename from reference/math/functions/mt-srand.xml
rename to reference/random/functions/mt-srand.xml
diff --git a/reference/math/functions/rand.xml b/reference/random/functions/rand.xml
similarity index 100%
rename from reference/math/functions/rand.xml
rename to reference/random/functions/rand.xml
diff --git a/reference/csprng/functions/random-bytes.xml b/reference/random/functions/random-bytes.xml
similarity index 100%
rename from reference/csprng/functions/random-bytes.xml
rename to reference/random/functions/random-bytes.xml
diff --git a/reference/csprng/functions/random-int.xml b/reference/random/functions/random-int.xml
similarity index 100%
rename from reference/csprng/functions/random-int.xml
rename to reference/random/functions/random-int.xml
diff --git a/reference/math/functions/srand.xml b/reference/random/functions/srand.xml
similarity index 100%
rename from reference/math/functions/srand.xml
rename to reference/random/functions/srand.xml
diff --git a/reference/random/random.brokenrandomengineerror.xml b/reference/random/random.brokenrandomengineerror.xml
new file mode 100644
index 000000000000..53bcebaa5c67
--- /dev/null
+++ b/reference/random/random.brokenrandomengineerror.xml
@@ -0,0 +1,79 @@
+<?xml version="1.0" encoding="utf-8"?>
+<phpdoc:classref xml:id="class.random-brokenrandomengineerror" xmlns:phpdoc="http://php.net/ns/phpdoc" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
+ <title>The Random\BrokenRandomEngineError class</title>
+ <titleabbrev>Random\BrokenRandomEngineError</titleabbrev>
+
+ <partintro>
+
+<!-- {{{ Random\BrokenRandomEngineError intro -->
+  <section xml:id="random-brokenrandomengineerror.intro">
+   &reftitle.intro;
+   <para>
+
+   </para>
+  </section>
+<!-- }}} -->
+
+  <section xml:id="random-brokenrandomengineerror.synopsis">
+   &reftitle.classsynopsis;
+
+<!-- {{{ Synopsis -->
+   <classsynopsis>
+    <ooclass><classname>Random\BrokenRandomEngineError</classname></ooclass>
+
+<!-- {{{ Class synopsis -->
+    <classsynopsisinfo>
+     <ooclass>
+      <classname>Random\BrokenRandomEngineError</classname>
+     </ooclass>
+     
+     <ooclass>
+      <modifier>extends</modifier>
+      <classname>Random\RandomError</classname>
+     </ooclass>
+     
+     <oointerface>
+      <interfacename>Throwable</interfacename>
+     </oointerface>
+    </classsynopsisinfo>
+<!-- }}} -->
+    <classsynopsisinfo role="comment">&InheritedProperties;</classsynopsisinfo>
+    <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('error.synopsis')/descendant::db:fieldsynopsis)"><xi:fallback/></xi:include>
+
+    
+    <classsynopsisinfo role="comment">&Methods;</classsynopsisinfo>
+    <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.random-brokenrandomengineerror')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[not(@role='procedural')])"><xi:fallback/></xi:include>
+    
+    <classsynopsisinfo role="comment">&InheritedMethods;</classsynopsisinfo>
+    <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.random-randomerror')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[not(@role='procedural')])"><xi:fallback/></xi:include>
+
+   </classsynopsis>
+<!-- }}} -->
+
+  </section>
+
+ </partintro>
+
+ &reference.random.entities.random-brokenrandomengineerror;
+
+</phpdoc:classref>
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: sgml
+sgml-omittag:t
+sgml-shorttag:t
+sgml-minimize-attributes:nil
+sgml-always-quote-attributes:t
+sgml-indent-step:1
+sgml-indent-data:t
+indent-tabs-mode:nil
+sgml-parent-document:nil
+sgml-default-dtd-file:"~/.phpdoc/manual.ced"
+sgml-exposed-tags:nil
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+End:
+vim600: syn=xml fen fdm=syntax fdl=2 si
+vim: et tw=78 syn=sgml
+vi: ts=1 sw=1
+-->
diff --git a/reference/random/random.cryptosafeengine.xml b/reference/random/random.cryptosafeengine.xml
new file mode 100644
index 000000000000..a7f87ac057e5
--- /dev/null
+++ b/reference/random/random.cryptosafeengine.xml
@@ -0,0 +1,67 @@
+<?xml version="1.0" encoding="utf-8"?>
+<phpdoc:classref xml:id="class.random-cryptosafeengine" xmlns:phpdoc="http://php.net/ns/phpdoc" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
+ <title>The Random\CryptoSafeEngine interface</title>
+ <titleabbrev>Random\CryptoSafeEngine</titleabbrev>
+
+ <partintro>
+
+<!-- {{{ Random\CryptoSafeEngine intro -->
+  <section xml:id="random-cryptosafeengine.intro">
+   &reftitle.intro;
+   <para>
+
+   </para>
+  </section>
+<!-- }}} -->
+
+  <section xml:id="random-cryptosafeengine.synopsis">
+   &reftitle.classsynopsis;
+
+<!-- {{{ Synopsis -->
+   <classsynopsis>
+    <ooclass><classname>Random\CryptoSafeEngine</classname></ooclass>
+
+<!-- {{{ Class synopsis -->
+    <classsynopsisinfo>
+     <ooclass>
+      <classname>Random\CryptoSafeEngine</classname>
+     </ooclass>
+     
+     <oointerface>
+      <interfacename>Random\Engine</interfacename>
+     </oointerface>
+    </classsynopsisinfo>
+<!-- }}} -->
+    
+    <classsynopsisinfo role="comment">&Methods;</classsynopsisinfo>
+    <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.random-cryptosafeengine')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[not(@role='procedural')])"><xi:fallback/></xi:include>
+   </classsynopsis>
+<!-- }}} -->
+
+  </section>
+
+ </partintro>
+
+ &reference.random.entities.random-cryptosafeengine;
+
+</phpdoc:classref>
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: sgml
+sgml-omittag:t
+sgml-shorttag:t
+sgml-minimize-attributes:nil
+sgml-always-quote-attributes:t
+sgml-indent-step:1
+sgml-indent-data:t
+indent-tabs-mode:nil
+sgml-parent-document:nil
+sgml-default-dtd-file:"~/.phpdoc/manual.ced"
+sgml-exposed-tags:nil
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+End:
+vim600: syn=xml fen fdm=syntax fdl=2 si
+vim: et tw=78 syn=sgml
+vi: ts=1 sw=1
+-->
diff --git a/reference/random/random.engine.mt19937.xml b/reference/random/random.engine.mt19937.xml
new file mode 100644
index 000000000000..26870507a45f
--- /dev/null
+++ b/reference/random/random.engine.mt19937.xml
@@ -0,0 +1,67 @@
+<?xml version="1.0" encoding="utf-8"?>
+<phpdoc:classref xml:id="class.random-engine-mt19937" xmlns:phpdoc="http://php.net/ns/phpdoc" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
+ <title>The Random\Engine\Mt19937 class</title>
+ <titleabbrev>Random\Engine\Mt19937</titleabbrev>
+
+ <partintro>
+
+<!-- {{{ Random\Engine\Mt19937 intro -->
+  <section xml:id="random-engine-mt19937.intro">
+   &reftitle.intro;
+   <para>
+
+   </para>
+  </section>
+<!-- }}} -->
+
+  <section xml:id="random-engine-mt19937.synopsis">
+   &reftitle.classsynopsis;
+
+<!-- {{{ Synopsis -->
+   <classsynopsis>
+    <ooclass><classname>Random\Engine\Mt19937</classname></ooclass>
+
+<!-- {{{ Class synopsis -->
+    <classsynopsisinfo>
+     <ooclass>
+      <classname>Random\Engine\Mt19937</classname>
+     </ooclass>
+     
+     <oointerface>
+      <interfacename>Random\Engine</interfacename>
+     </oointerface>
+    </classsynopsisinfo>
+<!-- }}} -->
+    
+    <classsynopsisinfo role="comment">&Methods;</classsynopsisinfo>
+    <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.random-engine-mt19937')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[not(@role='procedural')])"><xi:fallback/></xi:include>
+   </classsynopsis>
+<!-- }}} -->
+
+  </section>
+
+ </partintro>
+
+ &reference.random.entities.random-engine-mt19937;
+
+</phpdoc:classref>
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: sgml
+sgml-omittag:t
+sgml-shorttag:t
+sgml-minimize-attributes:nil
+sgml-always-quote-attributes:t
+sgml-indent-step:1
+sgml-indent-data:t
+indent-tabs-mode:nil
+sgml-parent-document:nil
+sgml-default-dtd-file:"~/.phpdoc/manual.ced"
+sgml-exposed-tags:nil
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+End:
+vim600: syn=xml fen fdm=syntax fdl=2 si
+vim: et tw=78 syn=sgml
+vi: ts=1 sw=1
+-->
diff --git a/reference/random/random.engine.pcgoneseq128xslrr64.xml b/reference/random/random.engine.pcgoneseq128xslrr64.xml
new file mode 100644
index 000000000000..2a394d2de5c1
--- /dev/null
+++ b/reference/random/random.engine.pcgoneseq128xslrr64.xml
@@ -0,0 +1,67 @@
+<?xml version="1.0" encoding="utf-8"?>
+<phpdoc:classref xml:id="class.random-engine-pcgoneseq128xslrr64" xmlns:phpdoc="http://php.net/ns/phpdoc" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
+ <title>The Random\Engine\PcgOneseq128XslRr64 class</title>
+ <titleabbrev>Random\Engine\PcgOneseq128XslRr64</titleabbrev>
+
+ <partintro>
+
+<!-- {{{ Random\Engine\PcgOneseq128XslRr64 intro -->
+  <section xml:id="random-engine-pcgoneseq128xslrr64.intro">
+   &reftitle.intro;
+   <para>
+
+   </para>
+  </section>
+<!-- }}} -->
+
+  <section xml:id="random-engine-pcgoneseq128xslrr64.synopsis">
+   &reftitle.classsynopsis;
+
+<!-- {{{ Synopsis -->
+   <classsynopsis>
+    <ooclass><classname>Random\Engine\PcgOneseq128XslRr64</classname></ooclass>
+
+<!-- {{{ Class synopsis -->
+    <classsynopsisinfo>
+     <ooclass>
+      <classname>Random\Engine\PcgOneseq128XslRr64</classname>
+     </ooclass>
+     
+     <oointerface>
+      <interfacename>Random\Engine</interfacename>
+     </oointerface>
+    </classsynopsisinfo>
+<!-- }}} -->
+    
+    <classsynopsisinfo role="comment">&Methods;</classsynopsisinfo>
+    <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.random-engine-pcgoneseq128xslrr64')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[not(@role='procedural')])"><xi:fallback/></xi:include>
+   </classsynopsis>
+<!-- }}} -->
+
+  </section>
+
+ </partintro>
+
+ &reference.random.entities.random-engine-pcgoneseq128xslrr64;
+
+</phpdoc:classref>
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: sgml
+sgml-omittag:t
+sgml-shorttag:t
+sgml-minimize-attributes:nil
+sgml-always-quote-attributes:t
+sgml-indent-step:1
+sgml-indent-data:t
+indent-tabs-mode:nil
+sgml-parent-document:nil
+sgml-default-dtd-file:"~/.phpdoc/manual.ced"
+sgml-exposed-tags:nil
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+End:
+vim600: syn=xml fen fdm=syntax fdl=2 si
+vim: et tw=78 syn=sgml
+vi: ts=1 sw=1
+-->
diff --git a/reference/random/random.engine.secure.xml b/reference/random/random.engine.secure.xml
new file mode 100644
index 000000000000..c3dd9be12ed5
--- /dev/null
+++ b/reference/random/random.engine.secure.xml
@@ -0,0 +1,67 @@
+<?xml version="1.0" encoding="utf-8"?>
+<phpdoc:classref xml:id="class.random-engine-secure" xmlns:phpdoc="http://php.net/ns/phpdoc" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
+ <title>The Random\Engine\Secure class</title>
+ <titleabbrev>Random\Engine\Secure</titleabbrev>
+
+ <partintro>
+
+<!-- {{{ Random\Engine\Secure intro -->
+  <section xml:id="random-engine-secure.intro">
+   &reftitle.intro;
+   <para>
+
+   </para>
+  </section>
+<!-- }}} -->
+
+  <section xml:id="random-engine-secure.synopsis">
+   &reftitle.classsynopsis;
+
+<!-- {{{ Synopsis -->
+   <classsynopsis>
+    <ooclass><classname>Random\Engine\Secure</classname></ooclass>
+
+<!-- {{{ Class synopsis -->
+    <classsynopsisinfo>
+     <ooclass>
+      <classname>Random\Engine\Secure</classname>
+     </ooclass>
+     
+     <oointerface>
+      <interfacename>Random\CryptoSafeEngine</interfacename>
+     </oointerface>
+    </classsynopsisinfo>
+<!-- }}} -->
+    
+    <classsynopsisinfo role="comment">&Methods;</classsynopsisinfo>
+    <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.random-engine-secure')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[not(@role='procedural')])"><xi:fallback/></xi:include>
+   </classsynopsis>
+<!-- }}} -->
+
+  </section>
+
+ </partintro>
+
+ &reference.random.entities.random-engine-secure;
+
+</phpdoc:classref>
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: sgml
+sgml-omittag:t
+sgml-shorttag:t
+sgml-minimize-attributes:nil
+sgml-always-quote-attributes:t
+sgml-indent-step:1
+sgml-indent-data:t
+indent-tabs-mode:nil
+sgml-parent-document:nil
+sgml-default-dtd-file:"~/.phpdoc/manual.ced"
+sgml-exposed-tags:nil
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+End:
+vim600: syn=xml fen fdm=syntax fdl=2 si
+vim: et tw=78 syn=sgml
+vi: ts=1 sw=1
+-->
diff --git a/reference/random/random.engine.xml b/reference/random/random.engine.xml
new file mode 100644
index 000000000000..4cc7f1bfb224
--- /dev/null
+++ b/reference/random/random.engine.xml
@@ -0,0 +1,63 @@
+<?xml version="1.0" encoding="utf-8"?>
+<phpdoc:classref xml:id="class.random-engine" xmlns:phpdoc="http://php.net/ns/phpdoc" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
+ <title>The Random\Engine interface</title>
+ <titleabbrev>Random\Engine</titleabbrev>
+
+ <partintro>
+
+<!-- {{{ Random\Engine intro -->
+  <section xml:id="random-engine.intro">
+   &reftitle.intro;
+   <para>
+
+   </para>
+  </section>
+<!-- }}} -->
+
+  <section xml:id="random-engine.synopsis">
+   &reftitle.classsynopsis;
+
+<!-- {{{ Synopsis -->
+   <classsynopsis>
+    <ooclass><classname>Random\Engine</classname></ooclass>
+
+<!-- {{{ Class synopsis -->
+    <classsynopsisinfo>
+     <ooclass>
+      <classname>Random\Engine</classname>
+     </ooclass>
+    </classsynopsisinfo>
+<!-- }}} -->
+    
+    <classsynopsisinfo role="comment">&Methods;</classsynopsisinfo>
+    <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.random-engine')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[not(@role='procedural')])"><xi:fallback/></xi:include>
+   </classsynopsis>
+<!-- }}} -->
+
+  </section>
+
+ </partintro>
+
+ &reference.random.entities.random-engine;
+
+</phpdoc:classref>
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: sgml
+sgml-omittag:t
+sgml-shorttag:t
+sgml-minimize-attributes:nil
+sgml-always-quote-attributes:t
+sgml-indent-step:1
+sgml-indent-data:t
+indent-tabs-mode:nil
+sgml-parent-document:nil
+sgml-default-dtd-file:"~/.phpdoc/manual.ced"
+sgml-exposed-tags:nil
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+End:
+vim600: syn=xml fen fdm=syntax fdl=2 si
+vim: et tw=78 syn=sgml
+vi: ts=1 sw=1
+-->
diff --git a/reference/random/random.engine.xoshiro256starstar.xml b/reference/random/random.engine.xoshiro256starstar.xml
new file mode 100644
index 000000000000..d379b1d925ee
--- /dev/null
+++ b/reference/random/random.engine.xoshiro256starstar.xml
@@ -0,0 +1,67 @@
+<?xml version="1.0" encoding="utf-8"?>
+<phpdoc:classref xml:id="class.random-engine-xoshiro256starstar" xmlns:phpdoc="http://php.net/ns/phpdoc" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
+ <title>The Random\Engine\Xoshiro256StarStar class</title>
+ <titleabbrev>Random\Engine\Xoshiro256StarStar</titleabbrev>
+
+ <partintro>
+
+<!-- {{{ Random\Engine\Xoshiro256StarStar intro -->
+  <section xml:id="random-engine-xoshiro256starstar.intro">
+   &reftitle.intro;
+   <para>
+
+   </para>
+  </section>
+<!-- }}} -->
+
+  <section xml:id="random-engine-xoshiro256starstar.synopsis">
+   &reftitle.classsynopsis;
+
+<!-- {{{ Synopsis -->
+   <classsynopsis>
+    <ooclass><classname>Random\Engine\Xoshiro256StarStar</classname></ooclass>
+
+<!-- {{{ Class synopsis -->
+    <classsynopsisinfo>
+     <ooclass>
+      <classname>Random\Engine\Xoshiro256StarStar</classname>
+     </ooclass>
+     
+     <oointerface>
+      <interfacename>Random\Engine</interfacename>
+     </oointerface>
+    </classsynopsisinfo>
+<!-- }}} -->
+    
+    <classsynopsisinfo role="comment">&Methods;</classsynopsisinfo>
+    <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.random-engine-xoshiro256starstar')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[not(@role='procedural')])"><xi:fallback/></xi:include>
+   </classsynopsis>
+<!-- }}} -->
+
+  </section>
+
+ </partintro>
+
+ &reference.random.entities.random-engine-xoshiro256starstar;
+
+</phpdoc:classref>
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: sgml
+sgml-omittag:t
+sgml-shorttag:t
+sgml-minimize-attributes:nil
+sgml-always-quote-attributes:t
+sgml-indent-step:1
+sgml-indent-data:t
+indent-tabs-mode:nil
+sgml-parent-document:nil
+sgml-default-dtd-file:"~/.phpdoc/manual.ced"
+sgml-exposed-tags:nil
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+End:
+vim600: syn=xml fen fdm=syntax fdl=2 si
+vim: et tw=78 syn=sgml
+vi: ts=1 sw=1
+-->
diff --git a/reference/random/random.randomerror.xml b/reference/random/random.randomerror.xml
new file mode 100644
index 000000000000..7652360228ea
--- /dev/null
+++ b/reference/random/random.randomerror.xml
@@ -0,0 +1,79 @@
+<?xml version="1.0" encoding="utf-8"?>
+<phpdoc:classref xml:id="class.random-randomerror" xmlns:phpdoc="http://php.net/ns/phpdoc" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
+ <title>The Random\RandomError class</title>
+ <titleabbrev>Random\RandomError</titleabbrev>
+
+ <partintro>
+
+<!-- {{{ Random\RandomError intro -->
+  <section xml:id="random-randomerror.intro">
+   &reftitle.intro;
+   <para>
+
+   </para>
+  </section>
+<!-- }}} -->
+
+  <section xml:id="random-randomerror.synopsis">
+   &reftitle.classsynopsis;
+
+<!-- {{{ Synopsis -->
+   <classsynopsis>
+    <ooclass><classname>Random\RandomError</classname></ooclass>
+
+<!-- {{{ Class synopsis -->
+    <classsynopsisinfo>
+     <ooclass>
+      <classname>Random\RandomError</classname>
+     </ooclass>
+     
+     <ooclass>
+      <modifier>extends</modifier>
+      <classname>Error</classname>
+     </ooclass>
+     
+     <oointerface>
+      <interfacename>Throwable</interfacename>
+     </oointerface>
+    </classsynopsisinfo>
+<!-- }}} -->
+    <classsynopsisinfo role="comment">&InheritedProperties;</classsynopsisinfo>
+    <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('error.synopsis')/descendant::db:fieldsynopsis)"><xi:fallback/></xi:include>
+
+    
+    <classsynopsisinfo role="comment">&Methods;</classsynopsisinfo>
+    <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.random-randomerror')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[not(@role='procedural')])"><xi:fallback/></xi:include>
+    
+    <classsynopsisinfo role="comment">&InheritedMethods;</classsynopsisinfo>
+    <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.error')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[not(@role='procedural')])"><xi:fallback/></xi:include>
+
+   </classsynopsis>
+<!-- }}} -->
+
+  </section>
+
+ </partintro>
+
+ &reference.random.entities.random-randomerror;
+
+</phpdoc:classref>
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: sgml
+sgml-omittag:t
+sgml-shorttag:t
+sgml-minimize-attributes:nil
+sgml-always-quote-attributes:t
+sgml-indent-step:1
+sgml-indent-data:t
+indent-tabs-mode:nil
+sgml-parent-document:nil
+sgml-default-dtd-file:"~/.phpdoc/manual.ced"
+sgml-exposed-tags:nil
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+End:
+vim600: syn=xml fen fdm=syntax fdl=2 si
+vim: et tw=78 syn=sgml
+vi: ts=1 sw=1
+-->
diff --git a/reference/random/random.randomexception.xml b/reference/random/random.randomexception.xml
new file mode 100644
index 000000000000..8d31bcbb87c0
--- /dev/null
+++ b/reference/random/random.randomexception.xml
@@ -0,0 +1,79 @@
+<?xml version="1.0" encoding="utf-8"?>
+<phpdoc:classref xml:id="class.random-randomexception" xmlns:phpdoc="http://php.net/ns/phpdoc" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
+ <title>The Random\RandomException class</title>
+ <titleabbrev>Random\RandomException</titleabbrev>
+
+ <partintro>
+
+<!-- {{{ Random\RandomException intro -->
+  <section xml:id="random-randomexception.intro">
+   &reftitle.intro;
+   <para>
+
+   </para>
+  </section>
+<!-- }}} -->
+
+  <section xml:id="random-randomexception.synopsis">
+   &reftitle.classsynopsis;
+
+<!-- {{{ Synopsis -->
+   <classsynopsis>
+    <ooclass><classname>Random\RandomException</classname></ooclass>
+
+<!-- {{{ Class synopsis -->
+    <classsynopsisinfo>
+     <ooclass>
+      <classname>Random\RandomException</classname>
+     </ooclass>
+     
+     <ooclass>
+      <modifier>extends</modifier>
+      <classname>Exception</classname>
+     </ooclass>
+     
+     <oointerface>
+      <interfacename>Throwable</interfacename>
+     </oointerface>
+    </classsynopsisinfo>
+<!-- }}} -->
+    <classsynopsisinfo role="comment">&InheritedProperties;</classsynopsisinfo>
+    <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('exception.synopsis')/descendant::db:fieldsynopsis)"><xi:fallback/></xi:include>
+
+    
+    <classsynopsisinfo role="comment">&Methods;</classsynopsisinfo>
+    <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.random-randomexception')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[not(@role='procedural')])"><xi:fallback/></xi:include>
+    
+    <classsynopsisinfo role="comment">&InheritedMethods;</classsynopsisinfo>
+    <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.exception')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[not(@role='procedural')])"><xi:fallback/></xi:include>
+
+   </classsynopsis>
+<!-- }}} -->
+
+  </section>
+
+ </partintro>
+
+ &reference.random.entities.random-randomexception;
+
+</phpdoc:classref>
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: sgml
+sgml-omittag:t
+sgml-shorttag:t
+sgml-minimize-attributes:nil
+sgml-always-quote-attributes:t
+sgml-indent-step:1
+sgml-indent-data:t
+indent-tabs-mode:nil
+sgml-parent-document:nil
+sgml-default-dtd-file:"~/.phpdoc/manual.ced"
+sgml-exposed-tags:nil
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+End:
+vim600: syn=xml fen fdm=syntax fdl=2 si
+vim: et tw=78 syn=sgml
+vi: ts=1 sw=1
+-->
diff --git a/reference/random/random.randomizer.xml b/reference/random/random.randomizer.xml
new file mode 100644
index 000000000000..148325f6b5ab
--- /dev/null
+++ b/reference/random/random.randomizer.xml
@@ -0,0 +1,85 @@
+<?xml version="1.0" encoding="utf-8"?>
+<phpdoc:classref xml:id="class.random-randomizer" xmlns:phpdoc="http://php.net/ns/phpdoc" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
+ <title>The Random\Randomizer class</title>
+ <titleabbrev>Random\Randomizer</titleabbrev>
+
+ <partintro>
+
+<!-- {{{ Random\Randomizer intro -->
+  <section xml:id="random-randomizer.intro">
+   &reftitle.intro;
+   <para>
+
+   </para>
+  </section>
+<!-- }}} -->
+
+  <section xml:id="random-randomizer.synopsis">
+   &reftitle.classsynopsis;
+
+<!-- {{{ Synopsis -->
+   <classsynopsis>
+    <ooclass><classname>Random\Randomizer</classname></ooclass>
+
+<!-- {{{ Class synopsis -->
+    <classsynopsisinfo>
+     <ooclass>
+      <classname>Random\Randomizer</classname>
+     </ooclass>
+    </classsynopsisinfo>
+<!-- }}} -->
+    <classsynopsisinfo role="comment">&Properties;</classsynopsisinfo>
+    <fieldsynopsis>
+     <modifier>Engine</modifier>
+     <varname linkend="random-randomizer.props.engine">engine</varname>
+    </fieldsynopsis>
+
+    
+    <classsynopsisinfo role="comment">&Methods;</classsynopsisinfo>
+    <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.random-randomizer')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[not(@role='procedural')])"><xi:fallback/></xi:include>
+   </classsynopsis>
+<!-- }}} -->
+
+  </section>
+
+  
+<!-- {{{ Random\Randomizer properties -->
+  <section xml:id="random-randomizer.props">
+   &reftitle.properties;
+   <variablelist>
+    <varlistentry xml:id="random-randomizer.props.engine">
+     <term><varname>engine</varname></term>
+     <listitem>
+      <para></para>
+     </listitem>
+    </varlistentry>
+   </variablelist>
+  </section>
+<!-- }}} -->
+
+
+ </partintro>
+
+ &reference.random.entities.random-randomizer;
+
+</phpdoc:classref>
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: sgml
+sgml-omittag:t
+sgml-shorttag:t
+sgml-minimize-attributes:nil
+sgml-always-quote-attributes:t
+sgml-indent-step:1
+sgml-indent-data:t
+indent-tabs-mode:nil
+sgml-parent-document:nil
+sgml-default-dtd-file:"~/.phpdoc/manual.ced"
+sgml-exposed-tags:nil
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+End:
+vim600: syn=xml fen fdm=syntax fdl=2 si
+vim: et tw=78 syn=sgml
+vi: ts=1 sw=1
+-->
diff --git a/reference/random/random/engine/generate.xml b/reference/random/random/engine/generate.xml
new file mode 100644
index 000000000000..fe2becf39617
--- /dev/null
+++ b/reference/random/random/engine/generate.xml
@@ -0,0 +1,77 @@
+<?xml version="1.0" encoding="utf-8"?>
+<refentry xml:id="random-engine.generate" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
+ <refnamediv>
+  <refname>Random\Engine::generate</refname>
+  <refpurpose>Description</refpurpose>
+ </refnamediv>
+
+ <refsect1 role="description">
+  &reftitle.description;
+  <methodsynopsis>
+   <modifier>abstract</modifier> <modifier>public</modifier> <type>string</type><methodname>Random\Engine::generate</methodname>
+   <void />
+  </methodsynopsis>
+  <para>
+
+  </para>
+
+  &warn.undocumented.func;
+
+ </refsect1>
+
+ <refsect1 role="parameters">
+  &reftitle.parameters;
+  &no.function.parameters;
+ </refsect1>
+
+ <refsect1 role="returnvalues">
+  &reftitle.returnvalues;
+  <para>
+   
+  </para>
+ </refsect1>
+
+ <refsect1 role="examples">
+  &reftitle.examples;
+  <example>
+   <title><function>Random\Engine::generate</function> example</title>
+   <programlisting role="php">
+<![CDATA[
+<?php
+
+/* ... */
+
+?>
+]]>
+   </programlisting>
+   &example.outputs.similar;
+   <screen>
+<![CDATA[
+...
+]]>
+   </screen>
+  </example>
+ </refsect1>
+
+
+</refentry>
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: sgml
+sgml-omittag:t
+sgml-shorttag:t
+sgml-minimize-attributes:nil
+sgml-always-quote-attributes:t
+sgml-indent-step:1
+sgml-indent-data:t
+indent-tabs-mode:nil
+sgml-parent-document:nil
+sgml-default-dtd-file:"~/.phpdoc/manual.ced"
+sgml-exposed-tags:nil
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+End:
+vim600: syn=xml fen fdm=syntax fdl=2 si
+vim: et tw=78 syn=sgml
+vi: ts=1 sw=1
+-->
diff --git a/reference/random/random/engine/mt19937/construct.xml b/reference/random/random/engine/mt19937/construct.xml
new file mode 100644
index 000000000000..2a8afe1f5210
--- /dev/null
+++ b/reference/random/random/engine/mt19937/construct.xml
@@ -0,0 +1,100 @@
+<?xml version="1.0" encoding="utf-8"?>
+<refentry xml:id="random-engine-mt19937.construct" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
+ <refnamediv>
+  <refname>Random\Engine\Mt19937::__construct</refname>
+  <refpurpose>Description</refpurpose>
+ </refnamediv>
+
+ <refsect1 role="description">
+  &reftitle.description;
+  <constructorsynopsis>
+   <modifier>public</modifier> <methodname>Random\Engine\Mt19937::__construct</methodname>
+   <methodparam choice="opt"><type class="union"><type>int</type><type>null</type></type><parameter>seed</parameter></methodparam>
+   <methodparam choice="opt"><type>int</type><parameter>mode</parameter></methodparam>
+  </constructorsynopsis>
+  <para>
+
+  </para>
+
+  &warn.undocumented.func;
+
+ </refsect1>
+
+ <refsect1 role="parameters">
+  &reftitle.parameters;
+  <variablelist>
+   <varlistentry>
+    <term><parameter>seed</parameter></term>
+    <listitem>
+     <para>
+      
+     </para>
+    </listitem>
+   </varlistentry>
+   <varlistentry>
+    <term><parameter>mode</parameter></term>
+    <listitem>
+     <para>
+      
+     </para>
+    </listitem>
+   </varlistentry>
+  </variablelist>
+ </refsect1>
+
+ <!-- Return values commented out, as constructors generally don't return a
+      value. Uncomment this if you do need a return values section (for
+      example, because there's also a procedural version of the method).
+ <refsect1 role="returnvalues">
+  &reftitle.returnvalues;
+  <para>
+   
+  </para>
+ </refsect1>
+ -->
+
+
+ <refsect1 role="examples">
+  &reftitle.examples;
+  <example>
+   <title><function>Random\Engine\Mt19937::__construct</function> example</title>
+   <programlisting role="php">
+<![CDATA[
+<?php
+
+/* ... */
+
+?>
+]]>
+   </programlisting>
+   &example.outputs.similar;
+   <screen>
+<![CDATA[
+...
+]]>
+   </screen>
+  </example>
+ </refsect1>
+
+
+</refentry>
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: sgml
+sgml-omittag:t
+sgml-shorttag:t
+sgml-minimize-attributes:nil
+sgml-always-quote-attributes:t
+sgml-indent-step:1
+sgml-indent-data:t
+indent-tabs-mode:nil
+sgml-parent-document:nil
+sgml-default-dtd-file:"~/.phpdoc/manual.ced"
+sgml-exposed-tags:nil
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+End:
+vim600: syn=xml fen fdm=syntax fdl=2 si
+vim: et tw=78 syn=sgml
+vi: ts=1 sw=1
+-->
diff --git a/reference/random/random/engine/mt19937/debuginfo.xml b/reference/random/random/engine/mt19937/debuginfo.xml
new file mode 100644
index 000000000000..8150f15d8374
--- /dev/null
+++ b/reference/random/random/engine/mt19937/debuginfo.xml
@@ -0,0 +1,77 @@
+<?xml version="1.0" encoding="utf-8"?>
+<refentry xml:id="random-engine-mt19937.debuginfo" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
+ <refnamediv>
+  <refname>Random\Engine\Mt19937::__debugInfo</refname>
+  <refpurpose>Description</refpurpose>
+ </refnamediv>
+
+ <refsect1 role="description">
+  &reftitle.description;
+  <methodsynopsis>
+   <modifier>public</modifier> <type>array</type><methodname>Random\Engine\Mt19937::__debugInfo</methodname>
+   <void />
+  </methodsynopsis>
+  <para>
+
+  </para>
+
+  &warn.undocumented.func;
+
+ </refsect1>
+
+ <refsect1 role="parameters">
+  &reftitle.parameters;
+  &no.function.parameters;
+ </refsect1>
+
+ <refsect1 role="returnvalues">
+  &reftitle.returnvalues;
+  <para>
+   
+  </para>
+ </refsect1>
+
+ <refsect1 role="examples">
+  &reftitle.examples;
+  <example>
+   <title><function>Random\Engine\Mt19937::__debugInfo</function> example</title>
+   <programlisting role="php">
+<![CDATA[
+<?php
+
+/* ... */
+
+?>
+]]>
+   </programlisting>
+   &example.outputs.similar;
+   <screen>
+<![CDATA[
+...
+]]>
+   </screen>
+  </example>
+ </refsect1>
+
+
+</refentry>
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: sgml
+sgml-omittag:t
+sgml-shorttag:t
+sgml-minimize-attributes:nil
+sgml-always-quote-attributes:t
+sgml-indent-step:1
+sgml-indent-data:t
+indent-tabs-mode:nil
+sgml-parent-document:nil
+sgml-default-dtd-file:"~/.phpdoc/manual.ced"
+sgml-exposed-tags:nil
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+End:
+vim600: syn=xml fen fdm=syntax fdl=2 si
+vim: et tw=78 syn=sgml
+vi: ts=1 sw=1
+-->
diff --git a/reference/random/random/engine/mt19937/generate.xml b/reference/random/random/engine/mt19937/generate.xml
new file mode 100644
index 000000000000..605af07798f1
--- /dev/null
+++ b/reference/random/random/engine/mt19937/generate.xml
@@ -0,0 +1,77 @@
+<?xml version="1.0" encoding="utf-8"?>
+<refentry xml:id="random-engine-mt19937.generate" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
+ <refnamediv>
+  <refname>Random\Engine\Mt19937::generate</refname>
+  <refpurpose>Description</refpurpose>
+ </refnamediv>
+
+ <refsect1 role="description">
+  &reftitle.description;
+  <methodsynopsis>
+   <modifier>public</modifier> <type>string</type><methodname>Random\Engine\Mt19937::generate</methodname>
+   <void />
+  </methodsynopsis>
+  <para>
+
+  </para>
+
+  &warn.undocumented.func;
+
+ </refsect1>
+
+ <refsect1 role="parameters">
+  &reftitle.parameters;
+  &no.function.parameters;
+ </refsect1>
+
+ <refsect1 role="returnvalues">
+  &reftitle.returnvalues;
+  <para>
+   
+  </para>
+ </refsect1>
+
+ <refsect1 role="examples">
+  &reftitle.examples;
+  <example>
+   <title><function>Random\Engine\Mt19937::generate</function> example</title>
+   <programlisting role="php">
+<![CDATA[
+<?php
+
+/* ... */
+
+?>
+]]>
+   </programlisting>
+   &example.outputs.similar;
+   <screen>
+<![CDATA[
+...
+]]>
+   </screen>
+  </example>
+ </refsect1>
+
+
+</refentry>
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: sgml
+sgml-omittag:t
+sgml-shorttag:t
+sgml-minimize-attributes:nil
+sgml-always-quote-attributes:t
+sgml-indent-step:1
+sgml-indent-data:t
+indent-tabs-mode:nil
+sgml-parent-document:nil
+sgml-default-dtd-file:"~/.phpdoc/manual.ced"
+sgml-exposed-tags:nil
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+End:
+vim600: syn=xml fen fdm=syntax fdl=2 si
+vim: et tw=78 syn=sgml
+vi: ts=1 sw=1
+-->
diff --git a/reference/random/random/engine/mt19937/serialize.xml b/reference/random/random/engine/mt19937/serialize.xml
new file mode 100644
index 000000000000..42ff90744802
--- /dev/null
+++ b/reference/random/random/engine/mt19937/serialize.xml
@@ -0,0 +1,77 @@
+<?xml version="1.0" encoding="utf-8"?>
+<refentry xml:id="random-engine-mt19937.serialize" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
+ <refnamediv>
+  <refname>Random\Engine\Mt19937::__serialize</refname>
+  <refpurpose>Description</refpurpose>
+ </refnamediv>
+
+ <refsect1 role="description">
+  &reftitle.description;
+  <methodsynopsis>
+   <modifier>public</modifier> <type>array</type><methodname>Random\Engine\Mt19937::__serialize</methodname>
+   <void />
+  </methodsynopsis>
+  <para>
+
+  </para>
+
+  &warn.undocumented.func;
+
+ </refsect1>
+
+ <refsect1 role="parameters">
+  &reftitle.parameters;
+  &no.function.parameters;
+ </refsect1>
+
+ <refsect1 role="returnvalues">
+  &reftitle.returnvalues;
+  <para>
+   
+  </para>
+ </refsect1>
+
+ <refsect1 role="examples">
+  &reftitle.examples;
+  <example>
+   <title><function>Random\Engine\Mt19937::__serialize</function> example</title>
+   <programlisting role="php">
+<![CDATA[
+<?php
+
+/* ... */
+
+?>
+]]>
+   </programlisting>
+   &example.outputs.similar;
+   <screen>
+<![CDATA[
+...
+]]>
+   </screen>
+  </example>
+ </refsect1>
+
+
+</refentry>
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: sgml
+sgml-omittag:t
+sgml-shorttag:t
+sgml-minimize-attributes:nil
+sgml-always-quote-attributes:t
+sgml-indent-step:1
+sgml-indent-data:t
+indent-tabs-mode:nil
+sgml-parent-document:nil
+sgml-default-dtd-file:"~/.phpdoc/manual.ced"
+sgml-exposed-tags:nil
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+End:
+vim600: syn=xml fen fdm=syntax fdl=2 si
+vim: et tw=78 syn=sgml
+vi: ts=1 sw=1
+-->
diff --git a/reference/random/random/engine/mt19937/unserialize.xml b/reference/random/random/engine/mt19937/unserialize.xml
new file mode 100644
index 000000000000..116f25b238c8
--- /dev/null
+++ b/reference/random/random/engine/mt19937/unserialize.xml
@@ -0,0 +1,86 @@
+<?xml version="1.0" encoding="utf-8"?>
+<refentry xml:id="random-engine-mt19937.unserialize" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
+ <refnamediv>
+  <refname>Random\Engine\Mt19937::__unserialize</refname>
+  <refpurpose>Description</refpurpose>
+ </refnamediv>
+
+ <refsect1 role="description">
+  &reftitle.description;
+  <methodsynopsis>
+   <modifier>public</modifier> <type>void</type><methodname>Random\Engine\Mt19937::__unserialize</methodname>
+   <methodparam><type>array</type><parameter>data</parameter></methodparam>
+  </methodsynopsis>
+  <para>
+
+  </para>
+
+  &warn.undocumented.func;
+
+ </refsect1>
+
+ <refsect1 role="parameters">
+  &reftitle.parameters;
+  <variablelist>
+   <varlistentry>
+    <term><parameter>data</parameter></term>
+    <listitem>
+     <para>
+      
+     </para>
+    </listitem>
+   </varlistentry>
+  </variablelist>
+ </refsect1>
+
+ <refsect1 role="returnvalues">
+  &reftitle.returnvalues;
+  <para>
+   
+  </para>
+ </refsect1>
+
+ <refsect1 role="examples">
+  &reftitle.examples;
+  <example>
+   <title><function>Random\Engine\Mt19937::__unserialize</function> example</title>
+   <programlisting role="php">
+<![CDATA[
+<?php
+
+/* ... */
+
+?>
+]]>
+   </programlisting>
+   &example.outputs.similar;
+   <screen>
+<![CDATA[
+...
+]]>
+   </screen>
+  </example>
+ </refsect1>
+
+
+</refentry>
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: sgml
+sgml-omittag:t
+sgml-shorttag:t
+sgml-minimize-attributes:nil
+sgml-always-quote-attributes:t
+sgml-indent-step:1
+sgml-indent-data:t
+indent-tabs-mode:nil
+sgml-parent-document:nil
+sgml-default-dtd-file:"~/.phpdoc/manual.ced"
+sgml-exposed-tags:nil
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+End:
+vim600: syn=xml fen fdm=syntax fdl=2 si
+vim: et tw=78 syn=sgml
+vi: ts=1 sw=1
+-->
diff --git a/reference/random/random/engine/pcgoneseq128xslrr64/construct.xml b/reference/random/random/engine/pcgoneseq128xslrr64/construct.xml
new file mode 100644
index 000000000000..93d26670cef4
--- /dev/null
+++ b/reference/random/random/engine/pcgoneseq128xslrr64/construct.xml
@@ -0,0 +1,91 @@
+<?xml version="1.0" encoding="utf-8"?>
+<refentry xml:id="random-engine-pcgoneseq128xslrr64.construct" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
+ <refnamediv>
+  <refname>Random\Engine\PcgOneseq128XslRr64::__construct</refname>
+  <refpurpose>Description</refpurpose>
+ </refnamediv>
+
+ <refsect1 role="description">
+  &reftitle.description;
+  <constructorsynopsis>
+   <modifier>public</modifier> <methodname>Random\Engine\PcgOneseq128XslRr64::__construct</methodname>
+   <methodparam choice="opt"><type class="union"><type>string</type><type>int</type><type>null</type></type><parameter>seed</parameter></methodparam>
+  </constructorsynopsis>
+  <para>
+
+  </para>
+
+  &warn.undocumented.func;
+
+ </refsect1>
+
+ <refsect1 role="parameters">
+  &reftitle.parameters;
+  <variablelist>
+   <varlistentry>
+    <term><parameter>seed</parameter></term>
+    <listitem>
+     <para>
+      
+     </para>
+    </listitem>
+   </varlistentry>
+  </variablelist>
+ </refsect1>
+
+ <!-- Return values commented out, as constructors generally don't return a
+      value. Uncomment this if you do need a return values section (for
+      example, because there's also a procedural version of the method).
+ <refsect1 role="returnvalues">
+  &reftitle.returnvalues;
+  <para>
+   
+  </para>
+ </refsect1>
+ -->
+
+
+ <refsect1 role="examples">
+  &reftitle.examples;
+  <example>
+   <title><function>Random\Engine\PcgOneseq128XslRr64::__construct</function> example</title>
+   <programlisting role="php">
+<![CDATA[
+<?php
+
+/* ... */
+
+?>
+]]>
+   </programlisting>
+   &example.outputs.similar;
+   <screen>
+<![CDATA[
+...
+]]>
+   </screen>
+  </example>
+ </refsect1>
+
+
+</refentry>
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: sgml
+sgml-omittag:t
+sgml-shorttag:t
+sgml-minimize-attributes:nil
+sgml-always-quote-attributes:t
+sgml-indent-step:1
+sgml-indent-data:t
+indent-tabs-mode:nil
+sgml-parent-document:nil
+sgml-default-dtd-file:"~/.phpdoc/manual.ced"
+sgml-exposed-tags:nil
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+End:
+vim600: syn=xml fen fdm=syntax fdl=2 si
+vim: et tw=78 syn=sgml
+vi: ts=1 sw=1
+-->
diff --git a/reference/random/random/engine/pcgoneseq128xslrr64/debuginfo.xml b/reference/random/random/engine/pcgoneseq128xslrr64/debuginfo.xml
new file mode 100644
index 000000000000..b5bb5ffa50a8
--- /dev/null
+++ b/reference/random/random/engine/pcgoneseq128xslrr64/debuginfo.xml
@@ -0,0 +1,77 @@
+<?xml version="1.0" encoding="utf-8"?>
+<refentry xml:id="random-engine-pcgoneseq128xslrr64.debuginfo" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
+ <refnamediv>
+  <refname>Random\Engine\PcgOneseq128XslRr64::__debugInfo</refname>
+  <refpurpose>Description</refpurpose>
+ </refnamediv>
+
+ <refsect1 role="description">
+  &reftitle.description;
+  <methodsynopsis>
+   <modifier>public</modifier> <type>array</type><methodname>Random\Engine\PcgOneseq128XslRr64::__debugInfo</methodname>
+   <void />
+  </methodsynopsis>
+  <para>
+
+  </para>
+
+  &warn.undocumented.func;
+
+ </refsect1>
+
+ <refsect1 role="parameters">
+  &reftitle.parameters;
+  &no.function.parameters;
+ </refsect1>
+
+ <refsect1 role="returnvalues">
+  &reftitle.returnvalues;
+  <para>
+   
+  </para>
+ </refsect1>
+
+ <refsect1 role="examples">
+  &reftitle.examples;
+  <example>
+   <title><function>Random\Engine\PcgOneseq128XslRr64::__debugInfo</function> example</title>
+   <programlisting role="php">
+<![CDATA[
+<?php
+
+/* ... */
+
+?>
+]]>
+   </programlisting>
+   &example.outputs.similar;
+   <screen>
+<![CDATA[
+...
+]]>
+   </screen>
+  </example>
+ </refsect1>
+
+
+</refentry>
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: sgml
+sgml-omittag:t
+sgml-shorttag:t
+sgml-minimize-attributes:nil
+sgml-always-quote-attributes:t
+sgml-indent-step:1
+sgml-indent-data:t
+indent-tabs-mode:nil
+sgml-parent-document:nil
+sgml-default-dtd-file:"~/.phpdoc/manual.ced"
+sgml-exposed-tags:nil
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+End:
+vim600: syn=xml fen fdm=syntax fdl=2 si
+vim: et tw=78 syn=sgml
+vi: ts=1 sw=1
+-->
diff --git a/reference/random/random/engine/pcgoneseq128xslrr64/generate.xml b/reference/random/random/engine/pcgoneseq128xslrr64/generate.xml
new file mode 100644
index 000000000000..6a10fa0963e2
--- /dev/null
+++ b/reference/random/random/engine/pcgoneseq128xslrr64/generate.xml
@@ -0,0 +1,77 @@
+<?xml version="1.0" encoding="utf-8"?>
+<refentry xml:id="random-engine-pcgoneseq128xslrr64.generate" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
+ <refnamediv>
+  <refname>Random\Engine\PcgOneseq128XslRr64::generate</refname>
+  <refpurpose>Description</refpurpose>
+ </refnamediv>
+
+ <refsect1 role="description">
+  &reftitle.description;
+  <methodsynopsis>
+   <modifier>public</modifier> <type>string</type><methodname>Random\Engine\PcgOneseq128XslRr64::generate</methodname>
+   <void />
+  </methodsynopsis>
+  <para>
+
+  </para>
+
+  &warn.undocumented.func;
+
+ </refsect1>
+
+ <refsect1 role="parameters">
+  &reftitle.parameters;
+  &no.function.parameters;
+ </refsect1>
+
+ <refsect1 role="returnvalues">
+  &reftitle.returnvalues;
+  <para>
+   
+  </para>
+ </refsect1>
+
+ <refsect1 role="examples">
+  &reftitle.examples;
+  <example>
+   <title><function>Random\Engine\PcgOneseq128XslRr64::generate</function> example</title>
+   <programlisting role="php">
+<![CDATA[
+<?php
+
+/* ... */
+
+?>
+]]>
+   </programlisting>
+   &example.outputs.similar;
+   <screen>
+<![CDATA[
+...
+]]>
+   </screen>
+  </example>
+ </refsect1>
+
+
+</refentry>
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: sgml
+sgml-omittag:t
+sgml-shorttag:t
+sgml-minimize-attributes:nil
+sgml-always-quote-attributes:t
+sgml-indent-step:1
+sgml-indent-data:t
+indent-tabs-mode:nil
+sgml-parent-document:nil
+sgml-default-dtd-file:"~/.phpdoc/manual.ced"
+sgml-exposed-tags:nil
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+End:
+vim600: syn=xml fen fdm=syntax fdl=2 si
+vim: et tw=78 syn=sgml
+vi: ts=1 sw=1
+-->
diff --git a/reference/random/random/engine/pcgoneseq128xslrr64/jump.xml b/reference/random/random/engine/pcgoneseq128xslrr64/jump.xml
new file mode 100644
index 000000000000..4e906719fbc0
--- /dev/null
+++ b/reference/random/random/engine/pcgoneseq128xslrr64/jump.xml
@@ -0,0 +1,86 @@
+<?xml version="1.0" encoding="utf-8"?>
+<refentry xml:id="random-engine-pcgoneseq128xslrr64.jump" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
+ <refnamediv>
+  <refname>Random\Engine\PcgOneseq128XslRr64::jump</refname>
+  <refpurpose>Description</refpurpose>
+ </refnamediv>
+
+ <refsect1 role="description">
+  &reftitle.description;
+  <methodsynopsis>
+   <modifier>public</modifier> <type>void</type><methodname>Random\Engine\PcgOneseq128XslRr64::jump</methodname>
+   <methodparam><type>int</type><parameter>advance</parameter></methodparam>
+  </methodsynopsis>
+  <para>
+
+  </para>
+
+  &warn.undocumented.func;
+
+ </refsect1>
+
+ <refsect1 role="parameters">
+  &reftitle.parameters;
+  <variablelist>
+   <varlistentry>
+    <term><parameter>advance</parameter></term>
+    <listitem>
+     <para>
+      
+     </para>
+    </listitem>
+   </varlistentry>
+  </variablelist>
+ </refsect1>
+
+ <refsect1 role="returnvalues">
+  &reftitle.returnvalues;
+  <para>
+   
+  </para>
+ </refsect1>
+
+ <refsect1 role="examples">
+  &reftitle.examples;
+  <example>
+   <title><function>Random\Engine\PcgOneseq128XslRr64::jump</function> example</title>
+   <programlisting role="php">
+<![CDATA[
+<?php
+
+/* ... */
+
+?>
+]]>
+   </programlisting>
+   &example.outputs.similar;
+   <screen>
+<![CDATA[
+...
+]]>
+   </screen>
+  </example>
+ </refsect1>
+
+
+</refentry>
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: sgml
+sgml-omittag:t
+sgml-shorttag:t
+sgml-minimize-attributes:nil
+sgml-always-quote-attributes:t
+sgml-indent-step:1
+sgml-indent-data:t
+indent-tabs-mode:nil
+sgml-parent-document:nil
+sgml-default-dtd-file:"~/.phpdoc/manual.ced"
+sgml-exposed-tags:nil
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+End:
+vim600: syn=xml fen fdm=syntax fdl=2 si
+vim: et tw=78 syn=sgml
+vi: ts=1 sw=1
+-->
diff --git a/reference/random/random/engine/pcgoneseq128xslrr64/serialize.xml b/reference/random/random/engine/pcgoneseq128xslrr64/serialize.xml
new file mode 100644
index 000000000000..69f19838d92d
--- /dev/null
+++ b/reference/random/random/engine/pcgoneseq128xslrr64/serialize.xml
@@ -0,0 +1,77 @@
+<?xml version="1.0" encoding="utf-8"?>
+<refentry xml:id="random-engine-pcgoneseq128xslrr64.serialize" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
+ <refnamediv>
+  <refname>Random\Engine\PcgOneseq128XslRr64::__serialize</refname>
+  <refpurpose>Description</refpurpose>
+ </refnamediv>
+
+ <refsect1 role="description">
+  &reftitle.description;
+  <methodsynopsis>
+   <modifier>public</modifier> <type>array</type><methodname>Random\Engine\PcgOneseq128XslRr64::__serialize</methodname>
+   <void />
+  </methodsynopsis>
+  <para>
+
+  </para>
+
+  &warn.undocumented.func;
+
+ </refsect1>
+
+ <refsect1 role="parameters">
+  &reftitle.parameters;
+  &no.function.parameters;
+ </refsect1>
+
+ <refsect1 role="returnvalues">
+  &reftitle.returnvalues;
+  <para>
+   
+  </para>
+ </refsect1>
+
+ <refsect1 role="examples">
+  &reftitle.examples;
+  <example>
+   <title><function>Random\Engine\PcgOneseq128XslRr64::__serialize</function> example</title>
+   <programlisting role="php">
+<![CDATA[
+<?php
+
+/* ... */
+
+?>
+]]>
+   </programlisting>
+   &example.outputs.similar;
+   <screen>
+<![CDATA[
+...
+]]>
+   </screen>
+  </example>
+ </refsect1>
+
+
+</refentry>
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: sgml
+sgml-omittag:t
+sgml-shorttag:t
+sgml-minimize-attributes:nil
+sgml-always-quote-attributes:t
+sgml-indent-step:1
+sgml-indent-data:t
+indent-tabs-mode:nil
+sgml-parent-document:nil
+sgml-default-dtd-file:"~/.phpdoc/manual.ced"
+sgml-exposed-tags:nil
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+End:
+vim600: syn=xml fen fdm=syntax fdl=2 si
+vim: et tw=78 syn=sgml
+vi: ts=1 sw=1
+-->
diff --git a/reference/random/random/engine/pcgoneseq128xslrr64/unserialize.xml b/reference/random/random/engine/pcgoneseq128xslrr64/unserialize.xml
new file mode 100644
index 000000000000..fd62e98203a7
--- /dev/null
+++ b/reference/random/random/engine/pcgoneseq128xslrr64/unserialize.xml
@@ -0,0 +1,86 @@
+<?xml version="1.0" encoding="utf-8"?>
+<refentry xml:id="random-engine-pcgoneseq128xslrr64.unserialize" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
+ <refnamediv>
+  <refname>Random\Engine\PcgOneseq128XslRr64::__unserialize</refname>
+  <refpurpose>Description</refpurpose>
+ </refnamediv>
+
+ <refsect1 role="description">
+  &reftitle.description;
+  <methodsynopsis>
+   <modifier>public</modifier> <type>void</type><methodname>Random\Engine\PcgOneseq128XslRr64::__unserialize</methodname>
+   <methodparam><type>array</type><parameter>data</parameter></methodparam>
+  </methodsynopsis>
+  <para>
+
+  </para>
+
+  &warn.undocumented.func;
+
+ </refsect1>
+
+ <refsect1 role="parameters">
+  &reftitle.parameters;
+  <variablelist>
+   <varlistentry>
+    <term><parameter>data</parameter></term>
+    <listitem>
+     <para>
+      
+     </para>
+    </listitem>
+   </varlistentry>
+  </variablelist>
+ </refsect1>
+
+ <refsect1 role="returnvalues">
+  &reftitle.returnvalues;
+  <para>
+   
+  </para>
+ </refsect1>
+
+ <refsect1 role="examples">
+  &reftitle.examples;
+  <example>
+   <title><function>Random\Engine\PcgOneseq128XslRr64::__unserialize</function> example</title>
+   <programlisting role="php">
+<![CDATA[
+<?php
+
+/* ... */
+
+?>
+]]>
+   </programlisting>
+   &example.outputs.similar;
+   <screen>
+<![CDATA[
+...
+]]>
+   </screen>
+  </example>
+ </refsect1>
+
+
+</refentry>
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: sgml
+sgml-omittag:t
+sgml-shorttag:t
+sgml-minimize-attributes:nil
+sgml-always-quote-attributes:t
+sgml-indent-step:1
+sgml-indent-data:t
+indent-tabs-mode:nil
+sgml-parent-document:nil
+sgml-default-dtd-file:"~/.phpdoc/manual.ced"
+sgml-exposed-tags:nil
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+End:
+vim600: syn=xml fen fdm=syntax fdl=2 si
+vim: et tw=78 syn=sgml
+vi: ts=1 sw=1
+-->
diff --git a/reference/random/random/engine/secure/generate.xml b/reference/random/random/engine/secure/generate.xml
new file mode 100644
index 000000000000..c046b3348552
--- /dev/null
+++ b/reference/random/random/engine/secure/generate.xml
@@ -0,0 +1,77 @@
+<?xml version="1.0" encoding="utf-8"?>
+<refentry xml:id="random-engine-secure.generate" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
+ <refnamediv>
+  <refname>Random\Engine\Secure::generate</refname>
+  <refpurpose>Description</refpurpose>
+ </refnamediv>
+
+ <refsect1 role="description">
+  &reftitle.description;
+  <methodsynopsis>
+   <modifier>public</modifier> <type>string</type><methodname>Random\Engine\Secure::generate</methodname>
+   <void />
+  </methodsynopsis>
+  <para>
+
+  </para>
+
+  &warn.undocumented.func;
+
+ </refsect1>
+
+ <refsect1 role="parameters">
+  &reftitle.parameters;
+  &no.function.parameters;
+ </refsect1>
+
+ <refsect1 role="returnvalues">
+  &reftitle.returnvalues;
+  <para>
+   
+  </para>
+ </refsect1>
+
+ <refsect1 role="examples">
+  &reftitle.examples;
+  <example>
+   <title><function>Random\Engine\Secure::generate</function> example</title>
+   <programlisting role="php">
+<![CDATA[
+<?php
+
+/* ... */
+
+?>
+]]>
+   </programlisting>
+   &example.outputs.similar;
+   <screen>
+<![CDATA[
+...
+]]>
+   </screen>
+  </example>
+ </refsect1>
+
+
+</refentry>
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: sgml
+sgml-omittag:t
+sgml-shorttag:t
+sgml-minimize-attributes:nil
+sgml-always-quote-attributes:t
+sgml-indent-step:1
+sgml-indent-data:t
+indent-tabs-mode:nil
+sgml-parent-document:nil
+sgml-default-dtd-file:"~/.phpdoc/manual.ced"
+sgml-exposed-tags:nil
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+End:
+vim600: syn=xml fen fdm=syntax fdl=2 si
+vim: et tw=78 syn=sgml
+vi: ts=1 sw=1
+-->
diff --git a/reference/random/random/engine/xoshiro256starstar/construct.xml b/reference/random/random/engine/xoshiro256starstar/construct.xml
new file mode 100644
index 000000000000..c02f1c98fa3f
--- /dev/null
+++ b/reference/random/random/engine/xoshiro256starstar/construct.xml
@@ -0,0 +1,91 @@
+<?xml version="1.0" encoding="utf-8"?>
+<refentry xml:id="random-engine-xoshiro256starstar.construct" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
+ <refnamediv>
+  <refname>Random\Engine\Xoshiro256StarStar::__construct</refname>
+  <refpurpose>Description</refpurpose>
+ </refnamediv>
+
+ <refsect1 role="description">
+  &reftitle.description;
+  <constructorsynopsis>
+   <modifier>public</modifier> <methodname>Random\Engine\Xoshiro256StarStar::__construct</methodname>
+   <methodparam choice="opt"><type class="union"><type>string</type><type>int</type><type>null</type></type><parameter>seed</parameter></methodparam>
+  </constructorsynopsis>
+  <para>
+
+  </para>
+
+  &warn.undocumented.func;
+
+ </refsect1>
+
+ <refsect1 role="parameters">
+  &reftitle.parameters;
+  <variablelist>
+   <varlistentry>
+    <term><parameter>seed</parameter></term>
+    <listitem>
+     <para>
+      
+     </para>
+    </listitem>
+   </varlistentry>
+  </variablelist>
+ </refsect1>
+
+ <!-- Return values commented out, as constructors generally don't return a
+      value. Uncomment this if you do need a return values section (for
+      example, because there's also a procedural version of the method).
+ <refsect1 role="returnvalues">
+  &reftitle.returnvalues;
+  <para>
+   
+  </para>
+ </refsect1>
+ -->
+
+
+ <refsect1 role="examples">
+  &reftitle.examples;
+  <example>
+   <title><function>Random\Engine\Xoshiro256StarStar::__construct</function> example</title>
+   <programlisting role="php">
+<![CDATA[
+<?php
+
+/* ... */
+
+?>
+]]>
+   </programlisting>
+   &example.outputs.similar;
+   <screen>
+<![CDATA[
+...
+]]>
+   </screen>
+  </example>
+ </refsect1>
+
+
+</refentry>
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: sgml
+sgml-omittag:t
+sgml-shorttag:t
+sgml-minimize-attributes:nil
+sgml-always-quote-attributes:t
+sgml-indent-step:1
+sgml-indent-data:t
+indent-tabs-mode:nil
+sgml-parent-document:nil
+sgml-default-dtd-file:"~/.phpdoc/manual.ced"
+sgml-exposed-tags:nil
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+End:
+vim600: syn=xml fen fdm=syntax fdl=2 si
+vim: et tw=78 syn=sgml
+vi: ts=1 sw=1
+-->
diff --git a/reference/random/random/engine/xoshiro256starstar/debuginfo.xml b/reference/random/random/engine/xoshiro256starstar/debuginfo.xml
new file mode 100644
index 000000000000..59030a2e9b5c
--- /dev/null
+++ b/reference/random/random/engine/xoshiro256starstar/debuginfo.xml
@@ -0,0 +1,77 @@
+<?xml version="1.0" encoding="utf-8"?>
+<refentry xml:id="random-engine-xoshiro256starstar.debuginfo" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
+ <refnamediv>
+  <refname>Random\Engine\Xoshiro256StarStar::__debugInfo</refname>
+  <refpurpose>Description</refpurpose>
+ </refnamediv>
+
+ <refsect1 role="description">
+  &reftitle.description;
+  <methodsynopsis>
+   <modifier>public</modifier> <type>array</type><methodname>Random\Engine\Xoshiro256StarStar::__debugInfo</methodname>
+   <void />
+  </methodsynopsis>
+  <para>
+
+  </para>
+
+  &warn.undocumented.func;
+
+ </refsect1>
+
+ <refsect1 role="parameters">
+  &reftitle.parameters;
+  &no.function.parameters;
+ </refsect1>
+
+ <refsect1 role="returnvalues">
+  &reftitle.returnvalues;
+  <para>
+   
+  </para>
+ </refsect1>
+
+ <refsect1 role="examples">
+  &reftitle.examples;
+  <example>
+   <title><function>Random\Engine\Xoshiro256StarStar::__debugInfo</function> example</title>
+   <programlisting role="php">
+<![CDATA[
+<?php
+
+/* ... */
+
+?>
+]]>
+   </programlisting>
+   &example.outputs.similar;
+   <screen>
+<![CDATA[
+...
+]]>
+   </screen>
+  </example>
+ </refsect1>
+
+
+</refentry>
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: sgml
+sgml-omittag:t
+sgml-shorttag:t
+sgml-minimize-attributes:nil
+sgml-always-quote-attributes:t
+sgml-indent-step:1
+sgml-indent-data:t
+indent-tabs-mode:nil
+sgml-parent-document:nil
+sgml-default-dtd-file:"~/.phpdoc/manual.ced"
+sgml-exposed-tags:nil
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+End:
+vim600: syn=xml fen fdm=syntax fdl=2 si
+vim: et tw=78 syn=sgml
+vi: ts=1 sw=1
+-->
diff --git a/reference/random/random/engine/xoshiro256starstar/generate.xml b/reference/random/random/engine/xoshiro256starstar/generate.xml
new file mode 100644
index 000000000000..707ab14484d0
--- /dev/null
+++ b/reference/random/random/engine/xoshiro256starstar/generate.xml
@@ -0,0 +1,77 @@
+<?xml version="1.0" encoding="utf-8"?>
+<refentry xml:id="random-engine-xoshiro256starstar.generate" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
+ <refnamediv>
+  <refname>Random\Engine\Xoshiro256StarStar::generate</refname>
+  <refpurpose>Description</refpurpose>
+ </refnamediv>
+
+ <refsect1 role="description">
+  &reftitle.description;
+  <methodsynopsis>
+   <modifier>public</modifier> <type>string</type><methodname>Random\Engine\Xoshiro256StarStar::generate</methodname>
+   <void />
+  </methodsynopsis>
+  <para>
+
+  </para>
+
+  &warn.undocumented.func;
+
+ </refsect1>
+
+ <refsect1 role="parameters">
+  &reftitle.parameters;
+  &no.function.parameters;
+ </refsect1>
+
+ <refsect1 role="returnvalues">
+  &reftitle.returnvalues;
+  <para>
+   
+  </para>
+ </refsect1>
+
+ <refsect1 role="examples">
+  &reftitle.examples;
+  <example>
+   <title><function>Random\Engine\Xoshiro256StarStar::generate</function> example</title>
+   <programlisting role="php">
+<![CDATA[
+<?php
+
+/* ... */
+
+?>
+]]>
+   </programlisting>
+   &example.outputs.similar;
+   <screen>
+<![CDATA[
+...
+]]>
+   </screen>
+  </example>
+ </refsect1>
+
+
+</refentry>
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: sgml
+sgml-omittag:t
+sgml-shorttag:t
+sgml-minimize-attributes:nil
+sgml-always-quote-attributes:t
+sgml-indent-step:1
+sgml-indent-data:t
+indent-tabs-mode:nil
+sgml-parent-document:nil
+sgml-default-dtd-file:"~/.phpdoc/manual.ced"
+sgml-exposed-tags:nil
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+End:
+vim600: syn=xml fen fdm=syntax fdl=2 si
+vim: et tw=78 syn=sgml
+vi: ts=1 sw=1
+-->
diff --git a/reference/random/random/engine/xoshiro256starstar/jump.xml b/reference/random/random/engine/xoshiro256starstar/jump.xml
new file mode 100644
index 000000000000..cdc6b6ee7e82
--- /dev/null
+++ b/reference/random/random/engine/xoshiro256starstar/jump.xml
@@ -0,0 +1,77 @@
+<?xml version="1.0" encoding="utf-8"?>
+<refentry xml:id="random-engine-xoshiro256starstar.jump" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
+ <refnamediv>
+  <refname>Random\Engine\Xoshiro256StarStar::jump</refname>
+  <refpurpose>Description</refpurpose>
+ </refnamediv>
+
+ <refsect1 role="description">
+  &reftitle.description;
+  <methodsynopsis>
+   <modifier>public</modifier> <type>void</type><methodname>Random\Engine\Xoshiro256StarStar::jump</methodname>
+   <void />
+  </methodsynopsis>
+  <para>
+
+  </para>
+
+  &warn.undocumented.func;
+
+ </refsect1>
+
+ <refsect1 role="parameters">
+  &reftitle.parameters;
+  &no.function.parameters;
+ </refsect1>
+
+ <refsect1 role="returnvalues">
+  &reftitle.returnvalues;
+  <para>
+   
+  </para>
+ </refsect1>
+
+ <refsect1 role="examples">
+  &reftitle.examples;
+  <example>
+   <title><function>Random\Engine\Xoshiro256StarStar::jump</function> example</title>
+   <programlisting role="php">
+<![CDATA[
+<?php
+
+/* ... */
+
+?>
+]]>
+   </programlisting>
+   &example.outputs.similar;
+   <screen>
+<![CDATA[
+...
+]]>
+   </screen>
+  </example>
+ </refsect1>
+
+
+</refentry>
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: sgml
+sgml-omittag:t
+sgml-shorttag:t
+sgml-minimize-attributes:nil
+sgml-always-quote-attributes:t
+sgml-indent-step:1
+sgml-indent-data:t
+indent-tabs-mode:nil
+sgml-parent-document:nil
+sgml-default-dtd-file:"~/.phpdoc/manual.ced"
+sgml-exposed-tags:nil
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+End:
+vim600: syn=xml fen fdm=syntax fdl=2 si
+vim: et tw=78 syn=sgml
+vi: ts=1 sw=1
+-->
diff --git a/reference/random/random/engine/xoshiro256starstar/jumplong.xml b/reference/random/random/engine/xoshiro256starstar/jumplong.xml
new file mode 100644
index 000000000000..3ecb7b357e7a
--- /dev/null
+++ b/reference/random/random/engine/xoshiro256starstar/jumplong.xml
@@ -0,0 +1,77 @@
+<?xml version="1.0" encoding="utf-8"?>
+<refentry xml:id="random-engine-xoshiro256starstar.jumplong" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
+ <refnamediv>
+  <refname>Random\Engine\Xoshiro256StarStar::jumpLong</refname>
+  <refpurpose>Description</refpurpose>
+ </refnamediv>
+
+ <refsect1 role="description">
+  &reftitle.description;
+  <methodsynopsis>
+   <modifier>public</modifier> <type>void</type><methodname>Random\Engine\Xoshiro256StarStar::jumpLong</methodname>
+   <void />
+  </methodsynopsis>
+  <para>
+
+  </para>
+
+  &warn.undocumented.func;
+
+ </refsect1>
+
+ <refsect1 role="parameters">
+  &reftitle.parameters;
+  &no.function.parameters;
+ </refsect1>
+
+ <refsect1 role="returnvalues">
+  &reftitle.returnvalues;
+  <para>
+   
+  </para>
+ </refsect1>
+
+ <refsect1 role="examples">
+  &reftitle.examples;
+  <example>
+   <title><function>Random\Engine\Xoshiro256StarStar::jumpLong</function> example</title>
+   <programlisting role="php">
+<![CDATA[
+<?php
+
+/* ... */
+
+?>
+]]>
+   </programlisting>
+   &example.outputs.similar;
+   <screen>
+<![CDATA[
+...
+]]>
+   </screen>
+  </example>
+ </refsect1>
+
+
+</refentry>
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: sgml
+sgml-omittag:t
+sgml-shorttag:t
+sgml-minimize-attributes:nil
+sgml-always-quote-attributes:t
+sgml-indent-step:1
+sgml-indent-data:t
+indent-tabs-mode:nil
+sgml-parent-document:nil
+sgml-default-dtd-file:"~/.phpdoc/manual.ced"
+sgml-exposed-tags:nil
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+End:
+vim600: syn=xml fen fdm=syntax fdl=2 si
+vim: et tw=78 syn=sgml
+vi: ts=1 sw=1
+-->
diff --git a/reference/random/random/engine/xoshiro256starstar/serialize.xml b/reference/random/random/engine/xoshiro256starstar/serialize.xml
new file mode 100644
index 000000000000..6f0767084edc
--- /dev/null
+++ b/reference/random/random/engine/xoshiro256starstar/serialize.xml
@@ -0,0 +1,77 @@
+<?xml version="1.0" encoding="utf-8"?>
+<refentry xml:id="random-engine-xoshiro256starstar.serialize" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
+ <refnamediv>
+  <refname>Random\Engine\Xoshiro256StarStar::__serialize</refname>
+  <refpurpose>Description</refpurpose>
+ </refnamediv>
+
+ <refsect1 role="description">
+  &reftitle.description;
+  <methodsynopsis>
+   <modifier>public</modifier> <type>array</type><methodname>Random\Engine\Xoshiro256StarStar::__serialize</methodname>
+   <void />
+  </methodsynopsis>
+  <para>
+
+  </para>
+
+  &warn.undocumented.func;
+
+ </refsect1>
+
+ <refsect1 role="parameters">
+  &reftitle.parameters;
+  &no.function.parameters;
+ </refsect1>
+
+ <refsect1 role="returnvalues">
+  &reftitle.returnvalues;
+  <para>
+   
+  </para>
+ </refsect1>
+
+ <refsect1 role="examples">
+  &reftitle.examples;
+  <example>
+   <title><function>Random\Engine\Xoshiro256StarStar::__serialize</function> example</title>
+   <programlisting role="php">
+<![CDATA[
+<?php
+
+/* ... */
+
+?>
+]]>
+   </programlisting>
+   &example.outputs.similar;
+   <screen>
+<![CDATA[
+...
+]]>
+   </screen>
+  </example>
+ </refsect1>
+
+
+</refentry>
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: sgml
+sgml-omittag:t
+sgml-shorttag:t
+sgml-minimize-attributes:nil
+sgml-always-quote-attributes:t
+sgml-indent-step:1
+sgml-indent-data:t
+indent-tabs-mode:nil
+sgml-parent-document:nil
+sgml-default-dtd-file:"~/.phpdoc/manual.ced"
+sgml-exposed-tags:nil
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+End:
+vim600: syn=xml fen fdm=syntax fdl=2 si
+vim: et tw=78 syn=sgml
+vi: ts=1 sw=1
+-->
diff --git a/reference/random/random/engine/xoshiro256starstar/unserialize.xml b/reference/random/random/engine/xoshiro256starstar/unserialize.xml
new file mode 100644
index 000000000000..daefad2a288a
--- /dev/null
+++ b/reference/random/random/engine/xoshiro256starstar/unserialize.xml
@@ -0,0 +1,86 @@
+<?xml version="1.0" encoding="utf-8"?>
+<refentry xml:id="random-engine-xoshiro256starstar.unserialize" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
+ <refnamediv>
+  <refname>Random\Engine\Xoshiro256StarStar::__unserialize</refname>
+  <refpurpose>Description</refpurpose>
+ </refnamediv>
+
+ <refsect1 role="description">
+  &reftitle.description;
+  <methodsynopsis>
+   <modifier>public</modifier> <type>void</type><methodname>Random\Engine\Xoshiro256StarStar::__unserialize</methodname>
+   <methodparam><type>array</type><parameter>data</parameter></methodparam>
+  </methodsynopsis>
+  <para>
+
+  </para>
+
+  &warn.undocumented.func;
+
+ </refsect1>
+
+ <refsect1 role="parameters">
+  &reftitle.parameters;
+  <variablelist>
+   <varlistentry>
+    <term><parameter>data</parameter></term>
+    <listitem>
+     <para>
+      
+     </para>
+    </listitem>
+   </varlistentry>
+  </variablelist>
+ </refsect1>
+
+ <refsect1 role="returnvalues">
+  &reftitle.returnvalues;
+  <para>
+   
+  </para>
+ </refsect1>
+
+ <refsect1 role="examples">
+  &reftitle.examples;
+  <example>
+   <title><function>Random\Engine\Xoshiro256StarStar::__unserialize</function> example</title>
+   <programlisting role="php">
+<![CDATA[
+<?php
+
+/* ... */
+
+?>
+]]>
+   </programlisting>
+   &example.outputs.similar;
+   <screen>
+<![CDATA[
+...
+]]>
+   </screen>
+  </example>
+ </refsect1>
+
+
+</refentry>
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: sgml
+sgml-omittag:t
+sgml-shorttag:t
+sgml-minimize-attributes:nil
+sgml-always-quote-attributes:t
+sgml-indent-step:1
+sgml-indent-data:t
+indent-tabs-mode:nil
+sgml-parent-document:nil
+sgml-default-dtd-file:"~/.phpdoc/manual.ced"
+sgml-exposed-tags:nil
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+End:
+vim600: syn=xml fen fdm=syntax fdl=2 si
+vim: et tw=78 syn=sgml
+vi: ts=1 sw=1
+-->
diff --git a/reference/random/random/randomizer/construct.xml b/reference/random/random/randomizer/construct.xml
new file mode 100644
index 000000000000..cf023232b9f7
--- /dev/null
+++ b/reference/random/random/randomizer/construct.xml
@@ -0,0 +1,91 @@
+<?xml version="1.0" encoding="utf-8"?>
+<refentry xml:id="random-randomizer.construct" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
+ <refnamediv>
+  <refname>Random\Randomizer::__construct</refname>
+  <refpurpose>Description</refpurpose>
+ </refnamediv>
+
+ <refsect1 role="description">
+  &reftitle.description;
+  <constructorsynopsis>
+   <modifier>public</modifier> <methodname>Random\Randomizer::__construct</methodname>
+   <methodparam choice="opt"><type class="union"><type>Random\Engine</type><type>null</type></type><parameter>engine</parameter></methodparam>
+  </constructorsynopsis>
+  <para>
+
+  </para>
+
+  &warn.undocumented.func;
+
+ </refsect1>
+
+ <refsect1 role="parameters">
+  &reftitle.parameters;
+  <variablelist>
+   <varlistentry>
+    <term><parameter>engine</parameter></term>
+    <listitem>
+     <para>
+      
+     </para>
+    </listitem>
+   </varlistentry>
+  </variablelist>
+ </refsect1>
+
+ <!-- Return values commented out, as constructors generally don't return a
+      value. Uncomment this if you do need a return values section (for
+      example, because there's also a procedural version of the method).
+ <refsect1 role="returnvalues">
+  &reftitle.returnvalues;
+  <para>
+   
+  </para>
+ </refsect1>
+ -->
+
+
+ <refsect1 role="examples">
+  &reftitle.examples;
+  <example>
+   <title><function>Random\Randomizer::__construct</function> example</title>
+   <programlisting role="php">
+<![CDATA[
+<?php
+
+/* ... */
+
+?>
+]]>
+   </programlisting>
+   &example.outputs.similar;
+   <screen>
+<![CDATA[
+...
+]]>
+   </screen>
+  </example>
+ </refsect1>
+
+
+</refentry>
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: sgml
+sgml-omittag:t
+sgml-shorttag:t
+sgml-minimize-attributes:nil
+sgml-always-quote-attributes:t
+sgml-indent-step:1
+sgml-indent-data:t
+indent-tabs-mode:nil
+sgml-parent-document:nil
+sgml-default-dtd-file:"~/.phpdoc/manual.ced"
+sgml-exposed-tags:nil
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+End:
+vim600: syn=xml fen fdm=syntax fdl=2 si
+vim: et tw=78 syn=sgml
+vi: ts=1 sw=1
+-->
diff --git a/reference/random/random/randomizer/getbytes.xml b/reference/random/random/randomizer/getbytes.xml
new file mode 100644
index 000000000000..5913b8abad2a
--- /dev/null
+++ b/reference/random/random/randomizer/getbytes.xml
@@ -0,0 +1,86 @@
+<?xml version="1.0" encoding="utf-8"?>
+<refentry xml:id="random-randomizer.getbytes" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
+ <refnamediv>
+  <refname>Random\Randomizer::getBytes</refname>
+  <refpurpose>Description</refpurpose>
+ </refnamediv>
+
+ <refsect1 role="description">
+  &reftitle.description;
+  <methodsynopsis>
+   <modifier>public</modifier> <type>string</type><methodname>Random\Randomizer::getBytes</methodname>
+   <methodparam><type>int</type><parameter>length</parameter></methodparam>
+  </methodsynopsis>
+  <para>
+
+  </para>
+
+  &warn.undocumented.func;
+
+ </refsect1>
+
+ <refsect1 role="parameters">
+  &reftitle.parameters;
+  <variablelist>
+   <varlistentry>
+    <term><parameter>length</parameter></term>
+    <listitem>
+     <para>
+      
+     </para>
+    </listitem>
+   </varlistentry>
+  </variablelist>
+ </refsect1>
+
+ <refsect1 role="returnvalues">
+  &reftitle.returnvalues;
+  <para>
+   
+  </para>
+ </refsect1>
+
+ <refsect1 role="examples">
+  &reftitle.examples;
+  <example>
+   <title><function>Random\Randomizer::getBytes</function> example</title>
+   <programlisting role="php">
+<![CDATA[
+<?php
+
+/* ... */
+
+?>
+]]>
+   </programlisting>
+   &example.outputs.similar;
+   <screen>
+<![CDATA[
+...
+]]>
+   </screen>
+  </example>
+ </refsect1>
+
+
+</refentry>
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: sgml
+sgml-omittag:t
+sgml-shorttag:t
+sgml-minimize-attributes:nil
+sgml-always-quote-attributes:t
+sgml-indent-step:1
+sgml-indent-data:t
+indent-tabs-mode:nil
+sgml-parent-document:nil
+sgml-default-dtd-file:"~/.phpdoc/manual.ced"
+sgml-exposed-tags:nil
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+End:
+vim600: syn=xml fen fdm=syntax fdl=2 si
+vim: et tw=78 syn=sgml
+vi: ts=1 sw=1
+-->
diff --git a/reference/random/random/randomizer/getint.xml b/reference/random/random/randomizer/getint.xml
new file mode 100644
index 000000000000..83f4950ea1fd
--- /dev/null
+++ b/reference/random/random/randomizer/getint.xml
@@ -0,0 +1,95 @@
+<?xml version="1.0" encoding="utf-8"?>
+<refentry xml:id="random-randomizer.getint" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
+ <refnamediv>
+  <refname>Random\Randomizer::getInt</refname>
+  <refpurpose>Description</refpurpose>
+ </refnamediv>
+
+ <refsect1 role="description">
+  &reftitle.description;
+  <methodsynopsis>
+   <modifier>public</modifier> <type>int</type><methodname>Random\Randomizer::getInt</methodname>
+   <methodparam><type>int</type><parameter>min</parameter></methodparam>
+   <methodparam><type>int</type><parameter>max</parameter></methodparam>
+  </methodsynopsis>
+  <para>
+
+  </para>
+
+  &warn.undocumented.func;
+
+ </refsect1>
+
+ <refsect1 role="parameters">
+  &reftitle.parameters;
+  <variablelist>
+   <varlistentry>
+    <term><parameter>min</parameter></term>
+    <listitem>
+     <para>
+      
+     </para>
+    </listitem>
+   </varlistentry>
+   <varlistentry>
+    <term><parameter>max</parameter></term>
+    <listitem>
+     <para>
+      
+     </para>
+    </listitem>
+   </varlistentry>
+  </variablelist>
+ </refsect1>
+
+ <refsect1 role="returnvalues">
+  &reftitle.returnvalues;
+  <para>
+   
+  </para>
+ </refsect1>
+
+ <refsect1 role="examples">
+  &reftitle.examples;
+  <example>
+   <title><function>Random\Randomizer::getInt</function> example</title>
+   <programlisting role="php">
+<![CDATA[
+<?php
+
+/* ... */
+
+?>
+]]>
+   </programlisting>
+   &example.outputs.similar;
+   <screen>
+<![CDATA[
+...
+]]>
+   </screen>
+  </example>
+ </refsect1>
+
+
+</refentry>
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: sgml
+sgml-omittag:t
+sgml-shorttag:t
+sgml-minimize-attributes:nil
+sgml-always-quote-attributes:t
+sgml-indent-step:1
+sgml-indent-data:t
+indent-tabs-mode:nil
+sgml-parent-document:nil
+sgml-default-dtd-file:"~/.phpdoc/manual.ced"
+sgml-exposed-tags:nil
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+End:
+vim600: syn=xml fen fdm=syntax fdl=2 si
+vim: et tw=78 syn=sgml
+vi: ts=1 sw=1
+-->
diff --git a/reference/random/random/randomizer/nextint.xml b/reference/random/random/randomizer/nextint.xml
new file mode 100644
index 000000000000..f3e0ced02ad8
--- /dev/null
+++ b/reference/random/random/randomizer/nextint.xml
@@ -0,0 +1,77 @@
+<?xml version="1.0" encoding="utf-8"?>
+<refentry xml:id="random-randomizer.nextint" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
+ <refnamediv>
+  <refname>Random\Randomizer::nextInt</refname>
+  <refpurpose>Description</refpurpose>
+ </refnamediv>
+
+ <refsect1 role="description">
+  &reftitle.description;
+  <methodsynopsis>
+   <modifier>public</modifier> <type>int</type><methodname>Random\Randomizer::nextInt</methodname>
+   <void />
+  </methodsynopsis>
+  <para>
+
+  </para>
+
+  &warn.undocumented.func;
+
+ </refsect1>
+
+ <refsect1 role="parameters">
+  &reftitle.parameters;
+  &no.function.parameters;
+ </refsect1>
+
+ <refsect1 role="returnvalues">
+  &reftitle.returnvalues;
+  <para>
+   
+  </para>
+ </refsect1>
+
+ <refsect1 role="examples">
+  &reftitle.examples;
+  <example>
+   <title><function>Random\Randomizer::nextInt</function> example</title>
+   <programlisting role="php">
+<![CDATA[
+<?php
+
+/* ... */
+
+?>
+]]>
+   </programlisting>
+   &example.outputs.similar;
+   <screen>
+<![CDATA[
+...
+]]>
+   </screen>
+  </example>
+ </refsect1>
+
+
+</refentry>
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: sgml
+sgml-omittag:t
+sgml-shorttag:t
+sgml-minimize-attributes:nil
+sgml-always-quote-attributes:t
+sgml-indent-step:1
+sgml-indent-data:t
+indent-tabs-mode:nil
+sgml-parent-document:nil
+sgml-default-dtd-file:"~/.phpdoc/manual.ced"
+sgml-exposed-tags:nil
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+End:
+vim600: syn=xml fen fdm=syntax fdl=2 si
+vim: et tw=78 syn=sgml
+vi: ts=1 sw=1
+-->
diff --git a/reference/random/random/randomizer/pickarraykeys.xml b/reference/random/random/randomizer/pickarraykeys.xml
new file mode 100644
index 000000000000..fcd9bdd16f30
--- /dev/null
+++ b/reference/random/random/randomizer/pickarraykeys.xml
@@ -0,0 +1,95 @@
+<?xml version="1.0" encoding="utf-8"?>
+<refentry xml:id="random-randomizer.pickarraykeys" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
+ <refnamediv>
+  <refname>Random\Randomizer::pickArrayKeys</refname>
+  <refpurpose>Description</refpurpose>
+ </refnamediv>
+
+ <refsect1 role="description">
+  &reftitle.description;
+  <methodsynopsis>
+   <modifier>public</modifier> <type>array</type><methodname>Random\Randomizer::pickArrayKeys</methodname>
+   <methodparam><type>array</type><parameter>array</parameter></methodparam>
+   <methodparam><type>int</type><parameter>num</parameter></methodparam>
+  </methodsynopsis>
+  <para>
+
+  </para>
+
+  &warn.undocumented.func;
+
+ </refsect1>
+
+ <refsect1 role="parameters">
+  &reftitle.parameters;
+  <variablelist>
+   <varlistentry>
+    <term><parameter>array</parameter></term>
+    <listitem>
+     <para>
+      
+     </para>
+    </listitem>
+   </varlistentry>
+   <varlistentry>
+    <term><parameter>num</parameter></term>
+    <listitem>
+     <para>
+      
+     </para>
+    </listitem>
+   </varlistentry>
+  </variablelist>
+ </refsect1>
+
+ <refsect1 role="returnvalues">
+  &reftitle.returnvalues;
+  <para>
+   
+  </para>
+ </refsect1>
+
+ <refsect1 role="examples">
+  &reftitle.examples;
+  <example>
+   <title><function>Random\Randomizer::pickArrayKeys</function> example</title>
+   <programlisting role="php">
+<![CDATA[
+<?php
+
+/* ... */
+
+?>
+]]>
+   </programlisting>
+   &example.outputs.similar;
+   <screen>
+<![CDATA[
+...
+]]>
+   </screen>
+  </example>
+ </refsect1>
+
+
+</refentry>
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: sgml
+sgml-omittag:t
+sgml-shorttag:t
+sgml-minimize-attributes:nil
+sgml-always-quote-attributes:t
+sgml-indent-step:1
+sgml-indent-data:t
+indent-tabs-mode:nil
+sgml-parent-document:nil
+sgml-default-dtd-file:"~/.phpdoc/manual.ced"
+sgml-exposed-tags:nil
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+End:
+vim600: syn=xml fen fdm=syntax fdl=2 si
+vim: et tw=78 syn=sgml
+vi: ts=1 sw=1
+-->
diff --git a/reference/random/random/randomizer/serialize.xml b/reference/random/random/randomizer/serialize.xml
new file mode 100644
index 000000000000..d9c87717b41d
--- /dev/null
+++ b/reference/random/random/randomizer/serialize.xml
@@ -0,0 +1,77 @@
+<?xml version="1.0" encoding="utf-8"?>
+<refentry xml:id="random-randomizer.serialize" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
+ <refnamediv>
+  <refname>Random\Randomizer::__serialize</refname>
+  <refpurpose>Description</refpurpose>
+ </refnamediv>
+
+ <refsect1 role="description">
+  &reftitle.description;
+  <methodsynopsis>
+   <modifier>public</modifier> <type>array</type><methodname>Random\Randomizer::__serialize</methodname>
+   <void />
+  </methodsynopsis>
+  <para>
+
+  </para>
+
+  &warn.undocumented.func;
+
+ </refsect1>
+
+ <refsect1 role="parameters">
+  &reftitle.parameters;
+  &no.function.parameters;
+ </refsect1>
+
+ <refsect1 role="returnvalues">
+  &reftitle.returnvalues;
+  <para>
+   
+  </para>
+ </refsect1>
+
+ <refsect1 role="examples">
+  &reftitle.examples;
+  <example>
+   <title><function>Random\Randomizer::__serialize</function> example</title>
+   <programlisting role="php">
+<![CDATA[
+<?php
+
+/* ... */
+
+?>
+]]>
+   </programlisting>
+   &example.outputs.similar;
+   <screen>
+<![CDATA[
+...
+]]>
+   </screen>
+  </example>
+ </refsect1>
+
+
+</refentry>
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: sgml
+sgml-omittag:t
+sgml-shorttag:t
+sgml-minimize-attributes:nil
+sgml-always-quote-attributes:t
+sgml-indent-step:1
+sgml-indent-data:t
+indent-tabs-mode:nil
+sgml-parent-document:nil
+sgml-default-dtd-file:"~/.phpdoc/manual.ced"
+sgml-exposed-tags:nil
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+End:
+vim600: syn=xml fen fdm=syntax fdl=2 si
+vim: et tw=78 syn=sgml
+vi: ts=1 sw=1
+-->
diff --git a/reference/random/random/randomizer/shufflearray.xml b/reference/random/random/randomizer/shufflearray.xml
new file mode 100644
index 000000000000..a21f388b6954
--- /dev/null
+++ b/reference/random/random/randomizer/shufflearray.xml
@@ -0,0 +1,86 @@
+<?xml version="1.0" encoding="utf-8"?>
+<refentry xml:id="random-randomizer.shufflearray" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
+ <refnamediv>
+  <refname>Random\Randomizer::shuffleArray</refname>
+  <refpurpose>Description</refpurpose>
+ </refnamediv>
+
+ <refsect1 role="description">
+  &reftitle.description;
+  <methodsynopsis>
+   <modifier>public</modifier> <type>array</type><methodname>Random\Randomizer::shuffleArray</methodname>
+   <methodparam><type>array</type><parameter>array</parameter></methodparam>
+  </methodsynopsis>
+  <para>
+
+  </para>
+
+  &warn.undocumented.func;
+
+ </refsect1>
+
+ <refsect1 role="parameters">
+  &reftitle.parameters;
+  <variablelist>
+   <varlistentry>
+    <term><parameter>array</parameter></term>
+    <listitem>
+     <para>
+      
+     </para>
+    </listitem>
+   </varlistentry>
+  </variablelist>
+ </refsect1>
+
+ <refsect1 role="returnvalues">
+  &reftitle.returnvalues;
+  <para>
+   
+  </para>
+ </refsect1>
+
+ <refsect1 role="examples">
+  &reftitle.examples;
+  <example>
+   <title><function>Random\Randomizer::shuffleArray</function> example</title>
+   <programlisting role="php">
+<![CDATA[
+<?php
+
+/* ... */
+
+?>
+]]>
+   </programlisting>
+   &example.outputs.similar;
+   <screen>
+<![CDATA[
+...
+]]>
+   </screen>
+  </example>
+ </refsect1>
+
+
+</refentry>
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: sgml
+sgml-omittag:t
+sgml-shorttag:t
+sgml-minimize-attributes:nil
+sgml-always-quote-attributes:t
+sgml-indent-step:1
+sgml-indent-data:t
+indent-tabs-mode:nil
+sgml-parent-document:nil
+sgml-default-dtd-file:"~/.phpdoc/manual.ced"
+sgml-exposed-tags:nil
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+End:
+vim600: syn=xml fen fdm=syntax fdl=2 si
+vim: et tw=78 syn=sgml
+vi: ts=1 sw=1
+-->
diff --git a/reference/random/random/randomizer/shufflebytes.xml b/reference/random/random/randomizer/shufflebytes.xml
new file mode 100644
index 000000000000..bc18e08b0b63
--- /dev/null
+++ b/reference/random/random/randomizer/shufflebytes.xml
@@ -0,0 +1,86 @@
+<?xml version="1.0" encoding="utf-8"?>
+<refentry xml:id="random-randomizer.shufflebytes" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
+ <refnamediv>
+  <refname>Random\Randomizer::shuffleBytes</refname>
+  <refpurpose>Description</refpurpose>
+ </refnamediv>
+
+ <refsect1 role="description">
+  &reftitle.description;
+  <methodsynopsis>
+   <modifier>public</modifier> <type>string</type><methodname>Random\Randomizer::shuffleBytes</methodname>
+   <methodparam><type>string</type><parameter>bytes</parameter></methodparam>
+  </methodsynopsis>
+  <para>
+
+  </para>
+
+  &warn.undocumented.func;
+
+ </refsect1>
+
+ <refsect1 role="parameters">
+  &reftitle.parameters;
+  <variablelist>
+   <varlistentry>
+    <term><parameter>bytes</parameter></term>
+    <listitem>
+     <para>
+      
+     </para>
+    </listitem>
+   </varlistentry>
+  </variablelist>
+ </refsect1>
+
+ <refsect1 role="returnvalues">
+  &reftitle.returnvalues;
+  <para>
+   
+  </para>
+ </refsect1>
+
+ <refsect1 role="examples">
+  &reftitle.examples;
+  <example>
+   <title><function>Random\Randomizer::shuffleBytes</function> example</title>
+   <programlisting role="php">
+<![CDATA[
+<?php
+
+/* ... */
+
+?>
+]]>
+   </programlisting>
+   &example.outputs.similar;
+   <screen>
+<![CDATA[
+...
+]]>
+   </screen>
+  </example>
+ </refsect1>
+
+
+</refentry>
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: sgml
+sgml-omittag:t
+sgml-shorttag:t
+sgml-minimize-attributes:nil
+sgml-always-quote-attributes:t
+sgml-indent-step:1
+sgml-indent-data:t
+indent-tabs-mode:nil
+sgml-parent-document:nil
+sgml-default-dtd-file:"~/.phpdoc/manual.ced"
+sgml-exposed-tags:nil
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+End:
+vim600: syn=xml fen fdm=syntax fdl=2 si
+vim: et tw=78 syn=sgml
+vi: ts=1 sw=1
+-->
diff --git a/reference/random/random/randomizer/unserialize.xml b/reference/random/random/randomizer/unserialize.xml
new file mode 100644
index 000000000000..7444acd3c5c0
--- /dev/null
+++ b/reference/random/random/randomizer/unserialize.xml
@@ -0,0 +1,86 @@
+<?xml version="1.0" encoding="utf-8"?>
+<refentry xml:id="random-randomizer.unserialize" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
+ <refnamediv>
+  <refname>Random\Randomizer::__unserialize</refname>
+  <refpurpose>Description</refpurpose>
+ </refnamediv>
+
+ <refsect1 role="description">
+  &reftitle.description;
+  <methodsynopsis>
+   <modifier>public</modifier> <type>void</type><methodname>Random\Randomizer::__unserialize</methodname>
+   <methodparam><type>array</type><parameter>data</parameter></methodparam>
+  </methodsynopsis>
+  <para>
+
+  </para>
+
+  &warn.undocumented.func;
+
+ </refsect1>
+
+ <refsect1 role="parameters">
+  &reftitle.parameters;
+  <variablelist>
+   <varlistentry>
+    <term><parameter>data</parameter></term>
+    <listitem>
+     <para>
+      
+     </para>
+    </listitem>
+   </varlistentry>
+  </variablelist>
+ </refsect1>
+
+ <refsect1 role="returnvalues">
+  &reftitle.returnvalues;
+  <para>
+   
+  </para>
+ </refsect1>
+
+ <refsect1 role="examples">
+  &reftitle.examples;
+  <example>
+   <title><function>Random\Randomizer::__unserialize</function> example</title>
+   <programlisting role="php">
+<![CDATA[
+<?php
+
+/* ... */
+
+?>
+]]>
+   </programlisting>
+   &example.outputs.similar;
+   <screen>
+<![CDATA[
+...
+]]>
+   </screen>
+  </example>
+ </refsect1>
+
+
+</refentry>
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: sgml
+sgml-omittag:t
+sgml-shorttag:t
+sgml-minimize-attributes:nil
+sgml-always-quote-attributes:t
+sgml-indent-step:1
+sgml-indent-data:t
+indent-tabs-mode:nil
+sgml-parent-document:nil
+sgml-default-dtd-file:"~/.phpdoc/manual.ced"
+sgml-exposed-tags:nil
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+End:
+vim600: syn=xml fen fdm=syntax fdl=2 si
+vim: et tw=78 syn=sgml
+vi: ts=1 sw=1
+-->
diff --git a/reference/csprng/reference.xml b/reference/random/reference.xml
similarity index 73%
rename from reference/csprng/reference.xml
rename to reference/random/reference.xml
index 09dea4f27a1a..2ca19f6c2a38 100644
--- a/reference/csprng/reference.xml
+++ b/reference/random/reference.xml
@@ -1,13 +1,10 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- $Revision$ -->
+<reference xml:id="ref.random" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
+ <title>Random &Functions;</title>
 
-<reference xml:id="ref.csprng" xmlns="http://docbook.org/ns/docbook">
- <title>CSPRNG &Functions;</title>
-
- &reference.csprng.entities.functions;
+ &reference.random.entities.functions;
 
 </reference>
-
 <!-- Keep this comment at the end of the file
 Local variables:
 mode: sgml
@@ -28,4 +25,3 @@ vim600: syn=xml fen fdm=syntax fdl=2 si
 vim: et tw=78 syn=sgml
 vi: ts=1 sw=1
 -->
-
diff --git a/reference/csprng/setup.xml b/reference/random/setup.xml
similarity index 72%
rename from reference/csprng/setup.xml
rename to reference/random/setup.xml
index 790b1c921d8b..351c34b609ed 100644
--- a/reference/csprng/setup.xml
+++ b/reference/random/setup.xml
@@ -1,31 +1,28 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- $Revision$ -->
-
-<chapter xml:id="csprng.setup">
+<chapter xml:id="random.setup" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  &reftitle.setup;
 
- <section xml:id="csprng.requirements">
+ <section xml:id="random.requirements">
   &reftitle.required;
   &no.requirement;
  </section>
 
- <section xml:id="csprng.installation">
+ <section xml:id="random.installation">
   &reftitle.install;
   &no.install;
  </section>
 
- <section xml:id="csprng.configuration">
+ <section xml:id="random.configuration">
   &reftitle.runtime;
   &no.config;
  </section>
 
- <section xml:id="csprng.resources">
+ <section xml:id="random.resources">
   &reftitle.resources;
   &no.resource;
  </section>
 
 </chapter>
-
 <!-- Keep this comment at the end of the file
 Local variables:
 mode: sgml
diff --git a/reference/random/versions.xml b/reference/random/versions.xml
new file mode 100644
index 000000000000..a3ebb6492e88
--- /dev/null
+++ b/reference/random/versions.xml
@@ -0,0 +1,115 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- Do NOT translate this file -->
+<versions>
+ <!-- Functions -->
+ <function name="lcg_value" from="PHP 4, PHP 5, PHP 7, PHP 8"/>
+ <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"/>
+ <function name="mt_rand" from="PHP 4, PHP 5, PHP 7, PHP 8"/>
+ <function name="mt_getrandmax" from="PHP 4, PHP 5, PHP 7, PHP 8"/>
+ <function name="getrandmax" from="PHP 4, PHP 5, PHP 7, PHP 8"/>
+ <function name="random_bytes" from="PHP 7, PHP 8"/>
+ <function name="random_int" from="PHP 7, PHP 8"/>
+ <!-- Classes and Methods -->
+
+ <function name='random\engine' from='PHP 5 &gt;= Unknown'/>
+ <function name='random\engine::generate' from='PHP 5 &gt;= Unknown'/>
+
+ <function name='random\cryptosafeengine' from='PHP 5 &gt;= Unknown'/>
+ <function name='random\cryptosafeengine::generate' from='PHP 5 &gt;= Unknown'/>
+
+ <function name='random\randomerror' from='PHP 5 &gt;= Unknown'/>
+ <function name='random\randomerror::__construct' from='PHP 5 &gt;= Unknown'/>
+ <function name='random\randomerror::__wakeup' from='PHP 5 &gt;= Unknown'/>
+ <function name='random\randomerror::getmessage' from='PHP 5 &gt;= Unknown'/>
+ <function name='random\randomerror::getcode' from='PHP 5 &gt;= Unknown'/>
+ <function name='random\randomerror::getfile' from='PHP 5 &gt;= Unknown'/>
+ <function name='random\randomerror::getline' from='PHP 5 &gt;= Unknown'/>
+ <function name='random\randomerror::gettrace' from='PHP 5 &gt;= Unknown'/>
+ <function name='random\randomerror::getprevious' from='PHP 5 &gt;= Unknown'/>
+ <function name='random\randomerror::gettraceasstring' from='PHP 5 &gt;= Unknown'/>
+ <function name='random\randomerror::__tostring' from='PHP 5 &gt;= Unknown'/>
+
+ <function name='random\brokenrandomengineerror' from='PHP 5 &gt;= Unknown'/>
+ <function name='random\brokenrandomengineerror::__construct' from='PHP 5 &gt;= Unknown'/>
+ <function name='random\brokenrandomengineerror::__wakeup' from='PHP 5 &gt;= Unknown'/>
+ <function name='random\brokenrandomengineerror::getmessage' from='PHP 5 &gt;= Unknown'/>
+ <function name='random\brokenrandomengineerror::getcode' from='PHP 5 &gt;= Unknown'/>
+ <function name='random\brokenrandomengineerror::getfile' from='PHP 5 &gt;= Unknown'/>
+ <function name='random\brokenrandomengineerror::getline' from='PHP 5 &gt;= Unknown'/>
+ <function name='random\brokenrandomengineerror::gettrace' from='PHP 5 &gt;= Unknown'/>
+ <function name='random\brokenrandomengineerror::getprevious' from='PHP 5 &gt;= Unknown'/>
+ <function name='random\brokenrandomengineerror::gettraceasstring' from='PHP 5 &gt;= Unknown'/>
+ <function name='random\brokenrandomengineerror::__tostring' from='PHP 5 &gt;= Unknown'/>
+
+ <function name='random\randomexception' from='PHP 5 &gt;= Unknown'/>
+ <function name='random\randomexception::__construct' from='PHP 5 &gt;= Unknown'/>
+ <function name='random\randomexception::__wakeup' from='PHP 5 &gt;= Unknown'/>
+ <function name='random\randomexception::getmessage' from='PHP 5 &gt;= Unknown'/>
+ <function name='random\randomexception::getcode' from='PHP 5 &gt;= Unknown'/>
+ <function name='random\randomexception::getfile' from='PHP 5 &gt;= Unknown'/>
+ <function name='random\randomexception::getline' from='PHP 5 &gt;= Unknown'/>
+ <function name='random\randomexception::gettrace' from='PHP 5 &gt;= Unknown'/>
+ <function name='random\randomexception::getprevious' from='PHP 5 &gt;= Unknown'/>
+ <function name='random\randomexception::gettraceasstring' from='PHP 5 &gt;= Unknown'/>
+ <function name='random\randomexception::__tostring' from='PHP 5 &gt;= Unknown'/>
+
+ <function name='random\engine\mt19937' from='PHP 5 &gt;= Unknown'/>
+ <function name='random\engine\mt19937::__construct' from='PHP 5 &gt;= Unknown'/>
+ <function name='random\engine\mt19937::generate' from='PHP 5 &gt;= Unknown'/>
+ <function name='random\engine\mt19937::__serialize' from='PHP 5 &gt;= Unknown'/>
+ <function name='random\engine\mt19937::__unserialize' from='PHP 5 &gt;= Unknown'/>
+ <function name='random\engine\mt19937::__debuginfo' from='PHP 5 &gt;= Unknown'/>
+
+ <function name='random\engine\pcgoneseq128xslrr64' from='PHP 5 &gt;= Unknown'/>
+ <function name='random\engine\pcgoneseq128xslrr64::__construct' from='PHP 5 &gt;= Unknown'/>
+ <function name='random\engine\pcgoneseq128xslrr64::generate' from='PHP 5 &gt;= Unknown'/>
+ <function name='random\engine\pcgoneseq128xslrr64::jump' from='PHP 5 &gt;= Unknown'/>
+ <function name='random\engine\pcgoneseq128xslrr64::__serialize' from='PHP 5 &gt;= Unknown'/>
+ <function name='random\engine\pcgoneseq128xslrr64::__unserialize' from='PHP 5 &gt;= Unknown'/>
+ <function name='random\engine\pcgoneseq128xslrr64::__debuginfo' from='PHP 5 &gt;= Unknown'/>
+
+ <function name='random\engine\xoshiro256starstar' from='PHP 5 &gt;= Unknown'/>
+ <function name='random\engine\xoshiro256starstar::__construct' from='PHP 5 &gt;= Unknown'/>
+ <function name='random\engine\xoshiro256starstar::generate' from='PHP 5 &gt;= Unknown'/>
+ <function name='random\engine\xoshiro256starstar::jump' from='PHP 5 &gt;= Unknown'/>
+ <function name='random\engine\xoshiro256starstar::jumplong' from='PHP 5 &gt;= Unknown'/>
+ <function name='random\engine\xoshiro256starstar::__serialize' from='PHP 5 &gt;= Unknown'/>
+ <function name='random\engine\xoshiro256starstar::__unserialize' from='PHP 5 &gt;= Unknown'/>
+ <function name='random\engine\xoshiro256starstar::__debuginfo' from='PHP 5 &gt;= Unknown'/>
+
+ <function name='random\engine\secure' from='PHP 5 &gt;= Unknown'/>
+ <function name='random\engine\secure::generate' from='PHP 5 &gt;= Unknown'/>
+
+ <function name='random\randomizer' from='PHP 5 &gt;= Unknown'/>
+ <function name='random\randomizer::__construct' from='PHP 5 &gt;= Unknown'/>
+ <function name='random\randomizer::nextint' from='PHP 5 &gt;= Unknown'/>
+ <function name='random\randomizer::getint' from='PHP 5 &gt;= Unknown'/>
+ <function name='random\randomizer::getbytes' from='PHP 5 &gt;= Unknown'/>
+ <function name='random\randomizer::shufflearray' from='PHP 5 &gt;= Unknown'/>
+ <function name='random\randomizer::shufflebytes' from='PHP 5 &gt;= Unknown'/>
+ <function name='random\randomizer::pickarraykeys' from='PHP 5 &gt;= Unknown'/>
+ <function name='random\randomizer::__serialize' from='PHP 5 &gt;= Unknown'/>
+ <function name='random\randomizer::__unserialize' from='PHP 5 &gt;= Unknown'/>
+</versions>
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: sgml
+sgml-omittag:t
+sgml-shorttag:t
+sgml-minimize-attributes:nil
+sgml-always-quote-attributes:t
+sgml-indent-step:1
+sgml-indent-data:t
+indent-tabs-mode:nil
+sgml-parent-document:nil
+sgml-default-dtd-file:"~/.phpdoc/manual.ced"
+sgml-exposed-tags:nil
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+End:
+vim600: syn=xml fen fdm=syntax fdl=2 si
+vim: et tw=78 syn=sgml
+vi: ts=1 sw=1
+-->

From 1b895db5feeaf9dfab2e9fd9695375d619135ea8 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Tim=20D=C3=BCsterhus?= <tim@bastelstu.be>
Date: Tue, 25 Oct 2022 21:14:17 +0200
Subject: [PATCH 02/17] Update ext/random versions

---
 reference/random/versions.xml | 140 +++++++++++++++++-----------------
 1 file changed, 70 insertions(+), 70 deletions(-)

diff --git a/reference/random/versions.xml b/reference/random/versions.xml
index a3ebb6492e88..da0a3e0e6813 100644
--- a/reference/random/versions.xml
+++ b/reference/random/versions.xml
@@ -13,85 +13,85 @@
  <function name="random_int" from="PHP 7, PHP 8"/>
  <!-- Classes and Methods -->
 
- <function name='random\engine' from='PHP 5 &gt;= Unknown'/>
- <function name='random\engine::generate' from='PHP 5 &gt;= Unknown'/>
+ <function name='random\engine' from='PHP 8 &gt;= 8.2.0'/>
+ <function name='random\engine::generate' from='PHP 8 &gt;= 8.2.0'/>
 
- <function name='random\cryptosafeengine' from='PHP 5 &gt;= Unknown'/>
- <function name='random\cryptosafeengine::generate' from='PHP 5 &gt;= Unknown'/>
+ <function name='random\cryptosafeengine' from='PHP 8 &gt;= 8.2.0'/>
+ <function name='random\cryptosafeengine::generate' from='PHP 8 &gt;= 8.2.0'/>
 
- <function name='random\randomerror' from='PHP 5 &gt;= Unknown'/>
- <function name='random\randomerror::__construct' from='PHP 5 &gt;= Unknown'/>
- <function name='random\randomerror::__wakeup' from='PHP 5 &gt;= Unknown'/>
- <function name='random\randomerror::getmessage' from='PHP 5 &gt;= Unknown'/>
- <function name='random\randomerror::getcode' from='PHP 5 &gt;= Unknown'/>
- <function name='random\randomerror::getfile' from='PHP 5 &gt;= Unknown'/>
- <function name='random\randomerror::getline' from='PHP 5 &gt;= Unknown'/>
- <function name='random\randomerror::gettrace' from='PHP 5 &gt;= Unknown'/>
- <function name='random\randomerror::getprevious' from='PHP 5 &gt;= Unknown'/>
- <function name='random\randomerror::gettraceasstring' from='PHP 5 &gt;= Unknown'/>
- <function name='random\randomerror::__tostring' from='PHP 5 &gt;= Unknown'/>
+ <function name='random\randomerror' from='PHP 8 &gt;= 8.2.0'/>
+ <function name='random\randomerror::__construct' from='PHP 8 &gt;= 8.2.0'/>
+ <function name='random\randomerror::__wakeup' from='PHP 8 &gt;= 8.2.0'/>
+ <function name='random\randomerror::getmessage' from='PHP 8 &gt;= 8.2.0'/>
+ <function name='random\randomerror::getcode' from='PHP 8 &gt;= 8.2.0'/>
+ <function name='random\randomerror::getfile' from='PHP 8 &gt;= 8.2.0'/>
+ <function name='random\randomerror::getline' from='PHP 8 &gt;= 8.2.0'/>
+ <function name='random\randomerror::gettrace' from='PHP 8 &gt;= 8.2.0'/>
+ <function name='random\randomerror::getprevious' from='PHP 8 &gt;= 8.2.0'/>
+ <function name='random\randomerror::gettraceasstring' from='PHP 8 &gt;= 8.2.0'/>
+ <function name='random\randomerror::__tostring' from='PHP 8 &gt;= 8.2.0'/>
 
- <function name='random\brokenrandomengineerror' from='PHP 5 &gt;= Unknown'/>
- <function name='random\brokenrandomengineerror::__construct' from='PHP 5 &gt;= Unknown'/>
- <function name='random\brokenrandomengineerror::__wakeup' from='PHP 5 &gt;= Unknown'/>
- <function name='random\brokenrandomengineerror::getmessage' from='PHP 5 &gt;= Unknown'/>
- <function name='random\brokenrandomengineerror::getcode' from='PHP 5 &gt;= Unknown'/>
- <function name='random\brokenrandomengineerror::getfile' from='PHP 5 &gt;= Unknown'/>
- <function name='random\brokenrandomengineerror::getline' from='PHP 5 &gt;= Unknown'/>
- <function name='random\brokenrandomengineerror::gettrace' from='PHP 5 &gt;= Unknown'/>
- <function name='random\brokenrandomengineerror::getprevious' from='PHP 5 &gt;= Unknown'/>
- <function name='random\brokenrandomengineerror::gettraceasstring' from='PHP 5 &gt;= Unknown'/>
- <function name='random\brokenrandomengineerror::__tostring' from='PHP 5 &gt;= Unknown'/>
+ <function name='random\brokenrandomengineerror' from='PHP 8 &gt;= 8.2.0'/>
+ <function name='random\brokenrandomengineerror::__construct' from='PHP 8 &gt;= 8.2.0'/>
+ <function name='random\brokenrandomengineerror::__wakeup' from='PHP 8 &gt;= 8.2.0'/>
+ <function name='random\brokenrandomengineerror::getmessage' from='PHP 8 &gt;= 8.2.0'/>
+ <function name='random\brokenrandomengineerror::getcode' from='PHP 8 &gt;= 8.2.0'/>
+ <function name='random\brokenrandomengineerror::getfile' from='PHP 8 &gt;= 8.2.0'/>
+ <function name='random\brokenrandomengineerror::getline' from='PHP 8 &gt;= 8.2.0'/>
+ <function name='random\brokenrandomengineerror::gettrace' from='PHP 8 &gt;= 8.2.0'/>
+ <function name='random\brokenrandomengineerror::getprevious' from='PHP 8 &gt;= 8.2.0'/>
+ <function name='random\brokenrandomengineerror::gettraceasstring' from='PHP 8 &gt;= 8.2.0'/>
+ <function name='random\brokenrandomengineerror::__tostring' from='PHP 8 &gt;= 8.2.0'/>
 
- <function name='random\randomexception' from='PHP 5 &gt;= Unknown'/>
- <function name='random\randomexception::__construct' from='PHP 5 &gt;= Unknown'/>
- <function name='random\randomexception::__wakeup' from='PHP 5 &gt;= Unknown'/>
- <function name='random\randomexception::getmessage' from='PHP 5 &gt;= Unknown'/>
- <function name='random\randomexception::getcode' from='PHP 5 &gt;= Unknown'/>
- <function name='random\randomexception::getfile' from='PHP 5 &gt;= Unknown'/>
- <function name='random\randomexception::getline' from='PHP 5 &gt;= Unknown'/>
- <function name='random\randomexception::gettrace' from='PHP 5 &gt;= Unknown'/>
- <function name='random\randomexception::getprevious' from='PHP 5 &gt;= Unknown'/>
- <function name='random\randomexception::gettraceasstring' from='PHP 5 &gt;= Unknown'/>
- <function name='random\randomexception::__tostring' from='PHP 5 &gt;= Unknown'/>
+ <function name='random\randomexception' from='PHP 8 &gt;= 8.2.0'/>
+ <function name='random\randomexception::__construct' from='PHP 8 &gt;= 8.2.0'/>
+ <function name='random\randomexception::__wakeup' from='PHP 8 &gt;= 8.2.0'/>
+ <function name='random\randomexception::getmessage' from='PHP 8 &gt;= 8.2.0'/>
+ <function name='random\randomexception::getcode' from='PHP 8 &gt;= 8.2.0'/>
+ <function name='random\randomexception::getfile' from='PHP 8 &gt;= 8.2.0'/>
+ <function name='random\randomexception::getline' from='PHP 8 &gt;= 8.2.0'/>
+ <function name='random\randomexception::gettrace' from='PHP 8 &gt;= 8.2.0'/>
+ <function name='random\randomexception::getprevious' from='PHP 8 &gt;= 8.2.0'/>
+ <function name='random\randomexception::gettraceasstring' from='PHP 8 &gt;= 8.2.0'/>
+ <function name='random\randomexception::__tostring' from='PHP 8 &gt;= 8.2.0'/>
 
- <function name='random\engine\mt19937' from='PHP 5 &gt;= Unknown'/>
- <function name='random\engine\mt19937::__construct' from='PHP 5 &gt;= Unknown'/>
- <function name='random\engine\mt19937::generate' from='PHP 5 &gt;= Unknown'/>
- <function name='random\engine\mt19937::__serialize' from='PHP 5 &gt;= Unknown'/>
- <function name='random\engine\mt19937::__unserialize' from='PHP 5 &gt;= Unknown'/>
- <function name='random\engine\mt19937::__debuginfo' from='PHP 5 &gt;= Unknown'/>
+ <function name='random\engine\mt19937' from='PHP 8 &gt;= 8.2.0'/>
+ <function name='random\engine\mt19937::__construct' from='PHP 8 &gt;= 8.2.0'/>
+ <function name='random\engine\mt19937::generate' from='PHP 8 &gt;= 8.2.0'/>
+ <function name='random\engine\mt19937::__serialize' from='PHP 8 &gt;= 8.2.0'/>
+ <function name='random\engine\mt19937::__unserialize' from='PHP 8 &gt;= 8.2.0'/>
+ <function name='random\engine\mt19937::__debuginfo' from='PHP 8 &gt;= 8.2.0'/>
 
- <function name='random\engine\pcgoneseq128xslrr64' from='PHP 5 &gt;= Unknown'/>
- <function name='random\engine\pcgoneseq128xslrr64::__construct' from='PHP 5 &gt;= Unknown'/>
- <function name='random\engine\pcgoneseq128xslrr64::generate' from='PHP 5 &gt;= Unknown'/>
- <function name='random\engine\pcgoneseq128xslrr64::jump' from='PHP 5 &gt;= Unknown'/>
- <function name='random\engine\pcgoneseq128xslrr64::__serialize' from='PHP 5 &gt;= Unknown'/>
- <function name='random\engine\pcgoneseq128xslrr64::__unserialize' from='PHP 5 &gt;= Unknown'/>
- <function name='random\engine\pcgoneseq128xslrr64::__debuginfo' from='PHP 5 &gt;= Unknown'/>
+ <function name='random\engine\pcgoneseq128xslrr64' from='PHP 8 &gt;= 8.2.0'/>
+ <function name='random\engine\pcgoneseq128xslrr64::__construct' from='PHP 8 &gt;= 8.2.0'/>
+ <function name='random\engine\pcgoneseq128xslrr64::generate' from='PHP 8 &gt;= 8.2.0'/>
+ <function name='random\engine\pcgoneseq128xslrr64::jump' from='PHP 8 &gt;= 8.2.0'/>
+ <function name='random\engine\pcgoneseq128xslrr64::__serialize' from='PHP 8 &gt;= 8.2.0'/>
+ <function name='random\engine\pcgoneseq128xslrr64::__unserialize' from='PHP 8 &gt;= 8.2.0'/>
+ <function name='random\engine\pcgoneseq128xslrr64::__debuginfo' from='PHP 8 &gt;= 8.2.0'/>
 
- <function name='random\engine\xoshiro256starstar' from='PHP 5 &gt;= Unknown'/>
- <function name='random\engine\xoshiro256starstar::__construct' from='PHP 5 &gt;= Unknown'/>
- <function name='random\engine\xoshiro256starstar::generate' from='PHP 5 &gt;= Unknown'/>
- <function name='random\engine\xoshiro256starstar::jump' from='PHP 5 &gt;= Unknown'/>
- <function name='random\engine\xoshiro256starstar::jumplong' from='PHP 5 &gt;= Unknown'/>
- <function name='random\engine\xoshiro256starstar::__serialize' from='PHP 5 &gt;= Unknown'/>
- <function name='random\engine\xoshiro256starstar::__unserialize' from='PHP 5 &gt;= Unknown'/>
- <function name='random\engine\xoshiro256starstar::__debuginfo' from='PHP 5 &gt;= Unknown'/>
+ <function name='random\engine\xoshiro256starstar' from='PHP 8 &gt;= 8.2.0'/>
+ <function name='random\engine\xoshiro256starstar::__construct' from='PHP 8 &gt;= 8.2.0'/>
+ <function name='random\engine\xoshiro256starstar::generate' from='PHP 8 &gt;= 8.2.0'/>
+ <function name='random\engine\xoshiro256starstar::jump' from='PHP 8 &gt;= 8.2.0'/>
+ <function name='random\engine\xoshiro256starstar::jumplong' from='PHP 8 &gt;= 8.2.0'/>
+ <function name='random\engine\xoshiro256starstar::__serialize' from='PHP 8 &gt;= 8.2.0'/>
+ <function name='random\engine\xoshiro256starstar::__unserialize' from='PHP 8 &gt;= 8.2.0'/>
+ <function name='random\engine\xoshiro256starstar::__debuginfo' from='PHP 8 &gt;= 8.2.0'/>
 
- <function name='random\engine\secure' from='PHP 5 &gt;= Unknown'/>
- <function name='random\engine\secure::generate' from='PHP 5 &gt;= Unknown'/>
+ <function name='random\engine\secure' from='PHP 8 &gt;= 8.2.0'/>
+ <function name='random\engine\secure::generate' from='PHP 8 &gt;= 8.2.0'/>
 
- <function name='random\randomizer' from='PHP 5 &gt;= Unknown'/>
- <function name='random\randomizer::__construct' from='PHP 5 &gt;= Unknown'/>
- <function name='random\randomizer::nextint' from='PHP 5 &gt;= Unknown'/>
- <function name='random\randomizer::getint' from='PHP 5 &gt;= Unknown'/>
- <function name='random\randomizer::getbytes' from='PHP 5 &gt;= Unknown'/>
- <function name='random\randomizer::shufflearray' from='PHP 5 &gt;= Unknown'/>
- <function name='random\randomizer::shufflebytes' from='PHP 5 &gt;= Unknown'/>
- <function name='random\randomizer::pickarraykeys' from='PHP 5 &gt;= Unknown'/>
- <function name='random\randomizer::__serialize' from='PHP 5 &gt;= Unknown'/>
- <function name='random\randomizer::__unserialize' from='PHP 5 &gt;= Unknown'/>
+ <function name='random\randomizer' from='PHP 8 &gt;= 8.2.0'/>
+ <function name='random\randomizer::__construct' from='PHP 8 &gt;= 8.2.0'/>
+ <function name='random\randomizer::nextint' from='PHP 8 &gt;= 8.2.0'/>
+ <function name='random\randomizer::getint' from='PHP 8 &gt;= 8.2.0'/>
+ <function name='random\randomizer::getbytes' from='PHP 8 &gt;= 8.2.0'/>
+ <function name='random\randomizer::shufflearray' from='PHP 8 &gt;= 8.2.0'/>
+ <function name='random\randomizer::shufflebytes' from='PHP 8 &gt;= 8.2.0'/>
+ <function name='random\randomizer::pickarraykeys' from='PHP 8 &gt;= 8.2.0'/>
+ <function name='random\randomizer::__serialize' from='PHP 8 &gt;= 8.2.0'/>
+ <function name='random\randomizer::__unserialize' from='PHP 8 &gt;= 8.2.0'/>
 </versions>
 <!-- Keep this comment at the end of the file
 Local variables:

From c2cab65a4db25356d7d35abb5d603e1cf852e7b7 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Tim=20D=C3=BCsterhus?= <tim@bastelstu.be>
Date: Tue, 25 Oct 2022 21:18:45 +0200
Subject: [PATCH 03/17] random: Fix position in extensions.xml

---
 appendices/extensions.xml | 2 +-
 reference/random/book.xml | 1 +
 2 files changed, 2 insertions(+), 1 deletion(-)

diff --git a/appendices/extensions.xml b/appendices/extensions.xml
index 9488dc6ebba9..21113f53e37c 100644
--- a/appendices/extensions.xml
+++ b/appendices/extensions.xml
@@ -220,6 +220,7 @@
     <listitem><para><xref linkend="book.outcontrol"/></para></listitem>
     <listitem><para><xref linkend="book.password"/></para></listitem>
     <listitem><para><xref linkend="book.pcre"/></para></listitem>
+    <listitem><para><xref linkend="book.random"/></para></listitem>
     <listitem><para><xref linkend="book.reflection"/></para></listitem>
     <listitem><para><xref linkend="book.spl"/></para></listitem>
     <listitem><para><xref linkend="book.stream"/></para></listitem>
@@ -255,7 +256,6 @@
     <listitem><para><xref linkend="book.phar"/></para></listitem>
     <listitem><para><xref linkend="book.phpdbg"/></para></listitem>
     <listitem><para><xref linkend="book.posix"/></para></listitem>
-    <listitem><para><xref linkend="book.random"/></para></listitem>
     <listitem><para><xref linkend="book.sem"/></para></listitem>
     <listitem><para><xref linkend="book.session"/></para></listitem>
     <listitem><para><xref linkend="book.shmop"/></para></listitem>
diff --git a/reference/random/book.xml b/reference/random/book.xml
index e8e5bb245d97..541313a27362 100644
--- a/reference/random/book.xml
+++ b/reference/random/book.xml
@@ -1,5 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <book xml:id="book.random" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
+ <?phpdoc extension-membership="core" ?>
  <title>Random</title>
  <titleabbrev>Random</titleabbrev>
 

From 2ca947638261da2f2ce38f2a2d4a5346bf0f27e1 Mon Sep 17 00:00:00 2001
From: "Christoph M. Becker" <cmbecker69@gmx.de>
Date: Wed, 26 Oct 2022 16:02:05 +0200
Subject: [PATCH 04/17] Hook up class and interface pages

---
 reference/random/book.xml                           | 13 +++++++++++++
 reference/random/random.brokenrandomengineerror.xml |  8 +-------
 reference/random/random.cryptosafeengine.xml        |  6 ++----
 reference/random/random.engine.mt19937.xml          |  3 ++-
 .../random/random.engine.pcgoneseq128xslrr64.xml    |  3 ++-
 reference/random/random.engine.secure.xml           |  2 +-
 reference/random/random.engine.xml                  |  2 +-
 .../random/random.engine.xoshiro256starstar.xml     |  3 ++-
 reference/random/random.randomerror.xml             |  6 ------
 reference/random/random.randomexception.xml         |  6 ------
 reference/random/random.randomizer.xml              |  3 ++-
 11 files changed, 26 insertions(+), 29 deletions(-)

diff --git a/reference/random/book.xml b/reference/random/book.xml
index 541313a27362..f12af5699516 100644
--- a/reference/random/book.xml
+++ b/reference/random/book.xml
@@ -16,6 +16,19 @@
  &reference.random.examples;
  &reference.random.reference;
 
+ &reference.random.random.randomizer;
+
+ &reference.random.random.engine;
+ &reference.random.random.engine.mt19937;
+ &reference.random.random.engine.pcgoneseq128xslrr64;
+ &reference.random.random.engine.xoshiro256starstar;
+ &reference.random.random.cryptosafeengine;
+ &reference.random.random.engine.secure;
+
+ &reference.random.random.randomerror;
+ &reference.random.random.brokenrandomengineerror;
+ &reference.random.random.randomexception;
+
 </book>
 <!-- Keep this comment at the end of the file
 Local variables:
diff --git a/reference/random/random.brokenrandomengineerror.xml b/reference/random/random.brokenrandomengineerror.xml
index 53bcebaa5c67..e0faa2cbb14e 100644
--- a/reference/random/random.brokenrandomengineerror.xml
+++ b/reference/random/random.brokenrandomengineerror.xml
@@ -40,12 +40,8 @@
     <classsynopsisinfo role="comment">&InheritedProperties;</classsynopsisinfo>
     <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('error.synopsis')/descendant::db:fieldsynopsis)"><xi:fallback/></xi:include>
 
-    
-    <classsynopsisinfo role="comment">&Methods;</classsynopsisinfo>
-    <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.random-brokenrandomengineerror')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[not(@role='procedural')])"><xi:fallback/></xi:include>
-    
     <classsynopsisinfo role="comment">&InheritedMethods;</classsynopsisinfo>
-    <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.random-randomerror')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[not(@role='procedural')])"><xi:fallback/></xi:include>
+    <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.error')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[not(@role='procedural')])"><xi:fallback/></xi:include>
 
    </classsynopsis>
 <!-- }}} -->
@@ -54,8 +50,6 @@
 
  </partintro>
 
- &reference.random.entities.random-brokenrandomengineerror;
-
 </phpdoc:classref>
 <!-- Keep this comment at the end of the file
 Local variables:
diff --git a/reference/random/random.cryptosafeengine.xml b/reference/random/random.cryptosafeengine.xml
index a7f87ac057e5..75c94d8a9ffe 100644
--- a/reference/random/random.cryptosafeengine.xml
+++ b/reference/random/random.cryptosafeengine.xml
@@ -33,8 +33,8 @@
     </classsynopsisinfo>
 <!-- }}} -->
     
-    <classsynopsisinfo role="comment">&Methods;</classsynopsisinfo>
-    <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.random-cryptosafeengine')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[not(@role='procedural')])"><xi:fallback/></xi:include>
+    <!-- <classsynopsisinfo role="comment">&Methods;</classsynopsisinfo>
+    <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.random-cryptosafeengine')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[not(@role='procedural')])"><xi:fallback/></xi:include> -->
    </classsynopsis>
 <!-- }}} -->
 
@@ -42,8 +42,6 @@
 
  </partintro>
 
- &reference.random.entities.random-cryptosafeengine;
-
 </phpdoc:classref>
 <!-- Keep this comment at the end of the file
 Local variables:
diff --git a/reference/random/random.engine.mt19937.xml b/reference/random/random.engine.mt19937.xml
index 26870507a45f..dd4d5764210e 100644
--- a/reference/random/random.engine.mt19937.xml
+++ b/reference/random/random.engine.mt19937.xml
@@ -34,6 +34,7 @@
 <!-- }}} -->
     
     <classsynopsisinfo role="comment">&Methods;</classsynopsisinfo>
+    <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.random-engine-mt19937')/db:refentry/db:refsect1[@role='description']/descendant::db:constructorsynopsis[not(@role='procedural')])"><xi:fallback/></xi:include>
     <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.random-engine-mt19937')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[not(@role='procedural')])"><xi:fallback/></xi:include>
    </classsynopsis>
 <!-- }}} -->
@@ -42,7 +43,7 @@
 
  </partintro>
 
- &reference.random.entities.random-engine-mt19937;
+ &reference.random.random.engine.entities.mt19937;
 
 </phpdoc:classref>
 <!-- Keep this comment at the end of the file
diff --git a/reference/random/random.engine.pcgoneseq128xslrr64.xml b/reference/random/random.engine.pcgoneseq128xslrr64.xml
index 2a394d2de5c1..b3119fde580d 100644
--- a/reference/random/random.engine.pcgoneseq128xslrr64.xml
+++ b/reference/random/random.engine.pcgoneseq128xslrr64.xml
@@ -34,6 +34,7 @@
 <!-- }}} -->
     
     <classsynopsisinfo role="comment">&Methods;</classsynopsisinfo>
+    <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.random-engine-pcgoneseq128xslrr64')/db:refentry/db:refsect1[@role='description']/descendant::db:constructorsynopsis[not(@role='procedural')])"><xi:fallback/></xi:include>
     <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.random-engine-pcgoneseq128xslrr64')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[not(@role='procedural')])"><xi:fallback/></xi:include>
    </classsynopsis>
 <!-- }}} -->
@@ -42,7 +43,7 @@
 
  </partintro>
 
- &reference.random.entities.random-engine-pcgoneseq128xslrr64;
+ &reference.random.random.engine.entities.pcgoneseq128xslrr64;
 
 </phpdoc:classref>
 <!-- Keep this comment at the end of the file
diff --git a/reference/random/random.engine.secure.xml b/reference/random/random.engine.secure.xml
index c3dd9be12ed5..e85b47896bde 100644
--- a/reference/random/random.engine.secure.xml
+++ b/reference/random/random.engine.secure.xml
@@ -42,7 +42,7 @@
 
  </partintro>
 
- &reference.random.entities.random-engine-secure;
+ &reference.random.random.engine.entities.secure;
 
 </phpdoc:classref>
 <!-- Keep this comment at the end of the file
diff --git a/reference/random/random.engine.xml b/reference/random/random.engine.xml
index 4cc7f1bfb224..65743293a71b 100644
--- a/reference/random/random.engine.xml
+++ b/reference/random/random.engine.xml
@@ -38,7 +38,7 @@
 
  </partintro>
 
- &reference.random.entities.random-engine;
+ &reference.random.random.engine.generate;
 
 </phpdoc:classref>
 <!-- Keep this comment at the end of the file
diff --git a/reference/random/random.engine.xoshiro256starstar.xml b/reference/random/random.engine.xoshiro256starstar.xml
index d379b1d925ee..cc4ae12f976b 100644
--- a/reference/random/random.engine.xoshiro256starstar.xml
+++ b/reference/random/random.engine.xoshiro256starstar.xml
@@ -34,6 +34,7 @@
 <!-- }}} -->
     
     <classsynopsisinfo role="comment">&Methods;</classsynopsisinfo>
+    <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.random-engine-xoshiro256starstar')/db:refentry/db:refsect1[@role='description']/descendant::db:constructorsynopsis[not(@role='procedural')])"><xi:fallback/></xi:include>
     <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.random-engine-xoshiro256starstar')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[not(@role='procedural')])"><xi:fallback/></xi:include>
    </classsynopsis>
 <!-- }}} -->
@@ -42,7 +43,7 @@
 
  </partintro>
 
- &reference.random.entities.random-engine-xoshiro256starstar;
+ &reference.random.random.engine.entities.xoshiro256starstar;
 
 </phpdoc:classref>
 <!-- Keep this comment at the end of the file
diff --git a/reference/random/random.randomerror.xml b/reference/random/random.randomerror.xml
index 7652360228ea..91279c9eed55 100644
--- a/reference/random/random.randomerror.xml
+++ b/reference/random/random.randomerror.xml
@@ -40,10 +40,6 @@
     <classsynopsisinfo role="comment">&InheritedProperties;</classsynopsisinfo>
     <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('error.synopsis')/descendant::db:fieldsynopsis)"><xi:fallback/></xi:include>
 
-    
-    <classsynopsisinfo role="comment">&Methods;</classsynopsisinfo>
-    <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.random-randomerror')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[not(@role='procedural')])"><xi:fallback/></xi:include>
-    
     <classsynopsisinfo role="comment">&InheritedMethods;</classsynopsisinfo>
     <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.error')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[not(@role='procedural')])"><xi:fallback/></xi:include>
 
@@ -54,8 +50,6 @@
 
  </partintro>
 
- &reference.random.entities.random-randomerror;
-
 </phpdoc:classref>
 <!-- Keep this comment at the end of the file
 Local variables:
diff --git a/reference/random/random.randomexception.xml b/reference/random/random.randomexception.xml
index 8d31bcbb87c0..c7fb76ab7cb1 100644
--- a/reference/random/random.randomexception.xml
+++ b/reference/random/random.randomexception.xml
@@ -40,10 +40,6 @@
     <classsynopsisinfo role="comment">&InheritedProperties;</classsynopsisinfo>
     <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('exception.synopsis')/descendant::db:fieldsynopsis)"><xi:fallback/></xi:include>
 
-    
-    <classsynopsisinfo role="comment">&Methods;</classsynopsisinfo>
-    <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.random-randomexception')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[not(@role='procedural')])"><xi:fallback/></xi:include>
-    
     <classsynopsisinfo role="comment">&InheritedMethods;</classsynopsisinfo>
     <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.exception')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[not(@role='procedural')])"><xi:fallback/></xi:include>
 
@@ -54,8 +50,6 @@
 
  </partintro>
 
- &reference.random.entities.random-randomexception;
-
 </phpdoc:classref>
 <!-- Keep this comment at the end of the file
 Local variables:
diff --git a/reference/random/random.randomizer.xml b/reference/random/random.randomizer.xml
index 148325f6b5ab..cbad35f9219d 100644
--- a/reference/random/random.randomizer.xml
+++ b/reference/random/random.randomizer.xml
@@ -36,6 +36,7 @@
 
     
     <classsynopsisinfo role="comment">&Methods;</classsynopsisinfo>
+    <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.random-randomizer')/db:refentry/db:refsect1[@role='description']/descendant::db:constructorsynopsis[not(@role='procedural')])"><xi:fallback /></xi:include>
     <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.random-randomizer')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[not(@role='procedural')])"><xi:fallback/></xi:include>
    </classsynopsis>
 <!-- }}} -->
@@ -60,7 +61,7 @@
 
  </partintro>
 
- &reference.random.entities.random-randomizer;
+ &reference.random.random.entities.randomizer;
 
 </phpdoc:classref>
 <!-- Keep this comment at the end of the file

From b399acddc4d725e5e0c4be0470590f7b1d769c1f Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Tim=20D=C3=BCsterhus?= <tim@bastelstu.be>
Date: Wed, 26 Oct 2022 16:11:48 +0200
Subject: [PATCH 05/17] random: Use `&extension.constants.core;`

---
 reference/random/constants.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/reference/random/constants.xml b/reference/random/constants.xml
index 42ec92c26f5c..3c65c4db5b4a 100644
--- a/reference/random/constants.xml
+++ b/reference/random/constants.xml
@@ -1,7 +1,7 @@
 <?xml version="1.0" encoding="utf-8"?>
 <appendix xml:id="random.constants" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  &reftitle.constants;
- &extension.constants;
+ &extension.constants.core;
  <para>
   <variablelist>
    <varlistentry xml:id="constant.mt-rand-mt19937">

From 473fe6e3be30928800894608803768f86fd441e0 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Tim=20D=C3=BCsterhus?= <tim@bastelstu.be>
Date: Wed, 26 Oct 2022 16:12:23 +0200
Subject: [PATCH 06/17] random: Drop useless book.developer.xml

---
 reference/random/book.developer.xml | 72 -----------------------------
 1 file changed, 72 deletions(-)
 delete mode 100644 reference/random/book.developer.xml

diff --git a/reference/random/book.developer.xml b/reference/random/book.developer.xml
deleted file mode 100644
index 9d47536facc5..000000000000
--- a/reference/random/book.developer.xml
+++ /dev/null
@@ -1,72 +0,0 @@
-<?xml version="1.0" encoding="utf-8"?>
-<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V5.0//EN"
-"{PATH_TO_DOCBASE}/docbook/docbook-xml/docbook.dtd" [
-<!-- We use xhtml entities all over the place -->
-<!ENTITY % xhtml-lat1        SYSTEM "{PATH_TO_DOCBASE}/entities/ISO/xhtml1-lat1.ent">
-<!ENTITY % xhtml-symbol      SYSTEM "{PATH_TO_DOCBASE}/entities/ISO/xhtml1-symbol.ent">
-<!ENTITY % xhtml-special     SYSTEM "{PATH_TO_DOCBASE}/entities/ISO/xhtml1-special.ent">
-<!ENTITY % isopub            SYSTEM "{PATH_TO_DOCBASE}/entities/ISO/isopub.ent">
-%xhtml-lat1;
-%xhtml-symbol;
-%xhtml-special;
-%isopub;
-
-<!-- Fallback to English definitions and snippets (in case of missing translation) -->
-<!ENTITY % language-defs.default     SYSTEM "{PATH_TO_DOC}/language-defs.ent">
-<!ENTITY % language-snippets.default SYSTEM "{PATH_TO_DOC}/language-snippets.ent">
-<!ENTITY % extensions.default        SYSTEM "{PATH_TO_DOC}/extensions.ent">
-
-%language-defs.default;
-%extensions.default;
-%language-snippets.default;
-
-<!-- All global entities for the XML files -->
-<!ENTITY % global.entities  SYSTEM "{PATH_TO_DOCBASE}/entities/global.ent">
-
-<!-- These are language independent -->
-<!ENTITY % frontpage.entities SYSTEM "{PATH_TO_DOC}/contributors.ent">
-<!ENTITY % file.entities      SYSTEM "{PATH_TO_DOCBASE}/entities/file-entities.ent">
-
-<!-- Include all external DTD parts defined previously -->
-%global.entities;
-%file.entities;
-%frontpage.entities;
-]>
-
-<book xml:id="book.random" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:lang="en">
- <title>Random</title>
- <titleabbrev>Random</titleabbrev>
-
- <preface xml:id="intro.random">
-  &reftitle.intro;
-  <para>
-
-  </para>
- </preface>
-
- &reference.random.setup;
- &reference.random.constants;
- &reference.random.examples;
- &reference.random.reference;
-
-</book>
-<!-- Keep this comment at the end of the file
-Local variables:
-mode: sgml
-sgml-omittag:t
-sgml-shorttag:t
-sgml-minimize-attributes:nil
-sgml-always-quote-attributes:t
-sgml-indent-step:1
-sgml-indent-data:t
-indent-tabs-mode:nil
-sgml-parent-document:nil
-sgml-default-dtd-file:"~/.phpdoc/manual.ced"
-sgml-exposed-tags:nil
-sgml-local-catalogs:nil
-sgml-local-ecat-files:nil
-End:
-vim600: syn=xml fen fdm=syntax fdl=2 si
-vim: et tw=78 syn=sgml
-vi: ts=1 sw=1
--->

From 91d72ecddaebcf521b0fc19643a000805655ee0a Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Tim=20D=C3=BCsterhus?= <tim@bastelstu.be>
Date: Wed, 26 Oct 2022 18:48:41 +0200
Subject: [PATCH 07/17] random: Configure a proper book title

---
 reference/random/book.xml | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/reference/random/book.xml b/reference/random/book.xml
index f12af5699516..8fc70ff418b9 100644
--- a/reference/random/book.xml
+++ b/reference/random/book.xml
@@ -1,8 +1,8 @@
 <?xml version="1.0" encoding="utf-8"?>
 <book xml:id="book.random" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <?phpdoc extension-membership="core" ?>
- <title>Random</title>
- <titleabbrev>Random</titleabbrev>
+ <title>Random Number Generators and Functions Related to Randomness</title>
+ <titleabbrev>random</titleabbrev>
 
  <preface xml:id="intro.random">
   &reftitle.intro;

From bed096e6c4659f65f2db1b3798579abbbcf20999 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Tim=20D=C3=BCsterhus?= <tim@bastelstu.be>
Date: Wed, 26 Oct 2022 18:49:53 +0200
Subject: [PATCH 08/17] random: Add refpurpose to all methods

---
 reference/random/random/engine/generate.xml                     | 2 +-
 reference/random/random/engine/mt19937/construct.xml            | 2 +-
 reference/random/random/engine/mt19937/debuginfo.xml            | 2 +-
 reference/random/random/engine/mt19937/generate.xml             | 2 +-
 reference/random/random/engine/mt19937/serialize.xml            | 2 +-
 reference/random/random/engine/mt19937/unserialize.xml          | 2 +-
 .../random/random/engine/pcgoneseq128xslrr64/construct.xml      | 2 +-
 .../random/random/engine/pcgoneseq128xslrr64/debuginfo.xml      | 2 +-
 reference/random/random/engine/pcgoneseq128xslrr64/generate.xml | 2 +-
 reference/random/random/engine/pcgoneseq128xslrr64/jump.xml     | 2 +-
 .../random/random/engine/pcgoneseq128xslrr64/serialize.xml      | 2 +-
 .../random/random/engine/pcgoneseq128xslrr64/unserialize.xml    | 2 +-
 reference/random/random/engine/secure/generate.xml              | 2 +-
 reference/random/random/engine/xoshiro256starstar/construct.xml | 2 +-
 reference/random/random/engine/xoshiro256starstar/debuginfo.xml | 2 +-
 reference/random/random/engine/xoshiro256starstar/generate.xml  | 2 +-
 reference/random/random/engine/xoshiro256starstar/jump.xml      | 2 +-
 reference/random/random/engine/xoshiro256starstar/jumplong.xml  | 2 +-
 reference/random/random/engine/xoshiro256starstar/serialize.xml | 2 +-
 .../random/random/engine/xoshiro256starstar/unserialize.xml     | 2 +-
 reference/random/random/randomizer/construct.xml                | 2 +-
 reference/random/random/randomizer/getbytes.xml                 | 2 +-
 reference/random/random/randomizer/getint.xml                   | 2 +-
 reference/random/random/randomizer/nextint.xml                  | 2 +-
 reference/random/random/randomizer/pickarraykeys.xml            | 2 +-
 reference/random/random/randomizer/serialize.xml                | 2 +-
 reference/random/random/randomizer/shufflearray.xml             | 2 +-
 reference/random/random/randomizer/shufflebytes.xml             | 2 +-
 reference/random/random/randomizer/unserialize.xml              | 2 +-
 29 files changed, 29 insertions(+), 29 deletions(-)

diff --git a/reference/random/random/engine/generate.xml b/reference/random/random/engine/generate.xml
index fe2becf39617..59aa97606505 100644
--- a/reference/random/random/engine/generate.xml
+++ b/reference/random/random/engine/generate.xml
@@ -2,7 +2,7 @@
 <refentry xml:id="random-engine.generate" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
   <refname>Random\Engine::generate</refname>
-  <refpurpose>Description</refpurpose>
+  <refpurpose>Generates randomness</refpurpose>
  </refnamediv>
 
  <refsect1 role="description">
diff --git a/reference/random/random/engine/mt19937/construct.xml b/reference/random/random/engine/mt19937/construct.xml
index 2a8afe1f5210..d6c9f8359a3e 100644
--- a/reference/random/random/engine/mt19937/construct.xml
+++ b/reference/random/random/engine/mt19937/construct.xml
@@ -2,7 +2,7 @@
 <refentry xml:id="random-engine-mt19937.construct" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
   <refname>Random\Engine\Mt19937::__construct</refname>
-  <refpurpose>Description</refpurpose>
+  <refpurpose>Constructs a new Mt19937 engine</refpurpose>
  </refnamediv>
 
  <refsect1 role="description">
diff --git a/reference/random/random/engine/mt19937/debuginfo.xml b/reference/random/random/engine/mt19937/debuginfo.xml
index 8150f15d8374..00a49c9a23b7 100644
--- a/reference/random/random/engine/mt19937/debuginfo.xml
+++ b/reference/random/random/engine/mt19937/debuginfo.xml
@@ -2,7 +2,7 @@
 <refentry xml:id="random-engine-mt19937.debuginfo" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
   <refname>Random\Engine\Mt19937::__debugInfo</refname>
-  <refpurpose>Description</refpurpose>
+  <refpurpose>Returns the internal state of the engine</refpurpose>
  </refnamediv>
 
  <refsect1 role="description">
diff --git a/reference/random/random/engine/mt19937/generate.xml b/reference/random/random/engine/mt19937/generate.xml
index 605af07798f1..e2776ccf5085 100644
--- a/reference/random/random/engine/mt19937/generate.xml
+++ b/reference/random/random/engine/mt19937/generate.xml
@@ -2,7 +2,7 @@
 <refentry xml:id="random-engine-mt19937.generate" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
   <refname>Random\Engine\Mt19937::generate</refname>
-  <refpurpose>Description</refpurpose>
+  <refpurpose>Generates 32 Bits of randomness</refpurpose>
  </refnamediv>
 
  <refsect1 role="description">
diff --git a/reference/random/random/engine/mt19937/serialize.xml b/reference/random/random/engine/mt19937/serialize.xml
index 42ff90744802..dd82bc162801 100644
--- a/reference/random/random/engine/mt19937/serialize.xml
+++ b/reference/random/random/engine/mt19937/serialize.xml
@@ -2,7 +2,7 @@
 <refentry xml:id="random-engine-mt19937.serialize" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
   <refname>Random\Engine\Mt19937::__serialize</refname>
-  <refpurpose>Description</refpurpose>
+  <refpurpose>Serializes the Mt19937 object</refpurpose>
  </refnamediv>
 
  <refsect1 role="description">
diff --git a/reference/random/random/engine/mt19937/unserialize.xml b/reference/random/random/engine/mt19937/unserialize.xml
index 116f25b238c8..6adb25e76f05 100644
--- a/reference/random/random/engine/mt19937/unserialize.xml
+++ b/reference/random/random/engine/mt19937/unserialize.xml
@@ -2,7 +2,7 @@
 <refentry xml:id="random-engine-mt19937.unserialize" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
   <refname>Random\Engine\Mt19937::__unserialize</refname>
-  <refpurpose>Description</refpurpose>
+  <refpurpose>Deserializes the <parameter>data</parameter> parameter into a Mt19937 object</refpurpose>
  </refnamediv>
 
  <refsect1 role="description">
diff --git a/reference/random/random/engine/pcgoneseq128xslrr64/construct.xml b/reference/random/random/engine/pcgoneseq128xslrr64/construct.xml
index 93d26670cef4..e281db7127f5 100644
--- a/reference/random/random/engine/pcgoneseq128xslrr64/construct.xml
+++ b/reference/random/random/engine/pcgoneseq128xslrr64/construct.xml
@@ -2,7 +2,7 @@
 <refentry xml:id="random-engine-pcgoneseq128xslrr64.construct" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
   <refname>Random\Engine\PcgOneseq128XslRr64::__construct</refname>
-  <refpurpose>Description</refpurpose>
+  <refpurpose>Constructs a new PCG Oneseq 128 XSL RR 64 engine</refpurpose>
  </refnamediv>
 
  <refsect1 role="description">
diff --git a/reference/random/random/engine/pcgoneseq128xslrr64/debuginfo.xml b/reference/random/random/engine/pcgoneseq128xslrr64/debuginfo.xml
index b5bb5ffa50a8..a4e11beeba37 100644
--- a/reference/random/random/engine/pcgoneseq128xslrr64/debuginfo.xml
+++ b/reference/random/random/engine/pcgoneseq128xslrr64/debuginfo.xml
@@ -2,7 +2,7 @@
 <refentry xml:id="random-engine-pcgoneseq128xslrr64.debuginfo" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
   <refname>Random\Engine\PcgOneseq128XslRr64::__debugInfo</refname>
-  <refpurpose>Description</refpurpose>
+  <refpurpose>Returns the internal state of the engine</refpurpose>
  </refnamediv>
 
  <refsect1 role="description">
diff --git a/reference/random/random/engine/pcgoneseq128xslrr64/generate.xml b/reference/random/random/engine/pcgoneseq128xslrr64/generate.xml
index 6a10fa0963e2..70e283570f6e 100644
--- a/reference/random/random/engine/pcgoneseq128xslrr64/generate.xml
+++ b/reference/random/random/engine/pcgoneseq128xslrr64/generate.xml
@@ -2,7 +2,7 @@
 <refentry xml:id="random-engine-pcgoneseq128xslrr64.generate" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
   <refname>Random\Engine\PcgOneseq128XslRr64::generate</refname>
-  <refpurpose>Description</refpurpose>
+  <refpurpose>Generates 64 Bits of randomness</refpurpose>
  </refnamediv>
 
  <refsect1 role="description">
diff --git a/reference/random/random/engine/pcgoneseq128xslrr64/jump.xml b/reference/random/random/engine/pcgoneseq128xslrr64/jump.xml
index 4e906719fbc0..72c9a90fac7a 100644
--- a/reference/random/random/engine/pcgoneseq128xslrr64/jump.xml
+++ b/reference/random/random/engine/pcgoneseq128xslrr64/jump.xml
@@ -2,7 +2,7 @@
 <refentry xml:id="random-engine-pcgoneseq128xslrr64.jump" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
   <refname>Random\Engine\PcgOneseq128XslRr64::jump</refname>
-  <refpurpose>Description</refpurpose>
+  <refpurpose>Efficiently moves the engine ahead multiple steps</refpurpose>
  </refnamediv>
 
  <refsect1 role="description">
diff --git a/reference/random/random/engine/pcgoneseq128xslrr64/serialize.xml b/reference/random/random/engine/pcgoneseq128xslrr64/serialize.xml
index 69f19838d92d..097b6026dc17 100644
--- a/reference/random/random/engine/pcgoneseq128xslrr64/serialize.xml
+++ b/reference/random/random/engine/pcgoneseq128xslrr64/serialize.xml
@@ -2,7 +2,7 @@
 <refentry xml:id="random-engine-pcgoneseq128xslrr64.serialize" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
   <refname>Random\Engine\PcgOneseq128XslRr64::__serialize</refname>
-  <refpurpose>Description</refpurpose>
+  <refpurpose>Serializes the PcgOneseq128XslRr64 object</refpurpose>
  </refnamediv>
 
  <refsect1 role="description">
diff --git a/reference/random/random/engine/pcgoneseq128xslrr64/unserialize.xml b/reference/random/random/engine/pcgoneseq128xslrr64/unserialize.xml
index fd62e98203a7..edc10207b6a0 100644
--- a/reference/random/random/engine/pcgoneseq128xslrr64/unserialize.xml
+++ b/reference/random/random/engine/pcgoneseq128xslrr64/unserialize.xml
@@ -2,7 +2,7 @@
 <refentry xml:id="random-engine-pcgoneseq128xslrr64.unserialize" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
   <refname>Random\Engine\PcgOneseq128XslRr64::__unserialize</refname>
-  <refpurpose>Description</refpurpose>
+  <refpurpose>Deserializes the <parameter>data</parameter> parameter into a PcgOneseq128XslRr64 object</refpurpose>
  </refnamediv>
 
  <refsect1 role="description">
diff --git a/reference/random/random/engine/secure/generate.xml b/reference/random/random/engine/secure/generate.xml
index c046b3348552..b772fc36dd87 100644
--- a/reference/random/random/engine/secure/generate.xml
+++ b/reference/random/random/engine/secure/generate.xml
@@ -2,7 +2,7 @@
 <refentry xml:id="random-engine-secure.generate" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
   <refname>Random\Engine\Secure::generate</refname>
-  <refpurpose>Description</refpurpose>
+  <refpurpose>Generates cryptographically secure randomness</refpurpose>
  </refnamediv>
 
  <refsect1 role="description">
diff --git a/reference/random/random/engine/xoshiro256starstar/construct.xml b/reference/random/random/engine/xoshiro256starstar/construct.xml
index c02f1c98fa3f..80b11e87904d 100644
--- a/reference/random/random/engine/xoshiro256starstar/construct.xml
+++ b/reference/random/random/engine/xoshiro256starstar/construct.xml
@@ -2,7 +2,7 @@
 <refentry xml:id="random-engine-xoshiro256starstar.construct" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
   <refname>Random\Engine\Xoshiro256StarStar::__construct</refname>
-  <refpurpose>Description</refpurpose>
+  <refpurpose>Constructs a new xoshiro256** engine</refpurpose>
  </refnamediv>
 
  <refsect1 role="description">
diff --git a/reference/random/random/engine/xoshiro256starstar/debuginfo.xml b/reference/random/random/engine/xoshiro256starstar/debuginfo.xml
index 59030a2e9b5c..4c124da39e52 100644
--- a/reference/random/random/engine/xoshiro256starstar/debuginfo.xml
+++ b/reference/random/random/engine/xoshiro256starstar/debuginfo.xml
@@ -2,7 +2,7 @@
 <refentry xml:id="random-engine-xoshiro256starstar.debuginfo" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
   <refname>Random\Engine\Xoshiro256StarStar::__debugInfo</refname>
-  <refpurpose>Description</refpurpose>
+  <refpurpose>Returns the internal state of the engine</refpurpose>
  </refnamediv>
 
  <refsect1 role="description">
diff --git a/reference/random/random/engine/xoshiro256starstar/generate.xml b/reference/random/random/engine/xoshiro256starstar/generate.xml
index 707ab14484d0..ec8d9ddf5643 100644
--- a/reference/random/random/engine/xoshiro256starstar/generate.xml
+++ b/reference/random/random/engine/xoshiro256starstar/generate.xml
@@ -2,7 +2,7 @@
 <refentry xml:id="random-engine-xoshiro256starstar.generate" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
   <refname>Random\Engine\Xoshiro256StarStar::generate</refname>
-  <refpurpose>Description</refpurpose>
+  <refpurpose>Generates 64 Bits of randomness</refpurpose>
  </refnamediv>
 
  <refsect1 role="description">
diff --git a/reference/random/random/engine/xoshiro256starstar/jump.xml b/reference/random/random/engine/xoshiro256starstar/jump.xml
index cdc6b6ee7e82..99df7948473b 100644
--- a/reference/random/random/engine/xoshiro256starstar/jump.xml
+++ b/reference/random/random/engine/xoshiro256starstar/jump.xml
@@ -2,7 +2,7 @@
 <refentry xml:id="random-engine-xoshiro256starstar.jump" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
   <refname>Random\Engine\Xoshiro256StarStar::jump</refname>
-  <refpurpose>Description</refpurpose>
+  <refpurpose>Efficiently moves the engine ahead by 2^128 steps</refpurpose>
  </refnamediv>
 
  <refsect1 role="description">
diff --git a/reference/random/random/engine/xoshiro256starstar/jumplong.xml b/reference/random/random/engine/xoshiro256starstar/jumplong.xml
index 3ecb7b357e7a..667c3c4d4095 100644
--- a/reference/random/random/engine/xoshiro256starstar/jumplong.xml
+++ b/reference/random/random/engine/xoshiro256starstar/jumplong.xml
@@ -2,7 +2,7 @@
 <refentry xml:id="random-engine-xoshiro256starstar.jumplong" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
   <refname>Random\Engine\Xoshiro256StarStar::jumpLong</refname>
-  <refpurpose>Description</refpurpose>
+  <refpurpose>Efficiently moves the engine ahead by 2^192 steps</refpurpose>
  </refnamediv>
 
  <refsect1 role="description">
diff --git a/reference/random/random/engine/xoshiro256starstar/serialize.xml b/reference/random/random/engine/xoshiro256starstar/serialize.xml
index 6f0767084edc..49ca6fe28a2d 100644
--- a/reference/random/random/engine/xoshiro256starstar/serialize.xml
+++ b/reference/random/random/engine/xoshiro256starstar/serialize.xml
@@ -2,7 +2,7 @@
 <refentry xml:id="random-engine-xoshiro256starstar.serialize" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
   <refname>Random\Engine\Xoshiro256StarStar::__serialize</refname>
-  <refpurpose>Description</refpurpose>
+  <refpurpose>Serializes the Xoshiro256StarStar object</refpurpose>
  </refnamediv>
 
  <refsect1 role="description">
diff --git a/reference/random/random/engine/xoshiro256starstar/unserialize.xml b/reference/random/random/engine/xoshiro256starstar/unserialize.xml
index daefad2a288a..213ab1d0f2b1 100644
--- a/reference/random/random/engine/xoshiro256starstar/unserialize.xml
+++ b/reference/random/random/engine/xoshiro256starstar/unserialize.xml
@@ -2,7 +2,7 @@
 <refentry xml:id="random-engine-xoshiro256starstar.unserialize" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
   <refname>Random\Engine\Xoshiro256StarStar::__unserialize</refname>
-  <refpurpose>Description</refpurpose>
+  <refpurpose>Deserializes the <parameter>data</parameter> parameter into a Xoshiro256StarStar object</refpurpose>
  </refnamediv>
 
  <refsect1 role="description">
diff --git a/reference/random/random/randomizer/construct.xml b/reference/random/random/randomizer/construct.xml
index cf023232b9f7..453adcaa7f73 100644
--- a/reference/random/random/randomizer/construct.xml
+++ b/reference/random/random/randomizer/construct.xml
@@ -2,7 +2,7 @@
 <refentry xml:id="random-randomizer.construct" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
   <refname>Random\Randomizer::__construct</refname>
-  <refpurpose>Description</refpurpose>
+  <refpurpose>Constructs a new Randomizer</refpurpose>
  </refnamediv>
 
  <refsect1 role="description">
diff --git a/reference/random/random/randomizer/getbytes.xml b/reference/random/random/randomizer/getbytes.xml
index 5913b8abad2a..7e9953fe8a28 100644
--- a/reference/random/random/randomizer/getbytes.xml
+++ b/reference/random/random/randomizer/getbytes.xml
@@ -2,7 +2,7 @@
 <refentry xml:id="random-randomizer.getbytes" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
   <refname>Random\Randomizer::getBytes</refname>
-  <refpurpose>Description</refpurpose>
+  <refpurpose>Get random bytes</refpurpose>
  </refnamediv>
 
  <refsect1 role="description">
diff --git a/reference/random/random/randomizer/getint.xml b/reference/random/random/randomizer/getint.xml
index 83f4950ea1fd..4cc14845ad29 100644
--- a/reference/random/random/randomizer/getint.xml
+++ b/reference/random/random/randomizer/getint.xml
@@ -2,7 +2,7 @@
 <refentry xml:id="random-randomizer.getint" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
   <refname>Random\Randomizer::getInt</refname>
-  <refpurpose>Description</refpurpose>
+  <refpurpose>Get a uniformly chosen integer from an interval</refpurpose>
  </refnamediv>
 
  <refsect1 role="description">
diff --git a/reference/random/random/randomizer/nextint.xml b/reference/random/random/randomizer/nextint.xml
index f3e0ced02ad8..db1d632af0d4 100644
--- a/reference/random/random/randomizer/nextint.xml
+++ b/reference/random/random/randomizer/nextint.xml
@@ -2,7 +2,7 @@
 <refentry xml:id="random-randomizer.nextint" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
   <refname>Random\Randomizer::nextInt</refname>
-  <refpurpose>Description</refpurpose>
+  <refpurpose>Get a positive integer</refpurpose>
  </refnamediv>
 
  <refsect1 role="description">
diff --git a/reference/random/random/randomizer/pickarraykeys.xml b/reference/random/random/randomizer/pickarraykeys.xml
index fcd9bdd16f30..5dcb96945869 100644
--- a/reference/random/random/randomizer/pickarraykeys.xml
+++ b/reference/random/random/randomizer/pickarraykeys.xml
@@ -2,7 +2,7 @@
 <refentry xml:id="random-randomizer.pickarraykeys" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
   <refname>Random\Randomizer::pickArrayKeys</refname>
-  <refpurpose>Description</refpurpose>
+  <refpurpose>Select random array keys</refpurpose>
  </refnamediv>
 
  <refsect1 role="description">
diff --git a/reference/random/random/randomizer/serialize.xml b/reference/random/random/randomizer/serialize.xml
index d9c87717b41d..9f9e52f8a4ff 100644
--- a/reference/random/random/randomizer/serialize.xml
+++ b/reference/random/random/randomizer/serialize.xml
@@ -2,7 +2,7 @@
 <refentry xml:id="random-randomizer.serialize" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
   <refname>Random\Randomizer::__serialize</refname>
-  <refpurpose>Description</refpurpose>
+  <refpurpose>Serializes the Randomizer object</refpurpose>
  </refnamediv>
 
  <refsect1 role="description">
diff --git a/reference/random/random/randomizer/shufflearray.xml b/reference/random/random/randomizer/shufflearray.xml
index a21f388b6954..c45dc3a3ec04 100644
--- a/reference/random/random/randomizer/shufflearray.xml
+++ b/reference/random/random/randomizer/shufflearray.xml
@@ -2,7 +2,7 @@
 <refentry xml:id="random-randomizer.shufflearray" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
   <refname>Random\Randomizer::shuffleArray</refname>
-  <refpurpose>Description</refpurpose>
+  <refpurpose>Shuffle the values of an array</refpurpose>
  </refnamediv>
 
  <refsect1 role="description">
diff --git a/reference/random/random/randomizer/shufflebytes.xml b/reference/random/random/randomizer/shufflebytes.xml
index bc18e08b0b63..d2e1e7bbc750 100644
--- a/reference/random/random/randomizer/shufflebytes.xml
+++ b/reference/random/random/randomizer/shufflebytes.xml
@@ -2,7 +2,7 @@
 <refentry xml:id="random-randomizer.shufflebytes" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
   <refname>Random\Randomizer::shuffleBytes</refname>
-  <refpurpose>Description</refpurpose>
+  <refpurpose>Shuffle the bytes of a string</refpurpose>
  </refnamediv>
 
  <refsect1 role="description">
diff --git a/reference/random/random/randomizer/unserialize.xml b/reference/random/random/randomizer/unserialize.xml
index 7444acd3c5c0..3698696313f7 100644
--- a/reference/random/random/randomizer/unserialize.xml
+++ b/reference/random/random/randomizer/unserialize.xml
@@ -2,7 +2,7 @@
 <refentry xml:id="random-randomizer.unserialize" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
   <refname>Random\Randomizer::__unserialize</refname>
-  <refpurpose>Description</refpurpose>
+  <refpurpose>Deserializes the <parameter>data</parameter> parameter into a Randomizer object</refpurpose>
  </refnamediv>
 
  <refsect1 role="description">

From c9f249ce1150dab173416b2104d8487e0172bbd4 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Tim=20D=C3=BCsterhus?= <tim@bastelstu.be>
Date: Wed, 26 Oct 2022 18:57:13 +0200
Subject: [PATCH 09/17] random: Add `&return.void;`

---
 reference/random/random/engine/mt19937/unserialize.xml          | 2 +-
 reference/random/random/engine/pcgoneseq128xslrr64/jump.xml     | 2 +-
 .../random/random/engine/pcgoneseq128xslrr64/unserialize.xml    | 2 +-
 reference/random/random/engine/xoshiro256starstar/jump.xml      | 2 +-
 reference/random/random/engine/xoshiro256starstar/jumplong.xml  | 2 +-
 .../random/random/engine/xoshiro256starstar/unserialize.xml     | 2 +-
 reference/random/random/randomizer/unserialize.xml              | 2 +-
 7 files changed, 7 insertions(+), 7 deletions(-)

diff --git a/reference/random/random/engine/mt19937/unserialize.xml b/reference/random/random/engine/mt19937/unserialize.xml
index 6adb25e76f05..a08501b849b5 100644
--- a/reference/random/random/engine/mt19937/unserialize.xml
+++ b/reference/random/random/engine/mt19937/unserialize.xml
@@ -36,7 +36,7 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   
+   &return.void;
   </para>
  </refsect1>
 
diff --git a/reference/random/random/engine/pcgoneseq128xslrr64/jump.xml b/reference/random/random/engine/pcgoneseq128xslrr64/jump.xml
index 72c9a90fac7a..ba978d7529e6 100644
--- a/reference/random/random/engine/pcgoneseq128xslrr64/jump.xml
+++ b/reference/random/random/engine/pcgoneseq128xslrr64/jump.xml
@@ -36,7 +36,7 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   
+   &return.void;
   </para>
  </refsect1>
 
diff --git a/reference/random/random/engine/pcgoneseq128xslrr64/unserialize.xml b/reference/random/random/engine/pcgoneseq128xslrr64/unserialize.xml
index edc10207b6a0..901d17a93968 100644
--- a/reference/random/random/engine/pcgoneseq128xslrr64/unserialize.xml
+++ b/reference/random/random/engine/pcgoneseq128xslrr64/unserialize.xml
@@ -36,7 +36,7 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   
+   &return.void;
   </para>
  </refsect1>
 
diff --git a/reference/random/random/engine/xoshiro256starstar/jump.xml b/reference/random/random/engine/xoshiro256starstar/jump.xml
index 99df7948473b..b03c04d44ebf 100644
--- a/reference/random/random/engine/xoshiro256starstar/jump.xml
+++ b/reference/random/random/engine/xoshiro256starstar/jump.xml
@@ -27,7 +27,7 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   
+   &return.void;
   </para>
  </refsect1>
 
diff --git a/reference/random/random/engine/xoshiro256starstar/jumplong.xml b/reference/random/random/engine/xoshiro256starstar/jumplong.xml
index 667c3c4d4095..e432f092bc2a 100644
--- a/reference/random/random/engine/xoshiro256starstar/jumplong.xml
+++ b/reference/random/random/engine/xoshiro256starstar/jumplong.xml
@@ -27,7 +27,7 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   
+   &return.void;
   </para>
  </refsect1>
 
diff --git a/reference/random/random/engine/xoshiro256starstar/unserialize.xml b/reference/random/random/engine/xoshiro256starstar/unserialize.xml
index 213ab1d0f2b1..0e5a90b01a9a 100644
--- a/reference/random/random/engine/xoshiro256starstar/unserialize.xml
+++ b/reference/random/random/engine/xoshiro256starstar/unserialize.xml
@@ -36,7 +36,7 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   
+   &return.void;
   </para>
  </refsect1>
 
diff --git a/reference/random/random/randomizer/unserialize.xml b/reference/random/random/randomizer/unserialize.xml
index 3698696313f7..0df450f1f3d1 100644
--- a/reference/random/random/randomizer/unserialize.xml
+++ b/reference/random/random/randomizer/unserialize.xml
@@ -36,7 +36,7 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   
+   &return.void;
   </para>
  </refsect1>
 

From 018f23842c926a98b3a09abfb1f68294a46eff03 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Tim=20D=C3=BCsterhus?= <tim@bastelstu.be>
Date: Wed, 26 Oct 2022 19:01:55 +0200
Subject: [PATCH 10/17] random: Add introduction to all engines

---
 reference/random/random.engine.mt19937.xml             | 2 +-
 reference/random/random.engine.pcgoneseq128xslrr64.xml | 2 +-
 reference/random/random.engine.secure.xml              | 2 +-
 reference/random/random.engine.xoshiro256starstar.xml  | 2 +-
 4 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/reference/random/random.engine.mt19937.xml b/reference/random/random.engine.mt19937.xml
index dd4d5764210e..1a77b9ff9785 100644
--- a/reference/random/random.engine.mt19937.xml
+++ b/reference/random/random.engine.mt19937.xml
@@ -9,7 +9,7 @@
   <section xml:id="random-engine-mt19937.intro">
    &reftitle.intro;
    <para>
-
+    Implements the Mt19937 (“Mersenne Twister”) algorithm.
    </para>
   </section>
 <!-- }}} -->
diff --git a/reference/random/random.engine.pcgoneseq128xslrr64.xml b/reference/random/random.engine.pcgoneseq128xslrr64.xml
index b3119fde580d..af91c8f89ce2 100644
--- a/reference/random/random.engine.pcgoneseq128xslrr64.xml
+++ b/reference/random/random.engine.pcgoneseq128xslrr64.xml
@@ -9,7 +9,7 @@
   <section xml:id="random-engine-pcgoneseq128xslrr64.intro">
    &reftitle.intro;
    <para>
-
+    Implements a Permuted congruential generator (PCG) with 128 Bits of state, XSL and RR transformations and 64 Bits output.
    </para>
   </section>
 <!-- }}} -->
diff --git a/reference/random/random.engine.secure.xml b/reference/random/random.engine.secure.xml
index e85b47896bde..b8378ba09aa5 100644
--- a/reference/random/random.engine.secure.xml
+++ b/reference/random/random.engine.secure.xml
@@ -9,7 +9,7 @@
   <section xml:id="random-engine-secure.intro">
    &reftitle.intro;
    <para>
-
+    Generates cryptographically secure randomness using the operating system’s <acronym>CSPRNG</acronym>.
    </para>
   </section>
 <!-- }}} -->
diff --git a/reference/random/random.engine.xoshiro256starstar.xml b/reference/random/random.engine.xoshiro256starstar.xml
index cc4ae12f976b..eb507eb70f64 100644
--- a/reference/random/random.engine.xoshiro256starstar.xml
+++ b/reference/random/random.engine.xoshiro256starstar.xml
@@ -9,7 +9,7 @@
   <section xml:id="random-engine-xoshiro256starstar.intro">
    &reftitle.intro;
    <para>
-
+    Implements the xoshiro256** algorithm.
    </para>
   </section>
 <!-- }}} -->

From 7d10e1def15165af3542741ad7d55643b0a8a5ed Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Tim=20D=C3=BCsterhus?= <tim@bastelstu.be>
Date: Wed, 26 Oct 2022 19:05:21 +0200
Subject: [PATCH 11/17] random: Add introduction to Randomizer

---
 reference/random/random.randomizer.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/reference/random/random.randomizer.xml b/reference/random/random.randomizer.xml
index cbad35f9219d..32908bdf50a7 100644
--- a/reference/random/random.randomizer.xml
+++ b/reference/random/random.randomizer.xml
@@ -9,7 +9,7 @@
   <section xml:id="random-randomizer.intro">
    &reftitle.intro;
    <para>
-
+    Provides a high-level API to the randomness provided by an <classname>Random\Engine</classname>.
    </para>
   </section>
 <!-- }}} -->

From 09c519e6a206e23994f3621320a1badeb518bf9d Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Tim=20D=C3=BCsterhus?= <tim@bastelstu.be>
Date: Wed, 26 Oct 2022 19:08:55 +0200
Subject: [PATCH 12/17] random: Add default value for
 Randomizer::__construct()'s engine

---
 reference/random/random/randomizer/construct.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/reference/random/random/randomizer/construct.xml b/reference/random/random/randomizer/construct.xml
index 453adcaa7f73..d2199eaf6b38 100644
--- a/reference/random/random/randomizer/construct.xml
+++ b/reference/random/random/randomizer/construct.xml
@@ -9,7 +9,7 @@
   &reftitle.description;
   <constructorsynopsis>
    <modifier>public</modifier> <methodname>Random\Randomizer::__construct</methodname>
-   <methodparam choice="opt"><type class="union"><type>Random\Engine</type><type>null</type></type><parameter>engine</parameter></methodparam>
+   <methodparam choice="opt"><type class="union"><type>Random\Engine</type><type>null</type></type><parameter>engine</parameter><initializer>new Random\Engine\Secure()</initializer></methodparam>
   </constructorsynopsis>
   <para>
 

From e123356c04fd629dd28b8ed1cc4b86a4c6c6f9c3 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Tim=20D=C3=BCsterhus?= <tim@bastelstu.be>
Date: Wed, 26 Oct 2022 19:10:45 +0200
Subject: [PATCH 13/17] random: Add missing modifiers to Randomizer::$engine

---
 reference/random/random.randomizer.xml | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/reference/random/random.randomizer.xml b/reference/random/random.randomizer.xml
index 32908bdf50a7..f47daa4d7572 100644
--- a/reference/random/random.randomizer.xml
+++ b/reference/random/random.randomizer.xml
@@ -30,6 +30,8 @@
 <!-- }}} -->
     <classsynopsisinfo role="comment">&Properties;</classsynopsisinfo>
     <fieldsynopsis>
+     <modifier>public</modifier>
+     <modifier>readonly</modifier>
      <modifier>Engine</modifier>
      <varname linkend="random-randomizer.props.engine">engine</varname>
     </fieldsynopsis>

From afcd87b52987eb55cda446d7656ca0189d1fd1b0 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Tim=20D=C3=BCsterhus?= <tim@bastelstu.be>
Date: Wed, 26 Oct 2022 19:15:42 +0200
Subject: [PATCH 14/17] random: Make interfaces actually interfaces

---
 reference/random/random.cryptosafeengine.xml | 8 ++++----
 reference/random/random.engine.xml           | 8 ++++----
 2 files changed, 8 insertions(+), 8 deletions(-)

diff --git a/reference/random/random.cryptosafeengine.xml b/reference/random/random.cryptosafeengine.xml
index 75c94d8a9ffe..00bd1c256cd2 100644
--- a/reference/random/random.cryptosafeengine.xml
+++ b/reference/random/random.cryptosafeengine.xml
@@ -15,7 +15,7 @@
 <!-- }}} -->
 
   <section xml:id="random-cryptosafeengine.synopsis">
-   &reftitle.classsynopsis;
+   &reftitle.interfacesynopsis;
 
 <!-- {{{ Synopsis -->
    <classsynopsis>
@@ -23,9 +23,9 @@
 
 <!-- {{{ Class synopsis -->
     <classsynopsisinfo>
-     <ooclass>
-      <classname>Random\CryptoSafeEngine</classname>
-     </ooclass>
+     <oointerface>
+      <interfacename>Random\CryptoSafeEngine</interfacename>
+     </oointerface>
      
      <oointerface>
       <interfacename>Random\Engine</interfacename>
diff --git a/reference/random/random.engine.xml b/reference/random/random.engine.xml
index 65743293a71b..07ea8d80dff3 100644
--- a/reference/random/random.engine.xml
+++ b/reference/random/random.engine.xml
@@ -15,7 +15,7 @@
 <!-- }}} -->
 
   <section xml:id="random-engine.synopsis">
-   &reftitle.classsynopsis;
+   &reftitle.interfacesynopsis;
 
 <!-- {{{ Synopsis -->
    <classsynopsis>
@@ -23,9 +23,9 @@
 
 <!-- {{{ Class synopsis -->
     <classsynopsisinfo>
-     <ooclass>
-      <classname>Random\Engine</classname>
-     </ooclass>
+     <oointerface>
+      <interfacename>Random\Engine</interfacename>
+     </oointerface>
     </classsynopsisinfo>
 <!-- }}} -->
     

From 4910926d47fa323770d587f6ed1308266ebe019d Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Tim=20D=C3=BCsterhus?= <tim@bastelstu.be>
Date: Wed, 26 Oct 2022 19:17:59 +0200
Subject: [PATCH 15/17] random: Add description to BrokenRandomEngineError

---
 reference/random/random.brokenrandomengineerror.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/reference/random/random.brokenrandomengineerror.xml b/reference/random/random.brokenrandomengineerror.xml
index e0faa2cbb14e..aca7e4647815 100644
--- a/reference/random/random.brokenrandomengineerror.xml
+++ b/reference/random/random.brokenrandomengineerror.xml
@@ -9,7 +9,7 @@
   <section xml:id="random-brokenrandomengineerror.intro">
    &reftitle.intro;
    <para>
-
+    Indicates that the used <classname>Random\Engine</classname> is broken, e.g. because it is severely biased.
    </para>
   </section>
 <!-- }}} -->

From 8fccb07fff26aa641f3647c39385597a5aee3571 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Tim=20D=C3=BCsterhus?= <tim@bastelstu.be>
Date: Wed, 26 Oct 2022 19:27:32 +0200
Subject: [PATCH 16/17] random: Add `final` modifier to relevant classes

---
 reference/random/random.engine.mt19937.xml             | 1 +
 reference/random/random.engine.pcgoneseq128xslrr64.xml | 1 +
 reference/random/random.engine.secure.xml              | 1 +
 reference/random/random.engine.xoshiro256starstar.xml  | 1 +
 reference/random/random.randomizer.xml                 | 1 +
 5 files changed, 5 insertions(+)

diff --git a/reference/random/random.engine.mt19937.xml b/reference/random/random.engine.mt19937.xml
index 1a77b9ff9785..ac0a08edee54 100644
--- a/reference/random/random.engine.mt19937.xml
+++ b/reference/random/random.engine.mt19937.xml
@@ -24,6 +24,7 @@
 <!-- {{{ Class synopsis -->
     <classsynopsisinfo>
      <ooclass>
+      <modifier>final</modifier>
       <classname>Random\Engine\Mt19937</classname>
      </ooclass>
      
diff --git a/reference/random/random.engine.pcgoneseq128xslrr64.xml b/reference/random/random.engine.pcgoneseq128xslrr64.xml
index af91c8f89ce2..d23f6cc97e5d 100644
--- a/reference/random/random.engine.pcgoneseq128xslrr64.xml
+++ b/reference/random/random.engine.pcgoneseq128xslrr64.xml
@@ -24,6 +24,7 @@
 <!-- {{{ Class synopsis -->
     <classsynopsisinfo>
      <ooclass>
+      <modifier>final</modifier>
       <classname>Random\Engine\PcgOneseq128XslRr64</classname>
      </ooclass>
      
diff --git a/reference/random/random.engine.secure.xml b/reference/random/random.engine.secure.xml
index b8378ba09aa5..b8febc1d247a 100644
--- a/reference/random/random.engine.secure.xml
+++ b/reference/random/random.engine.secure.xml
@@ -24,6 +24,7 @@
 <!-- {{{ Class synopsis -->
     <classsynopsisinfo>
      <ooclass>
+      <modifier>final</modifier>
       <classname>Random\Engine\Secure</classname>
      </ooclass>
      
diff --git a/reference/random/random.engine.xoshiro256starstar.xml b/reference/random/random.engine.xoshiro256starstar.xml
index eb507eb70f64..697ca5f68685 100644
--- a/reference/random/random.engine.xoshiro256starstar.xml
+++ b/reference/random/random.engine.xoshiro256starstar.xml
@@ -24,6 +24,7 @@
 <!-- {{{ Class synopsis -->
     <classsynopsisinfo>
      <ooclass>
+      <modifier>final</modifier>
       <classname>Random\Engine\Xoshiro256StarStar</classname>
      </ooclass>
      
diff --git a/reference/random/random.randomizer.xml b/reference/random/random.randomizer.xml
index f47daa4d7572..d65e9e3606e5 100644
--- a/reference/random/random.randomizer.xml
+++ b/reference/random/random.randomizer.xml
@@ -24,6 +24,7 @@
 <!-- {{{ Class synopsis -->
     <classsynopsisinfo>
      <ooclass>
+      <modifier>final</modifier>
       <classname>Random\Randomizer</classname>
      </ooclass>
     </classsynopsisinfo>

From 2d16e83b7cd6e551bce5a270c89fc601fbf8c546 Mon Sep 17 00:00:00 2001
From: "Christoph M. Becker" <cmbecker69@gmx.de>
Date: Thu, 27 Oct 2022 17:14:48 +0200
Subject: [PATCH 17/17] Remove trailing whitespace

---
 reference/random/functions/getrandmax.xml              |  2 +-
 reference/random/functions/lcg-value.xml               |  2 +-
 reference/random/functions/mt-getrandmax.xml           |  4 ++--
 reference/random/functions/mt-rand.xml                 |  2 +-
 reference/random/functions/mt-srand.xml                | 10 +++++-----
 reference/random/functions/rand.xml                    |  4 ++--
 reference/random/random.brokenrandomengineerror.xml    |  4 ++--
 reference/random/random.cryptosafeengine.xml           |  4 ++--
 reference/random/random.engine.mt19937.xml             |  4 ++--
 reference/random/random.engine.pcgoneseq128xslrr64.xml |  4 ++--
 reference/random/random.engine.secure.xml              |  4 ++--
 reference/random/random.engine.xml                     |  2 +-
 reference/random/random.engine.xoshiro256starstar.xml  |  4 ++--
 reference/random/random.randomerror.xml                |  4 ++--
 reference/random/random.randomexception.xml            |  4 ++--
 reference/random/random.randomizer.xml                 |  4 ++--
 reference/random/random/engine/generate.xml            |  2 +-
 reference/random/random/engine/mt19937/construct.xml   |  6 +++---
 reference/random/random/engine/mt19937/debuginfo.xml   |  2 +-
 reference/random/random/engine/mt19937/generate.xml    |  2 +-
 reference/random/random/engine/mt19937/serialize.xml   |  2 +-
 reference/random/random/engine/mt19937/unserialize.xml |  2 +-
 .../random/engine/pcgoneseq128xslrr64/construct.xml    |  4 ++--
 .../random/engine/pcgoneseq128xslrr64/debuginfo.xml    |  2 +-
 .../random/engine/pcgoneseq128xslrr64/generate.xml     |  2 +-
 .../random/random/engine/pcgoneseq128xslrr64/jump.xml  |  2 +-
 .../random/engine/pcgoneseq128xslrr64/serialize.xml    |  2 +-
 .../random/engine/pcgoneseq128xslrr64/unserialize.xml  |  2 +-
 reference/random/random/engine/secure/generate.xml     |  2 +-
 .../random/engine/xoshiro256starstar/construct.xml     |  4 ++--
 .../random/engine/xoshiro256starstar/debuginfo.xml     |  2 +-
 .../random/engine/xoshiro256starstar/generate.xml      |  2 +-
 .../random/engine/xoshiro256starstar/serialize.xml     |  2 +-
 .../random/engine/xoshiro256starstar/unserialize.xml   |  2 +-
 reference/random/random/randomizer/construct.xml       |  4 ++--
 reference/random/random/randomizer/getbytes.xml        |  4 ++--
 reference/random/random/randomizer/getint.xml          |  6 +++---
 reference/random/random/randomizer/nextint.xml         |  2 +-
 reference/random/random/randomizer/pickarraykeys.xml   |  6 +++---
 reference/random/random/randomizer/serialize.xml       |  2 +-
 reference/random/random/randomizer/shufflearray.xml    |  4 ++--
 reference/random/random/randomizer/shufflebytes.xml    |  4 ++--
 reference/random/random/randomizer/unserialize.xml     |  2 +-
 43 files changed, 70 insertions(+), 70 deletions(-)

diff --git a/reference/random/functions/getrandmax.xml b/reference/random/functions/getrandmax.xml
index 911f4fbc9900..6ffcef02583b 100644
--- a/reference/random/functions/getrandmax.xml
+++ b/reference/random/functions/getrandmax.xml
@@ -21,7 +21,7 @@
   &reftitle.parameters;
   &no.function.parameters;
  </refsect1>
- 
+
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
diff --git a/reference/random/functions/lcg-value.xml b/reference/random/functions/lcg-value.xml
index e12a9d4cedef..ae9ce92bf643 100644
--- a/reference/random/functions/lcg-value.xml
+++ b/reference/random/functions/lcg-value.xml
@@ -24,7 +24,7 @@
   &reftitle.parameters;
   &no.function.parameters;
  </refsect1>
- 
+
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
diff --git a/reference/random/functions/mt-getrandmax.xml b/reference/random/functions/mt-getrandmax.xml
index 3e533ba4356f..2586ad6af437 100644
--- a/reference/random/functions/mt-getrandmax.xml
+++ b/reference/random/functions/mt-getrandmax.xml
@@ -21,12 +21,12 @@
   &reftitle.parameters;
   &no.function.parameters;
  </refsect1>
- 
+
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
    Returns the maximum random value returned by a call to
-   <function>mt_rand</function> without arguments, which is the maximum value 
+   <function>mt_rand</function> without arguments, which is the maximum value
    that can be used for its <parameter>max</parameter> parameter without the
    result being scaled up (and therefore less random).
   </para>
diff --git a/reference/random/functions/mt-rand.xml b/reference/random/functions/mt-rand.xml
index 91d90aa4cbcf..f59743312475 100644
--- a/reference/random/functions/mt-rand.xml
+++ b/reference/random/functions/mt-rand.xml
@@ -19,7 +19,7 @@
   &caution.cryptographically-insecure;
   <simpara>
    Many random number generators of older libcs
-   have dubious or unknown characteristics and are slow. 
+   have dubious or unknown characteristics and are slow.
    The <function>mt_rand</function> function is a drop-in replacement
    for the older <function>rand</function>. It uses a random
    number generator with known characteristics using the
diff --git a/reference/random/functions/mt-srand.xml b/reference/random/functions/mt-srand.xml
index fc37e5bc2f2c..fff61ee2a13d 100644
--- a/reference/random/functions/mt-srand.xml
+++ b/reference/random/functions/mt-srand.xml
@@ -17,9 +17,9 @@
    <parameter>seed</parameter> or with a random value
    if no <parameter>seed</parameter> is given.
   </para>
-  
+
   &note.randomseed;
-  
+
  </refsect1>
  <refsect1 role="parameters">
   &reftitle.parameters;
@@ -56,7 +56,7 @@
           <row>
            <entry><constant>MT_RAND_PHP</constant></entry>
            <entry>
-            Uses an incorrect Mersenne Twister implementation which was used as the default up till PHP 7.1.0. 
+            Uses an incorrect Mersenne Twister implementation which was used as the default up till PHP 7.1.0.
             This mode is available for backward compatibility.
            </entry>
           </row>
@@ -69,14 +69,14 @@
    </variablelist>
   </para>
  </refsect1>
- 
+
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
    &return.void;
   </para>
  </refsect1>
- 
+
  <refsect1 role="changelog">
   &reftitle.changelog;
   <para>
diff --git a/reference/random/functions/rand.xml b/reference/random/functions/rand.xml
index 8d36cb67feb3..9829b789a51e 100644
--- a/reference/random/functions/rand.xml
+++ b/reference/random/functions/rand.xml
@@ -126,7 +126,7 @@ echo rand(5, 15);
    </example>
   </para>
  </refsect1>
- 
+
  <refsect1 role="notes">
   &reftitle.notes;
   <warning>
@@ -138,7 +138,7 @@ echo rand(5, 15);
    </para>
   </warning>
  </refsect1>
- 
+
  <refsect1 role="seealso">
   &reftitle.seealso;
   <para>
diff --git a/reference/random/random.brokenrandomengineerror.xml b/reference/random/random.brokenrandomengineerror.xml
index aca7e4647815..b71f82405fb2 100644
--- a/reference/random/random.brokenrandomengineerror.xml
+++ b/reference/random/random.brokenrandomengineerror.xml
@@ -26,12 +26,12 @@
      <ooclass>
       <classname>Random\BrokenRandomEngineError</classname>
      </ooclass>
-     
+
      <ooclass>
       <modifier>extends</modifier>
       <classname>Random\RandomError</classname>
      </ooclass>
-     
+
      <oointerface>
       <interfacename>Throwable</interfacename>
      </oointerface>
diff --git a/reference/random/random.cryptosafeengine.xml b/reference/random/random.cryptosafeengine.xml
index 00bd1c256cd2..61a85e28c5bf 100644
--- a/reference/random/random.cryptosafeengine.xml
+++ b/reference/random/random.cryptosafeengine.xml
@@ -26,13 +26,13 @@
      <oointerface>
       <interfacename>Random\CryptoSafeEngine</interfacename>
      </oointerface>
-     
+
      <oointerface>
       <interfacename>Random\Engine</interfacename>
      </oointerface>
     </classsynopsisinfo>
 <!-- }}} -->
-    
+
     <!-- <classsynopsisinfo role="comment">&Methods;</classsynopsisinfo>
     <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.random-cryptosafeengine')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[not(@role='procedural')])"><xi:fallback/></xi:include> -->
    </classsynopsis>
diff --git a/reference/random/random.engine.mt19937.xml b/reference/random/random.engine.mt19937.xml
index ac0a08edee54..b2aeae452d34 100644
--- a/reference/random/random.engine.mt19937.xml
+++ b/reference/random/random.engine.mt19937.xml
@@ -27,13 +27,13 @@
       <modifier>final</modifier>
       <classname>Random\Engine\Mt19937</classname>
      </ooclass>
-     
+
      <oointerface>
       <interfacename>Random\Engine</interfacename>
      </oointerface>
     </classsynopsisinfo>
 <!-- }}} -->
-    
+
     <classsynopsisinfo role="comment">&Methods;</classsynopsisinfo>
     <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.random-engine-mt19937')/db:refentry/db:refsect1[@role='description']/descendant::db:constructorsynopsis[not(@role='procedural')])"><xi:fallback/></xi:include>
     <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.random-engine-mt19937')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[not(@role='procedural')])"><xi:fallback/></xi:include>
diff --git a/reference/random/random.engine.pcgoneseq128xslrr64.xml b/reference/random/random.engine.pcgoneseq128xslrr64.xml
index d23f6cc97e5d..ca7e3704d1a6 100644
--- a/reference/random/random.engine.pcgoneseq128xslrr64.xml
+++ b/reference/random/random.engine.pcgoneseq128xslrr64.xml
@@ -27,13 +27,13 @@
       <modifier>final</modifier>
       <classname>Random\Engine\PcgOneseq128XslRr64</classname>
      </ooclass>
-     
+
      <oointerface>
       <interfacename>Random\Engine</interfacename>
      </oointerface>
     </classsynopsisinfo>
 <!-- }}} -->
-    
+
     <classsynopsisinfo role="comment">&Methods;</classsynopsisinfo>
     <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.random-engine-pcgoneseq128xslrr64')/db:refentry/db:refsect1[@role='description']/descendant::db:constructorsynopsis[not(@role='procedural')])"><xi:fallback/></xi:include>
     <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.random-engine-pcgoneseq128xslrr64')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[not(@role='procedural')])"><xi:fallback/></xi:include>
diff --git a/reference/random/random.engine.secure.xml b/reference/random/random.engine.secure.xml
index b8febc1d247a..86b4cfe36aa7 100644
--- a/reference/random/random.engine.secure.xml
+++ b/reference/random/random.engine.secure.xml
@@ -27,13 +27,13 @@
       <modifier>final</modifier>
       <classname>Random\Engine\Secure</classname>
      </ooclass>
-     
+
      <oointerface>
       <interfacename>Random\CryptoSafeEngine</interfacename>
      </oointerface>
     </classsynopsisinfo>
 <!-- }}} -->
-    
+
     <classsynopsisinfo role="comment">&Methods;</classsynopsisinfo>
     <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.random-engine-secure')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[not(@role='procedural')])"><xi:fallback/></xi:include>
    </classsynopsis>
diff --git a/reference/random/random.engine.xml b/reference/random/random.engine.xml
index 07ea8d80dff3..25800c9346cb 100644
--- a/reference/random/random.engine.xml
+++ b/reference/random/random.engine.xml
@@ -28,7 +28,7 @@
      </oointerface>
     </classsynopsisinfo>
 <!-- }}} -->
-    
+
     <classsynopsisinfo role="comment">&Methods;</classsynopsisinfo>
     <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.random-engine')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[not(@role='procedural')])"><xi:fallback/></xi:include>
    </classsynopsis>
diff --git a/reference/random/random.engine.xoshiro256starstar.xml b/reference/random/random.engine.xoshiro256starstar.xml
index 697ca5f68685..921f0c5a91bb 100644
--- a/reference/random/random.engine.xoshiro256starstar.xml
+++ b/reference/random/random.engine.xoshiro256starstar.xml
@@ -27,13 +27,13 @@
       <modifier>final</modifier>
       <classname>Random\Engine\Xoshiro256StarStar</classname>
      </ooclass>
-     
+
      <oointerface>
       <interfacename>Random\Engine</interfacename>
      </oointerface>
     </classsynopsisinfo>
 <!-- }}} -->
-    
+
     <classsynopsisinfo role="comment">&Methods;</classsynopsisinfo>
     <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.random-engine-xoshiro256starstar')/db:refentry/db:refsect1[@role='description']/descendant::db:constructorsynopsis[not(@role='procedural')])"><xi:fallback/></xi:include>
     <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.random-engine-xoshiro256starstar')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[not(@role='procedural')])"><xi:fallback/></xi:include>
diff --git a/reference/random/random.randomerror.xml b/reference/random/random.randomerror.xml
index 91279c9eed55..a6992be66414 100644
--- a/reference/random/random.randomerror.xml
+++ b/reference/random/random.randomerror.xml
@@ -26,12 +26,12 @@
      <ooclass>
       <classname>Random\RandomError</classname>
      </ooclass>
-     
+
      <ooclass>
       <modifier>extends</modifier>
       <classname>Error</classname>
      </ooclass>
-     
+
      <oointerface>
       <interfacename>Throwable</interfacename>
      </oointerface>
diff --git a/reference/random/random.randomexception.xml b/reference/random/random.randomexception.xml
index c7fb76ab7cb1..31659d180457 100644
--- a/reference/random/random.randomexception.xml
+++ b/reference/random/random.randomexception.xml
@@ -26,12 +26,12 @@
      <ooclass>
       <classname>Random\RandomException</classname>
      </ooclass>
-     
+
      <ooclass>
       <modifier>extends</modifier>
       <classname>Exception</classname>
      </ooclass>
-     
+
      <oointerface>
       <interfacename>Throwable</interfacename>
      </oointerface>
diff --git a/reference/random/random.randomizer.xml b/reference/random/random.randomizer.xml
index d65e9e3606e5..378af106738d 100644
--- a/reference/random/random.randomizer.xml
+++ b/reference/random/random.randomizer.xml
@@ -37,7 +37,7 @@
      <varname linkend="random-randomizer.props.engine">engine</varname>
     </fieldsynopsis>
 
-    
+
     <classsynopsisinfo role="comment">&Methods;</classsynopsisinfo>
     <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.random-randomizer')/db:refentry/db:refsect1[@role='description']/descendant::db:constructorsynopsis[not(@role='procedural')])"><xi:fallback /></xi:include>
     <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.random-randomizer')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[not(@role='procedural')])"><xi:fallback/></xi:include>
@@ -46,7 +46,7 @@
 
   </section>
 
-  
+
 <!-- {{{ Random\Randomizer properties -->
   <section xml:id="random-randomizer.props">
    &reftitle.properties;
diff --git a/reference/random/random/engine/generate.xml b/reference/random/random/engine/generate.xml
index 59aa97606505..094839f66ed3 100644
--- a/reference/random/random/engine/generate.xml
+++ b/reference/random/random/engine/generate.xml
@@ -27,7 +27,7 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   
+
   </para>
  </refsect1>
 
diff --git a/reference/random/random/engine/mt19937/construct.xml b/reference/random/random/engine/mt19937/construct.xml
index d6c9f8359a3e..f2e0e0b0e2d4 100644
--- a/reference/random/random/engine/mt19937/construct.xml
+++ b/reference/random/random/engine/mt19937/construct.xml
@@ -27,7 +27,7 @@
     <term><parameter>seed</parameter></term>
     <listitem>
      <para>
-      
+
      </para>
     </listitem>
    </varlistentry>
@@ -35,7 +35,7 @@
     <term><parameter>mode</parameter></term>
     <listitem>
      <para>
-      
+
      </para>
     </listitem>
    </varlistentry>
@@ -48,7 +48,7 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   
+
   </para>
  </refsect1>
  -->
diff --git a/reference/random/random/engine/mt19937/debuginfo.xml b/reference/random/random/engine/mt19937/debuginfo.xml
index 00a49c9a23b7..493e551eab53 100644
--- a/reference/random/random/engine/mt19937/debuginfo.xml
+++ b/reference/random/random/engine/mt19937/debuginfo.xml
@@ -27,7 +27,7 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   
+
   </para>
  </refsect1>
 
diff --git a/reference/random/random/engine/mt19937/generate.xml b/reference/random/random/engine/mt19937/generate.xml
index e2776ccf5085..3e4be1a57e40 100644
--- a/reference/random/random/engine/mt19937/generate.xml
+++ b/reference/random/random/engine/mt19937/generate.xml
@@ -27,7 +27,7 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   
+
   </para>
  </refsect1>
 
diff --git a/reference/random/random/engine/mt19937/serialize.xml b/reference/random/random/engine/mt19937/serialize.xml
index dd82bc162801..62043c9c17de 100644
--- a/reference/random/random/engine/mt19937/serialize.xml
+++ b/reference/random/random/engine/mt19937/serialize.xml
@@ -27,7 +27,7 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   
+
   </para>
  </refsect1>
 
diff --git a/reference/random/random/engine/mt19937/unserialize.xml b/reference/random/random/engine/mt19937/unserialize.xml
index a08501b849b5..77b2d1e11095 100644
--- a/reference/random/random/engine/mt19937/unserialize.xml
+++ b/reference/random/random/engine/mt19937/unserialize.xml
@@ -26,7 +26,7 @@
     <term><parameter>data</parameter></term>
     <listitem>
      <para>
-      
+
      </para>
     </listitem>
    </varlistentry>
diff --git a/reference/random/random/engine/pcgoneseq128xslrr64/construct.xml b/reference/random/random/engine/pcgoneseq128xslrr64/construct.xml
index e281db7127f5..fafc5ba55664 100644
--- a/reference/random/random/engine/pcgoneseq128xslrr64/construct.xml
+++ b/reference/random/random/engine/pcgoneseq128xslrr64/construct.xml
@@ -26,7 +26,7 @@
     <term><parameter>seed</parameter></term>
     <listitem>
      <para>
-      
+
      </para>
     </listitem>
    </varlistentry>
@@ -39,7 +39,7 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   
+
   </para>
  </refsect1>
  -->
diff --git a/reference/random/random/engine/pcgoneseq128xslrr64/debuginfo.xml b/reference/random/random/engine/pcgoneseq128xslrr64/debuginfo.xml
index a4e11beeba37..7556a0606c66 100644
--- a/reference/random/random/engine/pcgoneseq128xslrr64/debuginfo.xml
+++ b/reference/random/random/engine/pcgoneseq128xslrr64/debuginfo.xml
@@ -27,7 +27,7 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   
+
   </para>
  </refsect1>
 
diff --git a/reference/random/random/engine/pcgoneseq128xslrr64/generate.xml b/reference/random/random/engine/pcgoneseq128xslrr64/generate.xml
index 70e283570f6e..af464611be7b 100644
--- a/reference/random/random/engine/pcgoneseq128xslrr64/generate.xml
+++ b/reference/random/random/engine/pcgoneseq128xslrr64/generate.xml
@@ -27,7 +27,7 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   
+
   </para>
  </refsect1>
 
diff --git a/reference/random/random/engine/pcgoneseq128xslrr64/jump.xml b/reference/random/random/engine/pcgoneseq128xslrr64/jump.xml
index ba978d7529e6..3321f091b940 100644
--- a/reference/random/random/engine/pcgoneseq128xslrr64/jump.xml
+++ b/reference/random/random/engine/pcgoneseq128xslrr64/jump.xml
@@ -26,7 +26,7 @@
     <term><parameter>advance</parameter></term>
     <listitem>
      <para>
-      
+
      </para>
     </listitem>
    </varlistentry>
diff --git a/reference/random/random/engine/pcgoneseq128xslrr64/serialize.xml b/reference/random/random/engine/pcgoneseq128xslrr64/serialize.xml
index 097b6026dc17..e9c8d04d3d50 100644
--- a/reference/random/random/engine/pcgoneseq128xslrr64/serialize.xml
+++ b/reference/random/random/engine/pcgoneseq128xslrr64/serialize.xml
@@ -27,7 +27,7 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   
+
   </para>
  </refsect1>
 
diff --git a/reference/random/random/engine/pcgoneseq128xslrr64/unserialize.xml b/reference/random/random/engine/pcgoneseq128xslrr64/unserialize.xml
index 901d17a93968..889893623143 100644
--- a/reference/random/random/engine/pcgoneseq128xslrr64/unserialize.xml
+++ b/reference/random/random/engine/pcgoneseq128xslrr64/unserialize.xml
@@ -26,7 +26,7 @@
     <term><parameter>data</parameter></term>
     <listitem>
      <para>
-      
+
      </para>
     </listitem>
    </varlistentry>
diff --git a/reference/random/random/engine/secure/generate.xml b/reference/random/random/engine/secure/generate.xml
index b772fc36dd87..cb5acd561410 100644
--- a/reference/random/random/engine/secure/generate.xml
+++ b/reference/random/random/engine/secure/generate.xml
@@ -27,7 +27,7 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   
+
   </para>
  </refsect1>
 
diff --git a/reference/random/random/engine/xoshiro256starstar/construct.xml b/reference/random/random/engine/xoshiro256starstar/construct.xml
index 80b11e87904d..00e4fca63b17 100644
--- a/reference/random/random/engine/xoshiro256starstar/construct.xml
+++ b/reference/random/random/engine/xoshiro256starstar/construct.xml
@@ -26,7 +26,7 @@
     <term><parameter>seed</parameter></term>
     <listitem>
      <para>
-      
+
      </para>
     </listitem>
    </varlistentry>
@@ -39,7 +39,7 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   
+
   </para>
  </refsect1>
  -->
diff --git a/reference/random/random/engine/xoshiro256starstar/debuginfo.xml b/reference/random/random/engine/xoshiro256starstar/debuginfo.xml
index 4c124da39e52..62417c39a92a 100644
--- a/reference/random/random/engine/xoshiro256starstar/debuginfo.xml
+++ b/reference/random/random/engine/xoshiro256starstar/debuginfo.xml
@@ -27,7 +27,7 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   
+
   </para>
  </refsect1>
 
diff --git a/reference/random/random/engine/xoshiro256starstar/generate.xml b/reference/random/random/engine/xoshiro256starstar/generate.xml
index ec8d9ddf5643..b5dfc0026b94 100644
--- a/reference/random/random/engine/xoshiro256starstar/generate.xml
+++ b/reference/random/random/engine/xoshiro256starstar/generate.xml
@@ -27,7 +27,7 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   
+
   </para>
  </refsect1>
 
diff --git a/reference/random/random/engine/xoshiro256starstar/serialize.xml b/reference/random/random/engine/xoshiro256starstar/serialize.xml
index 49ca6fe28a2d..eb3174b3e453 100644
--- a/reference/random/random/engine/xoshiro256starstar/serialize.xml
+++ b/reference/random/random/engine/xoshiro256starstar/serialize.xml
@@ -27,7 +27,7 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   
+
   </para>
  </refsect1>
 
diff --git a/reference/random/random/engine/xoshiro256starstar/unserialize.xml b/reference/random/random/engine/xoshiro256starstar/unserialize.xml
index 0e5a90b01a9a..de63aca53ec7 100644
--- a/reference/random/random/engine/xoshiro256starstar/unserialize.xml
+++ b/reference/random/random/engine/xoshiro256starstar/unserialize.xml
@@ -26,7 +26,7 @@
     <term><parameter>data</parameter></term>
     <listitem>
      <para>
-      
+
      </para>
     </listitem>
    </varlistentry>
diff --git a/reference/random/random/randomizer/construct.xml b/reference/random/random/randomizer/construct.xml
index d2199eaf6b38..930baebbdee6 100644
--- a/reference/random/random/randomizer/construct.xml
+++ b/reference/random/random/randomizer/construct.xml
@@ -26,7 +26,7 @@
     <term><parameter>engine</parameter></term>
     <listitem>
      <para>
-      
+
      </para>
     </listitem>
    </varlistentry>
@@ -39,7 +39,7 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   
+
   </para>
  </refsect1>
  -->
diff --git a/reference/random/random/randomizer/getbytes.xml b/reference/random/random/randomizer/getbytes.xml
index 7e9953fe8a28..e604fd1d3267 100644
--- a/reference/random/random/randomizer/getbytes.xml
+++ b/reference/random/random/randomizer/getbytes.xml
@@ -26,7 +26,7 @@
     <term><parameter>length</parameter></term>
     <listitem>
      <para>
-      
+
      </para>
     </listitem>
    </varlistentry>
@@ -36,7 +36,7 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   
+
   </para>
  </refsect1>
 
diff --git a/reference/random/random/randomizer/getint.xml b/reference/random/random/randomizer/getint.xml
index 4cc14845ad29..00897d73f1b5 100644
--- a/reference/random/random/randomizer/getint.xml
+++ b/reference/random/random/randomizer/getint.xml
@@ -27,7 +27,7 @@
     <term><parameter>min</parameter></term>
     <listitem>
      <para>
-      
+
      </para>
     </listitem>
    </varlistentry>
@@ -35,7 +35,7 @@
     <term><parameter>max</parameter></term>
     <listitem>
      <para>
-      
+
      </para>
     </listitem>
    </varlistentry>
@@ -45,7 +45,7 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   
+
   </para>
  </refsect1>
 
diff --git a/reference/random/random/randomizer/nextint.xml b/reference/random/random/randomizer/nextint.xml
index db1d632af0d4..98b8862fdc4c 100644
--- a/reference/random/random/randomizer/nextint.xml
+++ b/reference/random/random/randomizer/nextint.xml
@@ -27,7 +27,7 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   
+
   </para>
  </refsect1>
 
diff --git a/reference/random/random/randomizer/pickarraykeys.xml b/reference/random/random/randomizer/pickarraykeys.xml
index 5dcb96945869..5689d8b00b0d 100644
--- a/reference/random/random/randomizer/pickarraykeys.xml
+++ b/reference/random/random/randomizer/pickarraykeys.xml
@@ -27,7 +27,7 @@
     <term><parameter>array</parameter></term>
     <listitem>
      <para>
-      
+
      </para>
     </listitem>
    </varlistentry>
@@ -35,7 +35,7 @@
     <term><parameter>num</parameter></term>
     <listitem>
      <para>
-      
+
      </para>
     </listitem>
    </varlistentry>
@@ -45,7 +45,7 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   
+
   </para>
  </refsect1>
 
diff --git a/reference/random/random/randomizer/serialize.xml b/reference/random/random/randomizer/serialize.xml
index 9f9e52f8a4ff..f68d5f796a57 100644
--- a/reference/random/random/randomizer/serialize.xml
+++ b/reference/random/random/randomizer/serialize.xml
@@ -27,7 +27,7 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   
+
   </para>
  </refsect1>
 
diff --git a/reference/random/random/randomizer/shufflearray.xml b/reference/random/random/randomizer/shufflearray.xml
index c45dc3a3ec04..c52293d939db 100644
--- a/reference/random/random/randomizer/shufflearray.xml
+++ b/reference/random/random/randomizer/shufflearray.xml
@@ -26,7 +26,7 @@
     <term><parameter>array</parameter></term>
     <listitem>
      <para>
-      
+
      </para>
     </listitem>
    </varlistentry>
@@ -36,7 +36,7 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   
+
   </para>
  </refsect1>
 
diff --git a/reference/random/random/randomizer/shufflebytes.xml b/reference/random/random/randomizer/shufflebytes.xml
index d2e1e7bbc750..627e9c15fa03 100644
--- a/reference/random/random/randomizer/shufflebytes.xml
+++ b/reference/random/random/randomizer/shufflebytes.xml
@@ -26,7 +26,7 @@
     <term><parameter>bytes</parameter></term>
     <listitem>
      <para>
-      
+
      </para>
     </listitem>
    </varlistentry>
@@ -36,7 +36,7 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   
+
   </para>
  </refsect1>
 
diff --git a/reference/random/random/randomizer/unserialize.xml b/reference/random/random/randomizer/unserialize.xml
index 0df450f1f3d1..6aa8dec2edcd 100644
--- a/reference/random/random/randomizer/unserialize.xml
+++ b/reference/random/random/randomizer/unserialize.xml
@@ -26,7 +26,7 @@
     <term><parameter>data</parameter></term>
     <listitem>
      <para>
-      
+
      </para>
     </listitem>
    </varlistentry>