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

[Stuart Marks]

On 11/24/15 3:30 AM, Peter Levart wrote:
>> 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.

Yes, this is a javadoc bug, https://bugs.openjdk.java.net/browse/JDK-8139101 .

s'marks