7032975: API files in javax.annotation.processing need to be updated for references to JLS

7032972: API files in javax.tools need to updated for references to JVM Spec with editions/hyperlinks 7032978: API files in javax.tools need to be updated for references to JLS with editions/hyperlinks Removed URLs and 'edition' references Reviewed-by: jjg, darcy
2025-09-21 11:34:38 +02:00 · 2011-04-13 11:35:43 -07:00 · 2011-04-13 11:35:43 -07:00 · e9456bc9af
commit e9456bc9af
parent 02daeca60e
107 changed files with 184 additions and 171 deletions
--- a/langtools/src/share/classes/com/sun/source/tree/AnnotationTree.java
+++ b/langtools/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&eacute;
 * @author Jonathan Gibbons
--- a/langtools/src/share/classes/com/sun/source/tree/ArrayAccessTree.java
+++ b/langtools/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&eacute;
 * @author Jonathan Gibbons
--- a/langtools/src/share/classes/com/sun/source/tree/ArrayTypeTree.java
+++ b/langtools/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&eacute;
 * @author Jonathan Gibbons
--- a/langtools/src/share/classes/com/sun/source/tree/AssertTree.java
+++ b/langtools/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&eacute;
 * @author Jonathan Gibbons
--- a/langtools/src/share/classes/com/sun/source/tree/AssignmentTree.java
+++ b/langtools/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&eacute;
 * @author Jonathan Gibbons
--- a/langtools/src/share/classes/com/sun/source/tree/BinaryTree.java
+++ b/langtools/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&eacute;
 * @author Jonathan Gibbons
--- a/langtools/src/share/classes/com/sun/source/tree/BlockTree.java
+++ b/langtools/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&eacute;
 * @author Jonathan Gibbons
--- a/langtools/src/share/classes/com/sun/source/tree/BreakTree.java
+++ b/langtools/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&eacute;
 * @author Jonathan Gibbons
--- a/langtools/src/share/classes/com/sun/source/tree/CaseTree.java
+++ b/langtools/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&eacute;
 * @author Jonathan Gibbons
--- a/langtools/src/share/classes/com/sun/source/tree/CatchTree.java
+++ b/langtools/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&eacute;
 * @author Jonathan Gibbons
--- a/langtools/src/share/classes/com/sun/source/tree/ClassTree.java
+++ b/langtools/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&eacute;
 * @author Jonathan Gibbons
--- a/langtools/src/share/classes/com/sun/source/tree/CompilationUnitTree.java
+++ b/langtools/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&eacute;
 * @since 1.6
--- a/langtools/src/share/classes/com/sun/source/tree/CompoundAssignmentTree.java
+++ b/langtools/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&eacute;
 * @author Jonathan Gibbons
--- a/langtools/src/share/classes/com/sun/source/tree/ConditionalExpressionTree.java
+++ b/langtools/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&eacute;
 * @author Jonathan Gibbons
--- a/langtools/src/share/classes/com/sun/source/tree/ContinueTree.java
+++ b/langtools/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&eacute;
 * @author Jonathan Gibbons
--- a/langtools/src/share/classes/com/sun/source/tree/DoWhileLoopTree.java
+++ b/langtools/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&eacute;
 * @author Jonathan Gibbons
--- a/langtools/src/share/classes/com/sun/source/tree/EmptyStatementTree.java
+++ b/langtools/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&eacute;
 * @author Jonathan Gibbons
--- a/langtools/src/share/classes/com/sun/source/tree/EnhancedForLoopTree.java
+++ b/langtools/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&eacute;
 * @author Jonathan Gibbons
--- a/langtools/src/share/classes/com/sun/source/tree/ExpressionStatementTree.java
+++ b/langtools/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&eacute;
 * @author Jonathan Gibbons
--- a/langtools/src/share/classes/com/sun/source/tree/ExpressionTree.java
+++ b/langtools/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&eacute;
 * @author Jonathan Gibbons
--- a/langtools/src/share/classes/com/sun/source/tree/ForLoopTree.java
+++ b/langtools/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&eacute;
 * @author Jonathan Gibbons
--- a/langtools/src/share/classes/com/sun/source/tree/IdentifierTree.java
+++ b/langtools/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&eacute;
 * @author Jonathan Gibbons
--- a/langtools/src/share/classes/com/sun/source/tree/IfTree.java
+++ b/langtools/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&eacute;
 * @author Jonathan Gibbons
