diff --git a/src/share/classes/java/lang/Iterable.java b/src/share/classes/java/lang/Iterable.java
index 9463feeab4f482ce01ac66807cfda48a2079c864..0b1e9548a522df470482cbcd82d971e36a5c6ccb 100644
--- a/src/share/classes/java/lang/Iterable.java
+++ b/src/share/classes/java/lang/Iterable.java
@@ -27,8 +27,12 @@ package java.lang;
 
 import java.util.Iterator;
 
-/** Implementing this interface allows an object to be the target of
- *  the "foreach" statement.
+/**
+ * Implementing this interface allows an object to be the target of
+ * the "foreach" statement.
+ *
+ * @param <T> the type of elements returned by the iterator
+ *
  * @since 1.5
  */
 public interface Iterable<T> {
diff --git a/src/share/classes/java/util/Collection.java b/src/share/classes/java/util/Collection.java
index e7cb3c91e0c8cff27e84dae7224afa5a271c122f..c79e0cde3093509c57be26b49893a3a096c70368 100644
--- a/src/share/classes/java/util/Collection.java
+++ b/src/share/classes/java/util/Collection.java
@@ -103,6 +103,8 @@ package java.util;
  * <a href="{@docRoot}/../technotes/guides/collections/index.html">
  * Java Collections Framework</a>.
  *
+ * @param <E> the type of elements in this collection
+ *
  * @author  Josh Bloch
  * @author  Neal Gafter
  * @see     Set
diff --git a/src/share/classes/java/util/Iterator.java b/src/share/classes/java/util/Iterator.java
index 16b9c431506642cde168f309ea651c37ccdf85da..fd9725de850a6b07f65ec07b360971385c83a883 100644
--- a/src/share/classes/java/util/Iterator.java
+++ b/src/share/classes/java/util/Iterator.java
@@ -41,6 +41,8 @@ package java.util;
  * <a href="{@docRoot}/../technotes/guides/collections/index.html">
  * Java Collections Framework</a>.
  *
+ * @param <E> the type of elements returned by this iterator
+ *
  * @author  Josh Bloch
  * @see Collection
  * @see ListIterator
diff --git a/src/share/classes/java/util/List.java b/src/share/classes/java/util/List.java
index 4ce27c82289f7739c07be470d6bcf2c3ec9aa961..a05fe305681ad0b695041f7fa15eab8ad1fa5941 100644
--- a/src/share/classes/java/util/List.java
+++ b/src/share/classes/java/util/List.java
@@ -89,6 +89,8 @@ package java.util;
  * <a href="{@docRoot}/../technotes/guides/collections/index.html">
  * Java Collections Framework</a>.
  *
+ * @param <E> the type of elements in this list
+ *
  * @author  Josh Bloch
  * @author  Neal Gafter
  * @see Collection