clarification on docs of Class#getInterfaces() and Class#getGenericInterfaces() needed?
joel.franck at oracle.com
Fri Mar 14 13:23:25 UTC 2014
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.
for the javadoc cleanup and
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.
More information about the core-libs-dev