diff --git a/src/java.compiler/share/classes/javax/annotation/processing/Filer.java b/src/java.compiler/share/classes/javax/annotation/processing/Filer.java index a66dc011fa7..b9dfaaf2bda 100644 --- a/src/java.compiler/share/classes/javax/annotation/processing/Filer.java +++ b/src/java.compiler/share/classes/javax/annotation/processing/Filer.java @@ -123,6 +123,7 @@ import java.io.IOException; * annotation if the environment is configured so that that class or * interface is accessible. * + * @spec https://www.rfc-editor.org/info/rfc3986 RFC 3986: RFC 3986: Uniform Resource Identifier (URI): Generic Syntax * @apiNote Some of the effect of overwriting a file can be * achieved by using a decorator-style pattern. Instead of * modifying a class directly, the class is designed so that either diff --git a/src/java.compiler/share/classes/javax/tools/JavaFileManager.java b/src/java.compiler/share/classes/javax/tools/JavaFileManager.java index dcda84566c9..9f85393d9e3 100644 --- a/src/java.compiler/share/classes/javax/tools/JavaFileManager.java +++ b/src/java.compiler/share/classes/javax/tools/JavaFileManager.java @@ -103,6 +103,7 @@ import static javax.tools.JavaFileObject.Kind; *

Unless explicitly allowed, all methods in this interface might * throw a NullPointerException if given a {@code null} argument. * + * @spec https://www.rfc-editor.org/info/rfc3986 RFC 3986: RFC 3986: Uniform Resource Identifier (URI): Generic Syntax * @see JavaFileObject * @see FileObject * @since 1.6 diff --git a/src/jdk.compiler/share/classes/com/sun/source/doctree/package-info.java b/src/jdk.compiler/share/classes/com/sun/source/doctree/package-info.java index 30832c062ff..e4794e7be94 100644 --- a/src/jdk.compiler/share/classes/com/sun/source/doctree/package-info.java +++ b/src/jdk.compiler/share/classes/com/sun/source/doctree/package-info.java @@ -27,10 +27,9 @@ * Provides interfaces to represent documentation comments as abstract syntax * trees (AST). * + * @spec javadoc/doc-comment-spec.html Documentation Comment Specification for the Standard Doclet * @author Jonathan Gibbons * @since 1.8 * - * @see - * Documentation Comment Specification for the Standard Doclet */ package com.sun.source.doctree; diff --git a/src/jdk.compiler/share/classes/com/sun/source/util/DocTrees.java b/src/jdk.compiler/share/classes/com/sun/source/util/DocTrees.java index 5a9aee518a1..ecad91f76c9 100644 --- a/src/jdk.compiler/share/classes/com/sun/source/util/DocTrees.java +++ b/src/jdk.compiler/share/classes/com/sun/source/util/DocTrees.java @@ -249,6 +249,7 @@ public abstract class DocTrees extends Trees { * * @param tree the tree containing the entity * @return a string containing the characters + * @spec https://www.w3.org/TR/html52 HTML Standard */ public abstract String getCharacters(EntityTree tree); } diff --git a/src/jdk.javadoc/share/classes/jdk/javadoc/doclet/StandardDoclet.java b/src/jdk.javadoc/share/classes/jdk/javadoc/doclet/StandardDoclet.java index 819c39fe0b6..a7cead17880 100644 --- a/src/jdk.javadoc/share/classes/jdk/javadoc/doclet/StandardDoclet.java +++ b/src/jdk.javadoc/share/classes/jdk/javadoc/doclet/StandardDoclet.java @@ -63,8 +63,8 @@ import jdk.javadoc.internal.doclets.formats.html.HtmlDoclet; * of {@code

} and {@code
} elements. * * - * @see - * Documentation Comment Specification for the Standard Doclet + @spec javadoc/doc-comment-spec.html Documentation Comment Specification for the Standard Doclet + @spec https://www.w3.org/TR/html52 HTML Standard */ public class StandardDoclet implements Doclet { diff --git a/src/jdk.javadoc/share/classes/module-info.java b/src/jdk.javadoc/share/classes/module-info.java index b666517e3f0..db25f03e918 100644 --- a/src/jdk.javadoc/share/classes/module-info.java +++ b/src/jdk.javadoc/share/classes/module-info.java @@ -42,6 +42,7 @@ * or the {@linkplain java.util.ServiceLoader service loader} with the name * {@code "javadoc"}. * + * @spec javadoc/doc-comment-spec.html Documentation Comment Specification for the Standard Doclet * @toolGuide javadoc * * @provides java.util.spi.ToolProvider @@ -51,8 +52,6 @@ * @provides javax.tools.DocumentationTool * @provides javax.tools.Tool * - * @see - * Documentation Comment Specification for the Standard Doclet * * @moduleGraph * @since 9