Skip to content

Commit 191c0c0

Browse files
TimWollaGirgias
andcommitted
random: Improve explanation of Xoshiro jumping
Co-authored-by: George Peter Banyard <girgias@php.net>
1 parent 458f787 commit 191c0c0

File tree

2 files changed

+12
-13
lines changed

2 files changed

+12
-13
lines changed

reference/random/random/engine/xoshiro256starstar/jump.xml

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -16,12 +16,12 @@
1616
<function>Random\Engine\Xoshiro256StarStar::generate</function> was called
1717
2<superscript>128</superscript> times.
1818
</para>
19-
2019
<para>
21-
Jumping allows for splitting a single seeded <classname>Random\Engine\Xoshiro256StarStar</classname>
22-
engine instance into 2<superscript>128</superscript> non-overlapping instances with 2<superscript>128</superscript>
23-
values each, by repeatedly <link linkend="language.oop5.cloning">cloning</link> and
24-
then jumping an engine acting as a blueprint.
20+
The purpose of a jump is to facilitate the creation of a new <classname>Random\Engine\Xoshiro256StarStar</classname>
21+
engine from an existing seeded <classname>Random\Engine\Xoshiro256StarStar</classname> engine.
22+
The seeded engine acts as a blueprint, which can be <link linkend="language.oop5.cloning">cloned</link>
23+
and repeatedly jumped to create 2<superscript>128</superscript> non-overlapping sequences with
24+
2<superscript>128</superscript> values each.
2525
</para>
2626
</refsect1>
2727

reference/random/random/engine/xoshiro256starstar/jumplong.xml

Lines changed: 7 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -16,18 +16,17 @@
1616
<function>Random\Engine\Xoshiro256StarStar::generate</function> was called
1717
2<superscript>192</superscript> times.
1818
</para>
19-
2019
<para>
21-
Long jumping allows for splitting a single seeded <classname>Random\Engine\Xoshiro256StarStar</classname>
22-
engine instance into 2<superscript>64</superscript> non-overlapping instances with 2<superscript>192</superscript>
23-
values each, by repeatedly <link linkend="language.oop5.cloning">cloning</link> and then
24-
long jumping an engine acting as a blueprint.
20+
The purpose of a long jump is to facilitate the creation of a new <classname>Random\Engine\Xoshiro256StarStar</classname>
21+
engine from an existing seeded <classname>Random\Engine\Xoshiro256StarStar</classname> engine.
22+
The seeded engine acts as a blueprint, which can be <link linkend="language.oop5.cloning">cloned</link>
23+
and repeatedly jumped to create 2<superscript>64</superscript> non-overlapping sequences with
24+
2<superscript>192</superscript> values each.
2525
</para>
26-
2726
<para>
2827
Long jumping may be combined with <function>Random\Engine\Xoshiro256StarStar::jump</function>ing
29-
by further splitting each of the 2<superscript>64</superscript> instances generated by long jumping,
30-
into 2<superscript>128</superscript> instances of 2<superscript>64</superscript> values each.
28+
to further split each of the 2<superscript>64</superscript> sequences generated by long jumping,
29+
into 2<superscript>128</superscript> sequences of 2<superscript>64</superscript> values each.
3130
</para>
3231
</refsect1>
3332

0 commit comments

Comments
 (0)