--- jsr166/src/main/java/util/SplittableRandom.java 2013/07/12 11:26:34 1.7
+++ jsr166/src/main/java/util/SplittableRandom.java 2013/07/14 08:06:49 1.10
@@ -41,7 +41,9 @@ import java.util.stream.DoubleStream;
* generate subtasks. Class SplittableRandom supports methods for
* producing pseudorandom numbers of type {@code int}, {@code long},
* and {@code double} with similar usages as for class
- * {@link java.util.Random} but differs in the following ways:
+ * {@link java.util.Random} but differs in the following ways:
+ *
+ *
*
* - Series of generated values pass the DieHarder suite testing
* independence and uniformity properties of random number generators.
@@ -453,7 +455,7 @@ public class SplittableRandom {
* @param bound the bound on the random number to be returned. Must be
* positive.
* @return a pseudorandom {@code int} value between zero
- * (inclusive) and the bound (exclusive).
+ * (inclusive) and the bound (exclusive)
* @throws IllegalArgumentException if the bound is less than zero
*/
public int nextInt(int bound) {
@@ -480,7 +482,7 @@ public class SplittableRandom {
* @param origin the least value returned
* @param bound the upper bound (exclusive)
* @return a pseudorandom {@code int} value between the origin
- * (inclusive) and the bound (exclusive).
+ * (inclusive) and the bound (exclusive)
* @throws IllegalArgumentException if {@code origin} is greater than
* or equal to {@code bound}
*/
@@ -506,7 +508,7 @@ public class SplittableRandom {
* @param bound the bound on the random number to be returned. Must be
* positive.
* @return a pseudorandom {@code long} value between zero
- * (inclusive) and the bound (exclusive).
+ * (inclusive) and the bound (exclusive)
* @throws IllegalArgumentException if {@code bound} is less than zero
*/
public long nextLong(long bound) {
@@ -533,7 +535,7 @@ public class SplittableRandom {
* @param origin the least value returned
* @param bound the upper bound (exclusive)
* @return a pseudorandom {@code long} value between the origin
- * (inclusive) and the bound (exclusive).
+ * (inclusive) and the bound (exclusive)
* @throws IllegalArgumentException if {@code origin} is greater than
* or equal to {@code bound}
*/
@@ -561,7 +563,7 @@ public class SplittableRandom {
* @param bound the bound on the random number to be returned. Must be
* positive.
* @return a pseudorandom {@code double} value between zero
- * (inclusive) and the bound (exclusive).
+ * (inclusive) and the bound (exclusive)
* @throws IllegalArgumentException if {@code bound} is less than zero
*/
public double nextDouble(double bound) {
@@ -579,7 +581,7 @@ public class SplittableRandom {
* @param origin the least value returned
* @param bound the upper bound
* @return a pseudorandom {@code double} value between the origin
- * (inclusive) and the bound (exclusive).
+ * (inclusive) and the bound (exclusive)
* @throws IllegalArgumentException if {@code origin} is greater than
* or equal to {@code bound}
*/
@@ -612,7 +614,7 @@ public class SplittableRandom {
/**
* Returns an effectively unlimited stream of pseudorandom {@code int}
- * values
+ * values.
*
* @implNote This method is implemented to be equivalent to {@code
* ints(Long.MAX_VALUE)}.
@@ -635,7 +637,7 @@ public class SplittableRandom {
* @param randomNumberOrigin the origin of each random value
* @param randomNumberBound the bound of each random value
* @return a stream of pseudorandom {@code int} values,
- * each with the given origin and bound.
+ * each with the given origin and bound
* @throws IllegalArgumentException if {@code streamSize} is
* less than zero, or {@code randomNumberOrigin}
* is greater than or equal to {@code randomNumberBound}
@@ -662,7 +664,7 @@ public class SplittableRandom {
* @param randomNumberOrigin the origin of each random value
* @param randomNumberBound the bound of each random value
* @return a stream of pseudorandom {@code int} values,
- * each with the given origin and bound.
+ * each with the given origin and bound
* @throws IllegalArgumentException if {@code randomNumberOrigin}
* is greater than or equal to {@code randomNumberBound}
*/
@@ -718,7 +720,7 @@ public class SplittableRandom {
* @param randomNumberOrigin the origin of each random value
* @param randomNumberBound the bound of each random value
* @return a stream of pseudorandom {@code long} values,
- * each with the given origin and bound.
+ * each with the given origin and bound
* @throws IllegalArgumentException if {@code streamSize} is
* less than zero, or {@code randomNumberOrigin}
* is greater than or equal to {@code randomNumberBound}
@@ -745,7 +747,7 @@ public class SplittableRandom {
* @param randomNumberOrigin the origin of each random value
* @param randomNumberBound the bound of each random value
* @return a stream of pseudorandom {@code long} values,
- * each with the given origin and bound.
+ * each with the given origin and bound
* @throws IllegalArgumentException if {@code randomNumberOrigin}
* is greater than or equal to {@code randomNumberBound}
*/
@@ -803,9 +805,9 @@ public class SplittableRandom {
* @param randomNumberOrigin the origin of each random value
* @param randomNumberBound the bound of each random value
* @return a stream of pseudorandom {@code double} values,
- * each with the given origin and bound.
+ * each with the given origin and bound
* @throws IllegalArgumentException if {@code streamSize} is
- * less than zero.
+ * less than zero
* @throws IllegalArgumentException if {@code randomNumberOrigin}
* is greater than or equal to {@code randomNumberBound}
*/
@@ -831,7 +833,7 @@ public class SplittableRandom {
* @param randomNumberOrigin the origin of each random value
* @param randomNumberBound the bound of each random value
* @return a stream of pseudorandom {@code double} values,
- * each with the given origin and bound.
+ * each with the given origin and bound
* @throws IllegalArgumentException if {@code randomNumberOrigin}
* is greater than or equal to {@code randomNumberBound}
*/
@@ -1013,4 +1015,3 @@ public class SplittableRandom {
}
}
-