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

*** 42,59 ****
   *
   * <p> Declarations should be compared using the {@link #equals(Object)}
   * method.  There is no guarantee that any particular declaration will
   * always be represented by the same object.
   *
   * @author Joseph D. Darcy
   * @author Scott Seligman
   *
   * @see Declarations
   * @see TypeMirror
   * @since 1.5
   */
! 
  public interface Declaration {
  
      /**
       * Tests whether an object represents the same declaration as this.
       *
--- 42,65 ----
   *
   * <p> Declarations should be compared using the {@link #equals(Object)}
   * method.  There is no guarantee that any particular declaration will
   * always be represented by the same object.
   *
+  * @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.Element}.
+  *
   * @author Joseph D. Darcy
   * @author Scott Seligman
   *
   * @see Declarations
   * @see TypeMirror
   * @since 1.5
   */
! @Deprecated
! @SuppressWarnings("deprecation")
  public interface Declaration {
  
      /**
       * Tests whether an object represents the same declaration as this.
       *