JDK 9 RFR of JDK-8173164: Resolve remaining HTML5 issues in javax.lang.model.*

[Martin Buchholz]

It's good.

There's a persistent ecosystem nuisance that tools don't recognize imports
done purely for javadoc's benefit and complain.  For this reason I
generally use fully qualified @links in the javadoc, even though it's
uglier.


On Sun, Jan 22, 2017 at 4:45 PM, joe darcy <joe.darcy at oracle.com> wrote:

> Hello,
>
> Even after the fixes for JDK-8172458, there is still a lingering HTML5
> compliance issue in javax.lang.model.* in addition to a few javadoc linkage
> problems. These should all be fixed; small patch below.
>
> With the patch, the code is doclint clean under both HTML 4.01 and HTML 5
> output.
>
> (I thought the linkage problem would have been caught by the javac and
> javadoc build options, but apparently not.)
>
> Thanks,
>
> -Joe
>
> diff -r 50c877258ca9 src/java.compiler/share/classe
> s/javax/lang/model/element/TypeElement.java
> --- a/src/java.compiler/share/classes/javax/lang/model/element/TypeElement.java
> Fri Jan 20 18:24:50 2017 -0800
> +++ b/src/java.compiler/share/classes/javax/lang/model/element/TypeElement.java
> Sun Jan 22 16:23:28 2017 -0800
> @@ -35,7 +35,7 @@
>   * type is a kind of class and an annotation type is a kind of
>   * interface.
>   *
> - * <p> <a name="ELEM_VS_TYPE"></a>
> + * <p> <a id="ELEM_VS_TYPE"></a>
>   * While a {@code TypeElement} represents a class or interface
>   * <i>element</i>, a {@link DeclaredType} represents a class
>   * or interface <i>type</i>, the latter being a use
> diff -r 50c877258ca9 src/java.compiler/share/classe
> s/javax/lang/model/util/Elements.java
> --- a/src/java.compiler/share/classes/javax/lang/model/util/Elements.java
> Fri Jan 20 18:24:50 2017 -0800
> +++ b/src/java.compiler/share/classes/javax/lang/model/util/Elements.java
> Sun Jan 22 16:23:28 2017 -0800
> @@ -29,6 +29,7 @@
>  import java.util.List;
>  import java.util.Map;
>
> +import javax.annotation.processing.ProcessingEnvironment;
>  import javax.lang.model.AnnotatedConstruct;
>  import javax.lang.model.element.*;
>
> @@ -91,7 +92,7 @@
>       * If the named module cannot be found, null is returned. One
> situation where a module
>       * cannot be found is if the environment does not include modules,
> such as
>       * an annotation processing environment configured for
> -     * a {@linkplain ProcessingEnvironment#getSourceVersion source
> version} without modules.      *
> +     * a {@linkplain ProcessingEnvironment#getSourceVersion source
> version} without modules.
>       *
>       * @param name  the name
>       * @return the named module element, or {@code null} if it cannot be
> found
> @@ -331,7 +332,7 @@
>       * If there is no module for the element, null is returned. One
> situation where there is
>       * no module for an element is if the environment does not include
> modules, such as
>       * an annotation processing environment configured for
> -     * a {@linkplain ProcessingEnvironment#getSourceVersion source
> version} without modules.      *
> +     * a {@linkplain ProcessingEnvironment#getSourceVersion source
> version} without modules.
>       *
>       * @param type the element being examined
>       * @return the module of an element
>
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.openjdk.java.net/pipermail/compiler-dev/attachments/20170123/56d2f65f/attachment-0001.html>