Mercurial > hg > openjdk > jdk9 > langtools
changeset 3870:f5dc63258a43
8172458: Make javax.lang.model javadoc HTML 5 compliant
Reviewed-by: jjg
line wrap: on
line diff
--- a/src/java.compiler/share/classes/javax/annotation/processing/Processor.java Mon Jan 09 13:50:45 2017 -0800 +++ b/src/java.compiler/share/classes/javax/annotation/processing/Processor.java Mon Jan 09 16:20:48 2017 -0800 @@ -243,9 +243,9 @@ * 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 "<tt><i>name</i>.*</tt>" + * Alternately it may be of the form "<code><i>name</i>.*</code>" * representing the set of all annotation types with canonical - * names beginning with "<tt><i>name.</i></tt>". + * names beginning with "<code><i>name.</i></code>". * * 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 @@ * <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> *
--- a/src/java.compiler/share/classes/javax/lang/model/element/AnnotationValueVisitor.java Mon Jan 09 13:50:45 2017 -0800 +++ b/src/java.compiler/share/classes/javax/lang/model/element/AnnotationValueVisitor.java Mon Jan 09 16:20:48 2017 -0800 @@ -41,7 +41,7 @@ * 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
--- a/src/java.compiler/share/classes/javax/lang/model/element/ElementVisitor.java Mon Jan 09 13:50:45 2017 -0800 +++ b/src/java.compiler/share/classes/javax/lang/model/element/ElementVisitor.java Mon Jan 09 16:20:48 2017 -0800 @@ -32,7 +32,7 @@ * 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
--- a/src/java.compiler/share/classes/javax/lang/model/type/TypeVisitor.java Mon Jan 09 13:50:45 2017 -0800 +++ b/src/java.compiler/share/classes/javax/lang/model/type/TypeVisitor.java Mon Jan 09 16:20:48 2017 -0800 @@ -32,7 +32,7 @@ * 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
--- a/src/java.compiler/share/classes/javax/lang/model/type/WildcardType.java Mon Jan 09 13:50:45 2017 -0800 +++ b/src/java.compiler/share/classes/javax/lang/model/type/WildcardType.java Mon Jan 09 16:20:48 2017 -0800 @@ -28,11 +28,11 @@ /** * 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
--- a/src/java.compiler/share/classes/javax/lang/model/util/ElementKindVisitor6.java Mon Jan 09 13:50:45 2017 -0800 +++ b/src/java.compiler/share/classes/javax/lang/model/util/ElementKindVisitor6.java Mon Jan 09 16:20:48 2017 -0800 @@ -36,10 +36,10 @@ * 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. *
--- a/src/java.compiler/share/classes/javax/lang/model/util/ElementKindVisitor7.java Mon Jan 09 13:50:45 2017 -0800 +++ b/src/java.compiler/share/classes/javax/lang/model/util/ElementKindVisitor7.java Mon Jan 09 16:20:48 2017 -0800 @@ -34,10 +34,10 @@ * 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. *
--- a/src/java.compiler/share/classes/javax/lang/model/util/ElementKindVisitor8.java Mon Jan 09 13:50:45 2017 -0800 +++ b/src/java.compiler/share/classes/javax/lang/model/util/ElementKindVisitor8.java Mon Jan 09 16:20:48 2017 -0800 @@ -34,10 +34,10 @@ * 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. *
--- a/src/java.compiler/share/classes/javax/lang/model/util/ElementKindVisitor9.java Mon Jan 09 13:50:45 2017 -0800 +++ b/src/java.compiler/share/classes/javax/lang/model/util/ElementKindVisitor9.java Mon Jan 09 16:20:48 2017 -0800 @@ -34,10 +34,10 @@ * 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. *
--- a/src/java.compiler/share/classes/javax/lang/model/util/ElementScanner6.java Mon Jan 09 13:50:45 2017 -0800 +++ b/src/java.compiler/share/classes/javax/lang/model/util/ElementScanner6.java Mon Jan 09 16:20:48 2017 -0800 @@ -34,26 +34,26 @@ /** * 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
--- a/src/java.compiler/share/classes/javax/lang/model/util/ElementScanner7.java Mon Jan 09 13:50:45 2017 -0800 +++ b/src/java.compiler/share/classes/javax/lang/model/util/ElementScanner7.java Mon Jan 09 16:20:48 2017 -0800 @@ -34,26 +34,26 @@ /** * 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
--- a/src/java.compiler/share/classes/javax/lang/model/util/ElementScanner8.java Mon Jan 09 13:50:45 2017 -0800 +++ b/src/java.compiler/share/classes/javax/lang/model/util/ElementScanner8.java Mon Jan 09 16:20:48 2017 -0800 @@ -34,26 +34,26 @@ /** * 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
--- a/src/java.compiler/share/classes/javax/lang/model/util/ElementScanner9.java Mon Jan 09 13:50:45 2017 -0800 +++ b/src/java.compiler/share/classes/javax/lang/model/util/ElementScanner9.java Mon Jan 09 16:20:48 2017 -0800 @@ -34,26 +34,26 @@ /** * 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
--- a/src/java.compiler/share/classes/javax/lang/model/util/TypeKindVisitor6.java Mon Jan 09 13:50:45 2017 -0800 +++ b/src/java.compiler/share/classes/javax/lang/model/util/TypeKindVisitor6.java Mon Jan 09 16:20:48 2017 -0800 @@ -34,10 +34,10 @@ * 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. *
--- a/src/java.compiler/share/classes/javax/lang/model/util/TypeKindVisitor7.java Mon Jan 09 13:50:45 2017 -0800 +++ b/src/java.compiler/share/classes/javax/lang/model/util/TypeKindVisitor7.java Mon Jan 09 16:20:48 2017 -0800 @@ -34,10 +34,10 @@ * 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. *
--- a/src/java.compiler/share/classes/javax/lang/model/util/TypeKindVisitor8.java Mon Jan 09 13:50:45 2017 -0800 +++ b/src/java.compiler/share/classes/javax/lang/model/util/TypeKindVisitor8.java Mon Jan 09 16:20:48 2017 -0800 @@ -34,10 +34,10 @@ * 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. *
--- a/src/java.compiler/share/classes/javax/lang/model/util/TypeKindVisitor9.java Mon Jan 09 13:50:45 2017 -0800 +++ b/src/java.compiler/share/classes/javax/lang/model/util/TypeKindVisitor9.java Mon Jan 09 16:20:48 2017 -0800 @@ -34,10 +34,10 @@ * 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. *