8223654: Clean up @jls references in com.sun.source

Reviewed-by: darcy
2019-05-10 13:37:00 -07:00 · 2019-05-10 13:37:00 -07:00 · 1772172053
commit 1772172053
parent 7aec6727ac
50 changed files with 76 additions and 50 deletions
--- a/src/jdk.compiler/share/classes/com/sun/source/tree/AnnotationTree.java
+++ b/src/jdk.compiler/share/classes/com/sun/source/tree/AnnotationTree.java
@ -36,7 +36,7 @@ import java.util.List;
 *    {@code @}<em>annotationType</em> ( <em>arguments</em> )
 * </pre>
 *
- * @jls section 9.7
+ * @jls 9.7 Annotations
 *
 * @author Peter von der Ah&eacute;
 * @author Jonathan Gibbons
--- a/src/jdk.compiler/share/classes/com/sun/source/tree/ArrayAccessTree.java
+++ b/src/jdk.compiler/share/classes/com/sun/source/tree/ArrayAccessTree.java
@ -33,7 +33,7 @@ package com.sun.source.tree;
 *   <em>expression</em> [ <em>index</em> ]
 * </pre>
 *
- * @jls section 15.13
+ * @jls 15.10.3 Array Access Expressions
 *
 * @author Peter von der Ah&eacute;
 * @author Jonathan Gibbons
--- a/src/jdk.compiler/share/classes/com/sun/source/tree/ArrayTypeTree.java
+++ b/src/jdk.compiler/share/classes/com/sun/source/tree/ArrayTypeTree.java
@ -33,7 +33,7 @@ package com.sun.source.tree;
 *   <em>type</em> []
 * </pre>
 *
- * @jls section 10.1
+ * @jls 10.1 Array Types
 *
 * @author Peter von der Ah&eacute;
 * @author Jonathan Gibbons
--- a/src/jdk.compiler/share/classes/com/sun/source/tree/AssertTree.java
+++ b/src/jdk.compiler/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>
 *
- * @jls section 14.10
+ * @jls 14.10 The assert Statement
 *
 * @author Peter von der Ah&eacute;
 * @author Jonathan Gibbons
--- a/src/jdk.compiler/share/classes/com/sun/source/tree/AssignmentTree.java
+++ b/src/jdk.compiler/share/classes/com/sun/source/tree/AssignmentTree.java
@ -33,7 +33,7 @@ package com.sun.source.tree;
 *   <em>variable</em> = <em>expression</em>
 * </pre>
 *
- * @jls section 15.26.1
+ * @jls 15.26.1 Simple Assignment Operator =
 *
 * @author Peter von der Ah&eacute;
 * @author Jonathan Gibbons
--- a/src/jdk.compiler/share/classes/com/sun/source/tree/BinaryTree.java
+++ b/src/jdk.compiler/share/classes/com/sun/source/tree/BinaryTree.java
@ -34,7 +34,14 @@ package com.sun.source.tree;
 *   <em>leftOperand</em> <em>operator</em> <em>rightOperand</em>
 * </pre>
 *
- * @jls sections 15.17 to 15.24
+ * @jls 15.17 Multiplicative Operators
+ * @jls 15.18 Additive Operators
+ * @jls 15.19 Shift Operators
+ * @jls 15.20 Relational Operators
+ * @jls 15.21 Equality Operators
+ * @jls 15.22 Bitwise and Logical Operators
+ * @jls 15.23 Conditional-And Operator &&
+ * @jls 15.24 Conditional-Or Operator ||
 *
 * @author Peter von der Ah&eacute;
 * @author Jonathan Gibbons
--- a/src/jdk.compiler/share/classes/com/sun/source/tree/BlockTree.java
+++ b/src/jdk.compiler/share/classes/com/sun/source/tree/BlockTree.java
@ -39,7 +39,7 @@ import java.util.List;
 *   static { <em>statements</em> }
 * </pre>
 *
- * @jls section 14.2
+ * @jls 14.2 Blocks
 *
 * @author Peter von der Ah&eacute;
 * @author Jonathan Gibbons
