Neal wrote:
=============
In the new Java Language Specification, we're formalizing the idea of deprecation. A new annotation (@Deprecated) is being introduced to mark deprecated declarations, and compilers are required by the JLS to give warnings when a deprecated entity - that is, one marked with the @Deprecated annotation - is used in non-deprecated code. The existing @deprecated javadoc tag, which is formally a comment, remains as a reliable mechanism to document the reason that a program element is deprecated, just as the @throws tag is a reliable way to document the reasons that a method can throw exceptions.

To take advantage of the new language feature, and to ensure that all Java compilers are required to report these warnings, we are marking all deprecated declarations in J2SE with the @Deprecated annotation. This is a trivial change, and does not have any effect on the behavior of the APIs or on their clients. The only effect is that javadoc will properly document the fact that the thing is deprecated, and java compilers will now be required to reliably report usage of deprecated entities.
==============

We should update the old com.sun.net.ssl.* APIs in mustang. It's probably
not worth making a core request at this late date for tger.

###@###.### 2004-06-24