Strange or obsolete @see tags in some exception javadoc (original) (raw)

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