8223654: Clean up @jls references in com.sun.source
authorjjg
Fri, 10 May 2019 13:37:00 -0700
changeset 54817 ef73702a906e
parent 54816 b27f33bef884
child 54818 ea4774a27d9f
8223654: Clean up @jls references in com.sun.source Reviewed-by: darcy
src/jdk.compiler/share/classes/com/sun/source/tree/AnnotationTree.java
src/jdk.compiler/share/classes/com/sun/source/tree/ArrayAccessTree.java
src/jdk.compiler/share/classes/com/sun/source/tree/ArrayTypeTree.java
src/jdk.compiler/share/classes/com/sun/source/tree/AssertTree.java
src/jdk.compiler/share/classes/com/sun/source/tree/AssignmentTree.java
src/jdk.compiler/share/classes/com/sun/source/tree/BinaryTree.java
src/jdk.compiler/share/classes/com/sun/source/tree/BlockTree.java
src/jdk.compiler/share/classes/com/sun/source/tree/BreakTree.java
src/jdk.compiler/share/classes/com/sun/source/tree/CaseTree.java
src/jdk.compiler/share/classes/com/sun/source/tree/CatchTree.java
src/jdk.compiler/share/classes/com/sun/source/tree/ClassTree.java
src/jdk.compiler/share/classes/com/sun/source/tree/CompilationUnitTree.java
src/jdk.compiler/share/classes/com/sun/source/tree/CompoundAssignmentTree.java
src/jdk.compiler/share/classes/com/sun/source/tree/ConditionalExpressionTree.java
src/jdk.compiler/share/classes/com/sun/source/tree/ContinueTree.java
src/jdk.compiler/share/classes/com/sun/source/tree/DoWhileLoopTree.java
src/jdk.compiler/share/classes/com/sun/source/tree/EmptyStatementTree.java
src/jdk.compiler/share/classes/com/sun/source/tree/EnhancedForLoopTree.java
src/jdk.compiler/share/classes/com/sun/source/tree/ExpressionStatementTree.java
src/jdk.compiler/share/classes/com/sun/source/tree/ExpressionTree.java
src/jdk.compiler/share/classes/com/sun/source/tree/ForLoopTree.java
src/jdk.compiler/share/classes/com/sun/source/tree/IdentifierTree.java
src/jdk.compiler/share/classes/com/sun/source/tree/IfTree.java
src/jdk.compiler/share/classes/com/sun/source/tree/ImportTree.java
src/jdk.compiler/share/classes/com/sun/source/tree/InstanceOfTree.java
src/jdk.compiler/share/classes/com/sun/source/tree/LabeledStatementTree.java
src/jdk.compiler/share/classes/com/sun/source/tree/LiteralTree.java
src/jdk.compiler/share/classes/com/sun/source/tree/MemberSelectTree.java
src/jdk.compiler/share/classes/com/sun/source/tree/MethodInvocationTree.java
src/jdk.compiler/share/classes/com/sun/source/tree/MethodTree.java
src/jdk.compiler/share/classes/com/sun/source/tree/ModifiersTree.java
src/jdk.compiler/share/classes/com/sun/source/tree/NewArrayTree.java
src/jdk.compiler/share/classes/com/sun/source/tree/NewClassTree.java
src/jdk.compiler/share/classes/com/sun/source/tree/PackageTree.java
src/jdk.compiler/share/classes/com/sun/source/tree/ParameterizedTypeTree.java
src/jdk.compiler/share/classes/com/sun/source/tree/ParenthesizedTree.java
src/jdk.compiler/share/classes/com/sun/source/tree/PrimitiveTypeTree.java
src/jdk.compiler/share/classes/com/sun/source/tree/ReturnTree.java
src/jdk.compiler/share/classes/com/sun/source/tree/StatementTree.java
src/jdk.compiler/share/classes/com/sun/source/tree/SwitchExpressionTree.java
src/jdk.compiler/share/classes/com/sun/source/tree/SwitchTree.java
src/jdk.compiler/share/classes/com/sun/source/tree/SynchronizedTree.java
src/jdk.compiler/share/classes/com/sun/source/tree/ThrowTree.java
src/jdk.compiler/share/classes/com/sun/source/tree/TryTree.java
src/jdk.compiler/share/classes/com/sun/source/tree/TypeCastTree.java
src/jdk.compiler/share/classes/com/sun/source/tree/TypeParameterTree.java
src/jdk.compiler/share/classes/com/sun/source/tree/UnaryTree.java
src/jdk.compiler/share/classes/com/sun/source/tree/VariableTree.java
src/jdk.compiler/share/classes/com/sun/source/tree/WhileLoopTree.java
src/jdk.compiler/share/classes/com/sun/source/tree/WildcardTree.java
--- a/src/jdk.compiler/share/classes/com/sun/source/tree/AnnotationTree.java	Fri May 10 12:33:40 2019 -0700
+++ b/src/jdk.compiler/share/classes/com/sun/source/tree/AnnotationTree.java	Fri May 10 13:37:00 2019 -0700
@@ -36,7 +36,7 @@
  *    {@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	Fri May 10 12:33:40 2019 -0700
+++ b/src/jdk.compiler/share/classes/com/sun/source/tree/ArrayAccessTree.java	Fri May 10 13:37:00 2019 -0700
@@ -33,7 +33,7 @@
  *   <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	Fri May 10 12:33:40 2019 -0700
+++ b/src/jdk.compiler/share/classes/com/sun/source/tree/ArrayTypeTree.java	Fri May 10 13:37:00 2019 -0700
@@ -33,7 +33,7 @@
  *   <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	Fri May 10 12:33:40 2019 -0700
+++ b/src/jdk.compiler/share/classes/com/sun/source/tree/AssertTree.java	Fri May 10 13:37:00 2019 -0700
@@ -35,7 +35,7 @@
  *   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	Fri May 10 12:33:40 2019 -0700
+++ b/src/jdk.compiler/share/classes/com/sun/source/tree/AssignmentTree.java	Fri May 10 13:37:00 2019 -0700
@@ -33,7 +33,7 @@
  *   <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	Fri May 10 12:33:40 2019 -0700
+++ b/src/jdk.compiler/share/classes/com/sun/source/tree/BinaryTree.java	Fri May 10 13:37:00 2019 -0700
@@ -34,7 +34,14 @@
  *   <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	Fri May 10 12:33:40 2019 -0700
+++ b/src/jdk.compiler/share/classes/com/sun/source/tree/BlockTree.java	Fri May 10 13:37:00 2019 -0700
@@ -39,7 +39,7 @@
  *   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	Fri May 10 12:33:40 2019 -0700
+++ b/src/jdk.compiler/share/classes/com/sun/source/tree/BreakTree.java	Fri May 10 13:37:00 2019 -0700
@@ -39,7 +39,7 @@
  *   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	Fri May 10 12:33:40 2019 -0700
+++ b/src/jdk.compiler/share/classes/com/sun/source/tree/CaseTree.java	Fri May 10 13:37:00 2019 -0700
@@ -39,7 +39,7 @@
  *       <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	Fri May 10 12:33:40 2019 -0700
+++ b/src/jdk.compiler/share/classes/com/sun/source/tree/CatchTree.java	Fri May 10 13:37:00 2019 -0700
@@ -34,7 +34,7 @@
  *       <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	Fri May 10 12:33:40 2019 -0700
+++ b/src/jdk.compiler/share/classes/com/sun/source/tree/ClassTree.java	Fri May 10 13:37:00 2019 -0700
@@ -42,7 +42,10 @@
  *   }
  * </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	Fri May 10 12:33:40 2019 -0700