--- a/src/jdk.compiler/share/classes/com/sun/source/tree/BreakTree.java
+++ b/src/jdk.compiler/share/classes/com/sun/source/tree/BreakTree.java
@ -39,7 +39,7 @@ import javax.lang.model.element.Name;
 *   break <em>expression</em> ;
 * </pre>
 *
- * @jls section 14.15
+ * @jls 14.15 The break Statement
 *
 * @author Peter von der Ah&eacute;
 * @author Jonathan Gibbons
--- a/src/jdk.compiler/share/classes/com/sun/source/tree/CaseTree.java
+++ b/src/jdk.compiler/share/classes/com/sun/source/tree/CaseTree.java
@ -39,7 +39,7 @@ import java.util.List;
 *       <em>statements</em>
 * </pre>
 *
- * @jls section 14.11
+ * @jls 14.11 The switch Statement
 *
 * @author Peter von der Ah&eacute;
 * @author Jonathan Gibbons
--- a/src/jdk.compiler/share/classes/com/sun/source/tree/CatchTree.java
+++ b/src/jdk.compiler/share/classes/com/sun/source/tree/CatchTree.java
@ -34,7 +34,7 @@ package com.sun.source.tree;
 *       <em>block</em>
 * </pre>
 *
- * @jls section 14.20
+ * @jls 14.20 The try statement
 *
 * @author Peter von der Ah&eacute;
 * @author Jonathan Gibbons
--- a/src/jdk.compiler/share/classes/com/sun/source/tree/ClassTree.java
+++ b/src/jdk.compiler/share/classes/com/sun/source/tree/ClassTree.java
@ -42,7 +42,10 @@ import javax.lang.model.element.Name;
 *   }
 * </pre>
 *
- * @jls sections 8.1, 8.9, 9.1, and 9.6
+ * @jls 8.1 Class Declarations
+ * @jls 8.9 Enum Types
+ * @jls 9.1 Interface Declarations
+ * @jls 9.6 Annotation Types
 *
 * @author Peter von der Ah&eacute;
 * @author Jonathan Gibbons
--- a/src/jdk.compiler/share/classes/com/sun/source/tree/CompilationUnitTree.java
+++ b/src/jdk.compiler/share/classes/com/sun/source/tree/CompilationUnitTree.java
@ -32,7 +32,8 @@ import javax.tools.JavaFileObject;
 * Represents the abstract syntax tree for compilation units (source
 * files) and package declarations (package-info.java).
 *
- * @jls sections 7.3, and 7.4
+ * @jls 7.3 Compilation Units
+ * @jls 7.4 Package Declarations
 *
 * @author Peter von der Ah&eacute;
 * @since 1.6
--- a/src/jdk.compiler/share/classes/com/sun/source/tree/CompoundAssignmentTree.java
+++ b/src/jdk.compiler/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>
 *
- * @jls section 15.26.2
+ * @jls 15.26.2 Compound Assignment Operators
 *
 * @author Peter von der Ah&eacute;
 * @author Jonathan Gibbons
--- a/src/jdk.compiler/share/classes/com/sun/source/tree/ConditionalExpressionTree.java
+++ b/src/jdk.compiler/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>
 *
- * @jls section 15.25
+ * @jls 15.25 Conditional Operator ? :
 *
 * @author Peter von der Ah&eacute;
 * @author Jonathan Gibbons
--- a/src/jdk.compiler/share/classes/com/sun/source/tree/ContinueTree.java
+++ b/src/jdk.compiler/share/classes/com/sun/source/tree/ContinueTree.java
@ -36,7 +36,7 @@ import javax.lang.model.element.Name;
 *   continue <em>label</em> ;
 * </pre>
 *
- * @jls section 14.16
+ * @jls 14.16 The continue Statement
 *
 * @author Peter von der Ah&eacute;
 * @author Jonathan Gibbons
--- a/src/jdk.compiler/share/classes/com/sun/source/tree/DoWhileLoopTree.java
+++ b/src/jdk.compiler/share/classes/com/sun/source/tree/DoWhileLoopTree.java
@ -35,7 +35,7 @@ package com.sun.source.tree;
 *   while ( <em>expression</em> );
 * </pre>
 *
- * @jls section 14.13
+ * @jls 14.13 The do Statement
 *
 * @author Peter von der Ah&eacute;
 * @author Jonathan Gibbons
