--- old/src/share/classes/java/lang/annotation/Annotation.java	2013-12-04 17:54:59.000000000 -0800
+++ new/src/share/classes/java/lang/annotation/Annotation.java	2013-12-04 17:54:59.000000000 -0800
@@ -34,6 +34,10 @@
  * More information about annotation types can be found in section 9.6 of
  * <cite>The Java&trade; Language Specification</cite>.
  *
+ * The {@link java.lang.reflect.AnnotatedElement} interface discusses
+ * compatibility concerns when evolving an annotation type from being
+ * non-repeatable to being repeatable.
+ *
  * @author  Josh Bloch
  * @since   1.5
  */