RFR(m): JEP 269 initial API and skeleton implementation (JDK-8139232)

[Peter Levart]

Hi Stuart,

>
> API spec (basically List, Map, and Set):
>
>     http://cr.openjdk.java.net/~smarks/reviews/jep269/api.20151123/
>
> Specdiff:
>
>     http://cr.openjdk.java.net/~smarks/reviews/jep269/specdiff.20151123/overview-summary.html 
>

Why do EnumSet.of(...) javadocs get this additional line:

  Specified by:
     of in interface Set<E extends java.lang.Enum<E>>

Since static interface methods are not inheritable, their specification 
should not propagate to equaly-signatured methods of classes 
implementing those interfaces (or even interfaces extending them). In 
case of EnumSet this is obviously wrong as specification of Set.of() is 
in some ways more restrictive than EnumSet.of() (EnumSet::of allows 
duplicates in arguments, Set::of doesn't). I think that javadoc tool 
needs to be fixed.

Regards, Peter