--- a/langtools/src/share/classes/com/sun/source/tree/ImportTree.java
+++ b/langtools/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&eacute;
 * @author Jonathan Gibbons
--- a/langtools/src/share/classes/com/sun/source/tree/InstanceOfTree.java
+++ b/langtools/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&eacute;
 * @author Jonathan Gibbons
--- a/langtools/src/share/classes/com/sun/source/tree/LabeledStatementTree.java
+++ b/langtools/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&eacute;
 * @author Jonathan Gibbons
--- a/langtools/src/share/classes/com/sun/source/tree/LiteralTree.java
+++ b/langtools/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&eacute;
 * @author Jonathan Gibbons
--- a/langtools/src/share/classes/com/sun/source/tree/MemberSelectTree.java
+++ b/langtools/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&eacute;
 * @author Jonathan Gibbons
--- a/langtools/src/share/classes/com/sun/source/tree/MethodInvocationTree.java
+++ b/langtools/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&eacute;
 * @author Jonathan Gibbons
--- a/langtools/src/share/classes/com/sun/source/tree/MethodTree.java
+++ b/langtools/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&eacute;
 * @author Jonathan Gibbons
--- a/langtools/src/share/classes/com/sun/source/tree/ModifiersTree.java
+++ b/langtools/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&eacute;
 * @author Jonathan Gibbons
--- a/langtools/src/share/classes/com/sun/source/tree/NewArrayTree.java
+++ b/langtools/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&eacute;
 * @author Jonathan Gibbons
--- a/langtools/src/share/classes/com/sun/source/tree/NewClassTree.java
+++ b/langtools/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&eacute;
 * @author Jonathan Gibbons
--- a/langtools/src/share/classes/com/sun/source/tree/ParameterizedTypeTree.java
+++ b/langtools/src/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>
 *
- * @see "The Java Language Specification, 3rd ed, section 4.5.1"
+ * @jls section 4.5.1
 *
 * @author Peter von der Ah&eacute;
 * @author Jonathan Gibbons
--- a/langtools/src/share/classes/com/sun/source/tree/ParenthesizedTree.java
+++ b/langtools/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&eacute;
 * @author Jonathan Gibbons
--- a/langtools/src/share/classes/com/sun/source/tree/PrimitiveTypeTree.java
+++ b/langtools/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&eacute;
 * @author Jonathan Gibbons
--- a/langtools/src/share/classes/com/sun/source/tree/ReturnTree.java
+++ b/langtools/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&eacute;
 * @author Jonathan Gibbons
--- a/langtools/src/share/classes/com/sun/source/tree/StatementTree.java
+++ b/langtools/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&eacute;
 * @author Jonathan Gibbons
--- a/langtools/src/share/classes/com/sun/source/tree/SwitchTree.java
+++ b/langtools/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&eacute;
 * @author Jonathan Gibbons
--- a/langtools/src/share/classes/com/sun/source/tree/SynchronizedTree.java
+++ b/langtools/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&eacute;
 * @author Jonathan Gibbons
--- a/langtools/src/share/classes/com/sun/source/tree/ThrowTree.java
+++ b/langtools/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&eacute;
 * @author Jonathan Gibbons
--- a/langtools/src/share/classes/com/sun/source/tree/TryTree.java
+++ b/langtools/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&eacute;
 * @author Jonathan Gibbons
--- a/langtools/src/share/classes/com/sun/source/tree/TypeCastTree.java
+++ b/langtools/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&eacute;
 * @author Jonathan Gibbons
--- a/langtools/src/share/classes/com/sun/source/tree/TypeParameterTree.java
+++ b/langtools/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&eacute;
 * @author Jonathan Gibbons
--- a/langtools/src/share/classes/com/sun/source/tree/UnaryTree.java
+++ b/langtools/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&eacute;
 * @author Jonathan Gibbons
--- a/langtools/src/share/classes/com/sun/source/tree/VariableTree.java
+++ b/langtools/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&eacute;
 * @author Jonathan Gibbons
--- a/langtools/src/share/classes/com/sun/source/tree/WhileLoopTree.java
+++ b/langtools/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&eacute;
 * @author Jonathan Gibbons
--- a/langtools/src/share/classes/com/sun/source/tree/WildcardTree.java
+++ b/langtools/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&eacute;
 * @author Jonathan Gibbons