--- a/langtools/src/jdk.javadoc/share/classes/com/sun/javadoc/Doclet.java	Fri May 27 12:37:18 2016 -0700
+++ b/langtools/src/jdk.javadoc/share/classes/com/sun/javadoc/Doclet.java	Fri May 27 13:06:58 2016 -0700
@@ -47,7 +47,13 @@
  * <p> To start the doclet, pass
  * {@code -doclet} followed by the fully-qualified
  * name of the starting class on the javadoc tool command line.
+ *
+ * @deprecated
+ *   The declarations in this package have been superseded by those
+ *   in the package {@code jdk.javadoc.doclet}.
+ *   For more information, see the <i>Migration Guide</i> in the documentation for that package.
  */
+@Deprecated
 public abstract class Doclet {
 
     /**