The documentation about deprecation

http://java.sun.com/j2se/1.4.2/docs/guide/misc/deprecation/index.html

should be overhauled for Tiger in light of the new @Deprecated annotation.
@Deprecated is addressed in the JDK 6 documentation
http://java.sun.com/javase/6/docs/technotes/guides/javadoc/deprecation/deprecation.html