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
This commit is contained in:
Jim Holmlund 2011-04-13 11:35:43 -07:00
parent 02daeca60e
commit e9456bc9af
107 changed files with 184 additions and 171 deletions

View File

@ -71,9 +71,18 @@ javac.version.opt =
javac.lint.opts = -Xlint:all,-deprecation -Werror
# options for the <javadoc> task for javac
javadoc.jls3.url=http://java.sun.com/docs/books/jls/
javadoc.jls3.cite=&lt;a href=&quot;${javadoc.jls3.url}&quot;&gt;The Java Language Specification, Third Edition&lt;/a&gt;
javadoc.jls3.option=-tag "jls3:a:See &lt;cite&gt;${javadoc.jls3.cite}&lt;/cite&gt;:"
#javadoc.jls3.url=http://java.sun.com/docs/books/jls/
#javadoc.jls3.cite=&lt;a href=&quot;${javadoc.jls3.url}&quot;&gt;The Java Language Specification, Third Edition&lt;/a&gt;
#javadoc.jls3.option=-tag "jls3:a:See &lt;cite&gt;${javadoc.jls3.cite}&lt;/cite&gt;:"
javadoc.jls.cite=The Java&trade; Language Specification
javadoc.jls.option=-tag "jls:a:See &lt;cite&gt;${javadoc.jls.cite}&lt;/cite&gt;:"
# jtreg, used to run the JDK regression tests
# See http://openjdk.java.net/jtreg/

View File

@ -464,7 +464,7 @@
</target>
<target name="javadoc-javac" depends="build-javac,-def-javadoc-tool">
<javadoc-tool name="javac" includes="${javac.includes}" options="${javadoc.jls3.option}"/>
<javadoc-tool name="javac" includes="${javac.includes}" options="${javadoc.jls.option}"/>
</target>
<target name="jtreg-javac" depends="build-javac,build-javap,-def-jtreg">

View File

