--- 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();
}
-