src/jdk.javadoc/share/classes/com/sun/javadoc/package-info.java

*** 1,7 ****
  /*
!  * Copyright (c) 1998, 2014, Oracle and/or its affiliates. All rights reserved.
   * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
   *
   * This code is free software; you can redistribute it and/or modify it
   * under the terms of the GNU General Public License version 2 only, as
   * published by the Free Software Foundation.  Oracle designates this
--- 1,7 ----
  /*
!  * Copyright (c) 1998, 2015, Oracle and/or its affiliates. All rights reserved.
   * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
   *
   * This code is free software; you can redistribute it and/or modify it
   * under the terms of the GNU General Public License version 2 only, as
   * published by the Free Software Foundation.  Oracle designates this
*** 22,31 ****
--- 22,36 ----
   * or visit www.oracle.com if you need additional information or have any
   * questions.
   */
  
  /**
+ <p style="font-style: italic; font-size:larger">
+ <b>Note:</b> The declarations in this package have been superseded by those
+ in the package {@code jdk.javadoc.doclet}.
+ </p>
+ 
  The Doclet API (also called the Javadoc API) provides a mechanism
  for clients to inspect the source-level structure of programs and
  libraries, including javadoc comments embedded in the source.
  This is useful for documentation, program checking, automatic
  code generation and many other tools.