/*
 * Java Genetic Algorithm Library (@__identifier__@).
 * Copyright (c) @__year__@ Franz Wilhelmstötter
 *
 * This library is free software; you can redistribute it and/or
 * modify it under the terms of the GNU Lesser General Public
 * License as published by the Free Software Foundation; either
 * version 2.1 of the License, or (at your option) any later version.
 *
 * This library is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
 * Lesser General Public License for more details.
 *
 * You should have received a copy of the GNU Lesser General Public
 * License along with this library; if not, write to the Free Software
 * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
 *
 * Author:
 *     Franz Wilhelmstötter (franz.wilhelmstoetter@gmx.at)
 *
 */
package org.jenetics.util;

import java.util.Random;

/**
 * Abstract {@Random} class with additional <i>next</i> random number methods.
 *
 * @author <a href="mailto:franz.wilhelmstoetter@gmx.at">Franz Wilhelmstötter</a>
 * @since 1.2
 * @version 1.2 &mdash; <em>$Date: 2013-06-13 $</em>
 */
abstract class PRNG extends Random {

	private static final long serialVersionUID = 1L;

	/**
	 * Create a new {@code PRNG} instance with the given {@code seed}.
	 *
	 * @param seed the seed of the new {@code PRNG} instance.
	 */
	protected PRNG(long seed) {
		super(seed);
	}

	/**
	 * Create a new {@code PRNG} instance with a seed created with the
	 * {@link math.random#seed()} value.
	 */
	protected PRNG() {
		this(math.random.seed());
	}

	/**
	 * Returns a pseudorandom, uniformly distributed int value between min and
	 * max (end points included).
	 *
	 * @param min lower bound for generated integer
	 * @param max upper bound for generated integer
	 * @return a random integer greater than or equal to {@code min} and less
	 *         than or equal to {@code max}
	 * @throws IllegalArgumentException if {@code min >= max}
	 */
	public int nextInt(final int min, final int max) {
		return math.random.nextInt(this, min, max);
	}

	/**
	 * Returns a pseudorandom, uniformly distributed int value between min
	 * and max (end points included).
	 *
	 * @param min lower bound for generated long integer
	 * @param max upper bound for generated long integer
	 * @return a random long integer greater than or equal to {@code min}
	 *         and less than or equal to {@code max}
	 * @throws IllegalArgumentException if {@code min >= max}
	 */
	public long nextLong(final long min, final long max) {
		return math.random.nextLong(this, min, max);
	}


	/**
	 * Returns a pseudorandom, uniformly distributed int value between 0
	 * (inclusive) and the specified value (exclusive), drawn from the given
	 * random number generator's sequence.
	 *
	 * @param n the bound on the random number to be returned. Must be
	 *        positive.
	 * @return the next pseudorandom, uniformly distributed int value
	 *         between 0 (inclusive) and n (exclusive) from the given random
	 *         number generator's sequence
	 * @throws IllegalArgumentException if n is smaller than 1.
	 */
	public long nextLong(final long n) {
		return math.random.nextLong(this, n);
	}

	/**
	 * Returns a pseudorandom, uniformly distributed double value between
	 * min (inclusively) and max (exclusively).
	 *
	 * @param min lower bound for generated float value
	 * @param max upper bound for generated float value
	 * @return a random float greater than or equal to {@code min} and less
	 *         than to {@code max}
	 */
	public float nextFloat(final float min, final float max) {
		return math.random.nextFloat(this, min, max);
	}

	/**
	 * Returns a pseudorandom, uniformly distributed double value between
	 * min (inclusively) and max (exclusively).
	 *
	 * @param min lower bound for generated double value
	 * @param max upper bound for generated double value
	 * @return a random double greater than or equal to {@code min} and less
	 *         than to {@code max}
	 */
	public double nextDouble(final double min, final double max) {
		return math.random.nextDouble(this, min, max);
	}

}

@@ -2039,37 +2039,88 @@
 ode min %3E= max%7D%0A
+%09 *%0A%09 * @see math.random#nextInt(Random, int, int)%0A
 %09 */%0A
-
 %09public int next
@@ -2605,24 +2605,78 @@
 min %3E= max%7D%0A
+%09 *%0A%09 * @see math.random#nextLong(Random, long, long)%0A
 %09 */%0A%09public
@@ -3300,16 +3300,64 @@
 than 1.%0A
+%09 *%0A%09 * @see math.random#nextLong(Random, long)%0A
 %09 */%0A%09pu
@@ -3763,32 +3763,89 @@
  to %7B@code max%7D%0A
+%09 *%0A%09 * @see math.random#nextFloat(Random, float, float)%0A
 %09 */%0A%09public flo
@@ -4244,32 +4244,32 @@
 e min%7D and less%0A
-
 %09 *         than
@@ -4284,16 +4284,76 @@
 de max%7D%0A
+%09 *%0A%09 * @see math.random#nextDouble(Random, double, double)%0A
 %09 */%0A%09pu

Improve Javadoc.