--- jsr166/src/extra166y/ParallelDoubleArray.java 2012/12/29 23:55:19 1.7 +++ jsr166/src/extra166y/ParallelDoubleArray.java 2013/02/05 17:49:18 1.10 @@ -61,7 +61,7 @@ public class ParallelDoubleArray extends /** * Creates a new ParallelDoubleArray using the given executor and - * an array of the given size + * an array of the given size. * @param size the array size * @param executor the executor */ @@ -154,13 +154,13 @@ public class ParallelDoubleArray extends } /** - * Returns the executor used for computations + * Returns the executor used for computations. * @return the executor */ public ForkJoinPool getExecutor() { return ex; } /** - * Applies the given procedure to elements + * Applies the given procedure to elements. * @param procedure the procedure */ public void apply(DoubleProcedure procedure) { @@ -168,7 +168,7 @@ public class ParallelDoubleArray extends } /** - * Returns reduction of elements + * Returns reduction of elements. * @param reducer the reducer * @param base the result for an empty array * @return reduction @@ -178,7 +178,7 @@ public class ParallelDoubleArray extends } /** - * Returns a new ParallelDoubleArray holding all elements + * Returns a new ParallelDoubleArray holding all elements. * @return a new ParallelDoubleArray holding all elements */ public ParallelDoubleArray all() { @@ -209,7 +209,7 @@ public class ParallelDoubleArray extends /** * Replaces elements with the results of applying the given - * mapping to each index and current element value + * mapping to each index and current element value. * @param op the op * @return this (to simplify use in expressions) */ @@ -222,7 +222,7 @@ public class ParallelDoubleArray extends * Replaces elements with the results of applying the given * generator. For example, to fill the array with uniform random * values, use - * replaceWithGeneratedValue(Ops.doubleRandom()) + * {@code replaceWithGeneratedValue(Ops.doubleRandom())}. * @param generator the generator * @return this (to simplify use in expressions) */ @@ -243,7 +243,7 @@ public class ParallelDoubleArray extends /** * Replaces elements with results of applying - * op(thisElement, otherElement) + * {@code op(thisElement, otherElement)}. * @param other the other array * @param combiner the combiner * @return this (to simplify use in expressions) @@ -258,7 +258,7 @@ public class ParallelDoubleArray extends /** * Replaces elements with results of applying - * op(thisElement, otherElement) + * {@code op(thisElement, otherElement)}. * @param other the other array * @param combiner the combiner * @return this (to simplify use in expressions) @@ -273,7 +273,7 @@ public class ParallelDoubleArray extends /** * Returns the index of some element equal to given target, or -1 - * if not present + * if not present. * @param target the element to search for * @return the index or -1 if not present */ @@ -362,9 +362,9 @@ public class ParallelDoubleArray extends /** * Replaces each element with the running cumulation of applying * the given reducer. For example, if the contents are the numbers - * 1, 2, 3, and the reducer operation adds numbers, then - * after invocation of this method, the contents would be 1, - * 3, 6 (that is, 1, 1+2, 1+2+3); + * {@code 1, 2, 3}, and the reducer operation adds numbers, then + * after invocation of this method, the contents would be {@code 1, + * 3, 6} (that is, {@code 1, 1+2, 1+2+3}). * @param reducer the reducer * @param base the result for an empty array * @return this (to simplify use in expressions) @@ -377,11 +377,11 @@ public class ParallelDoubleArray extends /** * Replaces each element with the cumulation of applying the given * reducer to all previous values, and returns the total - * reduction. For example, if the contents are the numbers 1, - * 2, 3, and the reducer operation adds numbers, then after - * invocation of this method, the contents would be 0, 1, - * 3 (that is, 0, 0+1, 0+1+2, and the return value - * would be 6 (that is, 1+2+3); + * reduction. For example, if the contents are the numbers {@code 1, + * 2, 3}, and the reducer operation adds numbers, then after + * invocation of this method, the contents would be {@code 0, 1, + * 3} (that is, {@code 0, 0+1, 0+1+2}, and the return value + * would be 6 (that is, {@code 1+2+3}). * @param reducer the reducer * @param base the result for an empty array * @return the total reduction @@ -439,7 +439,7 @@ public class ParallelDoubleArray extends } /** - * Equivalent to asList().addAll but specialized for + * Equivalent to {@code asList().addAll} but specialized for * array arguments and likely to be more efficient. * @param other the elements to add * @return this (to simplify use in expressions) @@ -797,7 +797,7 @@ public class ParallelDoubleArray extends * Returns an iterator stepping through each element of the array * up to the current limit. This iterator does not * support the remove operation. However, a full - * ListIterator supporting add, remove, and set + * {@code ListIterator} supporting add, remove, and set * operations is available via {@link #asList}. * @return an iterator stepping through each element */ @@ -852,27 +852,27 @@ public class ParallelDoubleArray extends public int size() { return fence; } /** - * Returns the underlying array used for computations + * Returns the underlying array used for computations. * @return the array */ public double[] getArray() { return array; } /** - * Returns the element of the array at the given index + * Returns the element of the array at the given index. * @param i the index * @return the element of the array at the given index */ public double get(int i) { return array[i]; } /** - * Sets the element of the array at the given index to the given value + * Sets the element of the array at the given index to the given value. * @param i the index * @param x the value */ public void set(int i, double x) { array[i] = x; } /** - * Equivalent to asList().toString() + * Equivalent to {@code asList().toString()}. * @return a string representation */ public String toString() {