8216335: Minor cleanups to javax.annotation.processing and javax.lang.model javadoc
Reviewed-by: vromero
--- 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
* "path-rootless" 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);