< prev index next >

src/java.compiler/share/classes/javax/annotation/processing/Processor.java

Print this page

        

@@ -192,11 +192,11 @@
  * </ol>
  *
  * <p>The {@link Filer} interface discusses restrictions on how
  * processors can operate on files.
  *
- * <p>Note that implementors of this interface may find it convenient
+ * @apiNote Implementors of this interface may find it convenient
  * to extend {@link AbstractProcessor} rather than implementing this
  * interface directly.
  *
  * @author Joseph D. Darcy
  * @author Scott Seligman

@@ -313,11 +313,11 @@
      * true} is returned, the annotation types are claimed and subsequent
      * processors will not be asked to process them; if {@code false}
      * is returned, the annotation types are unclaimed and subsequent
      * processors may be asked to process them.  A processor may
      * always return the same boolean value or may vary the result
-     * based on chosen criteria.
+     * based on its own chosen criteria.
      *
      * <p>The input set will be empty if the processor supports {@code
      * "*"} and the root elements have no annotations.  A {@code
      * Processor} must gracefully handle an empty set of annotations.
      *

@@ -341,12 +341,12 @@
     * grammar, such as a regular expression or a URL.
     *
     * <p>Since incomplete programs are being modeled, some of the
     * parameters may only have partial information or may be {@code
     * null}.  At least one of {@code element} and {@code userText}
-    * must be non-{@code null}.  If {@code element} is non-{@code
-    * null}, {@code annotation} and {@code member} may be {@code
+    * must be non-{@code null}.  If {@code element} is non-{@code null},
+    * {@code annotation} and {@code member} may be {@code
     * null}.  Processors may not throw a {@code NullPointerException}
     * if some parameters are {@code null}; if a processor has no
     * completions to offer based on the provided information, an
     * empty iterable can be returned.  The processor may also return
     * a single completion with an empty value string and a message
< prev index next >