Strange or obsolete @see tags in some exception javadoc

Martin Desruisseaux martin.desruisseaux at geomatys.fr
Thu Jan 12 11:30:16 UTC 2012


Hello all

Some widely-used exceptions which were defined in the old Java 1.0 days have 
strange or obsolete javadoc "@see" tags:

http://docs.oracle.com/javase/7/docs/api/java/lang/IllegalArgumentException.html
IllegalArgumentException declares "@see Thread#setPriority(int)". Why is 
Thread.setPriority(int) so special in regard to IllegalArgumentException?

http://docs.oracle.com/javase/7/docs/api/java/lang/NumberFormatException.html
NumberFormatException declares "@see Integer#toString()". Shouldn't it be "@see 
Integer#parseInt(String)" instead?

http://docs.oracle.com/javase/7/docs/api/java/util/NoSuchElementException.html
NoSuchElementException declares the legacy "@see Enumeration#nextElement()", but 
does not declare the "@see Iterator#next()" replacement.

     Martin




More information about the core-libs-dev mailing list