clarification on docs of Class#getInterfaces() and Class#getGenericInterfaces() needed?

[Joel Borggren-Franck]

Hi Jochen,

On 2014-03-10, Jochen Theodorou wrote:
> 
> You basically find this sentence for Class#getInterfaces() and
> Class#getGenericInterfaces() "If this object represents a class, the
> return value is an array containing objects representing all
> interfaces implemented by the class."
> 
> The problem is that wording of "all". When I look at for example
> AbstractList, then all means to me more than just List (which is
> what is returned for AbstractList.class.getInterfaces()).

I agree this could be clearer. I plan to improve this for 9.

See

https://bugs.openjdk.java.net/browse/JDK-8023020

for the javadoc cleanup and

https://bugs.openjdk.java.net/browse/JDK-6761417

for a related enhancement request.

I do think it is important to state the various corner cases but the
main part of the method doc could be improved.

cheers
/Joel