Deprecation policy?

[Neal Gafter]

I notice that javax.swing.tree.DefaultTreeSelectionModel.notifyPathChange
<http://download.java.net/jdk7/docs/api/javax/swing/tree/DefaultTreeSelectionModel.html#notifyPathChange%28java.util.Vector,%20javax.swing.tree.TreePath%29>has
been deprecated "As of JDK version 1.7" with no further explanation in its
documentation.  This method had the very strange property in 1.6 that the
method itself was protected but it had a parameter that mentions (in a
generic type argument) a package-private
type<http://java.sun.com/javase/6/docs/api/javax/swing/tree/DefaultTreeSelectionModel.html#notifyPathChange%28java.util.Vector,%20javax.swing.tree.TreePath%29>,
which would make it hard to use correctly.  Still, isn't it traditional for
the deprecation documentation to provide clients with more explanation or
assistance?
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.openjdk.java.net/pipermail/core-libs-dev/attachments/20091117/e8989f38/attachment.html>