src/share/classes/com/sun/mirror/apt/Messager.java

*** 23,46 ****
   * have any questions.
   */
  
  package com.sun.mirror.apt;
  
- 
  import com.sun.mirror.util.SourcePosition;
  
- 
  /**
   * A <tt>Messager</tt> provides the way for
   * an annotation processor to report error messages, warnings, and
   * other notices.
   *
   * @author Joseph D. Darcy
   * @author Scott Seligman
   * @since 1.5
   */
! 
  public interface Messager {
  
      /**
       * Prints an error message.
       * Equivalent to <tt>printError(null, msg)</tt>.
--- 23,50 ----
   * have any questions.
   */
  
  package com.sun.mirror.apt;
  
  import com.sun.mirror.util.SourcePosition;
  
  /**
   * A <tt>Messager</tt> provides the way for
   * an annotation processor to report error messages, warnings, and
   * other notices.
   *
+  * @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.annotation.processing.Messager}.
+  *
   * @author Joseph D. Darcy
   * @author Scott Seligman
   * @since 1.5
   */
! @Deprecated
! @SuppressWarnings("deprecation")
  public interface Messager {
  
      /**
       * Prints an error message.
       * Equivalent to <tt>printError(null, msg)</tt>.