+++ b/src/jdk.compiler/share/classes/com/sun/source/tree/CompilationUnitTree.java	Fri May 10 13:37:00 2019 -0700
@@ -32,7 +32,8 @@
  * 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	Fri May 10 12:33:40 2019 -0700
+++ b/src/jdk.compiler/share/classes/com/sun/source/tree/CompoundAssignmentTree.java	Fri May 10 13:37:00 2019 -0700
@@ -34,7 +34,7 @@
  *   <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	Fri May 10 12:33:40 2019 -0700
+++ b/src/jdk.compiler/share/classes/com/sun/source/tree/ConditionalExpressionTree.java	Fri May 10 13:37:00 2019 -0700
@@ -33,7 +33,7 @@
  *   <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	Fri May 10 12:33:40 2019 -0700
+++ b/src/jdk.compiler/share/classes/com/sun/source/tree/ContinueTree.java	Fri May 10 13:37:00 2019 -0700
@@ -36,7 +36,7 @@
  *   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	Fri May 10 12:33:40 2019 -0700
+++ b/src/jdk.compiler/share/classes/com/sun/source/tree/DoWhileLoopTree.java	Fri May 10 13:37:00 2019 -0700
@@ -35,7 +35,7 @@
  *   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	Fri May 10 12:33:40 2019 -0700
