--- jsr166/src/extra166y/ParallelArray.java 2011/12/05 04:08:47 1.3 +++ jsr166/src/extra166y/ParallelArray.java 2012/11/18 18:03:10 1.6 @@ -22,7 +22,7 @@ import java.lang.reflect.Array; * matching a predicate or ranges of indices, and to reduce * all elements into a single value such as a sum. * - *

A ParallelArray is constructed by allocating, using, or copying + *

A ParallelArray is constructed by allocating, using, or copying * an array, using one of the static factory methods {@link #create}, * {@link #createEmpty}, {@link #createUsingHandoff} and {@link * #createFromCopy}. Upon construction, the encapsulated array managed @@ -31,7 +31,7 @@ import java.lang.reflect.Array; * array, access by another thread of an element of a ParallelArray * while another operation is in progress has undefined effects. * - *

The ForkJoinPool used to construct a ParallelArray can be + *

The ForkJoinPool used to construct a ParallelArray can be * shared safely by other threads (and used in other * ParallelArrays). To avoid the overhead associated with creating * multiple executors, it is often a good idea to use the {@link @@ -67,7 +67,7 @@ import java.lang.reflect.Array; * significantly improving performance beyond that of the Long and * Double versions.) * - *

Most usages of ParallelArray involve sets of operations prefixed + *

Most usages of ParallelArray involve sets of operations prefixed * with range bounds, filters, and mappings (including mappings that * combine elements from other ParallelArrays), using * withBounds, withFilter, and withMapping, @@ -139,7 +139,6 @@ import java.lang.reflect.Array; * static final GpaField gpaField = new GpaField(); * } * - * */ public class ParallelArray extends AbstractParallelAnyArray.OUPap implements Iterable { /* @@ -273,20 +272,20 @@ public class ParallelArray extends Ab * mapped ParallelArray. */ public static interface SummaryStatistics { - /** Return the number of elements */ + /** Returns the number of elements */ public int size(); - /** Return the minimum element, or null if empty */ + /** Returns the minimum element, or null if empty */ public T min(); - /** Return the maximum element, or null if empty */ + /** Returns the maximum element, or null if empty */ public T max(); - /** Return the index of the minimum element, or -1 if empty */ + /** Returns the index of the minimum element, or -1 if empty */ public int indexOfMin(); - /** Return the index of the maximum element, or -1 if empty */ + /** Returns the index of the maximum element, or -1 if empty */ public int indexOfMax(); } /** - * Returns the executor used for computations + * Returns the executor used for computations. * @return the executor */ public ForkJoinPool getExecutor() { return ex; } @@ -1096,7 +1095,7 @@ public class ParallelArray extends Ab } /** - * Make len slots available at index + * Makes len slots available at index. */ final void insertSlotsAt(int index, int len) { if (len <= 0)