Mercurial > jdk8-mips64-public > langtools / changeset

     1.1 --- a/make/build.properties	Tue Apr 12 20:58:06 2011 -0700
     1.2 +++ b/make/build.properties	Wed Apr 13 11:35:43 2011 -0700
     1.3 @@ -71,9 +71,18 @@
     1.4  javac.lint.opts = -Xlint:all,-deprecation -Werror
     1.5  
     1.6  # options for the <javadoc> task for javac
     1.7 -javadoc.jls3.url=http://java.sun.com/docs/books/jls/
     1.8 -javadoc.jls3.cite=&lt;a href=&quot;${javadoc.jls3.url}&quot;&gt;The Java Language Specification, Third Edition&lt;/a&gt;
     1.9 -javadoc.jls3.option=-tag "jls3:a:See &lt;cite&gt;${javadoc.jls3.cite}&lt;/cite&gt;:"
    1.10 +#javadoc.jls3.url=http://java.sun.com/docs/books/jls/
    1.11 +#javadoc.jls3.cite=&lt;a href=&quot;${javadoc.jls3.url}&quot;&gt;The Java Language Specification, Third Edition&lt;/a&gt;
    1.12 +#javadoc.jls3.option=-tag "jls3:a:See &lt;cite&gt;${javadoc.jls3.cite}&lt;/cite&gt;:"
    1.13 +
    1.14 +
    1.15 +javadoc.jls.cite=The Java&trade; Language Specification
    1.16 +
    1.17 +javadoc.jls.option=-tag "jls:a:See &lt;cite&gt;${javadoc.jls.cite}&lt;/cite&gt;:"
    1.18 +
    1.19 +
    1.20 +
    1.21 +
    1.22  
    1.23  # jtreg, used to run the JDK regression tests
    1.24  # See http://openjdk.java.net/jtreg/

     2.1 --- a/make/build.xml	Tue Apr 12 20:58:06 2011 -0700
     2.2 +++ b/make/build.xml	Wed Apr 13 11:35:43 2011 -0700
     2.3 @@ -464,7 +464,7 @@
     2.4      </target>
     2.5  
     2.6      <target name="javadoc-javac" depends="build-javac,-def-javadoc-tool">
     2.7 -        <javadoc-tool name="javac" includes="${javac.includes}" options="${javadoc.jls3.option}"/>
     2.8 +        <javadoc-tool name="javac" includes="${javac.includes}" options="${javadoc.jls.option}"/>
     2.9      </target>
    2.10  
    2.11      <target name="jtreg-javac" depends="build-javac,build-javap,-def-jtreg">

     3.1 --- a/src/share/classes/com/sun/javadoc/ClassDoc.java	Tue Apr 12 20:58:06 2011 -0700
     3.2 +++ b/src/share/classes/com/sun/javadoc/ClassDoc.java	Wed Apr 13 11:35:43 2011 -0700
     3.3 @@ -311,8 +311,8 @@
     3.4  
     3.5      /**
     3.6       * Get the list of classes and interfaces declared as imported.
     3.7 -     * These are called "single-type-import declarations" in the
     3.8 -     * Java Language Specification.
     3.9 +     * These are called "single-type-import declarations" in
    3.10 +     * <cite>The Java&trade; Language Specification</cite>.
    3.11       *
    3.12       * @return an array of ClassDoc representing the imported classes.
    3.13       *
    3.14 @@ -325,8 +325,8 @@
    3.15  
    3.16      /**
    3.17       * Get the list of packages declared as imported.
    3.18 -     * These are called "type-import-on-demand declarations" in the
    3.19 -     * Java Language Specification.
    3.20 +     * These are called "type-import-on-demand declarations" in
    3.21 +     * <cite>The Java&trade; Language Specification</cite>.
    3.22       *
    3.23       * @return an array of PackageDoc representing the imported packages.
    3.24       *

     4.1 --- a/src/share/classes/com/sun/source/tree/AnnotationTree.java	Tue Apr 12 20:58:06 2011 -0700
     4.2 +++ b/src/share/classes/com/sun/source/tree/AnnotationTree.java	Wed Apr 13 11:35:43 2011 -0700
     4.3 @@ -36,7 +36,7 @@
     4.4   *    {@code @}<em>annotationType</em> ( <em>arguments</em> )
     4.5   * </pre>
     4.6   *
     4.7 - * @see "The Java Language Specification, 3rd ed, section 9.7"
     4.8 + * @jls section 9.7
     4.9   *
    4.10   * @author Peter von der Ah&eacute;
    4.11   * @author Jonathan Gibbons

     5.1 --- a/src/share/classes/com/sun/source/tree/ArrayAccessTree.java	Tue Apr 12 20:58:06 2011 -0700
     5.2 +++ b/src/share/classes/com/sun/source/tree/ArrayAccessTree.java	Wed Apr 13 11:35:43 2011 -0700
     5.3 @@ -33,7 +33,7 @@
     5.4   *   <em>expression</em> [ <em>index</em> ]
     5.5   * </pre>
     5.6   *
     5.7 - * @see "The Java Language Specification, 3rd ed, section 15.13"
     5.8 + * @jls section 15.13
     5.9   *
    5.10   * @author Peter von der Ah&eacute;
    5.11   * @author Jonathan Gibbons

     6.1 --- a/src/share/classes/com/sun/source/tree/ArrayTypeTree.java	Tue Apr 12 20:58:06 2011 -0700
     6.2 +++ b/src/share/classes/com/sun/source/tree/ArrayTypeTree.java	Wed Apr 13 11:35:43 2011 -0700
     6.3 @@ -33,7 +33,7 @@
     6.4   *   <em>type</em> []
     6.5   * </pre>
     6.6   *
     6.7 - * @see "The Java Language Specification, 3rd ed, section 10.1"
     6.8 + * @jls section 10.1
     6.9   *
    6.10   * @author Peter von der Ah&eacute;
    6.11   * @author Jonathan Gibbons

     7.1 --- a/src/share/classes/com/sun/source/tree/AssertTree.java	Tue Apr 12 20:58:06 2011 -0700
     7.2 +++ b/src/share/classes/com/sun/source/tree/AssertTree.java	Wed Apr 13 11:35:43 2011 -0700
     7.3 @@ -35,7 +35,7 @@
     7.4   *   assert <em>condition</em> : <em>detail</em> ;
     7.5   * </pre>
     7.6   *
     7.7 - * @see "The Java Language Specification, 3rd ed, section 14.10"
     7.8 + * @jls section 14.10
     7.9   *
    7.10   * @author Peter von der Ah&eacute;
    7.11   * @author Jonathan Gibbons

     8.1 --- a/src/share/classes/com/sun/source/tree/AssignmentTree.java	Tue Apr 12 20:58:06 2011 -0700
     8.2 +++ b/src/share/classes/com/sun/source/tree/AssignmentTree.java	Wed Apr 13 11:35:43 2011 -0700
     8.3 @@ -33,7 +33,7 @@
     8.4   *   <em>variable</em> = <em>expression</em>
     8.5   * </pre>
     8.6   *
     8.7 - * @see "The Java Language Specification, 3rd ed, section 15.26.1"
     8.8 + * @jls section 15.26.1
     8.9   *
    8.10   * @author Peter von der Ah&eacute;
    8.11   * @author Jonathan Gibbons

     9.1 --- a/src/share/classes/com/sun/source/tree/BinaryTree.java	Tue Apr 12 20:58:06 2011 -0700
     9.2 +++ b/src/share/classes/com/sun/source/tree/BinaryTree.java	Wed Apr 13 11:35:43 2011 -0700
     9.3 @@ -34,7 +34,7 @@
     9.4   *   <em>leftOperand</em> <em>operator</em> <em>rightOperand</em>
     9.5   * </pre>
     9.6   *
     9.7 - * @see "The Java Language Specification, 3rd ed, sections 15.17 to 15.24"
     9.8 + * @jls sections 15.17 to 15.24
     9.9   *
    9.10   * @author Peter von der Ah&eacute;
    9.11   * @author Jonathan Gibbons

    10.1 --- a/src/share/classes/com/sun/source/tree/BlockTree.java	Tue Apr 12 20:58:06 2011 -0700
    10.2 +++ b/src/share/classes/com/sun/source/tree/BlockTree.java	Wed Apr 13 11:35:43 2011 -0700
    10.3 @@ -39,7 +39,7 @@
    10.4   *   static { <em>statements</em> }
    10.5   * </pre>
    10.6   *
    10.7 - * @see "The Java Language Specification, 3rd ed, section 14.2"
    10.8 + * @jls section 14.2
    10.9   *
   10.10   * @author Peter von der Ah&eacute;
   10.11   * @author Jonathan Gibbons

    11.1 --- a/src/share/classes/com/sun/source/tree/BreakTree.java	Tue Apr 12 20:58:06 2011 -0700
    11.2 +++ b/src/share/classes/com/sun/source/tree/BreakTree.java	Wed Apr 13 11:35:43 2011 -0700
    11.3 @@ -37,7 +37,7 @@
    11.4   *   break <em>label</em> ;
    11.5   * </pre>
    11.6   *
    11.7 - * @see "The Java Language Specification, 3rd ed, section 14.15"
    11.8 + * @jls section 14.15
    11.9   *
   11.10   * @author Peter von der Ah&eacute;
   11.11   * @author Jonathan Gibbons

    12.1 --- a/src/share/classes/com/sun/source/tree/CaseTree.java	Tue Apr 12 20:58:06 2011 -0700
    12.2 +++ b/src/share/classes/com/sun/source/tree/CaseTree.java	Wed Apr 13 11:35:43 2011 -0700
    12.3 @@ -39,7 +39,7 @@
    12.4   *       <em>statements</em>
    12.5   * </pre>
    12.6   *
    12.7 - * @see "The Java Language Specification, 3rd ed, section 14.11"
    12.8 + * @jls section 14.11
    12.9   *
   12.10   * @author Peter von der Ah&eacute;
   12.11   * @author Jonathan Gibbons

    13.1 --- a/src/share/classes/com/sun/source/tree/CatchTree.java	Tue Apr 12 20:58:06 2011 -0700
    13.2 +++ b/src/share/classes/com/sun/source/tree/CatchTree.java	Wed Apr 13 11:35:43 2011 -0700
    13.3 @@ -34,7 +34,7 @@
    13.4   *       <em>block</em>
    13.5   * </pre>
    13.6   *
    13.7 - * @see "The Java Language Specification, 3rd ed, section 14.20"
    13.8 + * @jls section 14.20
    13.9   *
   13.10   * @author Peter von der Ah&eacute;
   13.11   * @author Jonathan Gibbons

    14.1 --- a/src/share/classes/com/sun/source/tree/ClassTree.java	Tue Apr 12 20:58:06 2011 -0700
    14.2 +++ b/src/share/classes/com/sun/source/tree/ClassTree.java	Wed Apr 13 11:35:43 2011 -0700
    14.3 @@ -42,8 +42,7 @@
    14.4   *   }
    14.5   * </pre>
    14.6   *
    14.7 - * @see "The Java Language Specification, 3rd ed,
    14.8 - * sections 8.1, 8.9, 9.1, and 9.6"
    14.9 + * @jls sections 8.1, 8.9, 9.1, and 9.6
   14.10   *
   14.11   * @author Peter von der Ah&eacute;
   14.12   * @author Jonathan Gibbons

    15.1 --- a/src/share/classes/com/sun/source/tree/CompilationUnitTree.java	Tue Apr 12 20:58:06 2011 -0700
    15.2 +++ b/src/share/classes/com/sun/source/tree/CompilationUnitTree.java	Wed Apr 13 11:35:43 2011 -0700
    15.3 @@ -33,7 +33,7 @@
    15.4   * Represents the abstract syntax tree for compilation units (source
    15.5   * files) and package declarations (package-info.java).
    15.6   *
    15.7 - * @see "The Java Language Specification, 3rd ed, sections 7.3, and 7.4"
    15.8 + * @jls sections 7.3, and 7.4
    15.9   *
   15.10   * @author Peter von der Ahé
   15.11   * @since 1.6

    16.1 --- a/src/share/classes/com/sun/source/tree/CompoundAssignmentTree.java	Tue Apr 12 20:58:06 2011 -0700
    16.2 +++ b/src/share/classes/com/sun/source/tree/CompoundAssignmentTree.java	Wed Apr 13 11:35:43 2011 -0700
    16.3 @@ -34,7 +34,7 @@
    16.4   *   <em>variable</em> <em>operator</em> <em>expression</em>
    16.5   * </pre>
    16.6   *
    16.7 - * @see "The Java Language Specification, 3rd ed, section 15.26.2"
    16.8 + * @jls section 15.26.2
    16.9   *
   16.10   * @author Peter von der Ah&eacute;
   16.11   * @author Jonathan Gibbons

    17.1 --- a/src/share/classes/com/sun/source/tree/ConditionalExpressionTree.java	Tue Apr 12 20:58:06 2011 -0700
    17.2 +++ b/src/share/classes/com/sun/source/tree/ConditionalExpressionTree.java	Wed Apr 13 11:35:43 2011 -0700
    17.3 @@ -33,7 +33,7 @@
    17.4   *   <em>condition</em> ? <em>trueExpression</em> : <em>falseExpression</em>
    17.5   * </pre>
    17.6   *
    17.7 - * @see "The Java Language Specification, 3rd ed, section 15.25"
    17.8 + * @jls section 15.25
    17.9   *
   17.10   * @author Peter von der Ah&eacute;
   17.11   * @author Jonathan Gibbons

    18.1 --- a/src/share/classes/com/sun/source/tree/ContinueTree.java	Tue Apr 12 20:58:06 2011 -0700
    18.2 +++ b/src/share/classes/com/sun/source/tree/ContinueTree.java	Wed Apr 13 11:35:43 2011 -0700
    18.3 @@ -36,7 +36,7 @@
    18.4   *   continue <em>label</em> ;
    18.5   * </pre>
    18.6   *
    18.7 - * @see "The Java Language Specification, 3rd ed, section 14.16"
    18.8 + * @jls section 14.16
    18.9   *
   18.10   * @author Peter von der Ah&eacute;
   18.11   * @author Jonathan Gibbons

    19.1 --- a/src/share/classes/com/sun/source/tree/DoWhileLoopTree.java	Tue Apr 12 20:58:06 2011 -0700
    19.2 +++ b/src/share/classes/com/sun/source/tree/DoWhileLoopTree.java	Wed Apr 13 11:35:43 2011 -0700
    19.3 @@ -35,7 +35,7 @@
    19.4   *   while ( <em>expression</em> );
    19.5   * </pre>
    19.6   *
    19.7 - * @see "The Java Language Specification, 3rd ed, section 14.13"
    19.8 + * @jls section 14.13
    19.9   *
   19.10   * @author Peter von der Ah&eacute;
   19.11   * @author Jonathan Gibbons

    20.1 --- a/src/share/classes/com/sun/source/tree/EmptyStatementTree.java	Tue Apr 12 20:58:06 2011 -0700
    20.2 +++ b/src/share/classes/com/sun/source/tree/EmptyStatementTree.java	Wed Apr 13 11:35:43 2011 -0700
    20.3 @@ -33,7 +33,7 @@
    20.4   *    ;
    20.5   * </pre>
    20.6   *
    20.7 - * @see "The Java Language Specification, 3rd ed, section 14.6"
    20.8 + * @jls section 14.6
    20.9   *
   20.10   * @author Peter von der Ah&eacute;
   20.11   * @author Jonathan Gibbons

    21.1 --- a/src/share/classes/com/sun/source/tree/EnhancedForLoopTree.java	Tue Apr 12 20:58:06 2011 -0700
    21.2 +++ b/src/share/classes/com/sun/source/tree/EnhancedForLoopTree.java	Wed Apr 13 11:35:43 2011 -0700
    21.3 @@ -34,7 +34,7 @@
    21.4   *       <em>statement</em>
    21.5   * </pre>
    21.6   *
    21.7 - * @see "The Java Language Specification, 3rd ed, section 14.14.2"
    21.8 + * @jls section 14.14.2
    21.9   *
   21.10   * @author Peter von der Ah&eacute;
   21.11   * @author Jonathan Gibbons

    22.1 --- a/src/share/classes/com/sun/source/tree/ExpressionStatementTree.java	Tue Apr 12 20:58:06 2011 -0700
    22.2 +++ b/src/share/classes/com/sun/source/tree/ExpressionStatementTree.java	Wed Apr 13 11:35:43 2011 -0700
    22.3 @@ -33,7 +33,7 @@
    22.4   *   <em>expression</em> ;
    22.5   * </pre>
    22.6   *
    22.7 - * @see "The Java Language Specification, 3rd ed, section 14.8"
    22.8 + * @jls section 14.8
    22.9   *
   22.10   * @author Peter von der Ah&eacute;
   22.11   * @author Jonathan Gibbons

    23.1 --- a/src/share/classes/com/sun/source/tree/ExpressionTree.java	Tue Apr 12 20:58:06 2011 -0700
    23.2 +++ b/src/share/classes/com/sun/source/tree/ExpressionTree.java	Wed Apr 13 11:35:43 2011 -0700
    23.3 @@ -29,7 +29,7 @@
    23.4   * A tree node used as the base class for the different types of
    23.5   * expressions.
    23.6   *
    23.7 - * @see "The Java Language Specification, 3rd ed, chapter 15"
    23.8 + * @jls chapter 15
    23.9   *
   23.10   * @author Peter von der Ahé
   23.11   * @author Jonathan Gibbons

    24.1 --- a/src/share/classes/com/sun/source/tree/ForLoopTree.java	Tue Apr 12 20:58:06 2011 -0700
    24.2 +++ b/src/share/classes/com/sun/source/tree/ForLoopTree.java	Wed Apr 13 11:35:43 2011 -0700
    24.3 @@ -36,7 +36,7 @@
    24.4   *       <em>statement</em>
    24.5   * </pre>
    24.6   *
    24.7 - * @see "The Java Language Specification, 3rd ed, section 14.14.1"
    24.8 + * @jls section 14.14.1
    24.9   *
   24.10   * @author Peter von der Ah&eacute;
   24.11   * @author Jonathan Gibbons

    25.1 --- a/src/share/classes/com/sun/source/tree/IdentifierTree.java	Tue Apr 12 20:58:06 2011 -0700
    25.2 +++ b/src/share/classes/com/sun/source/tree/IdentifierTree.java	Wed Apr 13 11:35:43 2011 -0700
    25.3 @@ -35,7 +35,7 @@
    25.4   *   <em>name</em>
    25.5   * </pre>
    25.6   *
    25.7 - * @see "The Java Language Specification, 3rd ed, section 6.5.6.1"
    25.8 + * @jls section 6.5.6.1
    25.9   *
   25.10   * @author Peter von der Ah&eacute;
   25.11   * @author Jonathan Gibbons

    26.1 --- a/src/share/classes/com/sun/source/tree/IfTree.java	Tue Apr 12 20:58:06 2011 -0700
    26.2 +++ b/src/share/classes/com/sun/source/tree/IfTree.java	Wed Apr 13 11:35:43 2011 -0700
    26.3 @@ -39,7 +39,7 @@
    26.4   *       <em>elseStatement</em>
    26.5   * </pre>
    26.6   *
    26.7 - * @see "The Java Language Specification, 3rd ed, section 14.9"
    26.8 + * @jls section 14.9
    26.9   *
   26.10   * @author Peter von der Ah&eacute;
   26.11   * @author Jonathan Gibbons

    27.1 --- a/src/share/classes/com/sun/source/tree/ImportTree.java	Tue Apr 12 20:58:06 2011 -0700
    27.2 +++ b/src/share/classes/com/sun/source/tree/ImportTree.java	Wed Apr 13 11:35:43 2011 -0700
    27.3 @@ -35,7 +35,7 @@
    27.4   *   static import <em>qualifiedIdentifier</em> ;
    27.5   * </pre>
    27.6   *
    27.7 - * @see "The Java Language Specification, 3rd ed, section 7.5"
    27.8 + * @jls section 7.5
    27.9   *
   27.10   * @author Peter von der Ah&eacute;
   27.11   * @author Jonathan Gibbons

    28.1 --- a/src/share/classes/com/sun/source/tree/InstanceOfTree.java	Tue Apr 12 20:58:06 2011 -0700
    28.2 +++ b/src/share/classes/com/sun/source/tree/InstanceOfTree.java	Wed Apr 13 11:35:43 2011 -0700
    28.3 @@ -33,7 +33,7 @@
    28.4   *   <em>expression</em> instanceof <em>type</em>
    28.5   * </pre>
    28.6   *
    28.7 - * @see "The Java Language Specification, 3rd ed, section 15.20.2"
    28.8 + * @jls section 15.20.2
    28.9   *
   28.10   * @author Peter von der Ah&eacute;
   28.11   * @author Jonathan Gibbons

    29.1 --- a/src/share/classes/com/sun/source/tree/LabeledStatementTree.java	Tue Apr 12 20:58:06 2011 -0700
    29.2 +++ b/src/share/classes/com/sun/source/tree/LabeledStatementTree.java	Wed Apr 13 11:35:43 2011 -0700
    29.3 @@ -35,7 +35,7 @@
    29.4   *   <em>label</em> : <em>statement</em>
    29.5   * </pre>
    29.6   *
    29.7 - * @see "The Java Language Specification, 3rd ed, section 14.7"
    29.8 + * @jls section 14.7
    29.9   *
   29.10   * @author Peter von der Ah&eacute;
   29.11   * @author Jonathan Gibbons

    30.1 --- a/src/share/classes/com/sun/source/tree/LiteralTree.java	Tue Apr 12 20:58:06 2011 -0700
    30.2 +++ b/src/share/classes/com/sun/source/tree/LiteralTree.java	Wed Apr 13 11:35:43 2011 -0700
    30.3 @@ -34,7 +34,7 @@
    30.4   *   <em>value</em>
    30.5   * </pre>
    30.6   *
    30.7 - * @see "The Java Language Specification, 3rd ed, section 15.28"
    30.8 + * @jls section 15.28
    30.9   *
   30.10   * @author Peter von der Ah&eacute;
   30.11   * @author Jonathan Gibbons

    31.1 --- a/src/share/classes/com/sun/source/tree/MemberSelectTree.java	Tue Apr 12 20:58:06 2011 -0700
    31.2 +++ b/src/share/classes/com/sun/source/tree/MemberSelectTree.java	Wed Apr 13 11:35:43 2011 -0700
    31.3 @@ -35,8 +35,7 @@
    31.4   *   <em>expression</em> . <em>identifier</em>
    31.5   * </pre>
    31.6   *
    31.7 - * @see "The Java Language Specification, 3rd ed, sections 6.5,
    31.8 - * 15.11, and 15.12"
    31.9 + * @jls sections 6.5, 15.11,and 15.12
   31.10   *
   31.11   * @author Peter von der Ah&eacute;
   31.12   * @author Jonathan Gibbons

    32.1 --- a/src/share/classes/com/sun/source/tree/MethodInvocationTree.java	Tue Apr 12 20:58:06 2011 -0700
    32.2 +++ b/src/share/classes/com/sun/source/tree/MethodInvocationTree.java	Wed Apr 13 11:35:43 2011 -0700
    32.3 @@ -37,7 +37,7 @@
    32.4   *   this . <em>typeArguments</em> <em>identifier</em> ( <em>arguments</em> )
    32.5   * </pre>
    32.6   *
    32.7 - * @see "The Java Language Specification, 3rd ed, section 15.12"
    32.8 + * @jls section 15.12
    32.9   *
   32.10   * @author Peter von der Ah&eacute;
   32.11   * @author Jonathan Gibbons

    33.1 --- a/src/share/classes/com/sun/source/tree/MethodTree.java	Tue Apr 12 20:58:06 2011 -0700
    33.2 +++ b/src/share/classes/com/sun/source/tree/MethodTree.java	Wed Apr 13 11:35:43 2011 -0700
    33.3 @@ -40,8 +40,7 @@
    33.4   *   <em>modifiers</em> <em>type</em> <em>name</em> () default <em>defaultValue</em>
    33.5   * </pre>
    33.6   *
    33.7 - * @see "The Java Language Specification, 3rd ed, sections 8.4, 8.6, 8.7,
    33.8 - * 9.4, and 9.6"
    33.9 + * @jls sections 8.4, 8.6, 8.7, 9.4, and 9.6
   33.10   *
   33.11   * @author Peter von der Ah&eacute;
   33.12   * @author Jonathan Gibbons

    34.1 --- a/src/share/classes/com/sun/source/tree/ModifiersTree.java	Tue Apr 12 20:58:06 2011 -0700
    34.2 +++ b/src/share/classes/com/sun/source/tree/ModifiersTree.java	Wed Apr 13 11:35:43 2011 -0700
    34.3 @@ -39,8 +39,7 @@
    34.4   *   <em>flags</em> <em>annotations</em>
    34.5   * </pre>
    34.6   *
    34.7 - * @see "The Java Language Specification, 3rd ed, sections
    34.8 - * 8.1.1, 8.3.1, 8.4.3, 8.5.1, 8.8.3, 9.1.1, and 9.7"
    34.9 + * @jls sections 8.1.1, 8.3.1, 8.4.3, 8.5.1, 8.8.3, 9.1.1, and 9.7
   34.10   *
   34.11   * @author Peter von der Ah&eacute;
   34.12   * @author Jonathan Gibbons

    35.1 --- a/src/share/classes/com/sun/source/tree/NewArrayTree.java	Tue Apr 12 20:58:06 2011 -0700
    35.2 +++ b/src/share/classes/com/sun/source/tree/NewArrayTree.java	Wed Apr 13 11:35:43 2011 -0700
    35.3 @@ -37,7 +37,7 @@
    35.4   *   new <em>type</em> <em>dimensions</em> [ ] <em>initializers</em>
    35.5   * </pre>
    35.6   *
    35.7 - * @see "The Java Language Specification, 3rd ed, section 15.10"
    35.8 + * @jls section 15.10
    35.9   *
   35.10   * @author Peter von der Ah&eacute;
   35.11   * @author Jonathan Gibbons

    36.1 --- a/src/share/classes/com/sun/source/tree/NewClassTree.java	Tue Apr 12 20:58:06 2011 -0700
    36.2 +++ b/src/share/classes/com/sun/source/tree/NewClassTree.java	Wed Apr 13 11:35:43 2011 -0700
    36.3 @@ -42,7 +42,7 @@
    36.4   *   <em>enclosingExpression</em>.new <em>identifier</em> ( <em>arguments</em> )
    36.5   * </pre>
    36.6   *
    36.7 - * @see "The Java Language Specification, 3rd ed, section 15.9"
    36.8 + * @jls section 15.9
    36.9   *
   36.10   * @author Peter von der Ah&eacute;
   36.11   * @author Jonathan Gibbons

    37.1 --- a/src/share/classes/com/sun/source/tree/ParameterizedTypeTree.java	Tue Apr 12 20:58:06 2011 -0700
    37.2 +++ b/src/share/classes/com/sun/source/tree/ParameterizedTypeTree.java	Wed Apr 13 11:35:43 2011 -0700
    37.3 @@ -35,7 +35,7 @@
    37.4   *   <em>type</em> &lt; <em>typeArguments</em> &gt;
    37.5   * </pre>
    37.6   *
    37.7 - * @see "The Java Language Specification, 3rd ed, section 4.5.1"
    37.8 + * @jls section 4.5.1
    37.9   *
   37.10   * @author Peter von der Ah&eacute;
   37.11   * @author Jonathan Gibbons

    38.1 --- a/src/share/classes/com/sun/source/tree/ParenthesizedTree.java	Tue Apr 12 20:58:06 2011 -0700
    38.2 +++ b/src/share/classes/com/sun/source/tree/ParenthesizedTree.java	Wed Apr 13 11:35:43 2011 -0700
    38.3 @@ -34,7 +34,7 @@
    38.4   *   ( <em>expression</em> )
    38.5   * </pre>
    38.6   *
    38.7 - * @see "The Java Language Specification, 3rd ed, section 15.8.5"
    38.8 + * @jls section 15.8.5
    38.9   *
   38.10   * @author Peter von der Ah&eacute;
   38.11   * @author Jonathan Gibbons

    39.1 --- a/src/share/classes/com/sun/source/tree/PrimitiveTypeTree.java	Tue Apr 12 20:58:06 2011 -0700
    39.2 +++ b/src/share/classes/com/sun/source/tree/PrimitiveTypeTree.java	Wed Apr 13 11:35:43 2011 -0700
    39.3 @@ -35,7 +35,7 @@
    39.4   *   <em>primitiveTypeKind</em>
    39.5   * </pre>
    39.6   *
    39.7 - * @see "The Java Language Specification, 3rd ed, section 4.2"
    39.8 + * @jls section 4.2
    39.9   *
   39.10   * @author Peter von der Ah&eacute;
   39.11   * @author Jonathan Gibbons

    40.1 --- a/src/share/classes/com/sun/source/tree/ReturnTree.java	Tue Apr 12 20:58:06 2011 -0700
    40.2 +++ b/src/share/classes/com/sun/source/tree/ReturnTree.java	Wed Apr 13 11:35:43 2011 -0700
    40.3 @@ -34,7 +34,7 @@
    40.4   *   return <em>expression</em>;
    40.5   * </pre>
    40.6   *
    40.7 - * @see "The Java Language Specification, 3rd ed, section 14.17"
    40.8 + * @jls section 14.17
    40.9   *
   40.10   * @author Peter von der Ah&eacute;
   40.11   * @author Jonathan Gibbons

    41.1 --- a/src/share/classes/com/sun/source/tree/StatementTree.java	Tue Apr 12 20:58:06 2011 -0700
    41.2 +++ b/src/share/classes/com/sun/source/tree/StatementTree.java	Wed Apr 13 11:35:43 2011 -0700
    41.3 @@ -29,7 +29,7 @@
    41.4   * A tree node used as the base class for the different kinds of
    41.5   * statements.
    41.6   *
    41.7 - * @see "The Java Language Specification, 3rd ed, chapter 14"
    41.8 + * @jls chapter 14
    41.9   *
   41.10   * @author Peter von der Ahé
   41.11   * @author Jonathan Gibbons

    42.1 --- a/src/share/classes/com/sun/source/tree/SwitchTree.java	Tue Apr 12 20:58:06 2011 -0700
    42.2 +++ b/src/share/classes/com/sun/source/tree/SwitchTree.java	Wed Apr 13 11:35:43 2011 -0700
    42.3 @@ -37,7 +37,7 @@
    42.4   *   }
    42.5   * </pre>
    42.6   *
    42.7 - * @see "The Java Language Specification, 3rd ed, section 14.11"
    42.8 + * @jls section 14.11
    42.9   *
   42.10   * @author Peter von der Ah&eacute;
   42.11   * @author Jonathan Gibbons

    43.1 --- a/src/share/classes/com/sun/source/tree/SynchronizedTree.java	Tue Apr 12 20:58:06 2011 -0700
    43.2 +++ b/src/share/classes/com/sun/source/tree/SynchronizedTree.java	Wed Apr 13 11:35:43 2011 -0700
    43.3 @@ -34,7 +34,7 @@
    43.4   *       </em>block</em>
    43.5   * </pre>
    43.6   *
    43.7 - * @see "The Java Language Specification, 3rd ed, section 14.19"
    43.8 + * @jls section 14.19
    43.9   *
   43.10   * @author Peter von der Ah&eacute;
   43.11   * @author Jonathan Gibbons

    44.1 --- a/src/share/classes/com/sun/source/tree/ThrowTree.java	Tue Apr 12 20:58:06 2011 -0700
    44.2 +++ b/src/share/classes/com/sun/source/tree/ThrowTree.java	Wed Apr 13 11:35:43 2011 -0700
    44.3 @@ -33,7 +33,7 @@
    44.4   *   throw <em>expression</em>;
    44.5   * </pre>
    44.6   *
    44.7 - * @see "The Java Language Specification, 3rd ed, section 14.18"
    44.8 + * @jls section 14.18
    44.9   *
   44.10   * @author Peter von der Ah&eacute;
   44.11   * @author Jonathan Gibbons

    45.1 --- a/src/share/classes/com/sun/source/tree/TryTree.java	Tue Apr 12 20:58:06 2011 -0700
    45.2 +++ b/src/share/classes/com/sun/source/tree/TryTree.java	Wed Apr 13 11:35:43 2011 -0700
    45.3 @@ -39,7 +39,7 @@
    45.4   *       <em>finallyBlock</em>
    45.5   * </pre>
    45.6   *
    45.7 - * @see "The Java Language Specification, 3rd ed, section 14.20"
    45.8 + * @jls section 14.20
    45.9   *
   45.10   * @author Peter von der Ah&eacute;
   45.11   * @author Jonathan Gibbons

    46.1 --- a/src/share/classes/com/sun/source/tree/TypeCastTree.java	Tue Apr 12 20:58:06 2011 -0700
    46.2 +++ b/src/share/classes/com/sun/source/tree/TypeCastTree.java	Wed Apr 13 11:35:43 2011 -0700
    46.3 @@ -33,7 +33,7 @@
    46.4   *   ( <em>type</em> ) <em>expression</em>
    46.5   * </pre>
    46.6   *
    46.7 - * @see "The Java Language Specification, 3rd ed, section 15.16"
    46.8 + * @jls section 15.16
    46.9   *
   46.10   * @author Peter von der Ah&eacute;
   46.11   * @author Jonathan Gibbons

    47.1 --- a/src/share/classes/com/sun/source/tree/TypeParameterTree.java	Tue Apr 12 20:58:06 2011 -0700
    47.2 +++ b/src/share/classes/com/sun/source/tree/TypeParameterTree.java	Wed Apr 13 11:35:43 2011 -0700
    47.3 @@ -38,7 +38,7 @@
    47.4   *   <em>name</em> extends <em>bounds</em>
    47.5   * </pre>
    47.6   *
    47.7 - * @see "The Java Language Specification, 3rd ed, section 4.4"
    47.8 + * @jls section 4.4
    47.9   *
   47.10   * @author Peter von der Ah&eacute;
   47.11   * @author Jonathan Gibbons

    48.1 --- a/src/share/classes/com/sun/source/tree/UnaryTree.java	Tue Apr 12 20:58:06 2011 -0700
    48.2 +++ b/src/share/classes/com/sun/source/tree/UnaryTree.java	Wed Apr 13 11:35:43 2011 -0700
    48.3 @@ -36,7 +36,7 @@
    48.4   *   <em>expression</em> <em>operator</em>
    48.5   * </pre>
    48.6   *
    48.7 - * @see "The Java Language Specification, 3rd ed, sections 15.14 and 15.15"
    48.8 + * @jls sections 15.14 and 15.15
    48.9   *
   48.10   * @author Peter von der Ah&eacute;
   48.11   * @author Jonathan Gibbons

    49.1 --- a/src/share/classes/com/sun/source/tree/VariableTree.java	Tue Apr 12 20:58:06 2011 -0700
    49.2 +++ b/src/share/classes/com/sun/source/tree/VariableTree.java	Wed Apr 13 11:35:43 2011 -0700
    49.3 @@ -35,7 +35,7 @@
    49.4   *   <em>modifiers</em> <em>type</em> <em>name</em> <em>initializer</em> ;
    49.5   * </pre>
    49.6   *
    49.7 - * @see "The Java Language Specification, 3rd ed, sections 8.3 and 14.4"
    49.8 + * @jls sections 8.3 and 14.4
    49.9   *
   49.10   * @author Peter von der Ah&eacute;
   49.11   * @author Jonathan Gibbons

    50.1 --- a/src/share/classes/com/sun/source/tree/WhileLoopTree.java	Tue Apr 12 20:58:06 2011 -0700
    50.2 +++ b/src/share/classes/com/sun/source/tree/WhileLoopTree.java	Wed Apr 13 11:35:43 2011 -0700
    50.3 @@ -35,7 +35,7 @@
    50.4   * </pre>
    50.5   *
    50.6   *
    50.7 - * @see "The Java Language Specification, 3rd ed, section 14.12"
    50.8 + * @jls section 14.12
    50.9   *
   50.10   * @author Peter von der Ah&eacute;
   50.11   * @author Jonathan Gibbons

    51.1 --- a/src/share/classes/com/sun/source/tree/WildcardTree.java	Tue Apr 12 20:58:06 2011 -0700
    51.2 +++ b/src/share/classes/com/sun/source/tree/WildcardTree.java	Wed Apr 13 11:35:43 2011 -0700
    51.3 @@ -38,7 +38,7 @@
    51.4   *   ? super <em>bound</em>
    51.5   * </pre>
    51.6   *
    51.7 - * @see "The Java Language Specification, 3rd ed, section 4.5.1"
    51.8 + * @jls section 4.5.1
    51.9   *
   51.10   * @author Peter von der Ah&eacute;
   51.11   * @author Jonathan Gibbons

    52.1 --- a/src/share/classes/com/sun/tools/apt/mirror/util/DeclarationsImpl.java	Tue Apr 12 20:58:06 2011 -0700
    52.2 +++ b/src/share/classes/com/sun/tools/apt/mirror/util/DeclarationsImpl.java	Wed Apr 13 11:35:43 2011 -0700
    52.3 @@ -67,7 +67,8 @@
    52.4  
    52.5      /**
    52.6       * {@inheritDoc}
    52.7 -     * See JLS 2 sections 8.3 and 8.4.6.
    52.8 +     * See sections 8.3 and 8.4.6 of
    52.9 +     * <cite>The Java&trade; Language Specification</cite>
   52.10       */
   52.11      public boolean hides(MemberDeclaration sub, MemberDeclaration sup) {
   52.12          Symbol hider = ((DeclarationImpl) sub).sym;
   52.13 @@ -107,7 +108,8 @@
   52.14  
   52.15      /**
   52.16       * {@inheritDoc}
   52.17 -     * See JLS 2 section 8.4.6.1.
   52.18 +     * See section 8.4.6.1 of
   52.19 +     * <cite>The Java&trade; Language Specification</cite>
   52.20       */
   52.21      public boolean overrides(MethodDeclaration sub, MethodDeclaration sup) {
   52.22          MethodSymbol overrider = ((MethodDeclarationImpl) sub).sym;

    53.1 --- a/src/share/classes/com/sun/tools/classfile/AccessFlags.java	Tue Apr 12 20:58:06 2011 -0700
    53.2 +++ b/src/share/classes/com/sun/tools/classfile/AccessFlags.java	Wed Apr 13 11:35:43 2011 -0700
    53.3 @@ -30,7 +30,7 @@
    53.4  import java.util.Set;
    53.5  
    53.6  /**
    53.7 - * See JVMS3, sections 4.2, 4.6, 4.7.
    53.8 + * See JVMS, sections 4.2, 4.6, 4.7.
    53.9   *
   53.10   *  <p><b>This is NOT part of any supported API.
   53.11   *  If you write code that depends on this, you do so at your own risk.

    54.1 --- a/src/share/classes/com/sun/tools/classfile/Annotation.java	Tue Apr 12 20:58:06 2011 -0700
    54.2 +++ b/src/share/classes/com/sun/tools/classfile/Annotation.java	Wed Apr 13 11:35:43 2011 -0700
    54.3 @@ -28,7 +28,7 @@
    54.4  import java.io.IOException;
    54.5  
    54.6  /**
    54.7 - * See JVMS3, section 4.8.16.
    54.8 + * See JVMS, section 4.8.16.
    54.9   *
   54.10   *  <p><b>This is NOT part of any supported API.
   54.11   *  If you write code that depends on this, you do so at your own risk.
   54.12 @@ -71,7 +71,7 @@
   54.13      public final element_value_pair element_value_pairs[];
   54.14  
   54.15      /**
   54.16 -     * See JVMS3, section 4.8.16.1.
   54.17 +     * See JVMS, section 4.8.16.1.
   54.18       */
   54.19      public static abstract class element_value {
   54.20          public static element_value read(ClassReader cr)

    55.1 --- a/src/share/classes/com/sun/tools/classfile/AnnotationDefault_attribute.java	Tue Apr 12 20:58:06 2011 -0700
    55.2 +++ b/src/share/classes/com/sun/tools/classfile/AnnotationDefault_attribute.java	Wed Apr 13 11:35:43 2011 -0700
    55.3 @@ -28,7 +28,7 @@
    55.4  import java.io.IOException;
    55.5  
    55.6  /**
    55.7 - * See JVMS3, section 4.8.15.
    55.8 + * See JVMS, section 4.8.15.
    55.9   *
   55.10   *  <p><b>This is NOT part of any supported API.
   55.11   *  If you write code that depends on this, you do so at your own risk.

    56.1 --- a/src/share/classes/com/sun/tools/classfile/BootstrapMethods_attribute.java	Tue Apr 12 20:58:06 2011 -0700
    56.2 +++ b/src/share/classes/com/sun/tools/classfile/BootstrapMethods_attribute.java	Wed Apr 13 11:35:43 2011 -0700
    56.3 @@ -28,7 +28,7 @@
    56.4  import java.io.IOException;
    56.5  
    56.6  /**
    56.7 - * See JVMS3 <TBD>
    56.8 + * See JVMS <TBD>
    56.9   * http://cr.openjdk.java.net/~jrose/pres/indy-javadoc-mlvm/
   56.10   *
   56.11   *  <p><b>This is NOT part of any supported API.

    57.1 --- a/src/share/classes/com/sun/tools/classfile/ClassFile.java	Tue Apr 12 20:58:06 2011 -0700
    57.2 +++ b/src/share/classes/com/sun/tools/classfile/ClassFile.java	Wed Apr 13 11:35:43 2011 -0700
    57.3 @@ -33,7 +33,7 @@
    57.4  import static com.sun.tools.classfile.AccessFlags.*;
    57.5  
    57.6  /**
    57.7 - * See JVMS3, section 4.2.
    57.8 + * See JVMS, section 4.2.
    57.9   *
   57.10   *  <p><b>This is NOT part of any supported API.
   57.11   *  If you write code that depends on this, you do so at your own risk.

    58.1 --- a/src/share/classes/com/sun/tools/classfile/Code_attribute.java	Tue Apr 12 20:58:06 2011 -0700
    58.2 +++ b/src/share/classes/com/sun/tools/classfile/Code_attribute.java	Wed Apr 13 11:35:43 2011 -0700
    58.3 @@ -30,7 +30,7 @@
    58.4  import java.util.NoSuchElementException;
    58.5  
    58.6  /**
    58.7 - * See JVMS3, section 4.8.3.
    58.8 + * See JVMS, section 4.8.3.
    58.9   *
   58.10   *  <p><b>This is NOT part of any supported API.
   58.11   *  If you write code that depends on this, you do so at your own risk.

    59.1 --- a/src/share/classes/com/sun/tools/classfile/ConstantPool.java	Tue Apr 12 20:58:06 2011 -0700
    59.2 +++ b/src/share/classes/com/sun/tools/classfile/ConstantPool.java	Wed Apr 13 11:35:43 2011 -0700
    59.3 @@ -31,7 +31,7 @@
    59.4  import java.util.Iterator;
    59.5  
    59.6  /**
    59.7 - * See JVMS3, section 4.5.
    59.8 + * See JVMS, section 4.5.
    59.9   *
   59.10   *  <p><b>This is NOT part of any supported API.
   59.11   *  If you write code that depends on this, you do so at your own risk.

    60.1 --- a/src/share/classes/com/sun/tools/classfile/ConstantValue_attribute.java	Tue Apr 12 20:58:06 2011 -0700
    60.2 +++ b/src/share/classes/com/sun/tools/classfile/ConstantValue_attribute.java	Wed Apr 13 11:35:43 2011 -0700
    60.3 @@ -28,7 +28,7 @@
    60.4  import java.io.IOException;
    60.5  
    60.6  /**
    60.7 - * See JVMS3, section 4.8.2.
    60.8 + * See JVMS, section 4.8.2.
    60.9   *
   60.10   *  <p><b>This is NOT part of any supported API.
   60.11   *  If you write code that depends on this, you do so at your own risk.

    61.1 --- a/src/share/classes/com/sun/tools/classfile/Deprecated_attribute.java	Tue Apr 12 20:58:06 2011 -0700
    61.2 +++ b/src/share/classes/com/sun/tools/classfile/Deprecated_attribute.java	Wed Apr 13 11:35:43 2011 -0700
    61.3 @@ -28,7 +28,7 @@
    61.4  import java.io.IOException;
    61.5  
    61.6  /**
    61.7 - * See JVMS3, section 4.8.15.
    61.8 + * See JVMS, section 4.8.15.
    61.9   *
   61.10   *  <p><b>This is NOT part of any supported API.
   61.11   *  If you write code that depends on this, you do so at your own risk.

    62.1 --- a/src/share/classes/com/sun/tools/classfile/Descriptor.java	Tue Apr 12 20:58:06 2011 -0700
    62.2 +++ b/src/share/classes/com/sun/tools/classfile/Descriptor.java	Wed Apr 13 11:35:43 2011 -0700
    62.3 @@ -29,7 +29,7 @@
    62.4  import java.io.IOException;
    62.5  
    62.6  /**
    62.7 - * See JVMS3, section 4.4.
    62.8 + * See JVMS, section 4.4.
    62.9   *
   62.10   *  <p><b>This is NOT part of any supported API.
   62.11   *  If you write code that depends on this, you do so at your own risk.

    63.1 --- a/src/share/classes/com/sun/tools/classfile/EnclosingMethod_attribute.java	Tue Apr 12 20:58:06 2011 -0700
    63.2 +++ b/src/share/classes/com/sun/tools/classfile/EnclosingMethod_attribute.java	Wed Apr 13 11:35:43 2011 -0700
    63.3 @@ -29,7 +29,7 @@
    63.4  import java.io.IOException;
    63.5  
    63.6  /**
    63.7 - * See JVMS3, section 4.8.7.
    63.8 + * See JVMS, section 4.8.7.
    63.9   *
   63.10   *  <p><b>This is NOT part of any supported API.
   63.11   *  If you write code that depends on this, you do so at your own risk.

    64.1 --- a/src/share/classes/com/sun/tools/classfile/Exceptions_attribute.java	Tue Apr 12 20:58:06 2011 -0700
    64.2 +++ b/src/share/classes/com/sun/tools/classfile/Exceptions_attribute.java	Wed Apr 13 11:35:43 2011 -0700
    64.3 @@ -28,7 +28,7 @@
    64.4  import java.io.IOException;
    64.5  
    64.6  /**
    64.7 - * See JVMS3, section 4.8.5.
    64.8 + * See JVMS, section 4.8.5.
    64.9   *
   64.10   *  <p><b>This is NOT part of any supported API.
   64.11   *  If you write code that depends on this, you do so at your own risk.

    65.1 --- a/src/share/classes/com/sun/tools/classfile/InnerClasses_attribute.java	Tue Apr 12 20:58:06 2011 -0700
    65.2 +++ b/src/share/classes/com/sun/tools/classfile/InnerClasses_attribute.java	Wed Apr 13 11:35:43 2011 -0700
    65.3 @@ -30,7 +30,7 @@
    65.4  import com.sun.tools.classfile.ConstantPool.*;
    65.5  
    65.6  /**
    65.7 - * See JVMS3, section 4.8.6.
    65.8 + * See JVMS, section 4.8.6.
    65.9   *
   65.10   *  <p><b>This is NOT part of any supported API.
   65.11   *  If you write code that depends on this, you do so at your own risk.

    66.1 --- a/src/share/classes/com/sun/tools/classfile/Instruction.java	Tue Apr 12 20:58:06 2011 -0700
    66.2 +++ b/src/share/classes/com/sun/tools/classfile/Instruction.java	Wed Apr 13 11:35:43 2011 -0700
    66.3 @@ -26,7 +26,7 @@
    66.4  package com.sun.tools.classfile;
    66.5  
    66.6  /**
    66.7 - * See JVMS3, chapter 6.
    66.8 + * See JVMS, chapter 6.
    66.9   *
   66.10   *  <p><b>This is NOT part of any supported API.
   66.11   *  If you write code that depends on this, you do so at your own risk.

    67.1 --- a/src/share/classes/com/sun/tools/classfile/LineNumberTable_attribute.java	Tue Apr 12 20:58:06 2011 -0700
    67.2 +++ b/src/share/classes/com/sun/tools/classfile/LineNumberTable_attribute.java	Wed Apr 13 11:35:43 2011 -0700
    67.3 @@ -28,7 +28,7 @@
    67.4  import java.io.IOException;
    67.5  
    67.6  /**
    67.7 - * See JVMS3, section 4.8.12.
    67.8 + * See JVMS, section 4.8.12.
    67.9   *
   67.10   *  <p><b>This is NOT part of any supported API.
   67.11   *  If you write code that depends on this, you do so at your own risk.

    68.1 --- a/src/share/classes/com/sun/tools/classfile/LocalVariableTable_attribute.java	Tue Apr 12 20:58:06 2011 -0700
    68.2 +++ b/src/share/classes/com/sun/tools/classfile/LocalVariableTable_attribute.java	Wed Apr 13 11:35:43 2011 -0700
    68.3 @@ -28,7 +28,7 @@
    68.4  import java.io.IOException;
    68.5  
    68.6  /**
    68.7 - * See JVMS3, section 4.8.13.
    68.8 + * See JVMS, section 4.8.13.
    68.9   *
   68.10   *  <p><b>This is NOT part of any supported API.
   68.11   *  If you write code that depends on this, you do so at your own risk.

    69.1 --- a/src/share/classes/com/sun/tools/classfile/LocalVariableTypeTable_attribute.java	Tue Apr 12 20:58:06 2011 -0700
    69.2 +++ b/src/share/classes/com/sun/tools/classfile/LocalVariableTypeTable_attribute.java	Wed Apr 13 11:35:43 2011 -0700
    69.3 @@ -28,7 +28,7 @@
    69.4  import java.io.IOException;
    69.5  
    69.6  /**
    69.7 - * See JVMS3, section 4.8.14.
    69.8 + * See JVMS, section 4.8.14.
    69.9   *
   69.10   *  <p><b>This is NOT part of any supported API.
   69.11   *  If you write code that depends on this, you do so at your own risk.

    70.1 --- a/src/share/classes/com/sun/tools/classfile/Opcode.java	Tue Apr 12 20:58:06 2011 -0700
    70.2 +++ b/src/share/classes/com/sun/tools/classfile/Opcode.java	Wed Apr 13 11:35:43 2011 -0700
    70.3 @@ -29,7 +29,7 @@
    70.4  import static com.sun.tools.classfile.Opcode.Set.*;
    70.5  
    70.6  /**
    70.7 - * See JVMS3, chapter 6.
    70.8 + * See JVMS, chapter 6.
    70.9   *
   70.10   * <p>In addition to providing all the standard opcodes defined in JVMS,
   70.11   * this class also provides legacy support for the PicoJava extensions.

    71.1 --- a/src/share/classes/com/sun/tools/classfile/RuntimeAnnotations_attribute.java	Tue Apr 12 20:58:06 2011 -0700
    71.2 +++ b/src/share/classes/com/sun/tools/classfile/RuntimeAnnotations_attribute.java	Wed Apr 13 11:35:43 2011 -0700
    71.3 @@ -28,7 +28,7 @@
    71.4  import java.io.IOException;
    71.5  
    71.6  /**
    71.7 - * See JVMS3, section 4.8.16 and 4.8.17.
    71.8 + * See JVMS, section 4.8.16 and 4.8.17.
    71.9   *
   71.10   *  <p><b>This is NOT part of any supported API.
   71.11   *  If you write code that depends on this, you do so at your own risk.

    72.1 --- a/src/share/classes/com/sun/tools/classfile/RuntimeInvisibleAnnotations_attribute.java	Tue Apr 12 20:58:06 2011 -0700
    72.2 +++ b/src/share/classes/com/sun/tools/classfile/RuntimeInvisibleAnnotations_attribute.java	Wed Apr 13 11:35:43 2011 -0700
    72.3 @@ -28,7 +28,7 @@
    72.4  import java.io.IOException;
    72.5  
    72.6  /**
    72.7 - * See JVMS3, section 4.8.17.
    72.8 + * See JVMS, section 4.8.17.
    72.9   *
   72.10   *  <p><b>This is NOT part of any supported API.
   72.11   *  If you write code that depends on this, you do so at your own risk.

    73.1 --- a/src/share/classes/com/sun/tools/classfile/RuntimeInvisibleParameterAnnotations_attribute.java	Tue Apr 12 20:58:06 2011 -0700
    73.2 +++ b/src/share/classes/com/sun/tools/classfile/RuntimeInvisibleParameterAnnotations_attribute.java	Wed Apr 13 11:35:43 2011 -0700
    73.3 @@ -28,7 +28,7 @@
    73.4  import java.io.IOException;
    73.5  
    73.6  /**
    73.7 - * See JVMS3, section 4.8.18.
    73.8 + * See JVMS, section 4.8.18.
    73.9   *
   73.10   *  <p><b>This is NOT part of any supported API.
   73.11   *  If you write code that depends on this, you do so at your own risk.

    74.1 --- a/src/share/classes/com/sun/tools/classfile/RuntimeParameterAnnotations_attribute.java	Tue Apr 12 20:58:06 2011 -0700
    74.2 +++ b/src/share/classes/com/sun/tools/classfile/RuntimeParameterAnnotations_attribute.java	Wed Apr 13 11:35:43 2011 -0700
    74.3 @@ -28,7 +28,7 @@
    74.4  import java.io.IOException;
    74.5  
    74.6  /**
    74.7 - * See JVMS3, section 4.8.18 and 4.8.19.
    74.8 + * See JVMS, section 4.8.18 and 4.8.19.
    74.9   *
   74.10   *  <p><b>This is NOT part of any supported API.
   74.11   *  If you write code that depends on this, you do so at your own risk.

    75.1 --- a/src/share/classes/com/sun/tools/classfile/RuntimeVisibleAnnotations_attribute.java	Tue Apr 12 20:58:06 2011 -0700
    75.2 +++ b/src/share/classes/com/sun/tools/classfile/RuntimeVisibleAnnotations_attribute.java	Wed Apr 13 11:35:43 2011 -0700
    75.3 @@ -28,7 +28,7 @@
    75.4  import java.io.IOException;
    75.5  
    75.6  /**
    75.7 - * See JVMS3, section 4.8.16.
    75.8 + * See JVMS, section 4.8.16.
    75.9   *
   75.10   *  <p><b>This is NOT part of any supported API.
   75.11   *  If you write code that depends on this, you do so at your own risk.

    76.1 --- a/src/share/classes/com/sun/tools/classfile/RuntimeVisibleParameterAnnotations_attribute.java	Tue Apr 12 20:58:06 2011 -0700
    76.2 +++ b/src/share/classes/com/sun/tools/classfile/RuntimeVisibleParameterAnnotations_attribute.java	Wed Apr 13 11:35:43 2011 -0700
    76.3 @@ -28,7 +28,7 @@
    76.4  import java.io.IOException;
    76.5  
    76.6  /**
    76.7 - * See JVMS3, section 4.8.18.
    76.8 + * See JVMS, section 4.8.18.
    76.9   *
   76.10   *  <p><b>This is NOT part of any supported API.
   76.11   *  If you write code that depends on this, you do so at your own risk.

    77.1 --- a/src/share/classes/com/sun/tools/classfile/Signature.java	Tue Apr 12 20:58:06 2011 -0700
    77.2 +++ b/src/share/classes/com/sun/tools/classfile/Signature.java	Wed Apr 13 11:35:43 2011 -0700
    77.3 @@ -30,7 +30,7 @@
    77.4  import com.sun.tools.classfile.Type.*;
    77.5  
    77.6  /**
    77.7 - * See JVMS3 4.4.4.
    77.8 + * See JVMS 4.4.4.
    77.9   *
   77.10   *  <p><b>This is NOT part of any supported API.
   77.11   *  If you write code that depends on this, you do so at your own risk.

    78.1 --- a/src/share/classes/com/sun/tools/classfile/Signature_attribute.java	Tue Apr 12 20:58:06 2011 -0700
    78.2 +++ b/src/share/classes/com/sun/tools/classfile/Signature_attribute.java	Wed Apr 13 11:35:43 2011 -0700
    78.3 @@ -28,7 +28,7 @@
    78.4  import java.io.IOException;
    78.5  
    78.6  /**
    78.7 - * See JVMS3, section 4.8.9.
    78.8 + * See JVMS, section 4.8.9.
    78.9   *
   78.10   *  <p><b>This is NOT part of any supported API.
   78.11   *  If you write code that depends on this, you do so at your own risk.

    79.1 --- a/src/share/classes/com/sun/tools/classfile/SourceDebugExtension_attribute.java	Tue Apr 12 20:58:06 2011 -0700
    79.2 +++ b/src/share/classes/com/sun/tools/classfile/SourceDebugExtension_attribute.java	Wed Apr 13 11:35:43 2011 -0700
    79.3 @@ -30,7 +30,7 @@
    79.4  import java.io.IOException;
    79.5  
    79.6  /**
    79.7 - * See JVMS3, section 4.8.15.
    79.8 + * See JVMS, section 4.8.15.
    79.9   *
   79.10   *  <p><b>This is NOT part of any supported API.
   79.11   *  If you write code that depends on this, you do so at your own risk.

    80.1 --- a/src/share/classes/com/sun/tools/classfile/SourceFile_attribute.java	Tue Apr 12 20:58:06 2011 -0700
    80.2 +++ b/src/share/classes/com/sun/tools/classfile/SourceFile_attribute.java	Wed Apr 13 11:35:43 2011 -0700
    80.3 @@ -28,7 +28,7 @@
    80.4  import java.io.IOException;
    80.5  
    80.6  /**
    80.7 - * See JVMS3, section 4.8.10.
    80.8 + * See JVMS, section 4.8.10.
    80.9   *
   80.10   *  <p><b>This is NOT part of any supported API.
   80.11   *  If you write code that depends on this, you do so at your own risk.

    81.1 --- a/src/share/classes/com/sun/tools/classfile/StackMapTable_attribute.java	Tue Apr 12 20:58:06 2011 -0700
    81.2 +++ b/src/share/classes/com/sun/tools/classfile/StackMapTable_attribute.java	Wed Apr 13 11:35:43 2011 -0700
    81.3 @@ -28,7 +28,7 @@
    81.4  import java.io.IOException;
    81.5  
    81.6  /**
    81.7 - * See JVMS3, section 4.8.4.
    81.8 + * See JVMS, section 4.8.4.
    81.9   *
   81.10   *  <p><b>This is NOT part of any supported API.
   81.11   *  If you write code that depends on this, you do so at your own risk.

    82.1 --- a/src/share/classes/com/sun/tools/classfile/Synthetic_attribute.java	Tue Apr 12 20:58:06 2011 -0700
    82.2 +++ b/src/share/classes/com/sun/tools/classfile/Synthetic_attribute.java	Wed Apr 13 11:35:43 2011 -0700
    82.3 @@ -28,7 +28,7 @@
    82.4  import java.io.IOException;
    82.5  
    82.6  /**
    82.7 - * See JVMS3, section 4.8.8.
    82.8 + * See JVMS, section 4.8.8.
    82.9   *
   82.10   *  <p><b>This is NOT part of any supported API.
   82.11   *  If you write code that depends on this, you do so at your own risk.

    83.1 --- a/src/share/classes/com/sun/tools/classfile/package.html	Tue Apr 12 20:58:06 2011 -0700
    83.2 +++ b/src/share/classes/com/sun/tools/classfile/package.html	Wed Apr 13 11:35:43 2011 -0700
    83.3 @@ -6,7 +6,7 @@
    83.4    </head>
    83.5    <body>
    83.6      A minimalist library to read and write class files into objects closely 
    83.7 -    based on the corresponding definitions in the Java Virtual Machine 
    83.8 -    Specification (JVMS).
    83.9 +    based on the corresponding definitions in 
   83.10 +    <cite>The Java&trade; Virtual Machine Specification</cite> (JVMS).
   83.11    </body>
   83.12  </html>

    84.1 --- a/src/share/classes/com/sun/tools/doclets/formats/html/HtmlDocletWriter.java	Tue Apr 12 20:58:06 2011 -0700
    84.2 +++ b/src/share/classes/com/sun/tools/doclets/formats/html/HtmlDocletWriter.java	Wed Apr 13 11:35:43 2011 -0700
    84.3 @@ -2523,8 +2523,9 @@
    84.4      }
    84.5  
    84.6      /**
    84.7 -     * According to the Java Language Specifications, all the outer classes
    84.8 -     * and static nested classes are core classes.
    84.9 +     * According to
   84.10 +     * <cite>The Java&trade; Language Specification</cite>,
   84.11 +     * all the outer classes and static nested classes are core classes.
   84.12       */
   84.13      public boolean isCoreClass(ClassDoc cd) {
   84.14          return cd.containingClass() == null || cd.isStatic();

    85.1 --- a/src/share/classes/com/sun/tools/doclets/internal/toolkit/util/Util.java	Tue Apr 12 20:58:06 2011 -0700
    85.2 +++ b/src/share/classes/com/sun/tools/doclets/internal/toolkit/util/Util.java	Wed Apr 13 11:35:43 2011 -0700
    85.3 @@ -175,8 +175,9 @@
    85.4      }
    85.5  
    85.6      /**
    85.7 -     * According to the Java Language Specifications, all the outer classes
    85.8 -     * and static inner classes are core classes.
    85.9 +     * According to
   85.10 +     * <cite>The Java&trade; Language Specification</cite>,
   85.11 +     * all the outer classes and static inner classes are core classes.
   85.12       */
   85.13      public static boolean isCoreClass(ClassDoc cd) {
   85.14          return cd.containingClass() == null || cd.isStatic();

    86.1 --- a/src/share/classes/com/sun/tools/javac/code/Symbol.java	Tue Apr 12 20:58:06 2011 -0700
    86.2 +++ b/src/share/classes/com/sun/tools/javac/code/Symbol.java	Wed Apr 13 11:35:43 2011 -0700
    86.3 @@ -1193,7 +1193,7 @@
    86.4          }
    86.5  
    86.6          private boolean isOverridableIn(TypeSymbol origin) {
    86.7 -            // JLS3 8.4.6.1
    86.8 +            // JLS 8.4.6.1
    86.9              switch ((int)(flags_field & Flags.AccessFlags)) {
   86.10              case Flags.PRIVATE:
   86.11                  return false;

    87.1 --- a/src/share/classes/com/sun/tools/javac/code/Types.java	Tue Apr 12 20:58:06 2011 -0700
    87.2 +++ b/src/share/classes/com/sun/tools/javac/code/Types.java	Wed Apr 13 11:35:43 2011 -0700
    87.3 @@ -1985,7 +1985,7 @@
    87.4       * signature</em> of the other.  This is <b>not</b> an equivalence
    87.5       * relation.
    87.6       *
    87.7 -     * @see "The Java Language Specification, Third Ed. (8.4.2)."
    87.8 +     * @jls section 8.4.2.
    87.9       * @see #overrideEquivalent(Type t, Type s)
   87.10       * @param t first signature (possibly raw).
   87.11       * @param s second signature (could be subjected to erasure).
   87.12 @@ -2004,7 +2004,7 @@
   87.13       * equivalence</em>.  This is the natural extension of
   87.14       * isSubSignature to an equivalence relation.
   87.15       *
   87.16 -     * @see "The Java Language Specification, Third Ed. (8.4.2)."
   87.17 +     * @jls section 8.4.2.
   87.18       * @see #isSubSignature(Type t, Type s)
   87.19       * @param t a signature (possible raw, could be subjected to
   87.20       * erasure).
   87.21 @@ -3049,8 +3049,7 @@
   87.22  
   87.23      /**
   87.24       * Return-Type-Substitutable.
   87.25 -     * @see <a href="http://java.sun.com/docs/books/jls/">The Java
   87.26 -     * Language Specification, Third Ed. (8.4.5)</a>
   87.27 +     * @jls section 8.4.5
   87.28       */
   87.29      public boolean returnTypeSubstitutable(Type r1, Type r2) {
   87.30          if (hasSameArgs(r1, r2))
   87.31 @@ -3130,7 +3129,7 @@
   87.32  
   87.33      // <editor-fold defaultstate="collapsed" desc="Capture conversion">
   87.34      /*
   87.35 -     * JLS 3rd Ed. 5.1.10 Capture Conversion:
   87.36 +     * JLS 5.1.10 Capture Conversion:
   87.37       *
   87.38       * Let G name a generic type declaration with n formal type
   87.39       * parameters A1 ... An with corresponding bounds U1 ... Un. There
   87.40 @@ -3163,7 +3162,7 @@
   87.41       * Capture conversion is not applied recursively.
   87.42       */
   87.43      /**
   87.44 -     * Capture conversion as specified by JLS 3rd Ed.
   87.45 +     * Capture conversion as specified by the JLS.
   87.46       */
   87.47  
   87.48      public List<Type> capture(List<Type> ts) {

    88.1 --- a/src/share/classes/com/sun/tools/javac/comp/Attr.java	Tue Apr 12 20:58:06 2011 -0700
    88.2 +++ b/src/share/classes/com/sun/tools/javac/comp/Attr.java	Wed Apr 13 11:35:43 2011 -0700
    88.3 @@ -2632,10 +2632,10 @@
    88.4           * @param tree    The tree making up the variable reference.
    88.5           * @param env     The current environment.
    88.6           * @param v       The variable's symbol.
    88.7 -         * @see JLS 3rd Ed. (8.9 Enums)
    88.8 +         * @jls  section 8.9 Enums
    88.9           */
   88.10          private void checkEnumInitializer(JCTree tree, Env<AttrContext> env, VarSymbol v) {
   88.11 -            // JLS 3rd Ed.:
   88.12 +            // JLS:
   88.13              //
   88.14              // "It is a compile-time error to reference a static field
   88.15              // of an enum type that is not a compile-time constant

    89.1 --- a/src/share/classes/com/sun/tools/javac/comp/Check.java	Tue Apr 12 20:58:06 2011 -0700
    89.2 +++ b/src/share/classes/com/sun/tools/javac/comp/Check.java	Wed Apr 13 11:35:43 2011 -0700
    89.3 @@ -2271,7 +2271,7 @@
    89.4       * that of any public or protected method declared in class Object
    89.5       * or in the interface annotation.Annotation."
    89.6       *
    89.7 -     * @jls3 9.6 Annotation Types
    89.8 +     * @jls 9.6 Annotation Types
    89.9       */
   89.10      void validateAnnotationMethod(DiagnosticPosition pos, MethodSymbol m) {
   89.11          for (Type sup = syms.annotationType; sup.tag == CLASS; sup = types.supertype(sup)) {

    90.1 --- a/src/share/classes/com/sun/tools/javac/comp/Flow.java	Tue Apr 12 20:58:06 2011 -0700
    90.2 +++ b/src/share/classes/com/sun/tools/javac/comp/Flow.java	Wed Apr 13 11:35:43 2011 -0700
    90.3 @@ -51,7 +51,7 @@
    90.4   *  unassignment analysis ensures that no final variable is assigned
    90.5   *  more than once.
    90.6   *
    90.7 - *  <p>The second edition of the JLS has a number of problems in the
    90.8 + *  <p>The JLS has a number of problems in the
    90.9   *  specification of these flow analysis problems. This implementation
   90.10   *  attempts to address those issues.
   90.11   *
   90.12 @@ -126,7 +126,7 @@
   90.13   *  don't have to worry about the return expression because this
   90.14   *  concept is only used for construcrors.
   90.15   *
   90.16 - *  <p>There is no spec in JLS2 for when a variable is definitely
   90.17 + *  <p>There is no spec in the JLS for when a variable is definitely
   90.18   *  assigned at the end of a constructor, which is needed for final
   90.19   *  fields (8.3.1.2).  We implement the rule that V is DA at the end
   90.20   *  of the constructor iff it is DA and the end of the body of the

    91.1 --- a/src/share/classes/com/sun/tools/javac/comp/Resolve.java	Tue Apr 12 20:58:06 2011 -0700
    91.2 +++ b/src/share/classes/com/sun/tools/javac/comp/Resolve.java	Wed Apr 13 11:35:43 2011 -0700
    91.3 @@ -346,7 +346,7 @@
    91.4          if (typeargtypes == null) typeargtypes = List.nil();
    91.5          if (mt.tag != FORALL && typeargtypes.nonEmpty()) {
    91.6              // This is not a polymorphic method, but typeargs are supplied
    91.7 -            // which is fine, see JLS3 15.12.2.1
    91.8 +            // which is fine, see JLS 15.12.2.1
    91.9          } else if (mt.tag == FORALL && typeargtypes.nonEmpty()) {
   91.10              ForAll pmt = (ForAll) mt;
   91.11              if (typeargtypes.length() != pmt.tvars.length())
   91.12 @@ -1769,7 +1769,7 @@
   91.13  
   91.14      /**
   91.15       * Resolve an appropriate implicit this instance for t's container.
   91.16 -     * JLS2 8.8.5.1 and 15.9.2
   91.17 +     * JLS 8.8.5.1 and 15.9.2
   91.18       */
   91.19      Type resolveImplicitThis(DiagnosticPosition pos, Env<AttrContext> env, Type t) {
   91.20          return resolveImplicitThis(pos, env, t, false);

    92.1 --- a/src/share/classes/com/sun/tools/javac/jvm/Gen.java	Tue Apr 12 20:58:06 2011 -0700
    92.2 +++ b/src/share/classes/com/sun/tools/javac/jvm/Gen.java	Wed Apr 13 11:35:43 2011 -0700
    92.3 @@ -283,7 +283,7 @@
    92.4          }
    92.5  
    92.6          // leave alone methods inherited from Object
    92.7 -        // JLS2 13.1.
    92.8 +        // JLS 13.1.
    92.9          if (sym.owner == syms.objectType.tsym)
   92.10              return sym;
   92.11  

    93.1 --- a/src/share/classes/javax/annotation/processing/Processor.java	Tue Apr 12 20:58:06 2011 -0700
    93.2 +++ b/src/share/classes/javax/annotation/processing/Processor.java	Wed Apr 13 11:35:43 2011 -0700
    93.3 @@ -225,12 +225,13 @@
    93.4       * </dl>
    93.5       * </blockquote>
    93.6       *
    93.7 -     * where <i>TypeName</i> is as defined in the <i>Java Language Specification</i>.
    93.8 +     * where <i>TypeName</i> is as defined in
    93.9 +     * <cite>The Java&trade; Language Specification</cite>.
   93.10       *
   93.11       * @return the names of the annotation types supported by this processor
   93.12       * @see javax.annotation.processing.SupportedAnnotationTypes
   93.13 -     * @jls3 3.8 Identifiers
   93.14 -     * @jls3 6.5.5 Meaning of Type Names
   93.15 +     * @jls 3.8 Identifiers
   93.16 +     * @jls 6.5.5 Meaning of Type Names
   93.17       */
   93.18      Set<String> getSupportedAnnotationTypes();
   93.19  

    94.1 --- a/src/share/classes/javax/lang/model/SourceVersion.java	Tue Apr 12 20:58:06 2011 -0700
    94.2 +++ b/src/share/classes/javax/lang/model/SourceVersion.java	Wed Apr 13 11:35:43 2011 -0700
    94.3 @@ -32,10 +32,9 @@
    94.4  /**
    94.5   * Source versions of the Java™ programming language.
    94.6   *
    94.7 - * See <a
    94.8 - * href="http://java.sun.com/docs/books/jls/">http://java.sun.com/docs/books/jls/</a>
    94.9 - * for information on editions of <i>The Java&trade; Language
   94.10 - * Specification</i>, including updates and clarifications.
   94.11 + * See the appropriate edition of
   94.12 + * <cite>The Java&trade; Language Specification</cite>
   94.13 + * for information about a particular source version.
   94.14   *
   94.15   * <p>Note that additional source version constants will be added to
   94.16   * model future releases of the language.
   94.17 @@ -59,17 +58,16 @@
   94.18      /**
   94.19       * The original version.
   94.20       *
   94.21 -     * The language described in the first edition of <i>The
   94.22 -     * Java&trade; Language Specification</i>.
   94.23 +     * The language described in
   94.24 +     * <cite>The Java&trade; Language Specification, First Edition</cite>.
   94.25       */
   94.26      RELEASE_0,
   94.27  
   94.28      /**
   94.29       * The version recognized by the Java Platform 1.1.
   94.30       *
   94.31 -     * The language is {@code RELEASE_0} <a
   94.32 -     * href="http://java.sun.com/docs/books/jls/first_edition/html/1.1Update.html">augmented</a>
   94.33 -     * with nested classes.
   94.34 +     * The language is {@code RELEASE_0} augmented with nested classes as described in the 1.1 update to
   94.35 +     * <cite>The Java&trade; Language Specification, First Edition</cite>.
   94.36       */
   94.37      RELEASE_1,
   94.38  
   94.39 @@ -77,8 +75,9 @@
   94.40       * The version recognized by the Java 2 Platform, Standard Edition,
   94.41       * v 1.2.
   94.42       *
   94.43 -     * The language described in <i>The Java&trade; Language
   94.44 -     * Specification, Second Edition</i>, which includes the {@code
   94.45 +     * The language described in
   94.46 +     * <cite>The Java&trade; Language Specification,
   94.47 +     * Second Edition</cite>, which includes the {@code
   94.48       * strictfp} modifier.
   94.49       */
   94.50      RELEASE_2,
   94.51 @@ -103,8 +102,9 @@
   94.52       * The version recognized by the Java 2 Platform, Standard
   94.53       * Edition 5.0.
   94.54       *
   94.55 -     * The language described in <i>The Java&trade; Language
   94.56 -     * Specification, Third Edition</i>.  First release to support
   94.57 +     * The language described in
   94.58 +     * <cite>The Java&trade; Language Specification,
   94.59 +     * Third Edition</cite>.  First release to support
   94.60       * generics, annotations, autoboxing, var-args, enhanced {@code
   94.61       * for} loop, and hexadecimal floating-point literals.
   94.62       */
   94.63 @@ -210,7 +210,7 @@
   94.64       * @param name the string to check
   94.65       * @return {@code true} if this string is a
   94.66       * syntactically valid name, {@code false} otherwise.
   94.67 -     * @jls3 6.2 Names and Identifiers
   94.68 +     * @jls 6.2 Names and Identifiers
   94.69       */
   94.70      public static boolean isName(CharSequence name) {
   94.71          String id = name.toString();

    95.1 --- a/src/share/classes/javax/lang/model/element/Element.java	Tue Apr 12 20:58:06 2011 -0700
    95.2 +++ b/src/share/classes/javax/lang/model/element/Element.java	Wed Apr 13 11:35:43 2011 -0700
    95.3 @@ -232,8 +232,8 @@
    95.4       *
    95.5       * @return the enclosed elements, or an empty list if none
    95.6       * @see Elements#getAllMembers
    95.7 -     * @jls3 8.8.9 Default Constructor
    95.8 -     * @jls3 8.9 Enums
    95.9 +     * @jls 8.8.9 Default Constructor
   95.10 +     * @jls 8.9 Enums
   95.11       */
   95.12      List<? extends Element> getEnclosedElements();
   95.13  

    96.1 --- a/src/share/classes/javax/lang/model/element/Modifier.java	Tue Apr 12 20:58:06 2011 -0700
    96.2 +++ b/src/share/classes/javax/lang/model/element/Modifier.java	Wed Apr 13 11:35:43 2011 -0700
    96.3 @@ -46,7 +46,7 @@
    96.4  
    96.5  public enum Modifier {
    96.6  
    96.7 -    // See JLS2 sections 8.1.1, 8.3.1, 8.4.3, 8.8.3, and 9.1.1.
    96.8 +    // See JLS sections 8.1.1, 8.3.1, 8.4.3, 8.8.3, and 9.1.1.
    96.9      // java.lang.reflect.Modifier includes INTERFACE, but that's a VMism.
   96.10  
   96.11      /** The modifier {@code public} */          PUBLIC,

    97.1 --- a/src/share/classes/javax/lang/model/element/PackageElement.java	Tue Apr 12 20:58:06 2011 -0700
    97.2 +++ b/src/share/classes/javax/lang/model/element/PackageElement.java	Wed Apr 13 11:35:43 2011 -0700
    97.3 @@ -43,7 +43,7 @@
    97.4       *
    97.5       * @return the fully qualified name of this package, or an
    97.6       * empty name if this is an unnamed package
    97.7 -     * @jls3 6.7 Fully Qualified Names and Canonical Names
    97.8 +     * @jls 6.7 Fully Qualified Names and Canonical Names
    97.9       */
   97.10      Name getQualifiedName();
   97.11  
   97.12 @@ -63,7 +63,7 @@
   97.13       *
   97.14       * @return {@code true} is this is an unnamed package and {@code
   97.15       * false} otherwise
   97.16 -     * @jls3 7.4.2 Unnamed Packages
   97.17 +     * @jls 7.4.2 Unnamed Packages
   97.18       */
   97.19      boolean isUnnamed();
   97.20  

    98.1 --- a/src/share/classes/javax/lang/model/element/TypeElement.java	Tue Apr 12 20:58:06 2011 -0700
    98.2 +++ b/src/share/classes/javax/lang/model/element/TypeElement.java	Wed Apr 13 11:35:43 2011 -0700
    98.3 @@ -101,7 +101,7 @@
    98.4       * an empty name if none
    98.5       *
    98.6       * @see Elements#getBinaryName
    98.7 -     * @jls3 6.7 Fully Qualified Names and Canonical Names
    98.8 +     * @jls 6.7 Fully Qualified Names and Canonical Names
    98.9       */
   98.10      Name getQualifiedName();
   98.11  

    99.1 --- a/src/share/classes/javax/lang/model/element/VariableElement.java	Tue Apr 12 20:58:06 2011 -0700
    99.2 +++ b/src/share/classes/javax/lang/model/element/VariableElement.java	Wed Apr 13 11:35:43 2011 -0700
    99.3 @@ -59,8 +59,8 @@
    99.4       * otherwise
    99.5       *
    99.6       * @see Elements#getConstantExpression(Object)
    99.7 -     * @jls3 15.28 Constant Expression
    99.8 -     * @jls3 4.12.4 final Variables
    99.9 +     * @jls 15.28 Constant Expression
   99.10 +     * @jls 4.12.4 final Variables
   99.11       */
   99.12      Object getConstantValue();
   99.13  }

   100.1 --- a/src/share/classes/javax/lang/model/type/DeclaredType.java	Tue Apr 12 20:58:06 2011 -0700
   100.2 +++ b/src/share/classes/javax/lang/model/type/DeclaredType.java	Wed Apr 13 11:35:43 2011 -0700
   100.3 @@ -79,8 +79,8 @@
   100.4       * enclosing instance.
   100.5       *
   100.6       * @return a type mirror for the enclosing type
   100.7 -     * @jls3 8.1.3 Inner Classes and Enclosing Instances
   100.8 -     * @jls3 15.9.2 Determining Enclosing Instances
   100.9 +     * @jls 8.1.3 Inner Classes and Enclosing Instances
  100.10 +     * @jls 15.9.2 Determining Enclosing Instances
  100.11       */
  100.12      TypeMirror getEnclosingType();
  100.13  

   101.1 --- a/src/share/classes/javax/lang/model/type/TypeVariable.java	Tue Apr 12 20:58:06 2011 -0700
   101.2 +++ b/src/share/classes/javax/lang/model/type/TypeVariable.java	Wed Apr 13 11:35:43 2011 -0700
   101.3 @@ -38,8 +38,8 @@
   101.4   * type, method, or constructor.
   101.5   * A type variable may also be declared implicitly, as by
   101.6   * the capture conversion of a wildcard type argument
   101.7 - * (see chapter 5 of <i>The Java Language Specification, Third
   101.8 - * Edition</i>).
   101.9 + * (see chapter 5 of
  101.10 + * <cite>The Java&trade; Language Specification</cite>).
  101.11   *
  101.12   * @author Joseph D. Darcy
  101.13   * @author Scott Seligman

   102.1 --- a/src/share/classes/javax/lang/model/util/Elements.java	Tue Apr 12 20:58:06 2011 -0700
   102.2 +++ b/src/share/classes/javax/lang/model/util/Elements.java	Wed Apr 13 11:35:43 2011 -0700
   102.3 @@ -95,7 +95,7 @@
   102.4       * @param e  the element being examined
   102.5       * @return the documentation comment of the element, or {@code null}
   102.6       *          if there is none
   102.7 -     * @jls3 3.6 White Space
   102.8 +     * @jls 3.6 White Space
   102.9       */
  102.10      String getDocComment(Element e);
  102.11  
  102.12 @@ -114,7 +114,7 @@
  102.13       * @return the binary name
  102.14       *
  102.15       * @see TypeElement#getQualifiedName
  102.16 -     * @jls3 13.1 The Form of a Binary
  102.17 +     * @jls 13.1 The Form of a Binary
  102.18       */
  102.19      Name getBinaryName(TypeElement type);
  102.20  
  102.21 @@ -210,8 +210,8 @@
  102.22       * @param type   the type of which the first method is a member
  102.23       * @return {@code true} if and only if the first method overrides
  102.24       *          the second
  102.25 -     * @jls3 8.4.8 Inheritance, Overriding, and Hiding
  102.26 -     * @jls3 9.4.1 Inheritance and Overriding
  102.27 +     * @jls 8.4.8 Inheritance, Overriding, and Hiding
  102.28 +     * @jls 9.4.1 Inheritance and Overriding
  102.29       */
  102.30      boolean overrides(ExecutableElement overrider, ExecutableElement overridden,
  102.31                        TypeElement type);

   103.1 --- a/src/share/classes/javax/lang/model/util/Types.java	Tue Apr 12 20:58:06 2011 -0700
   103.2 +++ b/src/share/classes/javax/lang/model/util/Types.java	Wed Apr 13 11:35:43 2011 -0700
   103.3 @@ -81,7 +81,7 @@
   103.4       * @return {@code true} if and only if the first type is a subtype
   103.5       *          of the second
   103.6       * @throws IllegalArgumentException if given an executable or package type
   103.7 -     * @jls3 4.10 Subtyping
   103.8 +     * @jls 4.10 Subtyping
   103.9       */
  103.10      boolean isSubtype(TypeMirror t1, TypeMirror t2);
  103.11  
  103.12 @@ -93,7 +93,7 @@
  103.13       * @return {@code true} if and only if the first type is assignable
  103.14       *          to the second
  103.15       * @throws IllegalArgumentException if given an executable or package type
  103.16 -     * @jls3 5.2 Assignment Conversion
  103.17 +     * @jls 5.2 Assignment Conversion
  103.18       */
  103.19      boolean isAssignable(TypeMirror t1, TypeMirror t2);
  103.20  
  103.21 @@ -104,7 +104,7 @@
  103.22       * @param t2  the second type
  103.23       * @return {@code true} if and only if the first type contains the second
  103.24       * @throws IllegalArgumentException if given an executable or package type
  103.25 -     * @jls3 4.5.1.1 Type Argument Containment and Equivalence
  103.26 +     * @jls 4.5.1.1 Type Argument Containment and Equivalence
  103.27       */
  103.28      boolean contains(TypeMirror t1, TypeMirror t2);
  103.29  
  103.30 @@ -116,7 +116,7 @@
  103.31       * @param m2  the second method
  103.32       * @return {@code true} if and only if the first signature is a
  103.33       *          subsignature of the second
  103.34 -     * @jls3 8.4.2 Method Signature
  103.35 +     * @jls 8.4.2 Method Signature
  103.36       */
  103.37      boolean isSubsignature(ExecutableType m1, ExecutableType m2);
  103.38  
  103.39 @@ -136,7 +136,7 @@
  103.40       * @param t  the type to be erased
  103.41       * @return the erasure of the given type
  103.42       * @throws IllegalArgumentException if given a package type
  103.43 -     * @jls3 4.6 Type Erasure
  103.44 +     * @jls 4.6 Type Erasure
  103.45       */
  103.46      TypeMirror erasure(TypeMirror t);
  103.47  
  103.48 @@ -146,7 +146,7 @@
  103.49       *
  103.50       * @param p  the primitive type to be converted
  103.51       * @return the class of a boxed value of type {@code p}
  103.52 -     * @jls3 5.1.7 Boxing Conversion
  103.53 +     * @jls 5.1.7 Boxing Conversion
  103.54       */
  103.55      TypeElement boxedClass(PrimitiveType p);
  103.56  
  103.57 @@ -158,7 +158,7 @@
  103.58       * @return the type of an unboxed value of type {@code t}
  103.59       * @throws IllegalArgumentException if the given type has no
  103.60       *          unboxing conversion
  103.61 -     * @jls3 5.1.8 Unboxing Conversion
  103.62 +     * @jls 5.1.8 Unboxing Conversion
  103.63       */
  103.64      PrimitiveType unboxedType(TypeMirror t);
  103.65  
  103.66 @@ -168,7 +168,7 @@
  103.67       * @param t  the type to be converted
  103.68       * @return the result of applying capture conversion
  103.69       * @throws IllegalArgumentException if given an executable or package type
  103.70 -     * @jls3 5.1.10 Capture Conversion
  103.71 +     * @jls 5.1.10 Capture Conversion
  103.72       */
  103.73      TypeMirror capture(TypeMirror t);
  103.74  

   104.1 --- a/src/share/classes/javax/tools/JavaCompiler.java	Tue Apr 12 20:58:06 2011 -0700
   104.2 +++ b/src/share/classes/javax/tools/JavaCompiler.java	Wed Apr 13 11:35:43 2011 -0700
   104.3 @@ -58,9 +58,11 @@
   104.4   * standard file manager such as the one returned by {@linkplain
   104.5   * #getStandardFileManager getStandardFileManager}.
   104.6   *
   104.7 - * <p>An instance implementing this interface must conform to the Java
   104.8 - * Language Specification and generate class files conforming to the
   104.9 - * Java Virtual Machine specification.  The versions of these
  104.10 + * <p>An instance implementing this interface must conform to
  104.11 + * <cite>The Java&trade; Language Specification</cite>
  104.12 + * and generate class files conforming to
  104.13 + * <cite>The Java&trade; Virtual Machine Specification</cite>.
  104.14 + * The versions of these
  104.15   * specifications are defined in the {@linkplain Tool} interface.
  104.16   *
  104.17   * Additionally, an instance of this interface supporting {@link

   105.1 --- a/src/share/classes/javax/tools/JavaFileManager.java	Tue Apr 12 20:58:06 2011 -0700
   105.2 +++ b/src/share/classes/javax/tools/JavaFileManager.java	Wed Apr 13 11:35:43 2011 -0700
   105.3 @@ -49,17 +49,16 @@
   105.4   * names must be given in the Java Virtual Machine internal form of
   105.5   * fully qualified class and interface names.  For convenience '.'
   105.6   * and '/' are interchangeable.  The internal form is defined in
   105.7 - * chapter four of the
   105.8 - * <a href="http://java.sun.com/docs/books/vmspec/2nd-edition/jvms-maintenance.html">Java
   105.9 - * Virtual Machine Specification</a>.
  105.10 + * chapter four of
  105.11 + * <cite>The Java&trade; Virtual Machine Specification</cite>.
  105.12  
  105.13   * <blockquote><p>
  105.14   *   <i>Discussion:</i> this means that the names
  105.15   *   "java/lang.package-info", "java/lang/package-info",
  105.16   *   "java.lang.package-info", are valid and equivalent.  Compare to
  105.17 - *   binary name as defined in the
  105.18 - *   <a href="http://java.sun.com/docs/books/jls/">Java Language
  105.19 - *   Specification (JLS)</a> section 13.1 "The Form of a Binary".
  105.20 + *   binary name as defined in
  105.21 + *   <cite>The Java&trade; Language Specification</cite>,
  105.22 + *   section 13.1 "The Form of a Binary".
  105.23   * </p></blockquote>
  105.24   *
  105.25   * <p>The case of names is significant.  All names should be treated
  105.26 @@ -173,7 +172,8 @@
  105.27  
  105.28      /**
  105.29       * Infers a binary name of a file object based on a location.  The
  105.30 -     * binary name returned might not be a valid JLS binary name.
  105.31 +     * binary name returned might not be a valid binary name according to
  105.32 +     * <cite>The Java&trade; Language Specification</cite>.
  105.33       *
  105.34       * @param location a location
  105.35       * @param file a file object

   106.1 --- a/src/share/classes/javax/tools/JavaFileObject.java	Tue Apr 12 20:58:06 2011 -0700
   106.2 +++ b/src/share/classes/javax/tools/JavaFileObject.java	Wed Apr 13 11:35:43 2011 -0700
   106.3 @@ -99,9 +99,9 @@
   106.4      /**
   106.5       * Checks if this file object is compatible with the specified
   106.6       * simple name and kind.  A simple name is a single identifier
   106.7 -     * (not qualified) as defined in the <a
   106.8 -     * href="http://java.sun.com/docs/books/jls/">Java Language
   106.9 -     * Specification</a> 3rd ed., section 6.2 "Names and Identifiers".
  106.10 +     * (not qualified) as defined in
  106.11 +     * <cite>The Java&trade; Language Specification</cite>,
  106.12 +     * section 6.2 "Names and Identifiers".
  106.13       *
  106.14       * @param simpleName a simple name of a class
  106.15       * @param kind a kind

   107.1 --- a/src/share/sample/javac/processing/src/CheckNamesProcessor.java	Tue Apr 12 20:58:06 2011 -0700
   107.2 +++ b/src/share/sample/javac/processing/src/CheckNamesProcessor.java	Wed Apr 13 11:35:43 2011 -0700
   107.3 @@ -152,7 +152,8 @@
   107.4       * Provide checks that an element and its enclosed elements follow
   107.5       * the usual naming conventions.
   107.6       *
   107.7 -     * <p> Conventions from JLSv3 section 6.8:
   107.8 +     * <p> Conventions from section 6.8 of
   107.9 +     *     <cite>The Java&trade; Language Specification</cite>
  107.10       *
  107.11       * <ul>
  107.12       * <li> Classes and interfaces: camel case, first letter is uppercase
  107.13 @@ -163,7 +164,8 @@
  107.14       * <li> non-final: camel case, initial lowercase
  107.15       * <li> constant: uppercase separated by underscores
  107.16       * </ul>
  107.17 -     * <li> Packages: checks left as exercise for the reader, see JLSv3 section 7.7
  107.18 +     * <li> Packages: checks left as exercise for the reader, see section 7.7 of
  107.19 +     * <cite>The Java&trade; Language Specification</cite>.
  107.20       * </ul>
  107.21       */
  107.22      private static class NameChecker {
  107.23 @@ -286,7 +288,7 @@
  107.24              public Void visitPackage(PackageElement e, Void p) {
  107.25                  /*
  107.26                   * Implementing the checks of package names is left
  107.27 -                 * as an exercise for the reader, see JLSv3 section
  107.28 +                 * as an exercise for the reader, see JLS section
  107.29                   * 7.7 for conventions.
  107.30                   */
  107.31