+++ b/src/jdk.compiler/share/classes/com/sun/source/tree/EmptyStatementTree.java	Fri May 10 13:37:00 2019 -0700
@@ -33,7 +33,7 @@
  *    ;
  * </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	Fri May 10 12:33:40 2019 -0700
+++ b/src/jdk.compiler/share/classes/com/sun/source/tree/EnhancedForLoopTree.java	Fri May 10 13:37:00 2019 -0700
@@ -34,7 +34,7 @@
  *       <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	Fri May 10 12:33:40 2019 -0700
+++ b/src/jdk.compiler/share/classes/com/sun/source/tree/ExpressionStatementTree.java	Fri May 10 13:37:00 2019 -0700
@@ -33,7 +33,7 @@
  *   <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	Fri May 10 12:33:40 2019 -0700
+++ b/src/jdk.compiler/share/classes/com/sun/source/tree/ExpressionTree.java	Fri May 10 13:37:00 2019 -0700
@@ -29,7 +29,7 @@
  * 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	Fri May 10 12:33:40 2019 -0700
+++ b/src/jdk.compiler/share/classes/com/sun/source/tree/ForLoopTree.java	Fri May 10 13:37:00 2019 -0700
@@ -36,7 +36,7 @@
  *       <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	Fri May 10 12:33:40 2019 -0700
+++ b/src/jdk.compiler/share/classes/com/sun/source/tree/IdentifierTree.java	Fri May 10 13:37:00 2019 -0700
@@ -35,7 +35,7 @@
  *   <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	Fri May 10 12:33:40 2019 -0700
+++ b/src/jdk.compiler/share/classes/com/sun/source/tree/IfTree.java	Fri May 10 13:37:00 2019 -0700
@@ -39,7 +39,7 @@
  *       <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	Fri May 10 12:33:40 2019 -0700
+++ b/src/jdk.compiler/share/classes/com/sun/source/tree/ImportTree.java	Fri May 10 13:37:00 2019 -0700
@@ -35,7 +35,7 @@
  *   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	Fri May 10 12:33:40 2019 -0700
+++ b/src/jdk.compiler/share/classes/com/sun/source/tree/InstanceOfTree.java	Fri May 10 13:37:00 2019 -0700
@@ -33,7 +33,7 @@
  *   <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	Fri May 10 12:33:40 2019 -0700
+++ b/src/jdk.compiler/share/classes/com/sun/source/tree/LabeledStatementTree.java	Fri May 10 13:37:00 2019 -0700
@@ -35,7 +35,7 @@
  *   <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	Fri May 10 12:33:40 2019 -0700
+++ b/src/jdk.compiler/share/classes/com/sun/source/tree/LiteralTree.java	Fri May 10 13:37:00 2019 -0700
@@ -34,7 +34,7 @@
  *   <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	Fri May 10 12:33:40 2019 -0700
+++ b/src/jdk.compiler/share/classes/com/sun/source/tree/MemberSelectTree.java	Fri May 10 13:37:00 2019 -0700
@@ -35,7 +35,9 @@
  *   <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	Fri May 10 12:33:40 2019 -0700
+++ b/src/jdk.compiler/share/classes/com/sun/source/tree/MethodInvocationTree.java	Fri May 10 13:37:00 2019 -0700
@@ -37,7 +37,7 @@
  *   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	Fri May 10 12:33:40 2019 -0700
+++ b/src/jdk.compiler/share/classes/com/sun/source/tree/MethodTree.java	Fri May 10 13:37:00 2019 -0700
@@ -40,7 +40,11 @@
  *   <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	Fri May 10 12:33:40 2019 -0700
+++ b/src/jdk.compiler/share/classes/com/sun/source/tree/ModifiersTree.java	Fri May 10 13:37:00 2019 -0700
@@ -39,7 +39,13 @@
  *   <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	Fri May 10 12:33:40 2019 -0700
+++ b/src/jdk.compiler/share/classes/com/sun/source/tree/NewArrayTree.java	Fri May 10 13:37:00 2019 -0700
@@ -37,7 +37,7 @@
  *   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	Fri May 10 12:33:40 2019 -0700
+++ b/src/jdk.compiler/share/classes/com/sun/source/tree/NewClassTree.java	Fri May 10 13:37:00 2019 -0700
@@ -42,7 +42,7 @@
  *   <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	Fri May 10 12:33:40 2019 -0700
