--- jsr166/src/main/java/util/ArrayList.java	2016/12/05 00:08:01	1.47
+++ jsr166/src/main/java/util/ArrayList.java	2017/05/06 06:49:45	1.50
@@ -91,7 +91,7 @@ import java.util.function.UnaryOperator;
  * should be used only to detect bugs.</i>
  *
  * <p>This class is a member of the
- * <a href="{@docRoot}/../technotes/guides/collections/index.html">
+ * <a href="{@docRoot}/java/util/package-summary.html#CollectionsFramework">
  * Java Collections Framework</a>.
  *
  * @param <E> the type of elements in this list
@@ -1371,6 +1371,9 @@ public class ArrayList<E> extends Abstra
         }
     }
 
+    /**
+     * @throws NullPointerException {@inheritDoc}
+     */
     @Override
     public void forEach(Consumer<? super E> action) {
         Objects.requireNonNull(action);
@@ -1440,7 +1443,7 @@ public class ArrayList<E> extends Abstra
         private int fence; // -1 until used; then one past last index
         private int expectedModCount; // initialized when fence set
 
-        /** Create new spliterator covering the given range */
+        /** Creates new spliterator covering the given range. */
         ArrayListSpliterator(int origin, int fence, int expectedModCount) {
             this.index = origin;
             this.fence = fence;
@@ -1522,6 +1525,9 @@ public class ArrayList<E> extends Abstra
         return (bits[i >> 6] & (1L << i)) == 0;
     }
 
+    /**
+     * @throws NullPointerException {@inheritDoc}
+     */
     @Override
     public boolean removeIf(Predicate<? super E> filter) {
         return removeIf(filter, 0, size);