8216335: Minor cleanups to javax.annotation.processing and javax.lang.model javadoc
authordarcy
Tue, 08 Jan 2019 13:04:04 -0800
changeset 53201 28ec06beb091
parent 53200 3cdf4d5148a8
child 53202 02e648ae46c3
child 57104 57fead34cce2
8216335: Minor cleanups to javax.annotation.processing and javax.lang.model javadoc Reviewed-by: vromero
src/java.compiler/share/classes/javax/annotation/processing/AbstractProcessor.java
src/java.compiler/share/classes/javax/annotation/processing/Filer.java
src/java.compiler/share/classes/javax/annotation/processing/Processor.java
src/java.compiler/share/classes/javax/lang/model/element/ModuleElement.java
src/java.compiler/share/classes/javax/lang/model/util/Elements.java
--- a/src/java.compiler/share/classes/javax/annotation/processing/AbstractProcessor.java	Tue Jan 08 14:15:14 2019 +0100
+++ b/src/java.compiler/share/classes/javax/annotation/processing/AbstractProcessor.java	Tue Jan 08 13:04:04 2019 -0800
@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2005, 2017, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2005, 2019, 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
@@ -92,10 +92,10 @@
      * same set of strings as the annotation.  If the class is not so
      * annotated, an empty set is returned.
      *
-     * If the {@link ProcessingEnvironment#getSourceVersion source
+     * If the {@linkplain ProcessingEnvironment#getSourceVersion source
      * version} does not support modules, in other words if it is less
      * than or equal to {@link SourceVersion#RELEASE_8 RELEASE_8},
-     * then any leading {@link Processor#getSupportedAnnotationTypes
+     * then any leading {@linkplain Processor#getSupportedAnnotationTypes
      * module prefixes} are stripped from the names.
      *
      * @return the names of the annotation types supported by this
--- a/src/java.compiler/share/classes/javax/annotation/processing/Filer.java	Tue Jan 08 14:15:14 2019 +0100
+++ b/src/java.compiler/share/classes/javax/annotation/processing/Filer.java	Tue Jan 08 13:04:04 2019 -0800
@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2005, 2017, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2005, 2019, 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
@@ -60,7 +60,7 @@
  * by {@code '/'}; {@code '.'} and {@code '..'} are invalid path
  * segments.  A valid relative name must match the
  * &quot;path-rootless&quot; rule of <a
- * href="http://www.ietf.org/rfc/rfc3986.txt">RFC 3986</a>, section
+ * href="http://www.ietf.org/html/rfc3986.txt">RFC 3986</a>, section
  * 3.3.
  *
  * <p>The file creation methods take a variable number of arguments to
--- a/src/java.compiler/share/classes/javax/annotation/processing/Processor.java	Tue Jan 08 14:15:14 2019 +0100
+++ b/src/java.compiler/share/classes/javax/annotation/processing/Processor.java	Tue Jan 08 13:04:04 2019 -0800
@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2005, 2017, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2005, 2019, 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
@@ -59,7 +59,7 @@
  * constructor of the processor class.
  *
  * <li>Next, the tool calls the {@link #init init} method with
- * an appropriate {@code ProcessingEnvironment}.
+ * an appropriate {@link ProcessingEnvironment}.
  *
  * <li>Afterwards, the tool calls {@link #getSupportedAnnotationTypes
  * getSupportedAnnotationTypes}, {@link #getSupportedOptions
--- a/src/java.compiler/share/classes/javax/lang/model/element/ModuleElement.java	Tue Jan 08 14:15:14 2019 +0100
+++ b/src/java.compiler/share/classes/javax/lang/model/element/ModuleElement.java	Tue Jan 08 13:04:04 2019 -0800
@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2005, 2017, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2005, 2019, 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
@@ -317,7 +317,7 @@
 
         /**
          * Returns the specific modules to which the package is being exported,
-         * or null, if the package is exported to all modules which
+         * or {@code null}, if the package is exported to all modules which
          * have readability to this module.
          * @return the specific modules to which the package is being exported
          */
@@ -339,7 +339,7 @@
 
         /**
          * Returns the specific modules to which the package is being open
-         * or null, if the package is open all modules which
+         * or {@code null}, if the package is open all modules which
          * have readability to this module.
          * @return the specific modules to which the package is being opened
          */
--- a/src/java.compiler/share/classes/javax/lang/model/util/Elements.java	Tue Jan 08 14:15:14 2019 +0100
+++ b/src/java.compiler/share/classes/javax/lang/model/util/Elements.java	Tue Jan 08 13:04:04 2019 -0800
@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2005, 2017, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2005, 2019, 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
@@ -511,6 +511,7 @@
      * @param hidden  the second element
      * @return {@code true} if and only if the first element hides
      *          the second
+     * @jls 8.4.8 Inheritance, Overriding, and Hiding
      */
     boolean hides(Element hider, Element hidden);