+++ b/src/jdk.compiler/share/classes/com/sun/source/tree/PackageTree.java	Fri May 10 13:37:00 2019 -0700
@@ -30,7 +30,8 @@
 /**
  * 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	Fri May 10 12:33:40 2019 -0700
+++ b/src/jdk.compiler/share/classes/com/sun/source/tree/ParameterizedTypeTree.java	Fri May 10 13:37:00 2019 -0700
@@ -35,7 +35,7 @@
  *   <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	Fri May 10 12:33:40 2019 -0700
+++ b/src/jdk.compiler/share/classes/com/sun/source/tree/ParenthesizedTree.java	Fri May 10 13:37:00 2019 -0700
@@ -34,7 +34,7 @@
  *   ( <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	Fri May 10 12:33:40 2019 -0700
+++ b/src/jdk.compiler/share/classes/com/sun/source/tree/PrimitiveTypeTree.java	Fri May 10 13:37:00 2019 -0700
@@ -35,7 +35,7 @@
  *   <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	Fri May 10 12:33:40 2019 -0700
+++ b/src/jdk.compiler/share/classes/com/sun/source/tree/ReturnTree.java	Fri May 10 13:37:00 2019 -0700
@@ -34,7 +34,7 @@
  *   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	Fri May 10 12:33:40 2019 -0700
+++ b/src/jdk.compiler/share/classes/com/sun/source/tree/StatementTree.java	Fri May 10 13:37:00 2019 -0700
@@ -29,7 +29,7 @@
  * 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	Fri May 10 12:33:40 2019 -0700
+++ b/src/jdk.compiler/share/classes/com/sun/source/tree/SwitchExpressionTree.java	Fri May 10 13:37:00 2019 -0700
@@ -37,7 +37,7 @@
  *   }
  * </pre>
  *
- * @jls section 15.29
+ * @jls 15.29 Switch Expressions
  *
  * @since 12
  *
--- a/src/jdk.compiler/share/classes/com/sun/source/tree/SwitchTree.java	Fri May 10 12:33:40 2019 -0700
+++ b/src/jdk.compiler/share/classes/com/sun/source/tree/SwitchTree.java	Fri May 10 13:37:00 2019 -0700
@@ -37,7 +37,7 @@
  *   }
  * </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	Fri May 10 12:33:40 2019 -0700
+++ b/src/jdk.compiler/share/classes/com/sun/source/tree/SynchronizedTree.java	Fri May 10 13:37:00 2019 -0700
@@ -34,7 +34,7 @@
  *       <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	Fri May 10 12:33:40 2019 -0700
+++ b/src/jdk.compiler/share/classes/com/sun/source/tree/ThrowTree.java	Fri May 10 13:37:00 2019 -0700
@@ -33,7 +33,7 @@
  *   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	Fri May 10 12:33:40 2019 -0700
+++ b/src/jdk.compiler/share/classes/com/sun/source/tree/TryTree.java	Fri May 10 13:37:00 2019 -0700
@@ -39,7 +39,7 @@
  *       <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	Fri May 10 12:33:40 2019 -0700
+++ b/src/jdk.compiler/share/classes/com/sun/source/tree/TypeCastTree.java	Fri May 10 13:37:00 2019 -0700
@@ -33,7 +33,7 @@
  *   ( <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	Fri May 10 12:33:40 2019 -0700
+++ b/src/jdk.compiler/share/classes/com/sun/source/tree/TypeParameterTree.java	Fri May 10 13:37:00 2019 -0700
@@ -40,7 +40,7 @@
  *   <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	Fri May 10 12:33:40 2019 -0700
+++ b/src/jdk.compiler/share/classes/com/sun/source/tree/UnaryTree.java	Fri May 10 13:37:00 2019 -0700
@@ -36,7 +36,8 @@
  *   <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	Fri May 10 12:33:40 2019 -0700
+++ b/src/jdk.compiler/share/classes/com/sun/source/tree/VariableTree.java	Fri May 10 13:37:00 2019 -0700
@@ -36,7 +36,8 @@
  *   <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	Fri May 10 12:33:40 2019 -0700
+++ b/src/jdk.compiler/share/classes/com/sun/source/tree/WhileLoopTree.java	Fri May 10 13:37:00 2019 -0700
@@ -35,7 +35,7 @@
  * </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	Fri May 10 12:33:40 2019 -0700
+++ b/src/jdk.compiler/share/classes/com/sun/source/tree/WildcardTree.java	Fri May 10 13:37:00 2019 -0700
@@ -38,7 +38,7 @@
  *   ? 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