diff options
Diffstat (limited to 'src/share/classes/com')
90 files changed, 109 insertions, 110 deletions
diff --git a/src/share/classes/com/sun/javadoc/ClassDoc.java b/src/share/classes/com/sun/javadoc/ClassDoc.java index 03ce11cb..8eda69b4 100644 --- a/src/share/classes/com/sun/javadoc/ClassDoc.java +++ b/src/share/classes/com/sun/javadoc/ClassDoc.java @@ -311,8 +311,8 @@ public interface ClassDoc extends ProgramElementDoc, Type { /** * Get the list of classes and interfaces declared as imported. - * These are called "single-type-import declarations" in the - * Java Language Specification. + * These are called "single-type-import declarations" in + * <cite>The Java™ Language Specification</cite>. * * @return an array of ClassDoc representing the imported classes. * @@ -325,8 +325,8 @@ public interface ClassDoc extends ProgramElementDoc, Type { /** * Get the list of packages declared as imported. - * These are called "type-import-on-demand declarations" in the - * Java Language Specification. + * These are called "type-import-on-demand declarations" in + * <cite>The Java™ Language Specification</cite>. * * @return an array of PackageDoc representing the imported packages. * diff --git a/src/share/classes/com/sun/source/tree/AnnotationTree.java b/src/share/classes/com/sun/source/tree/AnnotationTree.java index 2ab8afb1..5a9074b2 100644 --- a/src/share/classes/com/sun/source/tree/AnnotationTree.java +++ b/src/share/classes/com/sun/source/tree/AnnotationTree.java @@ -36,7 +36,7 @@ import java.util.List; * {@code @}<em>annotationType</em> ( <em>arguments</em> ) * </pre> * - * @see "The Java Language Specification, 3rd ed, section 9.7" + * @jls section 9.7 * * @author Peter von der Ahé * @author Jonathan Gibbons diff --git a/src/share/classes/com/sun/source/tree/ArrayAccessTree.java b/src/share/classes/com/sun/source/tree/ArrayAccessTree.java index b52307e2..7e5fc2cf 100644 --- a/src/share/classes/com/sun/source/tree/ArrayAccessTree.java +++ b/src/share/classes/com/sun/source/tree/ArrayAccessTree.java @@ -33,7 +33,7 @@ package com.sun.source.tree; * <em>expression</em> [ <em>index</em> ] * </pre> * - * @see "The Java Language Specification, 3rd ed, section 15.13" + * @jls section 15.13 * * @author Peter von der Ahé * @author Jonathan Gibbons diff --git a/src/share/classes/com/sun/source/tree/ArrayTypeTree.java b/src/share/classes/com/sun/source/tree/ArrayTypeTree.java index bd6ef6c1..0c58a719 100644 --- a/src/share/classes/com/sun/source/tree/ArrayTypeTree.java +++ b/src/share/classes/com/sun/source/tree/ArrayTypeTree.java @@ -33,7 +33,7 @@ package com.sun.source.tree; * <em>type</em> [] * </pre> * - * @see "The Java Language Specification, 3rd ed, section 10.1" + * @jls section 10.1 * * @author Peter von der Ahé * @author Jonathan Gibbons diff --git a/src/share/classes/com/sun/source/tree/AssertTree.java b/src/share/classes/com/sun/source/tree/AssertTree.java index 1212f7fd..fce758ed 100644 --- a/src/share/classes/com/sun/source/tree/AssertTree.java +++ b/src/share/classes/com/sun/source/tree/AssertTree.java @@ -35,7 +35,7 @@ package com.sun.source.tree; * assert <em>condition</em> : <em>detail</em> ; * </pre> * - * @see "The Java Language Specification, 3rd ed, section 14.10" + * @jls section 14.10 * * @author Peter von der Ahé * @author Jonathan Gibbons diff --git a/src/share/classes/com/sun/source/tree/AssignmentTree.java b/src/share/classes/com/sun/source/tree/AssignmentTree.java index 0224d633..9c5480d5 100644 --- a/src/share/classes/com/sun/source/tree/AssignmentTree.java +++ b/src/share/classes/com/sun/source/tree/AssignmentTree.java @@ -33,7 +33,7 @@ package com.sun.source.tree; * <em>variable</em> = <em>expression</em> * </pre> * - * @see "The Java Language Specification, 3rd ed, section 15.26.1" + * @jls section 15.26.1 * * @author Peter von der Ahé * @author Jonathan Gibbons diff --git a/src/share/classes/com/sun/source/tree/BinaryTree.java b/src/share/classes/com/sun/source/tree/BinaryTree.java index 21875f30..d24497a3 100644 --- a/src/share/classes/com/sun/source/tree/BinaryTree.java +++ b/src/share/classes/com/sun/source/tree/BinaryTree.java @@ -34,7 +34,7 @@ package com.sun.source.tree; * <em>leftOperand</em> <em>operator</em> <em>rightOperand</em> * </pre> * - * @see "The Java Language Specification, 3rd ed, sections 15.17 to 15.24" + * @jls sections 15.17 to 15.24 * * @author Peter von der Ahé * @author Jonathan Gibbons diff --git a/src/share/classes/com/sun/source/tree/BlockTree.java b/src/share/classes/com/sun/source/tree/BlockTree.java index 1013f964..330309a0 100644 --- a/src/share/classes/com/sun/source/tree/BlockTree.java +++ b/src/share/classes/com/sun/source/tree/BlockTree.java @@ -39,7 +39,7 @@ import java.util.List; * static { <em>statements</em> } * </pre> * - * @see "The Java Language Specification, 3rd ed, section 14.2" + * @jls section 14.2 * * @author Peter von der Ahé * @author Jonathan Gibbons diff --git a/src/share/classes/com/sun/source/tree/BreakTree.java b/src/share/classes/com/sun/source/tree/BreakTree.java index ae40b156..e287a981 100644 --- a/src/share/classes/com/sun/source/tree/BreakTree.java +++ b/src/share/classes/com/sun/source/tree/BreakTree.java @@ -37,7 +37,7 @@ import javax.lang.model.element.Name; * break <em>label</em> ; * </pre> * - * @see "The Java Language Specification, 3rd ed, section 14.15" + * @jls section 14.15 * * @author Peter von der Ahé * @author Jonathan Gibbons diff --git a/src/share/classes/com/sun/source/tree/CaseTree.java b/src/share/classes/com/sun/source/tree/CaseTree.java index 717f00d8..a273c2ff 100644 --- a/src/share/classes/com/sun/source/tree/CaseTree.java +++ b/src/share/classes/com/sun/source/tree/CaseTree.java @@ -39,7 +39,7 @@ import java.util.List; * <em>statements</em> * </pre> * - * @see "The Java Language Specification, 3rd ed, section 14.11" + * @jls section 14.11 * * @author Peter von der Ahé * @author Jonathan Gibbons diff --git a/src/share/classes/com/sun/source/tree/CatchTree.java b/src/share/classes/com/sun/source/tree/CatchTree.java index 29743866..9c34e860 100644 --- a/src/share/classes/com/sun/source/tree/CatchTree.java +++ b/src/share/classes/com/sun/source/tree/CatchTree.java @@ -34,7 +34,7 @@ package com.sun.source.tree; * <em>block</em> * </pre> * - * @see "The Java Language Specification, 3rd ed, section 14.20" + * @jls section 14.20 * * @author Peter von der Ahé * @author Jonathan Gibbons diff --git a/src/share/classes/com/sun/source/tree/ClassTree.java b/src/share/classes/com/sun/source/tree/ClassTree.java index 4ff167a6..81c7c2f2 100644 --- a/src/share/classes/com/sun/source/tree/ClassTree.java +++ b/src/share/classes/com/sun/source/tree/ClassTree.java @@ -42,8 +42,7 @@ import javax.lang.model.element.Name; * } * </pre> * - * @see "The Java Language Specification, 3rd ed, - * sections 8.1, 8.9, 9.1, and 9.6" + * @jls sections 8.1, 8.9, 9.1, and 9.6 * * @author Peter von der Ahé * @author Jonathan Gibbons diff --git a/src/share/classes/com/sun/source/tree/CompilationUnitTree.java b/src/share/classes/com/sun/source/tree/CompilationUnitTree.java index 6f130fc6..66b585cf 100644 --- a/src/share/classes/com/sun/source/tree/CompilationUnitTree.java +++ b/src/share/classes/com/sun/source/tree/CompilationUnitTree.java @@ -33,7 +33,7 @@ import com.sun.source.tree.LineMap; * Represents the abstract syntax tree for compilation units (source * files) and package declarations (package-info.java). * - * @see "The Java Language Specification, 3rd ed, sections 7.3, and 7.4" + * @jls sections 7.3, and 7.4 * * @author Peter von der Ahé * @since 1.6 diff --git a/src/share/classes/com/sun/source/tree/CompoundAssignmentTree.java b/src/share/classes/com/sun/source/tree/CompoundAssignmentTree.java index 37a292ca..86eb99c2 100644 --- a/src/share/classes/com/sun/source/tree/CompoundAssignmentTree.java +++ b/src/share/classes/com/sun/source/tree/CompoundAssignmentTree.java @@ -34,7 +34,7 @@ package com.sun.source.tree; * <em>variable</em> <em>operator</em> <em>expression</em> * </pre> * - * @see "The Java Language Specification, 3rd ed, section 15.26.2" + * @jls section 15.26.2 * * @author Peter von der Ahé * @author Jonathan Gibbons diff --git a/src/share/classes/com/sun/source/tree/ConditionalExpressionTree.java b/src/share/classes/com/sun/source/tree/ConditionalExpressionTree.java index 6c9fb8c2..4492611f 100644 --- a/src/share/classes/com/sun/source/tree/ConditionalExpressionTree.java +++ b/src/share/classes/com/sun/source/tree/ConditionalExpressionTree.java @@ -33,7 +33,7 @@ package com.sun.source.tree; * <em>condition</em> ? <em>trueExpression</em> : <em>falseExpression</em> * </pre> * - * @see "The Java Language Specification, 3rd ed, section 15.25" + * @jls section 15.25 * * @author Peter von der Ahé * @author Jonathan Gibbons diff --git a/src/share/classes/com/sun/source/tree/ContinueTree.java b/src/share/classes/com/sun/source/tree/ContinueTree.java index 0d141d86..98db3549 100644 --- a/src/share/classes/com/sun/source/tree/ContinueTree.java +++ b/src/share/classes/com/sun/source/tree/ContinueTree.java @@ -36,7 +36,7 @@ import javax.lang.model.element.Name; * continue <em>label</em> ; * </pre> * - * @see "The Java Language Specification, 3rd ed, section 14.16" + * @jls section 14.16 * * @author Peter von der Ahé * @author Jonathan Gibbons diff --git a/src/share/classes/com/sun/source/tree/DoWhileLoopTree.java b/src/share/classes/com/sun/source/tree/DoWhileLoopTree.java index 70d98331..4a6e20b4 100644 --- a/src/share/classes/com/sun/source/tree/DoWhileLoopTree.java +++ b/src/share/classes/com/sun/source/tree/DoWhileLoopTree.java @@ -35,7 +35,7 @@ package com.sun.source.tree; * while ( <em>expression</em> ); * </pre> * - * @see "The Java Language Specification, 3rd ed, section 14.13" + * @jls section 14.13 * * @author Peter von der Ahé * @author Jonathan Gibbons diff --git a/src/share/classes/com/sun/source/tree/EmptyStatementTree.java b/src/share/classes/com/sun/source/tree/EmptyStatementTree.java index d8b072a0..baf13c15 100644 --- a/src/share/classes/com/sun/source/tree/EmptyStatementTree.java +++ b/src/share/classes/com/sun/source/tree/EmptyStatementTree.java @@ -33,7 +33,7 @@ package com.sun.source.tree; * ; * </pre> * - * @see "The Java Language Specification, 3rd ed, section 14.6" + * @jls section 14.6 * * @author Peter von der Ahé * @author Jonathan Gibbons diff --git a/src/share/classes/com/sun/source/tree/EnhancedForLoopTree.java b/src/share/classes/com/sun/source/tree/EnhancedForLoopTree.java index be486acb..f550bfaf 100644 --- a/src/share/classes/com/sun/source/tree/EnhancedForLoopTree.java +++ b/src/share/classes/com/sun/source/tree/EnhancedForLoopTree.java @@ -34,7 +34,7 @@ package com.sun.source.tree; * <em>statement</em> * </pre> * - * @see "The Java Language Specification, 3rd ed, section 14.14.2" + * @jls section 14.14.2 * * @author Peter von der Ahé * @author Jonathan Gibbons diff --git a/src/share/classes/com/sun/source/tree/ExpressionStatementTree.java b/src/share/classes/com/sun/source/tree/ExpressionStatementTree.java index 099e9384..f3661c1d 100644 --- a/src/share/classes/com/sun/source/tree/ExpressionStatementTree.java +++ b/src/share/classes/com/sun/source/tree/ExpressionStatementTree.java @@ -33,7 +33,7 @@ package com.sun.source.tree; * <em>expression</em> ; * </pre> * - * @see "The Java Language Specification, 3rd ed, section 14.8" + * @jls section 14.8 * * @author Peter von der Ahé * @author Jonathan Gibbons diff --git a/src/share/classes/com/sun/source/tree/ExpressionTree.java b/src/share/classes/com/sun/source/tree/ExpressionTree.java index 71ead42d..1ef4349f 100644 --- a/src/share/classes/com/sun/source/tree/ExpressionTree.java +++ b/src/share/classes/com/sun/source/tree/ExpressionTree.java @@ -29,7 +29,7 @@ package com.sun.source.tree; * A tree node used as the base class for the different types of * expressions. * - * @see "The Java Language Specification, 3rd ed, chapter 15" + * @jls chapter 15 * * @author Peter von der Ahé * @author Jonathan Gibbons diff --git a/src/share/classes/com/sun/source/tree/ForLoopTree.java b/src/share/classes/com/sun/source/tree/ForLoopTree.java index 7e0f60a9..12e21b79 100644 --- a/src/share/classes/com/sun/source/tree/ForLoopTree.java +++ b/src/share/classes/com/sun/source/tree/ForLoopTree.java @@ -36,7 +36,7 @@ import java.util.List; * <em>statement</em> * </pre> * - * @see "The Java Language Specification, 3rd ed, section 14.14.1" + * @jls section 14.14.1 * * @author Peter von der Ahé * @author Jonathan Gibbons diff --git a/src/share/classes/com/sun/source/tree/IdentifierTree.java b/src/share/classes/com/sun/source/tree/IdentifierTree.java index 4a973cfc..1d2d8adc 100644 --- a/src/share/classes/com/sun/source/tree/IdentifierTree.java +++ b/src/share/classes/com/sun/source/tree/IdentifierTree.java @@ -35,7 +35,7 @@ import javax.lang.model.element.Name; * <em>name</em> * </pre> * - * @see "The Java Language Specification, 3rd ed, section 6.5.6.1" + * @jls section 6.5.6.1 * * @author Peter von der Ahé * @author Jonathan Gibbons diff --git a/src/share/classes/com/sun/source/tree/IfTree.java b/src/share/classes/com/sun/source/tree/IfTree.java index 30d225d8..f6009466 100644 --- a/src/share/classes/com/sun/source/tree/IfTree.java +++ b/src/share/classes/com/sun/source/tree/IfTree.java @@ -39,7 +39,7 @@ package com.sun.source.tree; * <em>elseStatement</em> * </pre> * - * @see "The Java Language Specification, 3rd ed, section 14.9" + * @jls section 14.9 * * @author Peter von der Ahé * @author Jonathan Gibbons diff --git a/src/share/classes/com/sun/source/tree/ImportTree.java b/src/share/classes/com/sun/source/tree/ImportTree.java index 4a176ec8..1fd027d5 100644 --- a/src/share/classes/com/sun/source/tree/ImportTree.java +++ b/src/share/classes/com/sun/source/tree/ImportTree.java @@ -35,7 +35,7 @@ package com.sun.source.tree; * static import <em>qualifiedIdentifier</em> ; * </pre> * - * @see "The Java Language Specification, 3rd ed, section 7.5" + * @jls section 7.5 * * @author Peter von der Ahé * @author Jonathan Gibbons diff --git a/src/share/classes/com/sun/source/tree/InstanceOfTree.java b/src/share/classes/com/sun/source/tree/InstanceOfTree.java index 5fb307ba..20d95e73 100644 --- a/src/share/classes/com/sun/source/tree/InstanceOfTree.java +++ b/src/share/classes/com/sun/source/tree/InstanceOfTree.java @@ -33,7 +33,7 @@ package com.sun.source.tree; * <em>expression</em> instanceof <em>type</em> * </pre> * - * @see "The Java Language Specification, 3rd ed, section 15.20.2" + * @jls section 15.20.2 * * @author Peter von der Ahé * @author Jonathan Gibbons diff --git a/src/share/classes/com/sun/source/tree/LabeledStatementTree.java b/src/share/classes/com/sun/source/tree/LabeledStatementTree.java index d7d7a353..ba58dd48 100644 --- a/src/share/classes/com/sun/source/tree/LabeledStatementTree.java +++ b/src/share/classes/com/sun/source/tree/LabeledStatementTree.java @@ -35,7 +35,7 @@ import javax.lang.model.element.Name; * <em>label</em> : <em>statement</em> * </pre> * - * @see "The Java Language Specification, 3rd ed, section 14.7" + * @jls section 14.7 * * @author Peter von der Ahé * @author Jonathan Gibbons diff --git a/src/share/classes/com/sun/source/tree/LiteralTree.java b/src/share/classes/com/sun/source/tree/LiteralTree.java index 76a91551..a8be528c 100644 --- a/src/share/classes/com/sun/source/tree/LiteralTree.java +++ b/src/share/classes/com/sun/source/tree/LiteralTree.java @@ -34,7 +34,7 @@ package com.sun.source.tree; * <em>value</em> * </pre> * - * @see "The Java Language Specification, 3rd ed, section 15.28" + * @jls section 15.28 * * @author Peter von der Ahé * @author Jonathan Gibbons diff --git a/src/share/classes/com/sun/source/tree/MemberSelectTree.java b/src/share/classes/com/sun/source/tree/MemberSelectTree.java index d0332c02..e5beec5d 100644 --- a/src/share/classes/com/sun/source/tree/MemberSelectTree.java +++ b/src/share/classes/com/sun/source/tree/MemberSelectTree.java @@ -35,8 +35,7 @@ import javax.lang.model.element.Name; * <em>expression</em> . <em>identifier</em> * </pre> * - * @see "The Java Language Specification, 3rd ed, sections 6.5, - * 15.11, and 15.12" + * @jls sections 6.5, 15.11,and 15.12 * * @author Peter von der Ahé * @author Jonathan Gibbons diff --git a/src/share/classes/com/sun/source/tree/MethodInvocationTree.java b/src/share/classes/com/sun/source/tree/MethodInvocationTree.java index 1d1cbab8..4728d996 100644 --- a/src/share/classes/com/sun/source/tree/MethodInvocationTree.java +++ b/src/share/classes/com/sun/source/tree/MethodInvocationTree.java @@ -37,7 +37,7 @@ import java.util.List; * this . <em>typeArguments</em> <em>identifier</em> ( <em>arguments</em> ) * </pre> * - * @see "The Java Language Specification, 3rd ed, section 15.12" + * @jls section 15.12 * * @author Peter von der Ahé * @author Jonathan Gibbons diff --git a/src/share/classes/com/sun/source/tree/MethodTree.java b/src/share/classes/com/sun/source/tree/MethodTree.java index 074c8c08..8dfd0ba8 100644 --- a/src/share/classes/com/sun/source/tree/MethodTree.java +++ b/src/share/classes/com/sun/source/tree/MethodTree.java @@ -40,8 +40,7 @@ import javax.lang.model.element.Name; * <em>modifiers</em> <em>type</em> <em>name</em> () default <em>defaultValue</em> * </pre> * - * @see "The Java Language Specification, 3rd ed, sections 8.4, 8.6, 8.7, - * 9.4, and 9.6" + * @jls sections 8.4, 8.6, 8.7, 9.4, and 9.6 * * @author Peter von der Ahé * @author Jonathan Gibbons diff --git a/src/share/classes/com/sun/source/tree/ModifiersTree.java b/src/share/classes/com/sun/source/tree/ModifiersTree.java index 8aeee844..3189651e 100644 --- a/src/share/classes/com/sun/source/tree/ModifiersTree.java +++ b/src/share/classes/com/sun/source/tree/ModifiersTree.java @@ -39,8 +39,7 @@ import javax.lang.model.element.Modifier; * <em>flags</em> <em>annotations</em> * </pre> * - * @see "The Java Language Specification, 3rd ed, sections - * 8.1.1, 8.3.1, 8.4.3, 8.5.1, 8.8.3, 9.1.1, and 9.7" + * @jls sections 8.1.1, 8.3.1, 8.4.3, 8.5.1, 8.8.3, 9.1.1, and 9.7 * * @author Peter von der Ahé * @author Jonathan Gibbons diff --git a/src/share/classes/com/sun/source/tree/NewArrayTree.java b/src/share/classes/com/sun/source/tree/NewArrayTree.java index bff2108e..cdd5cd51 100644 --- a/src/share/classes/com/sun/source/tree/NewArrayTree.java +++ b/src/share/classes/com/sun/source/tree/NewArrayTree.java @@ -37,7 +37,7 @@ import java.util.List; * new <em>type</em> <em>dimensions</em> [ ] <em>initializers</em> * </pre> * - * @see "The Java Language Specification, 3rd ed, section 15.10" + * @jls section 15.10 * * @author Peter von der Ahé * @author Jonathan Gibbons diff --git a/src/share/classes/com/sun/source/tree/NewClassTree.java b/src/share/classes/com/sun/source/tree/NewClassTree.java index aed47b0a..06d713be 100644 --- a/src/share/classes/com/sun/source/tree/NewClassTree.java +++ b/src/share/classes/com/sun/source/tree/NewClassTree.java @@ -42,7 +42,7 @@ import java.util.List; * <em>enclosingExpression</em>.new <em>identifier</em> ( <em>arguments</em> ) * </pre> * - * @see "The Java Language Specification, 3rd ed, section 15.9" + * @jls section 15.9 * * @author Peter von der Ahé * @author Jonathan Gibbons diff --git a/src/share/classes/com/sun/source/tree/ParameterizedTypeTree.java b/src/share/classes/com/sun/source/tree/ParameterizedTypeTree.java index 7f88ddf1..aef328dd 100644 --- a/src/share/classes/com/sun/source/tree/ParameterizedTypeTree.java +++ b/src/share/classes/com/sun/source/tree/ParameterizedTypeTree.java @@ -35,7 +35,7 @@ import java.util.List; * <em>type</em> < <em>typeArguments</em> > * </pre> * - * @see "The Java Language Specification, 3rd ed, section 4.5.1" + * @jls section 4.5.1 * * @author Peter von der Ahé * @author Jonathan Gibbons diff --git a/src/share/classes/com/sun/source/tree/ParenthesizedTree.java b/src/share/classes/com/sun/source/tree/ParenthesizedTree.java index 9290fd23..d68516fa 100644 --- a/src/share/classes/com/sun/source/tree/ParenthesizedTree.java +++ b/src/share/classes/com/sun/source/tree/ParenthesizedTree.java @@ -34,7 +34,7 @@ package com.sun.source.tree; * ( <em>expression</em> ) * </pre> * - * @see "The Java Language Specification, 3rd ed, section 15.8.5" + * @jls section 15.8.5 * * @author Peter von der Ahé * @author Jonathan Gibbons diff --git a/src/share/classes/com/sun/source/tree/PrimitiveTypeTree.java b/src/share/classes/com/sun/source/tree/PrimitiveTypeTree.java index 0e1f95f7..f6cd5669 100644 --- a/src/share/classes/com/sun/source/tree/PrimitiveTypeTree.java +++ b/src/share/classes/com/sun/source/tree/PrimitiveTypeTree.java @@ -35,7 +35,7 @@ import javax.lang.model.type.TypeKind; * <em>primitiveTypeKind</em> * </pre> * - * @see "The Java Language Specification, 3rd ed, section 4.2" + * @jls section 4.2 * * @author Peter von der Ahé * @author Jonathan Gibbons diff --git a/src/share/classes/com/sun/source/tree/ReturnTree.java b/src/share/classes/com/sun/source/tree/ReturnTree.java index e785be6d..62a51cb3 100644 --- a/src/share/classes/com/sun/source/tree/ReturnTree.java +++ b/src/share/classes/com/sun/source/tree/ReturnTree.java @@ -34,7 +34,7 @@ package com.sun.source.tree; * return <em>expression</em>; * </pre> * - * @see "The Java Language Specification, 3rd ed, section 14.17" + * @jls section 14.17 * * @author Peter von der Ahé * @author Jonathan Gibbons diff --git a/src/share/classes/com/sun/source/tree/StatementTree.java b/src/share/classes/com/sun/source/tree/StatementTree.java index 24b8bd3c..47dba7dd 100644 --- a/src/share/classes/com/sun/source/tree/StatementTree.java +++ b/src/share/classes/com/sun/source/tree/StatementTree.java @@ -29,7 +29,7 @@ package com.sun.source.tree; * A tree node used as the base class for the different kinds of * statements. * - * @see "The Java Language Specification, 3rd ed, chapter 14" + * @jls chapter 14 * * @author Peter von der Ahé * @author Jonathan Gibbons diff --git a/src/share/classes/com/sun/source/tree/SwitchTree.java b/src/share/classes/com/sun/source/tree/SwitchTree.java index 5cc5186a..c5a87c42 100644 --- a/src/share/classes/com/sun/source/tree/SwitchTree.java +++ b/src/share/classes/com/sun/source/tree/SwitchTree.java @@ -37,7 +37,7 @@ import java.util.List; * } * </pre> * - * @see "The Java Language Specification, 3rd ed, section 14.11" + * @jls section 14.11 * * @author Peter von der Ahé * @author Jonathan Gibbons diff --git a/src/share/classes/com/sun/source/tree/SynchronizedTree.java b/src/share/classes/com/sun/source/tree/SynchronizedTree.java index 17d1441c..20c9a442 100644 --- a/src/share/classes/com/sun/source/tree/SynchronizedTree.java +++ b/src/share/classes/com/sun/source/tree/SynchronizedTree.java @@ -34,7 +34,7 @@ package com.sun.source.tree; * </em>block</em> * </pre> * - * @see "The Java Language Specification, 3rd ed, section 14.19" + * @jls section 14.19 * * @author Peter von der Ahé * @author Jonathan Gibbons diff --git a/src/share/classes/com/sun/source/tree/ThrowTree.java b/src/share/classes/com/sun/source/tree/ThrowTree.java index e30e31b5..a91f63b0 100644 --- a/src/share/classes/com/sun/source/tree/ThrowTree.java +++ b/src/share/classes/com/sun/source/tree/ThrowTree.java @@ -33,7 +33,7 @@ package com.sun.source.tree; * throw <em>expression</em>; * </pre> * - * @see "The Java Language Specification, 3rd ed, section 14.18" + * @jls section 14.18 * * @author Peter von der Ahé * @author Jonathan Gibbons diff --git a/src/share/classes/com/sun/source/tree/TryTree.java b/src/share/classes/com/sun/source/tree/TryTree.java index 24c185dc..f2510bd5 100644 --- a/src/share/classes/com/sun/source/tree/TryTree.java +++ b/src/share/classes/com/sun/source/tree/TryTree.java @@ -39,7 +39,7 @@ import java.util.List; * <em>finallyBlock</em> * </pre> * - * @see "The Java Language Specification, 3rd ed, section 14.20" + * @jls section 14.20 * * @author Peter von der Ahé * @author Jonathan Gibbons diff --git a/src/share/classes/com/sun/source/tree/TypeCastTree.java b/src/share/classes/com/sun/source/tree/TypeCastTree.java index 682b5403..43dc6192 100644 --- a/src/share/classes/com/sun/source/tree/TypeCastTree.java +++ b/src/share/classes/com/sun/source/tree/TypeCastTree.java @@ -33,7 +33,7 @@ package com.sun.source.tree; * ( <em>type</em> ) <em>expression</em> * </pre> * - * @see "The Java Language Specification, 3rd ed, section 15.16" + * @jls section 15.16 * * @author Peter von der Ahé * @author Jonathan Gibbons diff --git a/src/share/classes/com/sun/source/tree/TypeParameterTree.java b/src/share/classes/com/sun/source/tree/TypeParameterTree.java index 66e8757e..6a603389 100644 --- a/src/share/classes/com/sun/source/tree/TypeParameterTree.java +++ b/src/share/classes/com/sun/source/tree/TypeParameterTree.java @@ -38,7 +38,7 @@ import javax.lang.model.element.Name; * <em>name</em> extends <em>bounds</em> * </pre> * - * @see "The Java Language Specification, 3rd ed, section 4.4" + * @jls section 4.4 * * @author Peter von der Ahé * @author Jonathan Gibbons diff --git a/src/share/classes/com/sun/source/tree/UnaryTree.java b/src/share/classes/com/sun/source/tree/UnaryTree.java index ed843c98..7b4d9e83 100644 --- a/src/share/classes/com/sun/source/tree/UnaryTree.java +++ b/src/share/classes/com/sun/source/tree/UnaryTree.java @@ -36,7 +36,7 @@ package com.sun.source.tree; * <em>expression</em> <em>operator</em> * </pre> * - * @see "The Java Language Specification, 3rd ed, sections 15.14 and 15.15" + * @jls sections 15.14 and 15.15 * * @author Peter von der Ahé * @author Jonathan Gibbons diff --git a/src/share/classes/com/sun/source/tree/VariableTree.java b/src/share/classes/com/sun/source/tree/VariableTree.java index 6d7f65f5..ea73f23a 100644 --- a/src/share/classes/com/sun/source/tree/VariableTree.java +++ b/src/share/classes/com/sun/source/tree/VariableTree.java @@ -35,7 +35,7 @@ import javax.lang.model.element.Name; * <em>modifiers</em> <em>type</em> <em>name</em> <em>initializer</em> ; * </pre> * - * @see "The Java Language Specification, 3rd ed, sections 8.3 and 14.4" + * @jls sections 8.3 and 14.4 * * @author Peter von der Ahé * @author Jonathan Gibbons diff --git a/src/share/classes/com/sun/source/tree/WhileLoopTree.java b/src/share/classes/com/sun/source/tree/WhileLoopTree.java index aec05f45..fd4a832a 100644 --- a/src/share/classes/com/sun/source/tree/WhileLoopTree.java +++ b/src/share/classes/com/sun/source/tree/WhileLoopTree.java @@ -35,7 +35,7 @@ package com.sun.source.tree; * </pre> * * - * @see "The Java Language Specification, 3rd ed, section 14.12" + * @jls section 14.12 * * @author Peter von der Ahé * @author Jonathan Gibbons diff --git a/src/share/classes/com/sun/source/tree/WildcardTree.java b/src/share/classes/com/sun/source/tree/WildcardTree.java index e6a98d0d..d3f62fd0 100644 --- a/src/share/classes/com/sun/source/tree/WildcardTree.java +++ b/src/share/classes/com/sun/source/tree/WildcardTree.java @@ -38,7 +38,7 @@ package com.sun.source.tree; * ? super <em>bound</em> * </pre> * - * @see "The Java Language Specification, 3rd ed, section 4.5.1" + * @jls section 4.5.1 * * @author Peter von der Ahé * @author Jonathan Gibbons diff --git a/src/share/classes/com/sun/tools/apt/mirror/util/DeclarationsImpl.java b/src/share/classes/com/sun/tools/apt/mirror/util/DeclarationsImpl.java index 7373804e..02f59ff0 100644 --- a/src/share/classes/com/sun/tools/apt/mirror/util/DeclarationsImpl.java +++ b/src/share/classes/com/sun/tools/apt/mirror/util/DeclarationsImpl.java @@ -67,7 +67,8 @@ public class DeclarationsImpl implements Declarations { /** * {@inheritDoc} - * See JLS 2 sections 8.3 and 8.4.6. + * See sections 8.3 and 8.4.6 of + * <cite>The Java™ Language Specification</cite> */ public boolean hides(MemberDeclaration sub, MemberDeclaration sup) { Symbol hider = ((DeclarationImpl) sub).sym; @@ -107,7 +108,8 @@ public class DeclarationsImpl implements Declarations { /** * {@inheritDoc} - * See JLS 2 section 8.4.6.1. + * See section 8.4.6.1 of + * <cite>The Java™ Language Specification</cite> */ public boolean overrides(MethodDeclaration sub, MethodDeclaration sup) { MethodSymbol overrider = ((MethodDeclarationImpl) sub).sym; diff --git a/src/share/classes/com/sun/tools/classfile/AccessFlags.java b/src/share/classes/com/sun/tools/classfile/AccessFlags.java index e7ab8969..bb8faf3d 100644 --- a/src/share/classes/com/sun/tools/classfile/AccessFlags.java +++ b/src/share/classes/com/sun/tools/classfile/AccessFlags.java @@ -30,7 +30,7 @@ import java.util.LinkedHashSet; import java.util.Set; /** - * See JVMS3, sections 4.2, 4.6, 4.7. + * See JVMS, sections 4.2, 4.6, 4.7. * * <p><b>This is NOT part of any supported API. * If you write code that depends on this, you do so at your own risk. diff --git a/src/share/classes/com/sun/tools/classfile/Annotation.java b/src/share/classes/com/sun/tools/classfile/Annotation.java index 98eadc6e..8192d1a0 100644 --- a/src/share/classes/com/sun/tools/classfile/Annotation.java +++ b/src/share/classes/com/sun/tools/classfile/Annotation.java @@ -28,7 +28,7 @@ package com.sun.tools.classfile; import java.io.IOException; /** - * See JVMS3, section 4.8.16. + * See JVMS, section 4.8.16. * * <p><b>This is NOT part of any supported API. * If you write code that depends on this, you do so at your own risk. @@ -71,7 +71,7 @@ public class Annotation { public final element_value_pair element_value_pairs[]; /** - * See JVMS3, section 4.8.16.1. + * See JVMS, section 4.8.16.1. */ public static abstract class element_value { public static element_value read(ClassReader cr) diff --git a/src/share/classes/com/sun/tools/classfile/AnnotationDefault_attribute.java b/src/share/classes/com/sun/tools/classfile/AnnotationDefault_attribute.java index 091a8fa2..1ca7fc45 100644 --- a/src/share/classes/com/sun/tools/classfile/AnnotationDefault_attribute.java +++ b/src/share/classes/com/sun/tools/classfile/AnnotationDefault_attribute.java @@ -28,7 +28,7 @@ package com.sun.tools.classfile; import java.io.IOException; /** - * See JVMS3, section 4.8.15. + * See JVMS, section 4.8.15. * * <p><b>This is NOT part of any supported API. * If you write code that depends on this, you do so at your own risk. diff --git a/src/share/classes/com/sun/tools/classfile/BootstrapMethods_attribute.java b/src/share/classes/com/sun/tools/classfile/BootstrapMethods_attribute.java index 59b00f11..38043332 100644 --- a/src/share/classes/com/sun/tools/classfile/BootstrapMethods_attribute.java +++ b/src/share/classes/com/sun/tools/classfile/BootstrapMethods_attribute.java @@ -28,7 +28,7 @@ package com.sun.tools.classfile; import java.io.IOException; /** - * See JVMS3 <TBD> + * See JVMS <TBD> * http://cr.openjdk.java.net/~jrose/pres/indy-javadoc-mlvm/ * * <p><b>This is NOT part of any supported API. diff --git a/src/share/classes/com/sun/tools/classfile/ClassFile.java b/src/share/classes/com/sun/tools/classfile/ClassFile.java index affcad05..9a68f617 100644 --- a/src/share/classes/com/sun/tools/classfile/ClassFile.java +++ b/src/share/classes/com/sun/tools/classfile/ClassFile.java @@ -33,7 +33,7 @@ import java.io.InputStream; import static com.sun.tools.classfile.AccessFlags.*; /** - * See JVMS3, section 4.2. + * See JVMS, section 4.2. * * <p><b>This is NOT part of any supported API. * If you write code that depends on this, you do so at your own risk. diff --git a/src/share/classes/com/sun/tools/classfile/Code_attribute.java b/src/share/classes/com/sun/tools/classfile/Code_attribute.java index bc21154c..af34c2a4 100644 --- a/src/share/classes/com/sun/tools/classfile/Code_attribute.java +++ b/src/share/classes/com/sun/tools/classfile/Code_attribute.java @@ -30,7 +30,7 @@ import java.util.Iterator; import java.util.NoSuchElementException; /** - * See JVMS3, section 4.8.3. + * See JVMS, section 4.8.3. * * <p><b>This is NOT part of any supported API. * If you write code that depends on this, you do so at your own risk. diff --git a/src/share/classes/com/sun/tools/classfile/ConstantPool.java b/src/share/classes/com/sun/tools/classfile/ConstantPool.java index c9a48bf4..29a5ce34 100644 --- a/src/share/classes/com/sun/tools/classfile/ConstantPool.java +++ b/src/share/classes/com/sun/tools/classfile/ConstantPool.java @@ -31,7 +31,7 @@ import java.io.OutputStream; import java.util.Iterator; /** - * See JVMS3, section 4.5. + * See JVMS, section 4.5. * * <p><b>This is NOT part of any supported API. * If you write code that depends on this, you do so at your own risk. diff --git a/src/share/classes/com/sun/tools/classfile/ConstantValue_attribute.java b/src/share/classes/com/sun/tools/classfile/ConstantValue_attribute.java index 94a88cb3..df40defa 100644 --- a/src/share/classes/com/sun/tools/classfile/ConstantValue_attribute.java +++ b/src/share/classes/com/sun/tools/classfile/ConstantValue_attribute.java @@ -28,7 +28,7 @@ package com.sun.tools.classfile; import java.io.IOException; /** - * See JVMS3, section 4.8.2. + * See JVMS, section 4.8.2. * * <p><b>This is NOT part of any supported API. * If you write code that depends on this, you do so at your own risk. diff --git a/src/share/classes/com/sun/tools/classfile/Deprecated_attribute.java b/src/share/classes/com/sun/tools/classfile/Deprecated_attribute.java index 646ed3d5..dbf6442f 100644 --- a/src/share/classes/com/sun/tools/classfile/Deprecated_attribute.java +++ b/src/share/classes/com/sun/tools/classfile/Deprecated_attribute.java @@ -28,7 +28,7 @@ package com.sun.tools.classfile; import java.io.IOException; /** - * See JVMS3, section 4.8.15. + * See JVMS, section 4.8.15. * * <p><b>This is NOT part of any supported API. * If you write code that depends on this, you do so at your own risk. diff --git a/src/share/classes/com/sun/tools/classfile/Descriptor.java b/src/share/classes/com/sun/tools/classfile/Descriptor.java index ff194c96..28db3312 100644 --- a/src/share/classes/com/sun/tools/classfile/Descriptor.java +++ b/src/share/classes/com/sun/tools/classfile/Descriptor.java @@ -29,7 +29,7 @@ package com.sun.tools.classfile; import java.io.IOException; /** - * See JVMS3, section 4.4. + * See JVMS, section 4.4. * * <p><b>This is NOT part of any supported API. * If you write code that depends on this, you do so at your own risk. diff --git a/src/share/classes/com/sun/tools/classfile/EnclosingMethod_attribute.java b/src/share/classes/com/sun/tools/classfile/EnclosingMethod_attribute.java index 2296810e..bdebe41e 100644 --- a/src/share/classes/com/sun/tools/classfile/EnclosingMethod_attribute.java +++ b/src/share/classes/com/sun/tools/classfile/EnclosingMethod_attribute.java @@ -29,7 +29,7 @@ package com.sun.tools.classfile; import java.io.IOException; /** - * See JVMS3, section 4.8.7. + * See JVMS, section 4.8.7. * * <p><b>This is NOT part of any supported API. * If you write code that depends on this, you do so at your own risk. diff --git a/src/share/classes/com/sun/tools/classfile/Exceptions_attribute.java b/src/share/classes/com/sun/tools/classfile/Exceptions_attribute.java index 05c301b3..a56db00b 100644 --- a/src/share/classes/com/sun/tools/classfile/Exceptions_attribute.java +++ b/src/share/classes/com/sun/tools/classfile/Exceptions_attribute.java @@ -28,7 +28,7 @@ package com.sun.tools.classfile; import java.io.IOException; /** - * See JVMS3, section 4.8.5. + * See JVMS, section 4.8.5. * * <p><b>This is NOT part of any supported API. * If you write code that depends on this, you do so at your own risk. diff --git a/src/share/classes/com/sun/tools/classfile/InnerClasses_attribute.java b/src/share/classes/com/sun/tools/classfile/InnerClasses_attribute.java index 2033a9ea..153a7ed9 100644 --- a/src/share/classes/com/sun/tools/classfile/InnerClasses_attribute.java +++ b/src/share/classes/com/sun/tools/classfile/InnerClasses_attribute.java @@ -30,7 +30,7 @@ import java.io.IOException; import com.sun.tools.classfile.ConstantPool.*; /** - * See JVMS3, section 4.8.6. + * See JVMS, section 4.8.6. * * <p><b>This is NOT part of any supported API. * If you write code that depends on this, you do so at your own risk. diff --git a/src/share/classes/com/sun/tools/classfile/Instruction.java b/src/share/classes/com/sun/tools/classfile/Instruction.java index d6ca812a..a2d36f5d 100644 --- a/src/share/classes/com/sun/tools/classfile/Instruction.java +++ b/src/share/classes/com/sun/tools/classfile/Instruction.java @@ -26,7 +26,7 @@ package com.sun.tools.classfile; /** - * See JVMS3, chapter 6. + * See JVMS, chapter 6. * * <p><b>This is NOT part of any supported API. * If you write code that depends on this, you do so at your own risk. diff --git a/src/share/classes/com/sun/tools/classfile/LineNumberTable_attribute.java b/src/share/classes/com/sun/tools/classfile/LineNumberTable_attribute.java index e07c9ec6..58595b7d 100644 --- a/src/share/classes/com/sun/tools/classfile/LineNumberTable_attribute.java +++ b/src/share/classes/com/sun/tools/classfile/LineNumberTable_attribute.java @@ -28,7 +28,7 @@ package com.sun.tools.classfile; import java.io.IOException; /** - * See JVMS3, section 4.8.12. + * See JVMS, section 4.8.12. * * <p><b>This is NOT part of any supported API. * If you write code that depends on this, you do so at your own risk. diff --git a/src/share/classes/com/sun/tools/classfile/LocalVariableTable_attribute.java b/src/share/classes/com/sun/tools/classfile/LocalVariableTable_attribute.java index 9aa060a2..1e4465f2 100644 --- a/src/share/classes/com/sun/tools/classfile/LocalVariableTable_attribute.java +++ b/src/share/classes/com/sun/tools/classfile/LocalVariableTable_attribute.java @@ -28,7 +28,7 @@ package com.sun.tools.classfile; import java.io.IOException; /** - * See JVMS3, section 4.8.13. + * See JVMS, section 4.8.13. * * <p><b>This is NOT part of any supported API. * If you write code that depends on this, you do so at your own risk. diff --git a/src/share/classes/com/sun/tools/classfile/LocalVariableTypeTable_attribute.java b/src/share/classes/com/sun/tools/classfile/LocalVariableTypeTable_attribute.java index b917b0f4..8332cbec 100644 --- a/src/share/classes/com/sun/tools/classfile/LocalVariableTypeTable_attribute.java +++ b/src/share/classes/com/sun/tools/classfile/LocalVariableTypeTable_attribute.java @@ -28,7 +28,7 @@ package com.sun.tools.classfile; import java.io.IOException; /** - * See JVMS3, section 4.8.14. + * See JVMS, section 4.8.14. * * <p><b>This is NOT part of any supported API. * If you write code that depends on this, you do so at your own risk. diff --git a/src/share/classes/com/sun/tools/classfile/Opcode.java b/src/share/classes/com/sun/tools/classfile/Opcode.java index b5a0086d..9f276450 100644 --- a/src/share/classes/com/sun/tools/classfile/Opcode.java +++ b/src/share/classes/com/sun/tools/classfile/Opcode.java @@ -29,7 +29,7 @@ import static com.sun.tools.classfile.Instruction.Kind.*; import static com.sun.tools.classfile.Opcode.Set.*; /** - * See JVMS3, chapter 6. + * See JVMS, chapter 6. * * <p>In addition to providing all the standard opcodes defined in JVMS, * this class also provides legacy support for the PicoJava extensions. diff --git a/src/share/classes/com/sun/tools/classfile/RuntimeAnnotations_attribute.java b/src/share/classes/com/sun/tools/classfile/RuntimeAnnotations_attribute.java index c0ec09d2..859cec40 100644 --- a/src/share/classes/com/sun/tools/classfile/RuntimeAnnotations_attribute.java +++ b/src/share/classes/com/sun/tools/classfile/RuntimeAnnotations_attribute.java @@ -28,7 +28,7 @@ package com.sun.tools.classfile; import java.io.IOException; /** - * See JVMS3, section 4.8.16 and 4.8.17. + * See JVMS, section 4.8.16 and 4.8.17. * * <p><b>This is NOT part of any supported API. * If you write code that depends on this, you do so at your own risk. diff --git a/src/share/classes/com/sun/tools/classfile/RuntimeInvisibleAnnotations_attribute.java b/src/share/classes/com/sun/tools/classfile/RuntimeInvisibleAnnotations_attribute.java index b1a2e65e..ed700823 100644 --- a/src/share/classes/com/sun/tools/classfile/RuntimeInvisibleAnnotations_attribute.java +++ b/src/share/classes/com/sun/tools/classfile/RuntimeInvisibleAnnotations_attribute.java @@ -28,7 +28,7 @@ package com.sun.tools.classfile; import java.io.IOException; /** - * See JVMS3, section 4.8.17. + * See JVMS, section 4.8.17. * * <p><b>This is NOT part of any supported API. * If you write code that depends on this, you do so at your own risk. diff --git a/src/share/classes/com/sun/tools/classfile/RuntimeInvisibleParameterAnnotations_attribute.java b/src/share/classes/com/sun/tools/classfile/RuntimeInvisibleParameterAnnotations_attribute.java index 340383c8..57de543a 100644 --- a/src/share/classes/com/sun/tools/classfile/RuntimeInvisibleParameterAnnotations_attribute.java +++ b/src/share/classes/com/sun/tools/classfile/RuntimeInvisibleParameterAnnotations_attribute.java @@ -28,7 +28,7 @@ package com.sun.tools.classfile; import java.io.IOException; /** - * See JVMS3, section 4.8.18. + * See JVMS, section 4.8.18. * * <p><b>This is NOT part of any supported API. * If you write code that depends on this, you do so at your own risk. diff --git a/src/share/classes/com/sun/tools/classfile/RuntimeParameterAnnotations_attribute.java b/src/share/classes/com/sun/tools/classfile/RuntimeParameterAnnotations_attribute.java index 22584380..904010f6 100644 --- a/src/share/classes/com/sun/tools/classfile/RuntimeParameterAnnotations_attribute.java +++ b/src/share/classes/com/sun/tools/classfile/RuntimeParameterAnnotations_attribute.java @@ -28,7 +28,7 @@ package com.sun.tools.classfile; import java.io.IOException; /** - * See JVMS3, section 4.8.18 and 4.8.19. + * See JVMS, section 4.8.18 and 4.8.19. * * <p><b>This is NOT part of any supported API. * If you write code that depends on this, you do so at your own risk. diff --git a/src/share/classes/com/sun/tools/classfile/RuntimeVisibleAnnotations_attribute.java b/src/share/classes/com/sun/tools/classfile/RuntimeVisibleAnnotations_attribute.java index 51075d6f..c7a44390 100644 --- a/src/share/classes/com/sun/tools/classfile/RuntimeVisibleAnnotations_attribute.java +++ b/src/share/classes/com/sun/tools/classfile/RuntimeVisibleAnnotations_attribute.java @@ -28,7 +28,7 @@ package com.sun.tools.classfile; import java.io.IOException; /** - * See JVMS3, section 4.8.16. + * See JVMS, section 4.8.16. * * <p><b>This is NOT part of any supported API. * If you write code that depends on this, you do so at your own risk. diff --git a/src/share/classes/com/sun/tools/classfile/RuntimeVisibleParameterAnnotations_attribute.java b/src/share/classes/com/sun/tools/classfile/RuntimeVisibleParameterAnnotations_attribute.java index 649fe85e..24214e7e 100644 --- a/src/share/classes/com/sun/tools/classfile/RuntimeVisibleParameterAnnotations_attribute.java +++ b/src/share/classes/com/sun/tools/classfile/RuntimeVisibleParameterAnnotations_attribute.java @@ -28,7 +28,7 @@ package com.sun.tools.classfile; import java.io.IOException; /** - * See JVMS3, section 4.8.18. + * See JVMS, section 4.8.18. * * <p><b>This is NOT part of any supported API. * If you write code that depends on this, you do so at your own risk. diff --git a/src/share/classes/com/sun/tools/classfile/Signature.java b/src/share/classes/com/sun/tools/classfile/Signature.java index ccc17bae..19c52f81 100644 --- a/src/share/classes/com/sun/tools/classfile/Signature.java +++ b/src/share/classes/com/sun/tools/classfile/Signature.java @@ -30,7 +30,7 @@ import java.util.List; import com.sun.tools.classfile.Type.*; /** - * See JVMS3 4.4.4. + * See JVMS 4.4.4. * * <p><b>This is NOT part of any supported API. * If you write code that depends on this, you do so at your own risk. diff --git a/src/share/classes/com/sun/tools/classfile/Signature_attribute.java b/src/share/classes/com/sun/tools/classfile/Signature_attribute.java index 89c4893e..acb9475c 100644 --- a/src/share/classes/com/sun/tools/classfile/Signature_attribute.java +++ b/src/share/classes/com/sun/tools/classfile/Signature_attribute.java @@ -28,7 +28,7 @@ package com.sun.tools.classfile; import java.io.IOException; /** - * See JVMS3, section 4.8.9. + * See JVMS, section 4.8.9. * * <p><b>This is NOT part of any supported API. * If you write code that depends on this, you do so at your own risk. diff --git a/src/share/classes/com/sun/tools/classfile/SourceDebugExtension_attribute.java b/src/share/classes/com/sun/tools/classfile/SourceDebugExtension_attribute.java index 6ed4f017..ba1f2aa8 100644 --- a/src/share/classes/com/sun/tools/classfile/SourceDebugExtension_attribute.java +++ b/src/share/classes/com/sun/tools/classfile/SourceDebugExtension_attribute.java @@ -30,7 +30,7 @@ import java.io.DataInputStream; import java.io.IOException; /** - * See JVMS3, section 4.8.15. + * See JVMS, section 4.8.15. * * <p><b>This is NOT part of any supported API. * If you write code that depends on this, you do so at your own risk. diff --git a/src/share/classes/com/sun/tools/classfile/SourceFile_attribute.java b/src/share/classes/com/sun/tools/classfile/SourceFile_attribute.java index 168a4474..c3b7509d 100644 --- a/src/share/classes/com/sun/tools/classfile/SourceFile_attribute.java +++ b/src/share/classes/com/sun/tools/classfile/SourceFile_attribute.java @@ -28,7 +28,7 @@ package com.sun.tools.classfile; import java.io.IOException; /** - * See JVMS3, section 4.8.10. + * See JVMS, section 4.8.10. * * <p><b>This is NOT part of any supported API. * If you write code that depends on this, you do so at your own risk. diff --git a/src/share/classes/com/sun/tools/classfile/StackMapTable_attribute.java b/src/share/classes/com/sun/tools/classfile/StackMapTable_attribute.java index bdb39a98..13c43e42 100644 --- a/src/share/classes/com/sun/tools/classfile/StackMapTable_attribute.java +++ b/src/share/classes/com/sun/tools/classfile/StackMapTable_attribute.java @@ -28,7 +28,7 @@ package com.sun.tools.classfile; import java.io.IOException; /** - * See JVMS3, section 4.8.4. + * See JVMS, section 4.8.4. * * <p><b>This is NOT part of any supported API. * If you write code that depends on this, you do so at your own risk. diff --git a/src/share/classes/com/sun/tools/classfile/Synthetic_attribute.java b/src/share/classes/com/sun/tools/classfile/Synthetic_attribute.java index f1995d28..0b7f933d 100644 --- a/src/share/classes/com/sun/tools/classfile/Synthetic_attribute.java +++ b/src/share/classes/com/sun/tools/classfile/Synthetic_attribute.java @@ -28,7 +28,7 @@ package com.sun.tools.classfile; import java.io.IOException; /** - * See JVMS3, section 4.8.8. + * See JVMS, section 4.8.8. * * <p><b>This is NOT part of any supported API. * If you write code that depends on this, you do so at your own risk. diff --git a/src/share/classes/com/sun/tools/classfile/package.html b/src/share/classes/com/sun/tools/classfile/package.html index d065ba5f..765dfb1a 100644 --- a/src/share/classes/com/sun/tools/classfile/package.html +++ b/src/share/classes/com/sun/tools/classfile/package.html @@ -6,7 +6,7 @@ </head> <body> A minimalist library to read and write class files into objects closely - based on the corresponding definitions in the Java Virtual Machine - Specification (JVMS). + based on the corresponding definitions in + <cite>The Java™ Virtual Machine Specification</cite> (JVMS). </body> </html> diff --git a/src/share/classes/com/sun/tools/doclets/formats/html/HtmlDocletWriter.java b/src/share/classes/com/sun/tools/doclets/formats/html/HtmlDocletWriter.java index 60609b4f..80cc01bd 100644 --- a/src/share/classes/com/sun/tools/doclets/formats/html/HtmlDocletWriter.java +++ b/src/share/classes/com/sun/tools/doclets/formats/html/HtmlDocletWriter.java @@ -2523,8 +2523,9 @@ public class HtmlDocletWriter extends HtmlDocWriter { } /** - * According to the Java Language Specifications, all the outer classes - * and static nested classes are core classes. + * According to + * <cite>The Java™ Language Specification</cite>, + * all the outer classes and static nested classes are core classes. */ public boolean isCoreClass(ClassDoc cd) { return cd.containingClass() == null || cd.isStatic(); diff --git a/src/share/classes/com/sun/tools/doclets/internal/toolkit/util/Util.java b/src/share/classes/com/sun/tools/doclets/internal/toolkit/util/Util.java index fde2c3c0..1e6186b3 100644 --- a/src/share/classes/com/sun/tools/doclets/internal/toolkit/util/Util.java +++ b/src/share/classes/com/sun/tools/doclets/internal/toolkit/util/Util.java @@ -175,8 +175,9 @@ public class Util { } /** - * According to the Java Language Specifications, all the outer classes - * and static inner classes are core classes. + * According to + * <cite>The Java™ Language Specification</cite>, + * all the outer classes and static inner classes are core classes. */ public static boolean isCoreClass(ClassDoc cd) { return cd.containingClass() == null || cd.isStatic(); diff --git a/src/share/classes/com/sun/tools/javac/code/Symbol.java b/src/share/classes/com/sun/tools/javac/code/Symbol.java index e5521027..381edd2f 100644 --- a/src/share/classes/com/sun/tools/javac/code/Symbol.java +++ b/src/share/classes/com/sun/tools/javac/code/Symbol.java @@ -1193,7 +1193,7 @@ public abstract class Symbol implements Element { } private boolean isOverridableIn(TypeSymbol origin) { - // JLS3 8.4.6.1 + // JLS 8.4.6.1 switch ((int)(flags_field & Flags.AccessFlags)) { case Flags.PRIVATE: return false; diff --git a/src/share/classes/com/sun/tools/javac/code/Types.java b/src/share/classes/com/sun/tools/javac/code/Types.java index 6408a06e..355f56f6 100644 --- a/src/share/classes/com/sun/tools/javac/code/Types.java +++ b/src/share/classes/com/sun/tools/javac/code/Types.java @@ -1985,7 +1985,7 @@ public class Types { * signature</em> of the other. This is <b>not</b> an equivalence * relation. * - * @see "The Java Language Specification, Third Ed. (8.4.2)." + * @jls section 8.4.2. * @see #overrideEquivalent(Type t, Type s) * @param t first signature (possibly raw). * @param s second signature (could be subjected to erasure). @@ -2004,7 +2004,7 @@ public class Types { * equivalence</em>. This is the natural extension of * isSubSignature to an equivalence relation. * - * @see "The Java Language Specification, Third Ed. (8.4.2)." + * @jls section 8.4.2. * @see #isSubSignature(Type t, Type s) * @param t a signature (possible raw, could be subjected to * erasure). @@ -3049,8 +3049,7 @@ public class Types { /** * Return-Type-Substitutable. - * @see <a href="http://java.sun.com/docs/books/jls/">The Java - * Language Specification, Third Ed. (8.4.5)</a> + * @jls section 8.4.5 */ public boolean returnTypeSubstitutable(Type r1, Type r2) { if (hasSameArgs(r1, r2)) @@ -3130,7 +3129,7 @@ public class Types { // <editor-fold defaultstate="collapsed" desc="Capture conversion"> /* - * JLS 3rd Ed. 5.1.10 Capture Conversion: + * JLS 5.1.10 Capture Conversion: * * Let G name a generic type declaration with n formal type * parameters A1 ... An with corresponding bounds U1 ... Un. There @@ -3163,7 +3162,7 @@ public class Types { * Capture conversion is not applied recursively. */ /** - * Capture conversion as specified by JLS 3rd Ed. + * Capture conversion as specified by the JLS. */ public List<Type> capture(List<Type> ts) { diff --git a/src/share/classes/com/sun/tools/javac/comp/Attr.java b/src/share/classes/com/sun/tools/javac/comp/Attr.java index 03d6180e..ad075a04 100644 --- a/src/share/classes/com/sun/tools/javac/comp/Attr.java +++ b/src/share/classes/com/sun/tools/javac/comp/Attr.java @@ -2632,10 +2632,10 @@ public class Attr extends JCTree.Visitor { * @param tree The tree making up the variable reference. * @param env The current environment. * @param v The variable's symbol. - * @see JLS 3rd Ed. (8.9 Enums) + * @jls section 8.9 Enums */ private void checkEnumInitializer(JCTree tree, Env<AttrContext> env, VarSymbol v) { - // JLS 3rd Ed.: + // JLS: // // "It is a compile-time error to reference a static field // of an enum type that is not a compile-time constant diff --git a/src/share/classes/com/sun/tools/javac/comp/Check.java b/src/share/classes/com/sun/tools/javac/comp/Check.java index c54d6862..c8537ef9 100644 --- a/src/share/classes/com/sun/tools/javac/comp/Check.java +++ b/src/share/classes/com/sun/tools/javac/comp/Check.java @@ -2271,7 +2271,7 @@ public class Check { * that of any public or protected method declared in class Object * or in the interface annotation.Annotation." * - * @jls3 9.6 Annotation Types + * @jls 9.6 Annotation Types */ void validateAnnotationMethod(DiagnosticPosition pos, MethodSymbol m) { for (Type sup = syms.annotationType; sup.tag == CLASS; sup = types.supertype(sup)) { diff --git a/src/share/classes/com/sun/tools/javac/comp/Flow.java b/src/share/classes/com/sun/tools/javac/comp/Flow.java index 1c199ea4..d58106e3 100644 --- a/src/share/classes/com/sun/tools/javac/comp/Flow.java +++ b/src/share/classes/com/sun/tools/javac/comp/Flow.java @@ -51,7 +51,7 @@ import static com.sun.tools.javac.code.TypeTags.*; * unassignment analysis ensures that no final variable is assigned * more than once. * - * <p>The second edition of the JLS has a number of problems in the + * <p>The JLS has a number of problems in the * specification of these flow analysis problems. This implementation * attempts to address those issues. * @@ -126,7 +126,7 @@ import static com.sun.tools.javac.code.TypeTags.*; * don't have to worry about the return expression because this * concept is only used for construcrors. * - * <p>There is no spec in JLS2 for when a variable is definitely + * <p>There is no spec in the JLS for when a variable is definitely * assigned at the end of a constructor, which is needed for final * fields (8.3.1.2). We implement the rule that V is DA at the end * of the constructor iff it is DA and the end of the body of the diff --git a/src/share/classes/com/sun/tools/javac/comp/Resolve.java b/src/share/classes/com/sun/tools/javac/comp/Resolve.java index 94ddd16f..6626cb45 100644 --- a/src/share/classes/com/sun/tools/javac/comp/Resolve.java +++ b/src/share/classes/com/sun/tools/javac/comp/Resolve.java @@ -346,7 +346,7 @@ public class Resolve { if (typeargtypes == null) typeargtypes = List.nil(); if (mt.tag != FORALL && typeargtypes.nonEmpty()) { // This is not a polymorphic method, but typeargs are supplied - // which is fine, see JLS3 15.12.2.1 + // which is fine, see JLS 15.12.2.1 } else if (mt.tag == FORALL && typeargtypes.nonEmpty()) { ForAll pmt = (ForAll) mt; if (typeargtypes.length() != pmt.tvars.length()) @@ -1769,7 +1769,7 @@ public class Resolve { /** * Resolve an appropriate implicit this instance for t's container. - * JLS2 8.8.5.1 and 15.9.2 + * JLS 8.8.5.1 and 15.9.2 */ Type resolveImplicitThis(DiagnosticPosition pos, Env<AttrContext> env, Type t) { return resolveImplicitThis(pos, env, t, false); diff --git a/src/share/classes/com/sun/tools/javac/jvm/Gen.java b/src/share/classes/com/sun/tools/javac/jvm/Gen.java index 55e1a9d5..bbde8d9e 100644 --- a/src/share/classes/com/sun/tools/javac/jvm/Gen.java +++ b/src/share/classes/com/sun/tools/javac/jvm/Gen.java @@ -283,7 +283,7 @@ public class Gen extends JCTree.Visitor { } // leave alone methods inherited from Object - // JLS2 13.1. + // JLS 13.1. if (sym.owner == syms.objectType.tsym) return sym; |