--- a/src/jdk.compiler/share/classes/com/sun/source/tree/EmptyStatementTree.java
+++ b/src/jdk.compiler/share/classes/com/sun/source/tree/EmptyStatementTree.java
@ -33,7 +33,7 @@ package com.sun.source.tree;
 *    ;
 * </pre>
 *
- * @jls section 14.6
+ * @jls 14.6 The Empty Statement
 *
 * @author Peter von der Ah&eacute;
 * @author Jonathan Gibbons
--- a/src/jdk.compiler/share/classes/com/sun/source/tree/EnhancedForLoopTree.java
+++ b/src/jdk.compiler/share/classes/com/sun/source/tree/EnhancedForLoopTree.java
@ -34,7 +34,7 @@ package com.sun.source.tree;
 *       <em>statement</em>
 * </pre>
 *
- * @jls section 14.14.2
+ * @jls 14.14.2 The enhanced for statement
 *
 * @author Peter von der Ah&eacute;
 * @author Jonathan Gibbons
--- a/src/jdk.compiler/share/classes/com/sun/source/tree/ExpressionStatementTree.java
+++ b/src/jdk.compiler/share/classes/com/sun/source/tree/ExpressionStatementTree.java
@ -33,7 +33,7 @@ package com.sun.source.tree;
 *   <em>expression</em> ;
 * </pre>
 *
- * @jls section 14.8
+ * @jls 14.8 Expression Statements
 *
 * @author Peter von der Ah&eacute;
 * @author Jonathan Gibbons
--- a/src/jdk.compiler/share/classes/com/sun/source/tree/ExpressionTree.java
+++ b/src/jdk.compiler/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.
 *
- * @jls chapter 15
+ * @jls 15 Expressions
 *
 * @author Peter von der Ah&eacute;
 * @author Jonathan Gibbons
--- a/src/jdk.compiler/share/classes/com/sun/source/tree/ForLoopTree.java
+++ b/src/jdk.compiler/share/classes/com/sun/source/tree/ForLoopTree.java
@ -36,7 +36,7 @@ import java.util.List;
 *       <em>statement</em>
 * </pre>
 *
- * @jls section 14.14.1
+ * @jls 14.14.1 The basic for Statement
 *
 * @author Peter von der Ah&eacute;
 * @author Jonathan Gibbons
--- a/src/jdk.compiler/share/classes/com/sun/source/tree/IdentifierTree.java
+++ b/src/jdk.compiler/share/classes/com/sun/source/tree/IdentifierTree.java
@ -35,7 +35,7 @@ import javax.lang.model.element.Name;
 *   <em>name</em>
 * </pre>
 *
- * @jls section 6.5.6.1
+ * @jls 6.5.6.1 Simple Expression Names
 *
 * @author Peter von der Ah&eacute;
 * @author Jonathan Gibbons
--- a/src/jdk.compiler/share/classes/com/sun/source/tree/IfTree.java
+++ b/src/jdk.compiler/share/classes/com/sun/source/tree/IfTree.java
@ -39,7 +39,7 @@ package com.sun.source.tree;
 *       <em>elseStatement</em>
 * </pre>
 *
- * @jls section 14.9
+ * @jls 14.9 The if Statement
 *
 * @author Peter von der Ah&eacute;
 * @author Jonathan Gibbons
--- a/src/jdk.compiler/share/classes/com/sun/source/tree/ImportTree.java
+++ b/src/jdk.compiler/share/classes/com/sun/source/tree/ImportTree.java
@ -35,7 +35,7 @@ package com.sun.source.tree;
 *   static import <em>qualifiedIdentifier</em> ;
 * </pre>
 *
- * @jls section 7.5
+ * @jls 7.5 Import Declarations
 *
 * @author Peter von der Ah&eacute;
 * @author Jonathan Gibbons
--- a/src/jdk.compiler/share/classes/com/sun/source/tree/InstanceOfTree.java
+++ b/src/jdk.compiler/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>
 *
- * @jls section 15.20.2
+ * @jls 15.20.2 Type Comparison Operator instanceof
 *
 * @author Peter von der Ah&eacute;
 * @author Jonathan Gibbons
