--- old/src/share/classes/java/lang/Enum.java 2009-10-13 17:32:21.000000000 -0700 +++ new/src/share/classes/java/lang/Enum.java 2009-10-13 17:32:21.000000000 -0700 @@ -40,10 +40,17 @@ * Edition, §8.9. * + *
Note that when using an enumeration type as the type of a set
+ * or as the type of the keys in a map, specialized and efficient
+ * {@linkplain java.util.EnumSet set} and {@linkplain
+ * java.util.EnumMap map} implementations are available.
+ *
* @param