RFR: 8248862: Implement Enhanced Pseudo-Random Number Generators [v31]

[Joe Darcy]

On Mon, 15 Mar 2021 12:54:32 GMT, Jim Laskey <jlaskey at openjdk.org> wrote:

>> This PR is to introduce a new random number API for the JDK. The primary API is found in RandomGenerator and RandomGeneratorFactory. Further description can be found in the JEP https://openjdk.java.net/jeps/356 .
>> 
>> javadoc can be found at http://cr.openjdk.java.net/~jlaskey/prng/doc/api/java.base/java/util/random/package-summary.html
>> 
>> old PR:  https://github.com/openjdk/jdk/pull/1273
>
> Jim Laskey has updated the pull request incrementally with one additional commit since the last revision:
> 
>   Missing @since

src/java.base/share/classes/java/util/Random.java line 135:

> 133:      * number generator which is maintained by method {@link #next}.
> 134:      *
> 135:      * @implSpec <p>The invocation {@code new Random(seed)} is equivalent to:

This is not conventional formatting for an implSpec section. I suggest putting implSpec on its own line and then left-justifying the text as normal. A new paragraph tag is no needed at the beginning of implSpec.

-------------

PR: https://git.openjdk.java.net/jdk/pull/1292