1.1 --- a/src/share/classes/javax/lang/model/util/Types.java Mon Mar 18 14:40:32 2013 -0700
1.2 +++ b/src/share/classes/javax/lang/model/util/Types.java Mon Mar 18 18:33:13 2013 -0700
1.3 @@ -59,6 +59,13 @@
1.4 /**
1.5 * Tests whether two {@code TypeMirror} objects represent the same type.
1.6 *
1.7 + * <p>Since annotations are only meta-data associated with a type,
1.8 + * the set of annotations on either argument is <em>not</em> taken
1.9 + * into account when computing whether or not two {@code
1.10 + * TypeMirror} objects are the same type. In particular, two
1.11 + * {@code TypeMirror} objects can have different annotations and
1.12 + * still be considered the same.
1.13 + *
1.14 * <p>Caveat: if either of the arguments to this method represents a
1.15 * wildcard, this method will return false. As a consequence, a wildcard
1.16 * is not the same type as itself. This might be surprising at first,
