Skip to content

Commit d8b0dee

Browse files
LudwikJaniukcl4es
LudwikJaniuk
authored and
cl4es
committedNov 8, 2021
8276239: Better tables in java.util.random package summary
Reviewed-by: jlaskey
1 parent fc0fe25 commit d8b0dee

File tree

1 file changed

+32
-32
lines changed

1 file changed

+32
-32
lines changed
 

‎src/java.base/share/classes/java/util/random/package-info.java

+32-32
Original file line numberDiff line numberDiff line change
@@ -223,7 +223,7 @@
223223
* lifetime of a particular Java SE release. Changing the deprecation status of
224224
* an algorithm is <em>not</em> a specification change.
225225
*
226-
* <table style="padding:0px 20px 0px 0px">
226+
* <table class="striped">
227227
* <caption>Available Algorithms</caption>
228228
* <thead>
229229
* <tr>
@@ -236,91 +236,91 @@
236236
* </thead>
237237
* <tbody>
238238
* <tr>
239-
* <td style="text-align:left">L128X1024MixRandom</td>
239+
* <th scope="row" style="text-align:left">L128X1024MixRandom</th>
240240
* <td style="text-align:left">LXM</td>
241241
* <td style="text-align:left">BigInteger.ONE.shiftLeft(1024).subtract(BigInteger.ONE).shiftLeft(128)</td>
242242
* <td style="text-align:right">1152</td>
243243
* <td style="text-align:right">1</td>
244244
* </tr>
245245
* <tr>
246-
* <td style="text-align:left">L128X128MixRandom</td>
246+
* <th scope="row" style="text-align:left">L128X128MixRandom</th>
247247
* <td style="text-align:left">LXM</td>
248248
* <td style="text-align:left">BigInteger.ONE.shiftLeft(128).subtract(BigInteger.ONE).shiftLeft(128)</td>
249249
* <td style="text-align:right">256</td>
250250
* <td style="text-align:right">1</td>
251251
* </tr>
252252
* <tr>
253-
* <td style="text-align:left">L128X256MixRandom</td>
253+
* <th scope="row" style="text-align:left">L128X256MixRandom</th>
254254
* <td style="text-align:left">LXM</td>
255255
* <td style="text-align:left">BigInteger.ONE.shiftLeft(256).subtract(BigInteger.ONE).shiftLeft(128)</td>
256256
* <td style="text-align:right">384</td>
257257
* <td style="text-align:right">1</td>
258258
* </tr>
259259
* <tr>
260-
* <td style="text-align:left">L32X64MixRandom</td>
260+
* <th scope="row" style="text-align:left">L32X64MixRandom</th>
261261
* <td style="text-align:left">LXM</td>
262262
* <td style="text-align:left">BigInteger.ONE.shiftLeft(64).subtract(BigInteger.ONE).shiftLeft(32)</td>
263263
* <td style="text-align:right">96</td>
264264
* <td style="text-align:right">1</td>
265265
* </tr>
266266
* <tr>
267-
* <td style="text-align:left">L64X1024MixRandom</td>
267+
* <th scope="row" style="text-align:left">L64X1024MixRandom</th>
268268
* <td style="text-align:left">LXM</td>
269269
* <td style="text-align:left">BigInteger.ONE.shiftLeft(1024).subtract(BigInteger.ONE).shiftLeft(64)</td>
270270
* <td style="text-align:right">1088</td>
271271
* <td style="text-align:right">16</td>
272272
* </tr>
273273
* <tr>
274-
* <td style="text-align:left">L64X128MixRandom</td>
274+
* <th scope="row" style="text-align:left">L64X128MixRandom</th>
275275
* <td style="text-align:left">LXM</td>
276276
* <td style="text-align:left">BigInteger.ONE.shiftLeft(128).subtract(BigInteger.ONE).shiftLeft(64)</td>
277277
* <td style="text-align:right">192</td>
278278
* <td style="text-align:right">2</td>
279279
* </tr>
280280
* <tr>
281-
* <td style="text-align:left">L64X128StarStarRandom</td>
281+
* <th scope="row" style="text-align:left">L64X128StarStarRandom</th>
282282
* <td style="text-align:left">LXM</td>
283283
* <td style="text-align:left">BigInteger.ONE.shiftLeft(128).subtract(BigInteger.ONE).shiftLeft(64)</td>
284284
* <td style="text-align:right">192</td>
285285
* <td style="text-align:right">2</td>
286286
* </tr>
287287
* <tr>
288-
* <td style="text-align:left">L64X256MixRandom</td>
288+
* <th scope="row" style="text-align:left">L64X256MixRandom</th>
289289
* <td style="text-align:left">LXM</td>
290290
* <td style="text-align:left">BigInteger.ONE.shiftLeft(256).subtract(BigInteger.ONE).shiftLeft(64)</td>
291291
* <td style="text-align:right">320</td>
292292
* <td style="text-align:right">4</td>
293293
* </tr>
294294
* <tr>
295-
* <td style="text-align:left">Random</td>
295+
* <th scope="row" style="text-align:left">Random</th>
296296
* <td style="text-align:left">Legacy</td>
297297
* <td style="text-align:left">BigInteger.ONE.shiftLeft(48)</td>
298298
* <td style="text-align:right">48</td>
299299
* <td style="text-align:right">0</td>
300300
* </tr>
301301
* <tr>
302-
* <td style="text-align:left">SplittableRandom</td>
302+
* <th scope="row" style="text-align:left">SplittableRandom</th>
303303
* <td style="text-align:left">Legacy</td>
304304
* <td style="text-align:left">BigInteger.ONE.shiftLeft(64)</td>
305305
* <td style="text-align:right">64</td>
306306
* <td style="text-align:right">1</td>
307307
* </tr>
308308
* <tr>
309-
* <td style="text-align:left">ThreadLocalRandom <sup>*</sup></td>
309+
* <th scope="row" style="text-align:left">ThreadLocalRandom <sup>*</sup></th>
310310
* <td style="text-align:left">Legacy</td>
311311
* <td style="text-align:left">BigInteger.ONE.shiftLeft(64)</td>
312312
* <td style="text-align:right">64</td>
313313
* <td style="text-align:right">1</td>
314314
* </tr>
315315
* <tr>
316-
* <td style="text-align:left">Xoroshiro128PlusPlus</td>
316+
* <th scope="row" style="text-align:left">Xoroshiro128PlusPlus</th>
317317
* <td style="text-align:left">Xoroshiro</td>
318318
* <td style="text-align:left">BigInteger.ONE.shiftLeft(128).subtract(BigInteger.ONE)</td>
319319
* <td style="text-align:right">128</td>
320320
* <td style="text-align:right">1</td>
321321
* </tr>
322322
* <tr>
323-
* <td style="text-align:left">Xoshiro256PlusPlus</td>
323+
* <th scope="row" style="text-align:left">Xoshiro256PlusPlus</th>
324324
* <td style="text-align:left">Xoshiro</td>
325325
* <td style="text-align:left">BigInteger.ONE.shiftLeft(256).subtract(BigInteger.ONE)</td>
326326
* <td style="text-align:right">256</td>
@@ -466,7 +466,7 @@
466466
* 1-bit), and equidistribution property for each of the specific LXM algorithms
467467
* used in this package.
468468
*
469-
* <table style="padding:0px 20px 0px 0px">
469+
* <table class="striped">
470470
* <caption>Algorithm Properties</caption>
471471
* <thead>
472472
* <tr><th style="text-align:left">Implementation</th>
@@ -476,42 +476,42 @@
476476
* <th style="text-align:left">{@link RandomGenerator#nextLong nextLong()} values are</th></tr>
477477
* </thead>
478478
* <tbody>
479-
* <tr><td style="text-align:left">"L32X64MixRandom"</td>
479+
* <tr><th scope="row" style="text-align:left">"L32X64MixRandom"</th>
480480
* <td style="text-align:right">2<sup>32</sup>(2<sup>64</sup>&minus;1)</td>
481481
* <td style="text-align:right">96 bits</td>
482482
* <td style="text-align:right">32 bits</td>
483483
* <td style="text-align:left"></td></tr>
484-
* <tr><td style="text-align:left">"L64X128StarStarRandom"</td>
484+
* <tr><th scope="row" style="text-align:left">"L64X128StarStarRandom"</th>
485485
* <td style="text-align:right">2<sup>64</sup>(2<sup>128</sup>&minus;1)</td>
486486
* <td style="text-align:right">192 bits</td>
487487
* <td style="text-align:right">64 bits</td>
488488
* <td style="text-align:left">2-equidistributed and exactly equidistributed</td></tr>
489-
* <tr><td style="text-align:left">"L64X128MixRandom"</td>
489+
* <tr><th scope="row" style="text-align:left">"L64X128MixRandom"</th>
490490
* <td style="text-align:right">2<sup>64</sup>(2<sup>128</sup>&minus;1)</td>
491491
* <td style="text-align:right">192 bits</td>
492492
* <td style="text-align:right">64 bits</td>
493493
* <td style="text-align:left">2-equidistributed and exactly equidistributed</td></tr>
494-
* <tr><td style="text-align:left">"L64X256MixRandom"</td>
494+
* <tr><th scope="row" style="text-align:left">"L64X256MixRandom"</th>
495495
* <td style="text-align:right">2<sup>64</sup>(2<sup>256</sup>&minus;1)</td>
496496
* <td style="text-align:right">320 bits</td>
497497
* <td style="text-align:right">64 bits</td>
498498
* <td style="text-align:left">4-equidistributed and exactly equidistributed</td></tr>
499-
* <tr><td style="text-align:left">"L64X1024MixRandom"</td>
499+
* <tr><th scope="row" style="text-align:left">"L64X1024MixRandom"</th>
500500
* <td style="text-align:right">2<sup>64</sup>(2<sup>1024</sup>&minus;1)</td>
501501
* <td style="text-align:right">1088 bits</td>
502502
* <td style="text-align:right">64 bits</td>
503503
* <td style="text-align:left">16-equidistributed and exactly equidistributed</td></tr>
504-
* <tr><td style="text-align:left">"L128X128MixRandom"</td>
504+
* <tr><th scope="row" style="text-align:left">"L128X128MixRandom"</th>
505505
* <td style="text-align:right">2<sup>128</sup>(2<sup>128</sup>&minus;1)</td>
506506
* <td style="text-align:right">256 bits</td>
507507
* <td style="text-align:right">128 bits</td>
508508
* <td style="text-align:left">exactly equidistributed</td></tr>
509-
* <tr><td style="text-align:left">"L128X256MixRandom"</td>
509+
* <tr><th scope="row" style="text-align:left">"L128X256MixRandom"</th>
510510
* <td style="text-align:right">2<sup>128</sup>(2<sup>256</sup>&minus;1)</td>
511511
* <td style="text-align:right">384 bits</td>
512512
* <td style="text-align:right">128 bits</td>
513513
* <td style="text-align:left">exactly equidistributed</td></tr>
514-
* <tr><td style="text-align:left">"L128X1024MixRandom"</td>
514+
* <tr><th scope="row" style="text-align:left">"L128X1024MixRandom"</th>
515515
* <td style="text-align:right">2<sup>128</sup>(2<sup>1024</sup>&minus;1)</td>
516516
* <td style="text-align:right">1152 bits</td>
517517
* <td style="text-align:right">128 bits</td>
@@ -575,7 +575,7 @@
575575
* missing 1-bit is handled through special coding of the multiply-add algorithm
576576
* used in the LCG.)
577577
*
578-
* <table style="padding:0px 20px 0px 0px">
578+
* <table class="striped">
579579
* <caption>LXM Multipliers</caption>
580580
* <thead>
581581
* <tr><th style="text-align:left">Implementation</th>
@@ -585,42 +585,42 @@
585585
* <th style="text-align:left">Mixing function</th></tr>
586586
* </thead>
587587
* <tbody>
588-
* <tr><td style="text-align:left">"L32X64MixRandom"</td>
588+
* <tr><th scope="row" style="text-align:left">"L32X64MixRandom"</th>
589589
* <td style="text-align:right">{@code 0xadb4a92d}</td>
590590
* <td style="text-align:left">{@code xoroshiro64}, version 1.0</td>
591591
* <td style="text-align:left">{@code (26, 9, 13)}</td>
592592
* <td style="text-align:left">mixLea32{@code (s+x0)}</td></tr>
593-
* <tr><td style="text-align:left">"L64X128StarStarRandom" </td>
593+
* <tr><th scope="row" style="text-align:left">"L64X128StarStarRandom" </th>
594594
* <td style="text-align:right">{@code 0xd1342543de82ef95L}</td>
595595
* <td style="text-align:left">{@code xoroshiro128}, version 1.0</td>
596596
* <td style="text-align:left">{@code (24, 16, 37)}</td>
597597
* <td style="text-align:left">{@code Long.rotateLeft((s+x0)* 5, 7) * 9}</td></tr>
598-
* <tr><td style="text-align:left">"L64X128MixRandom"</td>
598+
* <tr><th scope="row" style="text-align:left">"L64X128MixRandom"</th>
599599
* <td style="text-align:right">{@code 0xd1342543de82ef95L}</td>
600600
* <td style="text-align:left">{@code xoroshiro128}, version 1.0</td>
601601
* <td style="text-align:left">{@code (24, 16, 37)}</td>
602602
* <td style="text-align:left">mixLea64{@code (s+x0)}</td></tr>
603-
* <tr><td style="text-align:left">"L64X256MixRandom"</td>
603+
* <tr><th scope="row" style="text-align:left">"L64X256MixRandom"</th>
604604
* <td style="text-align:right">{@code 0xd1342543de82ef95L}</td>
605605
* <td style="text-align:left">{@code xoshiro256}, version 1.0</td>
606606
* <td style="text-align:left">{@code (17, 45)}</td>
607607
* <td style="text-align:left">mixLea64{@code (s+x0)}</td></tr>
608-
* <tr><td style="text-align:left">"L64X1024MixRandom"</td>
608+
* <tr><th scope="row" style="text-align:left">"L64X1024MixRandom"</th>
609609
* <td style="text-align:right">{@code 0xd1342543de82ef95L}</td>
610610
* <td style="text-align:left">{@code xoroshiro1024}, version 1.0</td>
611611
* <td style="text-align:left">{@code (25, 27, 36)}</td>
612612
* <td style="text-align:left">mixLea64{@code (s+x0)}</td></tr>
613-
* <tr><td style="text-align:left">"L128X128MixRandom"</td>
613+
* <tr><th scope="row" style="text-align:left">"L128X128MixRandom"</th>
614614
* <td style="text-align:right">{@code 0x1d605bbb58c8abbfdL}</td>
615615
* <td style="text-align:left">{@code xoroshiro128}, version 1.0</td>
616616
* <td style="text-align:left">{@code (24, 16, 37)}</td>
617617
* <td style="text-align:left">mixLea64{@code (sh+x0)}</td></tr>
618-
* <tr><td style="text-align:left">"L128X256MixRandom"</td>
618+
* <tr><th scope="row" style="text-align:left">"L128X256MixRandom"</th>
619619
* <td style="text-align:right">{@code 0x1d605bbb58c8abbfdL}</td>
620620
* <td style="text-align:left">{@code xoshiro256}, version 1.0</td>
621621
* <td style="text-align:left">{@code (17, 45)}</td>
622622
* <td style="text-align:left">mixLea64{@code (sh+x0)}</td></tr>
623-
* <tr><td style="text-align:left">"L128X1024MixRandom"</td>
623+
* <tr><th scope="row" style="text-align:left">"L128X1024MixRandom"</th>
624624
* <td style="text-align:right">{@code 0x1d605bbb58c8abbfdL}</td>
625625
* <td style="text-align:left">{@code xoroshiro1024}, version 1.0</td>
626626
* <td style="text-align:left">{@code (25, 27, 36)}</td>

0 commit comments

Comments
 (0)
Please sign in to comment.