jdk/src/share/classes/java/util/Collection.java
changeset 20491 eb2dfc7436af
parent 20489 cce02e4a6cbe
--- a/jdk/src/share/classes/java/util/Collection.java	Tue Oct 01 17:15:43 2013 +0400
+++ b/jdk/src/share/classes/java/util/Collection.java	Mon Sep 30 15:50:06 2013 -0700
@@ -104,6 +104,13 @@
  * the specified behavior of underlying {@link Object} methods wherever the
  * implementor deems it appropriate.
  *
+ * <p>Some collection operations which perform recursive traversal of the
+ * collection may fail with an exception for self-referential instances where
+ * the collection directly or indirectly contains itself. This includes the
+ * {@code clone()}, {@code equals()}, {@code hashCode()} and {@code toString()}
+ * methods. Implementations may optionally handle the self-referential scenario,
+ * however most current implementations do not do so.
+ *
  * <p>This interface is a member of the
  * <a href="{@docRoot}/../technotes/guides/collections/index.html">
  * Java Collections Framework</a>.