src/share/classes/com/sun/mirror/declaration/PackageDeclaration.java

*** 35,49 ****
   *
   * <p> {@link com.sun.mirror.util.DeclarationFilter}
   * provides a simple way to select just the items of interest
   * when a method returns a collection of declarations.
   *
   * @author Joseph D. Darcy
   * @author Scott Seligman
   * @since 1.5
   */
! 
  public interface PackageDeclaration extends Declaration {
  
      /**
       * Returns the fully qualified name of this package.
       * This is also known as the package's <i>canonical</i> name.
--- 35,55 ----
   *
   * <p> {@link com.sun.mirror.util.DeclarationFilter}
   * provides a simple way to select just the items of interest
   * when a method returns a collection of declarations.
   *
+  * @deprecated All components of this API have been superseded by the
+  * standardized annotation processing API.  The replacement for the
+  * functionality of this interface is {@link
+  * javax.lang.model.element.PackageElement}.
+  *
   * @author Joseph D. Darcy
   * @author Scott Seligman
   * @since 1.5
   */
! @Deprecated
! @SuppressWarnings("deprecation")
  public interface PackageDeclaration extends Declaration {
  
      /**
       * Returns the fully qualified name of this package.
       * This is also known as the package's <i>canonical</i> name.