improve class javadoc for rngs

Author: TilmanNeumann

src/main/java/de/tilman_neumann/jml/random/LehmerRng64.java

@@ -18,7 +18,7 @@
 /**
  * Lehmer's random number generator for 64 bit numbers; requires 128 bit multiplication internally.
  * 
- * This is class is still <strong>experimental</strong>. It seems to work but not much faster than Random yet.
+ * It seems to work but not much faster than Random yet.
  * 
  * @see https://en.wikipedia.org/wiki/Lehmer_random_number_generator
  */

src/main/java/de/tilman_neumann/jml/random/LehmerRng64MH.java

@@ -16,9 +16,9 @@
 import de.tilman_neumann.jml.base.Uint128;
 
 /**
- * Lehmer's random number generator for 64 bit numbers, using Math.multiplyHigh(); requires 128 bit multiplication internally.
+ * Lehmer's random number generator for 64 bit numbers; requires 128 bit multiplication internally.
  * 
- * This is class is still <strong>experimental</strong>.
+ * This variant uses using Math.multiplyHigh().
  * 
  * @see https://en.wikipedia.org/wiki/Lehmer_random_number_generator
  */

src/main/java/de/tilman_neumann/jml/random/SpRand32.java

@@ -17,7 +17,7 @@
 import org.apache.logging.log4j.Logger;
 
 /**
- * My Java port of the pseudo-random number generator from tinyEcm.c by Ben Buhrow.
+ * My Java port of the 32-bit pseudo-random number generator from tinyEcm.c by Ben Buhrow.
  * 
  * This generator is special in that nextInt() creates strictly non-negative random numbers.
  * 

src/main/java/de/tilman_neumann/jml/random/SplitMix64.java

@@ -16,10 +16,11 @@
 import de.tilman_neumann.jml.base.Uint128;
 
 /**
- * 64 bit random number generator adapted from https://rosettacode.org/wiki/Pseudo-random_numbers/Splitmix64.
+ * splitmix64 is a 64 bit random number generator with 64 bit state.
+ * Adapted from https://rosettacode.org/wiki/Pseudo-random_numbers/Splitmix64.
  * 
  * Very fast, but its statistical properties are poor.
- * But according to https://en.wikipedia.org/wiki/Xorshift#Initialization, it is well-suited to initialize other random generators.
+ * According to https://en.wikipedia.org/wiki/Xorshift#Initialization, it is well-suited to initialize other random generators.
  * 
  * @author Tilman Neumann
  */

src/main/java/de/tilman_neumann/jml/random/Xoroshiro128Plus.java

@@ -16,7 +16,7 @@
 import de.tilman_neumann.jml.base.Uint128;
 
 /**
- * 64 bit random number generator.
+ * xoroshiro128+ is a 64 bit random number generator using 128 bit state.
  * 
  * @see https://nullprogram.com/blog/2017/09/21/
 . * 

src/main/java/de/tilman_neumann/jml/random/Xoroshiro256StarStar.java

@@ -16,9 +16,10 @@
 import de.tilman_neumann.jml.base.Uint128;
 
 /**
- * 64 bit random number generator adapted from https://en.wikipedia.org/wiki/Xorshift.
+ * xoroshiro256** is a 64 bit random number generator using 256 bit state.
+ * Adapted from https://en.wikipedia.org/wiki/Xorshift.
  * 
- * This seems to be the best 64 bit pseudo-random number generator these days, see also https://nullprogram.com/blog/2017/09/21/
+ * This seems to be one of the best 64 bit pseudo-random number generators these days, see also https://nullprogram.com/blog/2017/09/21/
  * 
  * @author Tilman Neumann
  */

src/main/java/de/tilman_neumann/jml/random/Xorshift128Plus.java

@@ -16,7 +16,8 @@
 import de.tilman_neumann.jml.base.Uint128;
 
 /**
- * 64 bit random number generator adapted from https://nullprogram.com/blog/2017/09/21/.
+ * xorshift128+ is a 64 bit random number generator using 128 bit state.
+ * Adapted from https://nullprogram.com/blog/2017/09/21/.
 . * 
  * @author Tilman Neumann
  */

src/main/java/de/tilman_neumann/jml/random/Xorshift64Star.java

@@ -16,7 +16,8 @@
 import de.tilman_neumann.jml.base.Uint128;
 
 /**
- * 64 bit random number generator adapted from https://nullprogram.com/blog/2017/09/21/.
+ * xorshift64* is a 64 bit random number generator using 64 bit state.
+ * Adapted from https://nullprogram.com/blog/2017/09/21/.
 . * 
  * @author Tilman Neumann
  */