--- a/src/jdk.compiler/share/classes/com/sun/source/tree/LabeledStatementTree.java
+++ b/src/jdk.compiler/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>
 *
- * @jls section 14.7
+ * @jls 14.7 Labeled Statements
 *
 * @author Peter von der Ah&eacute;
 * @author Jonathan Gibbons
--- a/src/jdk.compiler/share/classes/com/sun/source/tree/LiteralTree.java
+++ b/src/jdk.compiler/share/classes/com/sun/source/tree/LiteralTree.java
@ -34,7 +34,7 @@ package com.sun.source.tree;
 *   <em>value</em>
 * </pre>
 *
- * @jls section 15.28
+ * @jls 15.28 Constant Expressions
 *
 * @author Peter von der Ah&eacute;
 * @author Jonathan Gibbons
--- a/src/jdk.compiler/share/classes/com/sun/source/tree/MemberSelectTree.java
+++ b/src/jdk.compiler/share/classes/com/sun/source/tree/MemberSelectTree.java
@ -35,7 +35,9 @@ import javax.lang.model.element.Name;
 *   <em>expression</em> . <em>identifier</em>
 * </pre>
 *
- * @jls sections 6.5, 15.11,and 15.12
+ * @jls 6.5 Determining the Meaning of a Name
+ * @jls 15.11 Field Access Expressions
+ * @jls 15.12 Method Invocation Expressions
 *
 * @author Peter von der Ah&eacute;
 * @author Jonathan Gibbons
--- a/src/jdk.compiler/share/classes/com/sun/source/tree/MethodInvocationTree.java
+++ b/src/jdk.compiler/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>
 *
- * @jls section 15.12
+ * @jls 15.12 Method Invocation Expressions
 *
 * @author Peter von der Ah&eacute;
 * @author Jonathan Gibbons
--- a/src/jdk.compiler/share/classes/com/sun/source/tree/MethodTree.java
+++ b/src/jdk.compiler/share/classes/com/sun/source/tree/MethodTree.java
@ -40,7 +40,11 @@ import javax.lang.model.element.Name;
 *   <em>modifiers</em> <em>type</em> <em>name</em> () default <em>defaultValue</em>
 * </pre>
 *
- * @jls sections 8.4, 8.6, 8.7, 9.4, and 9.6
+ * @jls 8.4 Method Declarations
+ * @jls 8.6 Instance Initializers
+ * @jls 8.7 Static Initializers
+ * @jls 9.4 Method Declarations
+ * @jls 9.6.1 Annotation Type Elements
 *
 * @author Peter von der Ah&eacute;
 * @author Jonathan Gibbons
--- a/src/jdk.compiler/share/classes/com/sun/source/tree/ModifiersTree.java
+++ b/src/jdk.compiler/share/classes/com/sun/source/tree/ModifiersTree.java
@ -39,7 +39,13 @@ import javax.lang.model.element.Modifier;
 *   <em>flags</em> <em>annotations</em>
 * </pre>
 *
- * @jls sections 8.1.1, 8.3.1, 8.4.3, 8.5.1, 8.8.3, 9.1.1, and 9.7
+ * @jls 8.1.1 Class Modifiers
+ * @jls 8.3.1 Field Modifiers
+ * @jls 8.4.3 Method Modifiers
+ * @jls 8.5.1 Static Member Type Declarations
+ * @jls 8.8.3 Constructor Modifiers
+ * @jls 9.1.1 Interface Modifiers
+ * @jls 9.7   Annotations
 *
 * @author Peter von der Ah&eacute;
 * @author Jonathan Gibbons
--- a/src/jdk.compiler/share/classes/com/sun/source/tree/NewArrayTree.java
+++ b/src/jdk.compiler/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>
 *
- * @jls section 15.10
+ * @jls 15.10.1 Array Creation Expressions
 *
 * @author Peter von der Ah&eacute;
 * @author Jonathan Gibbons
--- a/src/jdk.compiler/share/classes/com/sun/source/tree/NewClassTree.java
+++ b/src/jdk.compiler/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>
 *
- * @jls section 15.9
+ * @jls 15.9 Class Instance Creation Expressions
 *
 * @author Peter von der Ah&eacute;
 * @author Jonathan Gibbons
