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?
...
-------------
Reported by:
From: Martin Desruisseaux <###@###.###>
Subject: Strange or obsolete @see tags in some exception javadoc
Date: January 12, 2012 03:30:16 PST
To: ###@###.###
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?
...
-------------
Reported by:
From: Martin Desruisseaux <###@###.###>
Subject: Strange or obsolete @see tags in some exception javadoc
Date: January 12, 2012 03:30:16 PST
To: ###@###.###