On Fri, 19 Feb 2021 12:48:05 GMT, Jim Laskey <jlas...@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:
> 
>   Remove tabs from random/package-info.java

src/java.base/share/classes/java/util/random/package-info.java line 193:

> 191:  *
> 192:  *
> 193:  * <h2><a id="algorithms">Random Number Generator Algorithms Available 
> in Java SE</a></h2>

Some comments and questions on the spec status of this table: is the 
intentional to require all of these algorithms in all compliant implementation 
of Java SE or just in the JDK reference implementation? Is the list intended to 
be exhaustive, meaning no other algorithms should be findable?

I recommend clarifying the intended Java SE vs JDK status here. Also, I 
recommend including wording along the lines of "this list may change in the 
future" and "an implementation may provide additional algorithms" etc.

Also, to aid future evolution of the set of algorithms, was there consideration 
of an "isDeprecated" predicate so that algorithms could be so-marked for a 
while before being dropped?

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

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

Reply via email to