--- a/src/jdk.compiler/share/classes/com/sun/source/tree/PackageTree.java
+++ b/src/jdk.compiler/share/classes/com/sun/source/tree/PackageTree.java
@ -30,7 +30,8 @@ import java.util.List;
 /**
 * Represents the package declaration.
 *
- * @jls sections 7.3, and 7.4
+ * @jls 7.3 Compilation Units
+ * @jls 7.4 Package Declarations
 *
 * @author Paul Govereau
 * @since 9
--- a/src/jdk.compiler/share/classes/com/sun/source/tree/ParameterizedTypeTree.java
+++ b/src/jdk.compiler/share/classes/com/sun/source/tree/ParameterizedTypeTree.java
@ -35,7 +35,7 @@ import java.util.List;
 *   <em>type</em> &lt; <em>typeArguments</em> &gt;
 * </pre>
 *
- * @jls section 4.5.1
+ * @jls 4.5.1 Type Arguments of Parameterized Types
 *
 * @author Peter von der Ah&eacute;
 * @author Jonathan Gibbons
--- a/src/jdk.compiler/share/classes/com/sun/source/tree/ParenthesizedTree.java
+++ b/src/jdk.compiler/share/classes/com/sun/source/tree/ParenthesizedTree.java
@ -34,7 +34,7 @@ package com.sun.source.tree;
 *   ( <em>expression</em> )
 * </pre>
 *
- * @jls section 15.8.5
+ * @jls 15.8.5 Parenthesized Expressions
 *
 * @author Peter von der Ah&eacute;
 * @author Jonathan Gibbons
--- a/src/jdk.compiler/share/classes/com/sun/source/tree/PrimitiveTypeTree.java
+++ b/src/jdk.compiler/share/classes/com/sun/source/tree/PrimitiveTypeTree.java
@ -35,7 +35,7 @@ import javax.lang.model.type.TypeKind;
 *   <em>primitiveTypeKind</em>
 * </pre>
 *
- * @jls section 4.2
+ * @jls 4.2 Primitive Types and Values
 *
 * @author Peter von der Ah&eacute;
 * @author Jonathan Gibbons
--- a/src/jdk.compiler/share/classes/com/sun/source/tree/ReturnTree.java
+++ b/src/jdk.compiler/share/classes/com/sun/source/tree/ReturnTree.java
@ -34,7 +34,7 @@ package com.sun.source.tree;
 *   return <em>expression</em>;
 * </pre>
 *
- * @jls section 14.17
+ * @jls 14.17 The return Statement
 *
 * @author Peter von der Ah&eacute;
 * @author Jonathan Gibbons
--- a/src/jdk.compiler/share/classes/com/sun/source/tree/StatementTree.java
+++ b/src/jdk.compiler/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.
 *
- * @jls chapter 14
+ * @jls 14 Blocks and Statements
 *
 * @author Peter von der Ah&eacute;
 * @author Jonathan Gibbons
--- a/src/jdk.compiler/share/classes/com/sun/source/tree/SwitchExpressionTree.java
+++ b/src/jdk.compiler/share/classes/com/sun/source/tree/SwitchExpressionTree.java
@ -37,7 +37,7 @@ import java.util.List;
 *   }
 * </pre>
 *
- * @jls section 15.29
+ * @jls 15.29 Switch Expressions
 *
 * @since 12
 *
--- a/src/jdk.compiler/share/classes/com/sun/source/tree/SwitchTree.java
+++ b/src/jdk.compiler/share/classes/com/sun/source/tree/SwitchTree.java
@ -37,7 +37,7 @@ import java.util.List;
 *   }
 * </pre>
 *
- * @jls section 14.11
+ * @jls 14.11 The switch Statement
 *
 * @author Peter von der Ah&eacute;
 * @author Jonathan Gibbons
--- a/src/jdk.compiler/share/classes/com/sun/source/tree/SynchronizedTree.java
+++ b/src/jdk.compiler/share/classes/com/sun/source/tree/SynchronizedTree.java
@ -34,7 +34,7 @@ package com.sun.source.tree;
 *       <em>block</em>
 * </pre>
 *
- * @jls section 14.19
+ * @jls 14.19 The synchronized Statement
 *
 * @author Peter von der Ah&eacute;
 * @author Jonathan Gibbons
--- a/src/jdk.compiler/share/classes/com/sun/source/tree/ThrowTree.java
+++ b/src/jdk.compiler/share/classes/com/sun/source/tree/ThrowTree.java
@ -33,7 +33,7 @@ package com.sun.source.tree;
 *   throw <em>expression</em>;
 * </pre>
 *
- * @jls section 14.18
+ * @jls 14.18 The throw Statement
 *
 * @author Peter von der Ah&eacute;
 * @author Jonathan Gibbons
--- a/src/jdk.compiler/share/classes/com/sun/source/tree/TryTree.java
+++ b/src/jdk.compiler/share/classes/com/sun/source/tree/TryTree.java
@ -39,7 +39,7 @@ import java.util.List;
 *       <em>finallyBlock</em>
 * </pre>
 *
- * @jls section 14.20
+ * @jls 14.20 The try statement
 *
 * @author Peter von der Ah&eacute;
 * @author Jonathan Gibbons
--- a/src/jdk.compiler/share/classes/com/sun/source/tree/TypeCastTree.java
+++ b/src/jdk.compiler/share/classes/com/sun/source/tree/TypeCastTree.java
@ -33,7 +33,7 @@ package com.sun.source.tree;
 *   ( <em>type</em> ) <em>expression</em>
 * </pre>
 *
- * @jls section 15.16
+ * @jls 15.16 Cast Expressions
 *
 * @author Peter von der Ah&eacute;
 * @author Jonathan Gibbons
--- a/src/jdk.compiler/share/classes/com/sun/source/tree/TypeParameterTree.java
+++ b/src/jdk.compiler/share/classes/com/sun/source/tree/TypeParameterTree.java
@ -40,7 +40,7 @@ import javax.lang.model.element.Name;
 *   <em>annotations</em> <em>name</em>
 * </pre>
 *
- * @jls section 4.4
+ * @jls 4.4 Type Variables
 *
 * @author Peter von der Ah&eacute;
 * @author Jonathan Gibbons
--- a/src/jdk.compiler/share/classes/com/sun/source/tree/UnaryTree.java
+++ b/src/jdk.compiler/share/classes/com/sun/source/tree/UnaryTree.java
@ -36,7 +36,8 @@ package com.sun.source.tree;
 *   <em>expression</em> <em>operator</em>
 * </pre>
 *
- * @jls sections 15.14 and 15.15
+ * @jls 15.14 Postfix Expressions
+ * @jls 15.15 Unary Operators
 *
 * @author Peter von der Ah&eacute;
 * @author Jonathan Gibbons
--- a/src/jdk.compiler/share/classes/com/sun/source/tree/VariableTree.java
+++ b/src/jdk.compiler/share/classes/com/sun/source/tree/VariableTree.java
@ -36,7 +36,8 @@ import javax.lang.model.element.Name;
 *   <em>modifiers</em> <em>type</em> <em>qualified-name</em>.this
 * </pre>
 *
- * @jls sections 8.3 and 14.4
+ * @jls 8.3 Field Declarations
+ * @jls 14.4 Local Variable Declaration Statements
 *
 * @author Peter von der Ah&eacute;
 * @author Jonathan Gibbons
--- a/src/jdk.compiler/share/classes/com/sun/source/tree/WhileLoopTree.java
+++ b/src/jdk.compiler/share/classes/com/sun/source/tree/WhileLoopTree.java
@ -35,7 +35,7 @@ package com.sun.source.tree;
 * </pre>
 *
 *
- * @jls section 14.12
+ * @jls 14.12 The while Statement
 *
 * @author Peter von der Ah&eacute;
 * @author Jonathan Gibbons
--- a/src/jdk.compiler/share/classes/com/sun/source/tree/WildcardTree.java
+++ b/src/jdk.compiler/share/classes/com/sun/source/tree/WildcardTree.java
@ -38,7 +38,7 @@ package com.sun.source.tree;
 *   ? super <em>bound</em>
 * </pre>
 *
- * @jls section 4.5.1
+ * @jls 4.5.1 Type Arguments of Parameterized Types
 *
 * @author Peter von der Ah&eacute;
 * @author Jonathan Gibbons