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