stan/jdk-24
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

8172458: Make javax.lang.model javadoc HTML 5 compliant

Browse Source 
Reviewed-by: jjg
This commit is contained in:
Joe Darcy 2017-01-09 16:20:48 -08:00
parent f9b57bfbed
commit bee65032d4
17 changed files with 66 additions and 66 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

10
langtools/src/java.compiler/share/classes/javax/annotation/processing/Processor.java
View File

@ -243,9 +243,9 @@ public interface Processor {
* Returns the names of the annotation types supported by this
* processor. An element of the result may be the canonical
* (fully qualified) name of a supported annotation type.
* Alternately it may be of the form &quot;<tt><i>name</i>.*</tt>&quot;
* Alternately it may be of the form &quot;<code><i>name</i>.*</code>&quot;
* representing the set of all annotation types with canonical
* names beginning with &quot;<tt><i>name.</i></tt>&quot;.
* names beginning with &quot;<code><i>name.</i></code>&quot;.
*
* In either of those cases, the name of the annotation type can
* be optionally preceded by a module name followed by a {@code
@ -267,13 +267,13 @@ public interface Processor {
* <dl>
* <dt><i>SupportedAnnotationTypeString:</i>
* <dd><i>ModulePrefix</i><sub><i>opt</i></sub> <i>TypeName</i> <i>DotStar</i><sub><i>opt</i></sub>
* <dd><tt>*</tt>
* <dd><code>*</code>
*
* <dt><i>ModulePrefix:</i>
* <dd><i>TypeName</i> <tt>/</tt>
* <dd><i>TypeName</i> <code>/</code>
*
* <dt><i>DotStar:</i>
* <dd><tt>.</tt> <tt>*</tt>
* <dd><code>.</code> <code>*</code>
* </dl>
* </blockquote>
*

2
langtools/src/java.compiler/share/classes/javax/lang/model/element/AnnotationValueVisitor.java
View File

@ -41,7 +41,7 @@ import javax.lang.model.type.TypeMirror;
* implementing this interface are used to operate on a value when the
* type of that value is unknown at compile time. When a visitor is
* passed to a value's {@link AnnotationValue#accept accept} method,
* the <tt>visit<i>XYZ</i></tt> method applicable to that value is
* the <code>visit<i>XYZ</i></code> method applicable to that value is
* invoked.
*
* <p> Classes implementing this interface may or may not throw a

2
langtools/src/java.compiler/share/classes/javax/lang/model/element/ElementVisitor.java
View File

@ -32,7 +32,7 @@ import javax.lang.model.util.*;
* pattern. Classes implementing this interface are used to operate
* on an element when the kind of element is unknown at compile time.
* When a visitor is passed to an element's {@link Element#accept
* accept} method, the <tt>visit<i>XYZ</i></tt> method most applicable
* accept} method, the <code>visit<i>XYZ</i></code> method most applicable
* to that element is invoked.
*
* <p> Classes implementing this interface may or may not throw a

2
langtools/src/java.compiler/share/classes/javax/lang/model/type/TypeVisitor.java
View File

@ -32,7 +32,7 @@ import javax.lang.model.element.*;
* visitor design pattern. Classes implementing this
* interface are used to operate on a type when the kind of
* type is unknown at compile time. When a visitor is passed to a
* type's {@link TypeMirror#accept accept} method, the <tt>visit<i>XYZ</i></tt>
* type's {@link TypeMirror#accept accept} method, the <code>visit<i>XYZ</i></code>
* method most applicable to that type is invoked.
*
* <p> Classes implementing this interface may or may not throw a

4
langtools/src/java.compiler/share/classes/javax/lang/model/type/WildcardType.java
View File

@ -28,11 +28,11 @@ package javax.lang.model.type;
/**
* Represents a wildcard type argument.
* Examples include: <pre><tt>
* Examples include: <pre><code>
* ?
* ? extends Number
* ? super T
* </tt></pre>
* </code></pre>
*
* <p> A wildcard may have its upper bound explicitly set by an
* {@code extends} clause, its lower bound explicitly set by a

8
langtools/src/java.compiler/share/classes/javax/lang/model/util/ElementKindVisitor6.java
View File

@ -36,10 +36,10 @@ import javax.lang.model.SourceVersion;
* A visitor of program elements based on their {@linkplain
* ElementKind kind} with default behavior appropriate for the {@link
* SourceVersion#RELEASE_6 RELEASE_6} source version. For {@linkplain
* Element elements} <tt><i>XYZ</i></tt> that may have more than one
* kind, the <tt>visit<i>XYZ</i></tt> methods in this class delegate
* to the <tt>visit<i>XYZKind</i></tt> method corresponding to the
* first argument's kind. The <tt>visit<i>XYZKind</i></tt> methods
* Element elements} <code><i>XYZ</i></code> that may have more than one
* kind, the <code>visit<i>XYZ</i></code> methods in this class delegate
* to the <code>visit<i>XYZKind</i></code> method corresponding to the
* first argument's kind. The <code>visit<i>XYZKind</i></code> methods
* call {@link #defaultAction defaultAction}, passing their arguments
* to {@code defaultAction}'s corresponding parameters.
*

8
langtools/src/java.compiler/share/classes/javax/lang/model/util/ElementKindVisitor7.java
View File

@ -34,10 +34,10 @@ import static javax.lang.model.SourceVersion.*;
* A visitor of program elements based on their {@linkplain
* ElementKind kind} with default behavior appropriate for the {@link
* SourceVersion#RELEASE_7 RELEASE_7} source version. For {@linkplain
* Element elements} <tt><i>XYZ</i></tt> that may have more than one
* kind, the <tt>visit<i>XYZ</i></tt> methods in this class delegate
* to the <tt>visit<i>XYZKind</i></tt> method corresponding to the
* first argument's kind. The <tt>visit<i>XYZKind</i></tt> methods
* Element elements} <code><i>XYZ</i></code> that may have more than one
* kind, the <code>visit<i>XYZ</i></code> methods in this class delegate
* to the <code>visit<i>XYZKind</i></code> method corresponding to the
* first argument's kind. The <code>visit<i>XYZKind</i></code> methods
* call {@link #defaultAction defaultAction}, passing their arguments
* to {@code defaultAction}'s corresponding parameters.
*

8
langtools/src/java.compiler/share/classes/javax/lang/model/util/ElementKindVisitor8.java
View File

@ -34,10 +34,10 @@ import javax.lang.model.SourceVersion;
* A visitor of program elements based on their {@linkplain
* ElementKind kind} with default behavior appropriate for the {@link
* SourceVersion#RELEASE_8 RELEASE_8} source version. For {@linkplain
* Element elements} <tt><i>XYZ</i></tt> that may have more than one
* kind, the <tt>visit<i>XYZ</i></tt> methods in this class delegate
* to the <tt>visit<i>XYZKind</i></tt> method corresponding to the
* first argument's kind. The <tt>visit<i>XYZKind</i></tt> methods
* Element elements} <code><i>XYZ</i></code> that may have more than one
* kind, the <code>visit<i>XYZ</i></code> methods in this class delegate
* to the <code>visit<i>XYZKind</i></code> method corresponding to the
* first argument's kind. The <code>visit<i>XYZKind</i></code> methods
* call {@link #defaultAction defaultAction}, passing their arguments
* to {@code defaultAction}'s corresponding parameters.
*

8
langtools/src/java.compiler/share/classes/javax/lang/model/util/ElementKindVisitor9.java
View File

@ -34,10 +34,10 @@ import javax.lang.model.SourceVersion;
* A visitor of program elements based on their {@linkplain
* ElementKind kind} with default behavior appropriate for the {@link
* SourceVersion#RELEASE_9 RELEASE_9} source version. For {@linkplain
* Element elements} <tt><i>XYZ</i></tt> that may have more than one
* kind, the <tt>visit<i>XYZ</i></tt> methods in this class delegate
* to the <tt>visit<i>XYZKind</i></tt> method corresponding to the
* first argument's kind. The <tt>visit<i>XYZKind</i></tt> methods
* Element elements} <code><i>XYZ</i></code> that may have more than one
* kind, the <code>visit<i>XYZ</i></code> methods in this class delegate
* to the <code>visit<i>XYZKind</i></code> method corresponding to the
* first argument's kind. The <code>visit<i>XYZKind</i></code> methods
* call {@link #defaultAction defaultAction}, passing their arguments
* to {@code defaultAction}'s corresponding parameters.
*

12
langtools/src/java.compiler/share/classes/javax/lang/model/util/ElementScanner6.java
View File

@ -34,26 +34,26 @@ import static javax.lang.model.SourceVersion.*;
/**
* A scanning visitor of program elements with default behavior
* appropriate for the {@link SourceVersion#RELEASE_6 RELEASE_6}
* source version. The <tt>visit<i>XYZ</i></tt> methods in this
* source version. The <code>visit<i>XYZ</i></code> methods in this
* class scan their component elements by calling {@code scan} on
* their {@linkplain Element#getEnclosedElements enclosed elements},
* {@linkplain ExecutableElement#getParameters parameters}, etc., as
* indicated in the individual method specifications. A subclass can
* control the order elements are visited by overriding the
* <tt>visit<i>XYZ</i></tt> methods. Note that clients of a scanner
* <code>visit<i>XYZ</i></code> methods. Note that clients of a scanner
* may get the desired behavior be invoking {@code v.scan(e, p)} rather
* than {@code v.visit(e, p)} on the root objects of interest.
*
* <p>When a subclass overrides a <tt>visit<i>XYZ</i></tt> method, the
* <p>When a subclass overrides a <code>visit<i>XYZ</i></code> method, the
* new method can cause the enclosed elements to be scanned in the
* default way by calling <tt>super.visit<i>XYZ</i></tt>. In this
* default way by calling <code>super.visit<i>XYZ</i></code>. In this
* fashion, the concrete visitor can control the ordering of traversal
* over the component elements with respect to the additional
* processing; for example, consistently calling
* <tt>super.visit<i>XYZ</i></tt> at the start of the overridden
* <code>super.visit<i>XYZ</i></code> at the start of the overridden
* methods will yield a preorder traversal, etc. If the component
* elements should be traversed in some other order, instead of
* calling <tt>super.visit<i>XYZ</i></tt>, an overriding visit method
* calling <code>super.visit<i>XYZ</i></code>, an overriding visit method
* should call {@code scan} with the elements in the desired order.
*
* <p> Methods in this class may be overridden subject to their

12
langtools/src/java.compiler/share/classes/javax/lang/model/util/ElementScanner7.java
View File

@ -34,26 +34,26 @@ import static javax.lang.model.SourceVersion.*;
/**
* A scanning visitor of program elements with default behavior
* appropriate for the {@link SourceVersion#RELEASE_7 RELEASE_7}
* source version. The <tt>visit<i>XYZ</i></tt> methods in this
* source version. The <code>visit<i>XYZ</i></code> methods in this
* class scan their component elements by calling {@code scan} on
* their {@linkplain Element#getEnclosedElements enclosed elements},
* {@linkplain ExecutableElement#getParameters parameters}, etc., as
* indicated in the individual method specifications. A subclass can
* control the order elements are visited by overriding the
* <tt>visit<i>XYZ</i></tt> methods. Note that clients of a scanner
* <code>visit<i>XYZ</i></code> methods. Note that clients of a scanner
* may get the desired behavior be invoking {@code v.scan(e, p)} rather
* than {@code v.visit(e, p)} on the root objects of interest.
*
* <p>When a subclass overrides a <tt>visit<i>XYZ</i></tt> method, the
* <p>When a subclass overrides a <code>visit<i>XYZ</i></code> method, the
* new method can cause the enclosed elements to be scanned in the
* default way by calling <tt>super.visit<i>XYZ</i></tt>. In this
* default way by calling <code>super.visit<i>XYZ</i></code>. In this
* fashion, the concrete visitor can control the ordering of traversal
* over the component elements with respect to the additional
* processing; for example, consistently calling
* <tt>super.visit<i>XYZ</i></tt> at the start of the overridden
* <code>super.visit<i>XYZ</i></code> at the start of the overridden
* methods will yield a preorder traversal, etc. If the component
* elements should be traversed in some other order, instead of
* calling <tt>super.visit<i>XYZ</i></tt>, an overriding visit method
* calling <code>super.visit<i>XYZ</i></code>, an overriding visit method
* should call {@code scan} with the elements in the desired order.
*
* <p> Methods in this class may be overridden subject to their

12
langtools/src/java.compiler/share/classes/javax/lang/model/util/ElementScanner8.java
View File

@ -34,26 +34,26 @@ import static javax.lang.model.SourceVersion.*;
/**
* A scanning visitor of program elements with default behavior
* appropriate for the {@link SourceVersion#RELEASE_8 RELEASE_8}
* source version. The <tt>visit<i>XYZ</i></tt> methods in this
* source version. The <code>visit<i>XYZ</i></code> methods in this
* class scan their component elements by calling {@code scan} on
* their {@linkplain Element#getEnclosedElements enclosed elements},
* {@linkplain ExecutableElement#getParameters parameters}, etc., as
* indicated in the individual method specifications. A subclass can
* control the order elements are visited by overriding the
* <tt>visit<i>XYZ</i></tt> methods. Note that clients of a scanner
* <code>visit<i>XYZ</i></code> methods. Note that clients of a scanner
* may get the desired behavior be invoking {@code v.scan(e, p)} rather
* than {@code v.visit(e, p)} on the root objects of interest.
*
* <p>When a subclass overrides a <tt>visit<i>XYZ</i></tt> method, the
* <p>When a subclass overrides a <code>visit<i>XYZ</i></code> method, the
* new method can cause the enclosed elements to be scanned in the
* default way by calling <tt>super.visit<i>XYZ</i></tt>. In this
* default way by calling <code>super.visit<i>XYZ</i></code>. In this
* fashion, the concrete visitor can control the ordering of traversal
* over the component elements with respect to the additional
* processing; for example, consistently calling
* <tt>super.visit<i>XYZ</i></tt> at the start of the overridden
* <code>super.visit<i>XYZ</i></code> at the start of the overridden
* methods will yield a preorder traversal, etc. If the component
* elements should be traversed in some other order, instead of
* calling <tt>super.visit<i>XYZ</i></tt>, an overriding visit method
* calling <code>super.visit<i>XYZ</i></code>, an overriding visit method
* should call {@code scan} with the elements in the desired order.
*
* <p> Methods in this class may be overridden subject to their

12
langtools/src/java.compiler/share/classes/javax/lang/model/util/ElementScanner9.java
View File

@ -34,26 +34,26 @@ import static javax.lang.model.SourceVersion.*;
/**
* A scanning visitor of program elements with default behavior
* appropriate for the {@link SourceVersion#RELEASE_9 RELEASE_9}
* source version. The <tt>visit<i>XYZ</i></tt> methods in this
* source version. The <code>visit<i>XYZ</i></code> methods in this
* class scan their component elements by calling {@code scan} on
* their {@linkplain Element#getEnclosedElements enclosed elements},
* {@linkplain ExecutableElement#getParameters parameters}, etc., as
* indicated in the individual method specifications. A subclass can
* control the order elements are visited by overriding the
* <tt>visit<i>XYZ</i></tt> methods. Note that clients of a scanner
* <code>visit<i>XYZ</i></code> methods. Note that clients of a scanner
* may get the desired behavior be invoking {@code v.scan(e, p)} rather
* than {@code v.visit(e, p)} on the root objects of interest.
*
* <p>When a subclass overrides a <tt>visit<i>XYZ</i></tt> method, the
* <p>When a subclass overrides a <code>visit<i>XYZ</i></code> method, the
* new method can cause the enclosed elements to be scanned in the
* default way by calling <tt>super.visit<i>XYZ</i></tt>. In this
* default way by calling <code>super.visit<i>XYZ</i></code>. In this
* fashion, the concrete visitor can control the ordering of traversal
* over the component elements with respect to the additional
* processing; for example, consistently calling
* <tt>super.visit<i>XYZ</i></tt> at the start of the overridden
* <code>super.visit<i>XYZ</i></code> at the start of the overridden
* methods will yield a preorder traversal, etc. If the component
* elements should be traversed in some other order, instead of
* calling <tt>super.visit<i>XYZ</i></tt>, an overriding visit method
* calling <code>super.visit<i>XYZ</i></code>, an overriding visit method
* should call {@code scan} with the elements in the desired order.
*
* <p> Methods in this class may be overridden subject to their

8
langtools/src/java.compiler/share/classes/javax/lang/model/util/TypeKindVisitor6.java
View File

@ -34,10 +34,10 @@ import static javax.lang.model.SourceVersion.*;
* A visitor of types based on their {@linkplain TypeKind kind} with
* default behavior appropriate for the {@link SourceVersion#RELEASE_6
* RELEASE_6} source version. For {@linkplain
* TypeMirror types} <tt><i>XYZ</i></tt> that may have more than one
* kind, the <tt>visit<i>XYZ</i></tt> methods in this class delegate
* to the <tt>visit<i>XYZKind</i></tt> method corresponding to the
* first argument's kind. The <tt>visit<i>XYZKind</i></tt> methods
* TypeMirror types} <code><i>XYZ</i></code> that may have more than one
* kind, the <code>visit<i>XYZ</i></code> methods in this class delegate
* to the <code>visit<i>XYZKind</i></code> method corresponding to the
* first argument's kind. The <code>visit<i>XYZKind</i></code> methods
* call {@link #defaultAction defaultAction}, passing their arguments
* to {@code defaultAction}'s corresponding parameters.
*

8
langtools/src/java.compiler/share/classes/javax/lang/model/util/TypeKindVisitor7.java
View File

@ -34,10 +34,10 @@ import javax.lang.model.SourceVersion;
* A visitor of types based on their {@linkplain TypeKind kind} with
* default behavior appropriate for the {@link SourceVersion#RELEASE_7
* RELEASE_7} source version. For {@linkplain
* TypeMirror types} <tt><i>XYZ</i></tt> that may have more than one
* kind, the <tt>visit<i>XYZ</i></tt> methods in this class delegate
* to the <tt>visit<i>XYZKind</i></tt> method corresponding to the
* first argument's kind. The <tt>visit<i>XYZKind</i></tt> methods
* TypeMirror types} <code><i>XYZ</i></code> that may have more than one
* kind, the <code>visit<i>XYZ</i></code> methods in this class delegate
* to the <code>visit<i>XYZKind</i></code> method corresponding to the
* first argument's kind. The <code>visit<i>XYZKind</i></code> methods
* call {@link #defaultAction defaultAction}, passing their arguments
* to {@code defaultAction}'s corresponding parameters.
*

8
langtools/src/java.compiler/share/classes/javax/lang/model/util/TypeKindVisitor8.java
View File

@ -34,10 +34,10 @@ import static javax.lang.model.SourceVersion.*;
* A visitor of types based on their {@linkplain TypeKind kind} with
* default behavior appropriate for the {@link SourceVersion#RELEASE_8
* RELEASE_8} source version. For {@linkplain
* TypeMirror types} <tt><i>XYZ</i></tt> that may have more than one
* kind, the <tt>visit<i>XYZ</i></tt> methods in this class delegate
* to the <tt>visit<i>XYZKind</i></tt> method corresponding to the
* first argument's kind. The <tt>visit<i>XYZKind</i></tt> methods
* TypeMirror types} <code><i>XYZ</i></code> that may have more than one
* kind, the <code>visit<i>XYZ</i></code> methods in this class delegate
* to the <code>visit<i>XYZKind</i></code> method corresponding to the
* first argument's kind. The <code>visit<i>XYZKind</i></code> methods
* call {@link #defaultAction defaultAction}, passing their arguments
* to {@code defaultAction}'s corresponding parameters.
*

8
langtools/src/java.compiler/share/classes/javax/lang/model/util/TypeKindVisitor9.java
View File

@ -34,10 +34,10 @@ import static javax.lang.model.SourceVersion.*;
* A visitor of types based on their {@linkplain TypeKind kind} with
* default behavior appropriate for the {@link SourceVersion#RELEASE_9
* RELEASE_9} source version. For {@linkplain
* TypeMirror types} <tt><i>XYZ</i></tt> that may have more than one
* kind, the <tt>visit<i>XYZ</i></tt> methods in this class delegate
* to the <tt>visit<i>XYZKind</i></tt> method corresponding to the
* first argument's kind. The <tt>visit<i>XYZKind</i></tt> methods
* TypeMirror types} <code><i>XYZ</i></code> that may have more than one
* kind, the <code>visit<i>XYZ</i></code> methods in this class delegate
* to the <code>visit<i>XYZKind</i></code> method corresponding to the
* first argument's kind. The <code>visit<i>XYZKind</i></code> methods
* call {@link #defaultAction defaultAction}, passing their arguments
* to {@code defaultAction}'s corresponding parameters.
*