@ -311,8 +311,8 @@ public interface ClassDoc extends ProgramElementDoc, Type {
/**
* Get the list of classes and interfaces declared as imported.
* These are called "single-type-import declarations" in the
* Java Language Specification.
* These are called "single-type-import declarations" in
* <cite>The Java&trade; Language Specification</cite>.
*
* @return an array of ClassDoc representing the imported classes.
*
@ -325,8 +325,8 @@ public interface ClassDoc extends ProgramElementDoc, Type {
/**
* Get the list of packages declared as imported.
* These are called "type-import-on-demand declarations" in the
* Java Language Specification.
* These are called "type-import-on-demand declarations" in
* <cite>The Java&trade; Language Specification</cite>.
*
* @return an array of PackageDoc representing the imported packages.
*

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -67,7 +67,8 @@ public class DeclarationsImpl implements Declarations {
/**
* {@inheritDoc}
* See JLS 2 sections 8.3 and 8.4.6.
* See sections 8.3 and 8.4.6 of
* <cite>The Java&trade; Language Specification</cite>
*/
public boolean hides(MemberDeclaration sub, MemberDeclaration sup) {
Symbol hider = ((DeclarationImpl) sub).sym;
@ -107,7 +108,8 @@ public class DeclarationsImpl implements Declarations {
/**
* {@inheritDoc}
* See JLS 2 section 8.4.6.1.
* See section 8.4.6.1 of
* <cite>The Java&trade; Language Specification</cite>
*/
public boolean overrides(MethodDeclaration sub, MethodDeclaration sup) {
MethodSymbol overrider = ((MethodDeclarationImpl) sub).sym;

View File

@ -30,7 +30,7 @@ import java.util.LinkedHashSet;
import java.util.Set;
/**
* See JVMS3, sections 4.2, 4.6, 4.7.
* See JVMS, sections 4.2, 4.6, 4.7.
*
* <p><b>This is NOT part of any supported API.
* If you write code that depends on this, you do so at your own risk.

View File

@ -28,7 +28,7 @@ package com.sun.tools.classfile;
import java.io.IOException;
/**
* See JVMS3, section 4.8.16.
* See JVMS, section 4.8.16.
*
* <p><b>This is NOT part of any supported API.
* If you write code that depends on this, you do so at your own risk.
@ -71,7 +71,7 @@ public class Annotation {
public final element_value_pair element_value_pairs[];
/**
* See JVMS3, section 4.8.16.1.
* See JVMS, section 4.8.16.1.
*/
public static abstract class element_value {
public static element_value read(ClassReader cr)

View File

@ -28,7 +28,7 @@ package com.sun.tools.classfile;
import java.io.IOException;
/**
* See JVMS3, section 4.8.15.
* See JVMS, section 4.8.15.
*
* <p><b>This is NOT part of any supported API.
* If you write code that depends on this, you do so at your own risk.

View File

@ -28,7 +28,7 @@ package com.sun.tools.classfile;
import java.io.IOException;
/**
* See JVMS3 <TBD>
* See JVMS <TBD>
* http://cr.openjdk.java.net/~jrose/pres/indy-javadoc-mlvm/
*
* <p><b>This is NOT part of any supported API.

View File

@ -33,7 +33,7 @@ import java.io.InputStream;
import static com.sun.tools.classfile.AccessFlags.*;
/**
* See JVMS3, section 4.2.
* See JVMS, section 4.2.
*
* <p><b>This is NOT part of any supported API.
* If you write code that depends on this, you do so at your own risk.

View File

@ -30,7 +30,7 @@ import java.util.Iterator;
import java.util.NoSuchElementException;
/**
* See JVMS3, section 4.8.3.
* See JVMS, section 4.8.3.
*
* <p><b>This is NOT part of any supported API.
* If you write code that depends on this, you do so at your own risk.

View File

@ -31,7 +31,7 @@ import java.io.OutputStream;
import java.util.Iterator;
/**
* See JVMS3, section 4.5.
* See JVMS, section 4.5.
*
* <p><b>This is NOT part of any supported API.
* If you write code that depends on this, you do so at your own risk.

View File

@ -28,7 +28,7 @@ package com.sun.tools.classfile;
import java.io.IOException;
/**
* See JVMS3, section 4.8.2.
* See JVMS, section 4.8.2.
*
* <p><b>This is NOT part of any supported API.
* If you write code that depends on this, you do so at your own risk.

View File

@ -28,7 +28,7 @@ package com.sun.tools.classfile;
import java.io.IOException;
/**
* See JVMS3, section 4.8.15.
* See JVMS, section 4.8.15.
*
* <p><b>This is NOT part of any supported API.
* If you write code that depends on this, you do so at your own risk.

View File

@ -29,7 +29,7 @@ package com.sun.tools.classfile;
import java.io.IOException;
/**
* See JVMS3, section 4.4.
* See JVMS, section 4.4.
*
* <p><b>This is NOT part of any supported API.
* If you write code that depends on this, you do so at your own risk.

View File

@ -29,7 +29,7 @@ package com.sun.tools.classfile;
import java.io.IOException;
/**
* See JVMS3, section 4.8.7.
* See JVMS, section 4.8.7.
*
* <p><b>This is NOT part of any supported API.
* If you write code that depends on this, you do so at your own risk.

View File

@ -28,7 +28,7 @@ package com.sun.tools.classfile;
import java.io.IOException;
/**
* See JVMS3, section 4.8.5.
* See JVMS, section 4.8.5.
*
* <p><b>This is NOT part of any supported API.
* If you write code that depends on this, you do so at your own risk.

View File

@ -30,7 +30,7 @@ import java.io.IOException;
import com.sun.tools.classfile.ConstantPool.*;
/**
* See JVMS3, section 4.8.6.
* See JVMS, section 4.8.6.
*
* <p><b>This is NOT part of any supported API.
* If you write code that depends on this, you do so at your own risk.

View File

@ -26,7 +26,7 @@
package com.sun.tools.classfile;
/**
* See JVMS3, chapter 6.
* See JVMS, chapter 6.
*
* <p><b>This is NOT part of any supported API.
* If you write code that depends on this, you do so at your own risk.

View File

@ -28,7 +28,7 @@ package com.sun.tools.classfile;
import java.io.IOException;
/**
* See JVMS3, section 4.8.12.
* See JVMS, section 4.8.12.
*
* <p><b>This is NOT part of any supported API.
* If you write code that depends on this, you do so at your own risk.

View File

@ -28,7 +28,7 @@ package com.sun.tools.classfile;
import java.io.IOException;
/**
* See JVMS3, section 4.8.13.
* See JVMS, section 4.8.13.
*
* <p><b>This is NOT part of any supported API.
* If you write code that depends on this, you do so at your own risk.

View File

@ -28,7 +28,7 @@ package com.sun.tools.classfile;
import java.io.IOException;
/**
* See JVMS3, section 4.8.14.
* See JVMS, section 4.8.14.
*
* <p><b>This is NOT part of any supported API.
* If you write code that depends on this, you do so at your own risk.

View File

@ -29,7 +29,7 @@ import static com.sun.tools.classfile.Instruction.Kind.*;
import static com.sun.tools.classfile.Opcode.Set.*;
/**
* See JVMS3, chapter 6.
* See JVMS, chapter 6.
*
* <p>In addition to providing all the standard opcodes defined in JVMS,
* this class also provides legacy support for the PicoJava extensions.

View File

@ -28,7 +28,7 @@ package com.sun.tools.classfile;
import java.io.IOException;
/**
* See JVMS3, section 4.8.16 and 4.8.17.
* See JVMS, section 4.8.16 and 4.8.17.
*
* <p><b>This is NOT part of any supported API.
* If you write code that depends on this, you do so at your own risk.

View File

@ -28,7 +28,7 @@ package com.sun.tools.classfile;
import java.io.IOException;
/**
* See JVMS3, section 4.8.17.
* See JVMS, section 4.8.17.
*
* <p><b>This is NOT part of any supported API.
* If you write code that depends on this, you do so at your own risk.

View File

@ -28,7 +28,7 @@ package com.sun.tools.classfile;
import java.io.IOException;
/**
* See JVMS3, section 4.8.18.
* See JVMS, section 4.8.18.
*
* <p><b>This is NOT part of any supported API.
* If you write code that depends on this, you do so at your own risk.

View File

@ -28,7 +28,7 @@ package com.sun.tools.classfile;
import java.io.IOException;
/**
* See JVMS3, section 4.8.18 and 4.8.19.
* See JVMS, section 4.8.18 and 4.8.19.
*
* <p><b>This is NOT part of any supported API.
* If you write code that depends on this, you do so at your own risk.

View File

@ -28,7 +28,7 @@ package com.sun.tools.classfile;
import java.io.IOException;
/**
* See JVMS3, section 4.8.16.
* See JVMS, section 4.8.16.
*
* <p><b>This is NOT part of any supported API.
* If you write code that depends on this, you do so at your own risk.

View File

@ -28,7 +28,7 @@ package com.sun.tools.classfile;
import java.io.IOException;
/**
* See JVMS3, section 4.8.18.
* See JVMS, section 4.8.18.
*
* <p><b>This is NOT part of any supported API.
* If you write code that depends on this, you do so at your own risk.

View File

@ -30,7 +30,7 @@ import java.util.List;
import com.sun.tools.classfile.Type.*;
/**
* See JVMS3 4.4.4.
* See JVMS 4.4.4.
*
* <p><b>This is NOT part of any supported API.
* If you write code that depends on this, you do so at your own risk.

View File

@ -28,7 +28,7 @@ package com.sun.tools.classfile;
import java.io.IOException;
/**
* See JVMS3, section 4.8.9.
* See JVMS, section 4.8.9.
*
* <p><b>This is NOT part of any supported API.
* If you write code that depends on this, you do so at your own risk.

View File

@ -30,7 +30,7 @@ import java.io.DataInputStream;
import java.io.IOException;
/**
* See JVMS3, section 4.8.15.
* See JVMS, section 4.8.15.
*
* <p><b>This is NOT part of any supported API.
* If you write code that depends on this, you do so at your own risk.

View File

@ -28,7 +28,7 @@ package com.sun.tools.classfile;
import java.io.IOException;
/**
* See JVMS3, section 4.8.10.
* See JVMS, section 4.8.10.
*
* <p><b>This is NOT part of any supported API.
* If you write code that depends on this, you do so at your own risk.

View File

@ -28,7 +28,7 @@ package com.sun.tools.classfile;
import java.io.IOException;
/**
* See JVMS3, section 4.8.4.
* See JVMS, section 4.8.4.
*
* <p><b>This is NOT part of any supported API.
* If you write code that depends on this, you do so at your own risk.

View File

@ -28,7 +28,7 @@ package com.sun.tools.classfile;
import java.io.IOException;
/**
* See JVMS3, section 4.8.8.
* See JVMS, section 4.8.8.
*
* <p><b>This is NOT part of any supported API.
* If you write code that depends on this, you do so at your own risk.

View File

@ -6,7 +6,7 @@
</head>
<body>
A minimalist library to read and write class files into objects closely
based on the corresponding definitions in the Java Virtual Machine
Specification (JVMS).
based on the corresponding definitions in
<cite>The Java&trade; Virtual Machine Specification</cite> (JVMS).
</body>
</html>

View File

@ -2523,8 +2523,9 @@ public class HtmlDocletWriter extends HtmlDocWriter {
}
/**
* According to the Java Language Specifications, all the outer classes
* and static nested classes are core classes.
* According to
* <cite>The Java&trade; Language Specification</cite>,
* all the outer classes and static nested classes are core classes.
*/
public boolean isCoreClass(ClassDoc cd) {
return cd.containingClass() == null || cd.isStatic();

View File

@ -175,8 +175,9 @@ public class Util {
}
/**
* According to the Java Language Specifications, all the outer classes
* and static inner classes are core classes.
* According to
* <cite>The Java&trade; Language Specification</cite>,
* all the outer classes and static inner classes are core classes.
*/
public static boolean isCoreClass(ClassDoc cd) {
return cd.containingClass() == null || cd.isStatic();

View File

@ -1193,7 +1193,7 @@ public abstract class Symbol implements Element {
}
private boolean isOverridableIn(TypeSymbol origin) {
// JLS3 8.4.6.1
// JLS 8.4.6.1
switch ((int)(flags_field & Flags.AccessFlags)) {
case Flags.PRIVATE:
return false;

View File

@ -1985,7 +1985,7 @@ public class Types {
* signature</em> of the other. This is <b>not</b> an equivalence
* relation.
*
* @see "The Java Language Specification, Third Ed. (8.4.2)."
* @jls section 8.4.2.
* @see #overrideEquivalent(Type t, Type s)
* @param t first signature (possibly raw).
* @param s second signature (could be subjected to erasure).
@ -2004,7 +2004,7 @@ public class Types {
* equivalence</em>. This is the natural extension of
* isSubSignature to an equivalence relation.
*
* @see "The Java Language Specification, Third Ed. (8.4.2)."
* @jls section 8.4.2.
* @see #isSubSignature(Type t, Type s)
* @param t a signature (possible raw, could be subjected to
* erasure).
@ -3049,8 +3049,7 @@ public class Types {
/**
* Return-Type-Substitutable.
* @see <a href="http://java.sun.com/docs/books/jls/">The Java
* Language Specification, Third Ed. (8.4.5)</a>
* @jls section 8.4.5
*/
public boolean returnTypeSubstitutable(Type r1, Type r2) {
if (hasSameArgs(r1, r2))
@ -3130,7 +3129,7 @@ public class Types {
// <editor-fold defaultstate="collapsed" desc="Capture conversion">
/*
* JLS 3rd Ed. 5.1.10 Capture Conversion:
* JLS 5.1.10 Capture Conversion:
*
* Let G name a generic type declaration with n formal type
* parameters A1 ... An with corresponding bounds U1 ... Un. There
@ -3163,7 +3162,7 @@ public class Types {
* Capture conversion is not applied recursively.
*/
/**
* Capture conversion as specified by JLS 3rd Ed.
* Capture conversion as specified by the JLS.
*/
public List<Type> capture(List<Type> ts) {

View File

@ -2632,10 +2632,10 @@ public class Attr extends JCTree.Visitor {
* @param tree The tree making up the variable reference.
* @param env The current environment.
* @param v The variable's symbol.
* @see JLS 3rd Ed. (8.9 Enums)
* @jls section 8.9 Enums
*/
private void checkEnumInitializer(JCTree tree, Env<AttrContext> env, VarSymbol v) {
// JLS 3rd Ed.:
// JLS:
//
// "It is a compile-time error to reference a static field
// of an enum type that is not a compile-time constant

View File

@ -2271,7 +2271,7 @@ public class Check {
* that of any public or protected method declared in class Object
* or in the interface annotation.Annotation."
*
* @jls3 9.6 Annotation Types
* @jls 9.6 Annotation Types
*/
void validateAnnotationMethod(DiagnosticPosition pos, MethodSymbol m) {
for (Type sup = syms.annotationType; sup.tag == CLASS; sup = types.supertype(sup)) {

View File

@ -51,7 +51,7 @@ import static com.sun.tools.javac.code.TypeTags.*;
* unassignment analysis ensures that no final variable is assigned
* more than once.
*
* <p>The second edition of the JLS has a number of problems in the
* <p>The JLS has a number of problems in the
* specification of these flow analysis problems. This implementation
* attempts to address those issues.
*
@ -126,7 +126,7 @@ import static com.sun.tools.javac.code.TypeTags.*;
* don't have to worry about the return expression because this
* concept is only used for construcrors.
*
* <p>There is no spec in JLS2 for when a variable is definitely
* <p>There is no spec in the JLS for when a variable is definitely
* assigned at the end of a constructor, which is needed for final
* fields (8.3.1.2). We implement the rule that V is DA at the end
* of the constructor iff it is DA and the end of the body of the

View File

@ -346,7 +346,7 @@ public class Resolve {
if (typeargtypes == null) typeargtypes = List.nil();
if (mt.tag != FORALL && typeargtypes.nonEmpty()) {
// This is not a polymorphic method, but typeargs are supplied
// which is fine, see JLS3 15.12.2.1
// which is fine, see JLS 15.12.2.1
} else if (mt.tag == FORALL && typeargtypes.nonEmpty()) {
ForAll pmt = (ForAll) mt;
if (typeargtypes.length() != pmt.tvars.length())
@ -1769,7 +1769,7 @@ public class Resolve {
/**
* Resolve an appropriate implicit this instance for t's container.
* JLS2 8.8.5.1 and 15.9.2
* JLS 8.8.5.1 and 15.9.2
*/
Type resolveImplicitThis(DiagnosticPosition pos, Env<AttrContext> env, Type t) {
return resolveImplicitThis(pos, env, t, false);

View File

@ -283,7 +283,7 @@ public class Gen extends JCTree.Visitor {
}
// leave alone methods inherited from Object
// JLS2 13.1.
// JLS 13.1.
if (sym.owner == syms.objectType.tsym)
return sym;

View File

@ -225,12 +225,13 @@ public interface Processor {
* </dl>
* </blockquote>
*
* where <i>TypeName</i> is as defined in the <i>Java Language Specification</i>.
* where <i>TypeName</i> is as defined in
* <cite>The Java&trade; Language Specification</cite>.
*
* @return the names of the annotation types supported by this processor
* @see javax.annotation.processing.SupportedAnnotationTypes
* @jls3 3.8 Identifiers
* @jls3 6.5.5 Meaning of Type Names
* @jls 3.8 Identifiers
* @jls 6.5.5 Meaning of Type Names
*/
Set<String> getSupportedAnnotationTypes();

View File

@ -32,10 +32,9 @@ import java.util.HashSet;
/**
* Source versions of the Java&trade; programming language.
*
* See <a
* href="http://java.sun.com/docs/books/jls/">http://java.sun.com/docs/books/jls/</a>
* for information on editions of <i>The Java&trade; Language
* Specification</i>, including updates and clarifications.
* See the appropriate edition of
* <cite>The Java&trade; Language Specification</cite>
* for information about a particular source version.
*
* <p>Note that additional source version constants will be added to
* model future releases of the language.
@ -59,17 +58,16 @@ public enum SourceVersion {
/**
* The original version.
*
* The language described in the first edition of <i>The
* Java&trade; Language Specification</i>.
* The language described in
* <cite>The Java&trade; Language Specification, First Edition</cite>.
*/
RELEASE_0,
/**
* The version recognized by the Java Platform 1.1.
*
* The language is {@code RELEASE_0} <a
* href="http://java.sun.com/docs/books/jls/first_edition/html/1.1Update.html">augmented</a>
* with nested classes.
* The language is {@code RELEASE_0} augmented with nested classes as described in the 1.1 update to
* <cite>The Java&trade; Language Specification, First Edition</cite>.
*/
RELEASE_1,
@ -77,8 +75,9 @@ public enum SourceVersion {
* The version recognized by the Java 2 Platform, Standard Edition,
* v 1.2.
*
* The language described in <i>The Java&trade; Language
* Specification, Second Edition</i>, which includes the {@code
* The language described in
* <cite>The Java&trade; Language Specification,
* Second Edition</cite>, which includes the {@code
* strictfp} modifier.
*/
RELEASE_2,
@ -103,8 +102,9 @@ public enum SourceVersion {
* The version recognized by the Java 2 Platform, Standard
* Edition 5.0.
*
* The language described in <i>The Java&trade; Language
* Specification, Third Edition</i>. First release to support
* The language described in
* <cite>The Java&trade; Language Specification,
* Third Edition</cite>. First release to support
* generics, annotations, autoboxing, var-args, enhanced {@code
* for} loop, and hexadecimal floating-point literals.
*/
@ -210,7 +210,7 @@ public enum SourceVersion {
* @param name the string to check
* @return {@code true} if this string is a
* syntactically valid name, {@code false} otherwise.
* @jls3 6.2 Names and Identifiers
* @jls 6.2 Names and Identifiers
*/
public static boolean isName(CharSequence name) {
String id = name.toString();

View File

@ -232,8 +232,8 @@ public interface Element {
*
* @return the enclosed elements, or an empty list if none
* @see Elements#getAllMembers
* @jls3 8.8.9 Default Constructor
* @jls3 8.9 Enums
* @jls 8.8.9 Default Constructor
* @jls 8.9 Enums
*/
List<? extends Element> getEnclosedElements();

View File

@ -46,7 +46,7 @@ package javax.lang.model.element;
public enum Modifier {
// See JLS2 sections 8.1.1, 8.3.1, 8.4.3, 8.8.3, and 9.1.1.
// See JLS sections 8.1.1, 8.3.1, 8.4.3, 8.8.3, and 9.1.1.
// java.lang.reflect.Modifier includes INTERFACE, but that's a VMism.
/** The modifier {@code public} */ PUBLIC,

View File

@ -43,7 +43,7 @@ public interface PackageElement extends Element, QualifiedNameable {
*
* @return the fully qualified name of this package, or an
* empty name if this is an unnamed package
* @jls3 6.7 Fully Qualified Names and Canonical Names
* @jls 6.7 Fully Qualified Names and Canonical Names
*/
Name getQualifiedName();
@ -63,7 +63,7 @@ public interface PackageElement extends Element, QualifiedNameable {
*
* @return {@code true} is this is an unnamed package and {@code
* false} otherwise
* @jls3 7.4.2 Unnamed Packages
* @jls 7.4.2 Unnamed Packages
*/
boolean isUnnamed();

View File

@ -101,7 +101,7 @@ public interface TypeElement extends Element, Parameterizable, QualifiedNameable
* an empty name if none
*
* @see Elements#getBinaryName
* @jls3 6.7 Fully Qualified Names and Canonical Names
* @jls 6.7 Fully Qualified Names and Canonical Names
*/
Name getQualifiedName();

View File

@ -59,8 +59,8 @@ public interface VariableElement extends Element {
* otherwise
*
* @see Elements#getConstantExpression(Object)
* @jls3 15.28 Constant Expression
* @jls3 4.12.4 final Variables
* @jls 15.28 Constant Expression
* @jls 4.12.4 final Variables
*/
Object getConstantValue();
}

View File

@ -79,8 +79,8 @@ public interface DeclaredType extends ReferenceType {
* enclosing instance.
*
* @return a type mirror for the enclosing type
* @jls3 8.1.3 Inner Classes and Enclosing Instances
* @jls3 15.9.2 Determining Enclosing Instances
* @jls 8.1.3 Inner Classes and Enclosing Instances
* @jls 15.9.2 Determining Enclosing Instances
*/
TypeMirror getEnclosingType();

Some files were not shown because too many files have changed in this diff Show More