--- jsr166/src/extra166y/ParallelLongArrayWithBounds.java 2009/01/06 14:30:58 1.1 +++ jsr166/src/extra166y/ParallelLongArrayWithBounds.java 2015/01/18 20:17:32 1.8 @@ -1,10 +1,11 @@ /* * Written by Doug Lea with assistance from members of JCP JSR-166 * Expert Group and released to the public domain, as explained at - * http://creativecommons.org/licenses/publicdomain + * http://creativecommons.org/publicdomain/zero/1.0/ */ package extra166y; + import jsr166y.*; import static extra166y.Ops.*; import java.util.*; @@ -28,9 +29,9 @@ public abstract class ParallelLongArrayW * only on the elements of the array between firstIndex * (inclusive) and upperBound (exclusive). The bound * arguments are relative to the current bounds. For example - * pa.withBounds(2, 8).withBounds(3, 5) indexes the + * {@code pa.withBounds(2, 8).withBounds(3, 5)} indexes the * 5th (= 2+3) and 6th elements of pa. However, indices - * returned by methods such as indexOf are + * returned by methods such as {@code indexOf} are * with respect to the underlying ParallelLongArray. * @param firstIndex the lower bound (inclusive) * @param upperBound the upper bound (exclusive) @@ -41,7 +42,7 @@ public abstract class ParallelLongArrayW /** * Returns the index of some element equal to given target, or - * -1 if not present + * -1 if not present. * @param target the element to search for * @return the index or -1 if not present */ @@ -77,7 +78,7 @@ public abstract class ParallelLongArrayW public abstract ParallelLongArrayWithBounds cumulate(LongReducer reducer, long base); /** - * Replaces each element with the running sum + * Replaces each element with the running sum. * @return this (to simplify use in expressions) */ public abstract ParallelLongArrayWithBounds cumulateSum(); @@ -93,7 +94,7 @@ public abstract class ParallelLongArrayW public abstract long precumulate(LongReducer reducer, long base); /** - * Replaces each element with its prefix sum + * Replaces each element with its prefix sum. * @return the total sum */ public abstract long precumulateSum(); @@ -113,10 +114,9 @@ public abstract class ParallelLongArrayW * Comparable. Unlike Arrays.sort, this sort does not * guarantee that elements with equal keys maintain their relative * position in the array. - * @throws ClassCastException if any element is not Comparable. * @return this (to simplify use in expressions) + * @throws ClassCastException if any element is not Comparable */ public abstract ParallelLongArrayWithBounds sort(); } -