JDK 9 RFR - 8031142 [was: Re: Using @implSpec in AbstractMap, AbstractCollection, AbstractList, etc]

[Martin Buchholz]

I retract my previous message.  What's actually happening is that
superclasses are preferred to superinterfaces as sources for @inheritDoc.

It used to be that javadoc was the only thing in java subject to the
dreaded diamond inheritance.  Maybe method resolution for default methods
vs. superclass methods today works the same way?

Anyways, this is one reason I was pessimistic back in 2005 that new
mechanisms like @implSpec would actually make java.util maintainers lives
much easier.