7032960: API files in java.awt need to be updated for references to JVM Spec with editions/hyperlinks
7032965: API files in java.io need to updated for references to JVM Spec with editions/hyperlinks
7032958: API files in java.lang need to updated for references to JLS with editions/hyperlinks
7032961: API files in java.lang need to updated for references to JVM with editions/hyperlinks
7032976: API files in javax.lang need to be updated for references to JLS with editions/hyperlinks
7032959: API files in java.util need to updated for references to JLS with editions/hyperlinks
7032962: API files in java.util need to updated for references to JVM Spec with editions/hyperlinks
7032967: API files in java.security need to updated for references to JVM Spec with editions/hyperlinks
7032955: API files in java.math need to updated for references to JLS with editions/hyperlinks
Summary: Removed URLs and 'edition' references
Reviewed-by: darcy
--- a/jdk/make/docs/Makefile Wed Apr 13 11:59:18 2011 -0700
+++ b/jdk/make/docs/Makefile Wed Apr 13 12:16:13 2011 -0700
@@ -53,7 +53,7 @@
DEV_DOCS_URL = $(DEV_DOCS_URL-$(JDK_MINOR_VERSION))
# Url to Java Language Spec
-JLS3_URL = http://java.sun.com/docs/books/jls/
+#JLS3_URL = http://java.sun.com/docs/books/jls/
# Common Java trademark line
JAVA_TRADEMARK_LINE = Java is a trademark or registered trademark of \
@@ -293,8 +293,8 @@
<strong>Java$(TRADEMARK) Platform<br>Standard Ed. $(JDK_MINOR_VERSION)</strong>
# Java language specification cite
-TAG_JLS3 = jls3:a:See <cite><a href="$(JLS3_URL)"> \
-The Java Language Specification, Third Edition</a></cite>:
+TAG_JLS = jls:a:See <cite> \
+The Java™ Language Specification</cite>:
# Overview file for core apis
COREAPI_OVERVIEW = $(SHARE_SRC)/classes/overview-core.html
@@ -329,7 +329,7 @@
$(call OptionPair,-tag,specdefault:X) ; \
$(call OptionPair,-tag,Note:X) ; \
$(call OptionPair,-tag,ToDo:X) ; \
- $(call OptionPair,-tag,$(TAG_JLS3)) ; \
+ $(call OptionPair,-tag,$(TAG_JLS)) ; \
$(call OptionOnly,-splitIndex) ; \
$(call OptionPair,-overview,$(COREAPI_OVERVIEW)) ; \
$(call OptionPair,-doctitle,$(COREAPI_DOCTITLE)) ; \
@@ -1081,6 +1081,7 @@
$(call OptionPair,-doctitle,$(TREEAPI_DOCTITLE)) ; \
$(call OptionPair,-windowtitle,$(TREEAPI_WINDOWTITLE) $(DRAFT_WINTITLE));\
$(call OptionPair,-header,$(TREEAPI_HEADER)$(DRAFT_HEADER)) ; \
+ $(call OptionPair,-tag,$(TAG_JLS)) ; \
$(call OptionPair,-bottom,$(TREEAPI_BOTTOM)$(DRAFT_BOTTOM)) ; \
$(call OptionTrip,-group,$(TREEAPI_GROUPNAME),$(TREEAPI_REGEXP)); \
$(call OptionTrip,-linkoffline,$(TREEAPI2COREAPI),$(COREAPI_DOCSDIR)/); \
--- a/jdk/make/jpda/jdwp/jdwp.spec Wed Apr 13 11:59:18 2011 -0700
+++ b/jdk/make/jpda/jdwp/jdwp.spec Wed Apr 13 12:16:13 2011 -0700
@@ -519,9 +519,8 @@
"Both the JNI signature and the generic signature are "
"returned for each class. "
"Generic signatures are described in the signature attribute "
- "section in the "
- "<a href=\"http://java.sun.com/docs/books/vmspec\">
- "Java Virtual Machine Specification, 3rd Edition.</a> "
+ "section in "
+ "<cite>The Java™ Virtual Machine Specification</cite>. "
"Since JDWP version 1.5."
(Out
)
@@ -623,8 +622,8 @@
(referenceType refType "The reference type ID.")
)
(Reply
- (int modBits "Modifier bits as defined in the "
- "<a href=\"http://java.sun.com/docs/books/vmspec/html/ClassFile.doc.html\">VM Specification</a>")
+ (int modBits "Modifier bits as defined in Chapter 4 of "
+ "<cite>The Java™ Virtual Machine Specification</cite>")
)
(ErrorSet
(Error INVALID_CLASS "refType is not the ID of a reference "
@@ -651,8 +650,8 @@
(int modBits "The modifier bit flags (also known as access flags) "
"which provide additional information on the "
"field declaration. Individual flag values are "
- "defined in the "
- "<a href=\"http://java.sun.com/docs/books/vmspec/html/ClassFile.doc.html\">VM Specification</a>."
+ "defined in Chapter 4 of "
+ "<cite>The Java™ Virtual Machine Specification</cite>. "
"In addition, The <code>0xf0000000</code> bit identifies "
"the field as synthetic, if the synthetic attribute "
"<a href=\"#JDWP_VirtualMachine_Capabilities\">capability</a> is available.")
@@ -686,8 +685,8 @@
(int modBits "The modifier bit flags (also known as access flags) "
"which provide additional information on the "
"method declaration. Individual flag values are "
- "defined in the "
- "<a href=\"http://java.sun.com/docs/books/vmspec/html/ClassFile.doc.html\">VM Specification</a>."
+ "defined in Chapter 4 of "
+ "<cite>The Java™ Virtual Machine Specification</cite>. "
"In addition, The <code>0xf0000000</code> bit identifies "
"the method as synthetic, if the synthetic attribute "
"<a href=\"#JDWP_VirtualMachine_Capabilities\">capability</a> is available.")
@@ -773,8 +772,8 @@
(Command Status=9
"Returns the current status of the reference type. The status "
"indicates the extent to which the reference type has been "
- "initialized, as described in the "
- "<a href=\"http://java.sun.com/docs/books/vmspec/html/Concepts.doc.html#16491\">VM specification</a>. "
+ "initialized, as described in section 2.1.6 of "
+ "<cite>The Java™ Virtual Machine Specification</cite>. "
"If the class is linked the PREPARED and VERIFIED bits in the returned status bits "
"will be set. If the class is initialized the INITIALIZED bit in the returned "
"status bits will be set. If an error occured during initialization then the "
@@ -852,9 +851,8 @@
"Returns the JNI signature of a reference type along with the "
"generic signature if there is one. "
"Generic signatures are described in the signature attribute "
- "section in the "
- "<a href=\"http://java.sun.com/docs/books/vmspec\">
- "Java Virtual Machine Specification, 3rd Edition.</a> "
+ "section in "
+ "<cite>The Java™ Virtual Machine Specification</cite>. "
"Since JDWP version 1.5."
"<p>
(Out
@@ -882,9 +880,8 @@
"by the compiler. "
"Fields are returned in the order they occur in the class file. "
"Generic signatures are described in the signature attribute "
- "section in the "
- "<a href=\"http://java.sun.com/docs/books/vmspec\">
- "Java Virtual Machine Specification, 3rd Edition.</a> "
+ "section in "
+ "<cite>The Java™ Virtual Machine Specification</cite>. "
"Since JDWP version 1.5."
(Out
(referenceType refType "The reference type ID.")
@@ -900,8 +897,8 @@
(int modBits "The modifier bit flags (also known as access flags) "
"which provide additional information on the "
"field declaration. Individual flag values are "
- "defined in the "
- "<a href=\"http://java.sun.com/docs/books/vmspec/html/ClassFile.doc.html\">VM Specification</a>."
+ "defined in Chapter 4 of "
+ "<cite>The Java™ Virtual Machine Specification</cite>. "
"In addition, The <code>0xf0000000</code> bit identifies "
"the field as synthetic, if the synthetic attribute "
"<a href=\"#JDWP_VirtualMachine_Capabilities\">capability</a> is available.")
@@ -925,9 +922,8 @@
"if present, and any synthetic methods created by the compiler. "
"Methods are returned in the order they occur in the class file. "
"Generic signatures are described in the signature attribute "
- "section in the "
- "<a href=\"http://java.sun.com/docs/books/vmspec\">
- "Java Virtual Machine Specification, 3rd Edition.</a> "
+ "section in "
+ "<cite>The Java™ Virtual Machine Specification</cite>. "
"Since JDWP version 1.5."
(Out
(referenceType refType "The reference type ID.")
@@ -943,8 +939,8 @@
(int modBits "The modifier bit flags (also known as access flags) "
"which provide additional information on the "
"method declaration. Individual flag values are "
- "defined in the "
- "<a href=\"http://java.sun.com/docs/books/vmspec/html/ClassFile.doc.html\">VM Specification</a>."
+ "defined in Chapter 4 of "
+ "<cite>The Java™ Virtual Machine Specification</cite>. "
"In addition, The <code>0xf0000000</code> bit identifies "
"the method as synthetic, if the synthetic attribute "
"<a href=\"#JDWP_VirtualMachine_Capabilities\">capability</a> is available.")
@@ -1006,8 +1002,8 @@
)
(Command ConstantPool=18
"Return the raw bytes of the constant pool in the format of the "
- "constant_pool item of the Class File Format in the "
- "Java Virtual Machine Specification. "
+ "constant_pool item of the Class File Format in "
+ "<cite>The Java™ Virtual Machine Specification</cite>. "
"<p>Since JDWP version 1.6. Requires canGetConstantPool capability - see "
"<a href=\"#JDWP_VirtualMachine_CapabilitiesNew\">CapabilitiesNew</a>.""
(Out
@@ -1016,7 +1012,8 @@
(Reply
(int count "Total number of constant pool entries plus one. This "
"corresponds to the constant_pool_count item of the "
- "Class File Format in the Java Virtual Machine Specification. ")
+ "Class File Format in "
+ "<cite>The Java™ Virtual Machine Specification</cite>. ")
(Repeat bytes
(byte cpbytes "Raw bytes of constant pool")
)
@@ -1324,7 +1321,8 @@
)
)
(Command Bytecodes=3
- "Retrieve the method's bytecodes as defined in the JVM Specification."
+ "Retrieve the method's bytecodes as defined in "
+ "<cite>The Java™ Virtual Machine Specification</cite>. "
"Requires canGetBytecodes capability - see "
"<a href=\"#JDWP_VirtualMachine_CapabilitiesNew\">CapabilitiesNew</a>."
(Out
@@ -1379,9 +1377,8 @@
"instance methods, the \"this\" reference is included in the "
"table. Also, synthetic variables may be present. "
"Generic signatures are described in the signature attribute "
- "section in the "
- "<a href=\"http://java.sun.com/docs/books/vmspec\">
- "Java Virtual Machine Specification, 3rd Edition.</a> "
+ "section in "
+ "<cite>The Java™ Virtual Machine Specification</cite>. "
"Since JDWP version 1.5."
(Out
(referenceType refType "The class.")
@@ -1970,8 +1967,9 @@
"<p>"
"The method which will return early is referred to as the "
"called method. The called method is the current method (as "
- "defined by the Frames section in the Java Virtual Machine "
- "Specification) for the specified thread at the time this command "
+ "defined by the Frames section in "
+ "<cite>The Java™ Virtual Machine Specification</cite>) "
+ "for the specified thread at the time this command "
"is received. "
"<p>"
"The specified thread must be suspended. "
--- a/jdk/src/share/classes/com/sun/beans/TypeResolver.java Wed Apr 13 11:59:18 2011 -0700
+++ b/jdk/src/share/classes/com/sun/beans/TypeResolver.java Wed Apr 13 12:16:13 2011 -0700
@@ -175,8 +175,8 @@
/**
* Converts the given {@code type} to the corresponding class.
* This method implements the concept of type erasure,
- * that is described in <a href="http://jscstage.sfbay.sun.com/docs/books/jls/third_edition/html/typesValues.html#4.6">section 4.6</a>
- * of Java Language Specification.
+ * that is described in section 4.6 of
+ * <cite>The Java™ Language Specification</cite>.
*
* @param type the array of types to convert
* @return a corresponding class
--- a/jdk/src/share/classes/com/sun/java/util/jar/pack/package.html Wed Apr 13 11:59:18 2011 -0700
+++ b/jdk/src/share/classes/com/sun/java/util/jar/pack/package.html Wed Apr 13 12:16:13 2011 -0700
@@ -88,8 +88,8 @@
http://java.sun.com/j2se/1.3/docs/guide/jar/jar.html</a></li>
<li>
-Java Virtual Machine Specification : <a href="http://java.sun.com/docs/books/vmspec/2nd-edition/html/ClassFile.doc.html">
-http://java.sun.com/docs/books/vmspec/2nd-edition/html/ClassFile.doc.html</a></li>
+Class File Specification: Chapter 4 of
+<em>The Java™ Virtual Machine Specification</em>
<li>
Hypertext Transfer Protocol -- HTTP/1.1 : <a href="http://www.ietf.org/rfc/rfc2616.txt">
--- a/jdk/src/share/classes/com/sun/jdi/Accessible.java Wed Apr 13 11:59:18 2011 -0700
+++ b/jdk/src/share/classes/com/sun/jdi/Accessible.java Wed Apr 13 12:16:13 2011 -0700
@@ -42,12 +42,9 @@
* Returns the Java<sup><font size=-2>TM</font></sup>
* programming language modifiers, encoded in an integer.
* <p>
- * The modifier encodings are defined in the
- * <a href="http://java.sun.com/docs/books/vmspec/">Java Virtual Machine
- * Specification</a>, in the <code>access_flag</code> tables for
- * <a href="http://java.sun.com/docs/books/vmspec/2nd-edition/html/ClassFile.doc.html#75734">classes</a>,
- * <a href="http://java.sun.com/docs/books/vmspec/2nd-edition/html/ClassFile.doc.html#88358">fields</a>, and
- * <a href="http://java.sun.com/docs/books/vmspec/2nd-edition/html/ClassFile.doc.html#75568">methods</a>.
+ * The modifier encodings are defined in
+ * <cite>The Java™ Virtual Machine Specification</cite>
+ * in the <code>access_flag</code> tables for classes(section 4.1), fields(section 4.5), and methods(section 4.6).
*/
public int modifiers();
--- a/jdk/src/share/classes/com/sun/jdi/ArrayType.java Wed Apr 13 11:59:18 2011 -0700
+++ b/jdk/src/share/classes/com/sun/jdi/ArrayType.java Wed Apr 13 12:16:13 2011 -0700
@@ -77,11 +77,9 @@
* as specified in the array declaration.
* <P>
* Note: The component type of a array will always be
- * created or loaded before the array - see the
- * <a href="http://java.sun.com/docs/books/vmspec/">Java Virtual
- * Machine Specification</a>, section
- * <a href="http://java.sun.com/docs/books/vmspec/2nd-edition/html/ConstantPool.doc.html#79473">5.3.3
- * Creating Array Classes</a>.
+ * created or loaded before the array - see
+ * <cite>The Java™ Virtual Machine Specification</cite>,
+ * section 5.3.3 - Creating Array Classes.
* However, although the component type will be loaded it may
* not yet be prepared, in which case the type will be returned
* but attempts to perform some operations on the returned type
--- a/jdk/src/share/classes/com/sun/jdi/ClassLoaderReference.java Wed Apr 13 11:59:18 2011 -0700
+++ b/jdk/src/share/classes/com/sun/jdi/ClassLoaderReference.java Wed Apr 13 12:16:13 2011 -0700
@@ -71,11 +71,9 @@
* <p>
* No ordering of the returned list is guaranteed.
* <p>
- * See the revised
- * <a href="http://java.sun.com/docs/books/vmspec/">Java
- * Virtual Machine Specification</a> section
- * <a href="http://java.sun.com/docs/books/vmspec/2nd-edition/html/ConstantPool.doc.html#72007">5.3
- * Creation and Loading</a>
+ * See
+ * <cite>The Java™ Virtual Machine Specification</cite>,
+ * section 5.3 - Creation and Loading
* for more information on the initiating classloader.
* <p>
* Note that unlike {@link #definedClasses()}
--- a/jdk/src/share/classes/com/sun/jdi/ClassNotLoadedException.java Wed Apr 13 11:59:18 2011 -0700
+++ b/jdk/src/share/classes/com/sun/jdi/ClassNotLoadedException.java Wed Apr 13 12:16:13 2011 -0700
@@ -60,9 +60,9 @@
* is visible to the class loader of enclosing class. (That is, the
* class loader of the enclosing class must be an <i>initiating</i> class
* loader for the class in question.)
- * See the <a href="http://java.sun.com/docs/books/vmspec/">Java
- * Virtual Machine Specification</a> for
- * more details.
+ * See
+ * <cite>The Java™ Virtual Machine Specification</cite>
+ * for more details.
*
* @author Gordon Hirsch
* @since 1.3
--- a/jdk/src/share/classes/com/sun/jdi/ClassType.java Wed Apr 13 11:59:18 2011 -0700
+++ b/jdk/src/share/classes/com/sun/jdi/ClassType.java Wed Apr 13 12:16:13 2011 -0700
@@ -164,10 +164,8 @@
* component type is passed. The component type can be a primitive type.
* Autoboxing is not supported.
*
- * See the <a href="http://java.sun.com/docs/books/jls/">
- * Java Language Specification</a>.
- * section
- * <a href="http://java.sun.com/docs/books/jls/second_edition/html/conversions.doc.html#184206">5.2</a>
+ * See Section 5.2 of
+ * <cite>The Java™ Language Specification</cite>
* for more information on assignment compatibility.
* <p>
* By default, all threads in the target VM are resumed while
@@ -280,10 +278,8 @@
* component type is passed. The component type can be a primitive type.
* Autoboxing is not supported.
*
- * See the <a href="http://java.sun.com/docs/books/jls/">
- * Java Language Specification</a>.
- * section
- * <a href="http://java.sun.com/docs/books/jls/second_edition/html/conversions.doc.html#184206">5.2</a>
+ * See section 5.2 of
+ * <cite>The Java™ Language Specification</cite>
* for more information on assignment compatibility.
* <p>
* By default, all threads in the target VM are resumed while
--- a/jdk/src/share/classes/com/sun/jdi/LocalVariable.java Wed Apr 13 11:59:18 2011 -0700
+++ b/jdk/src/share/classes/com/sun/jdi/LocalVariable.java Wed Apr 13 12:16:13 2011 -0700
@@ -102,9 +102,7 @@
/**
* Gets the generic signature for this variable if there is one.
* Generic signatures are described in the
- * <a href="http://java.sun.com/docs/books/vmspec">
- * "Java<sup><font size=-2>TM</font></sup>
- * Virtual Machine Specification, 3rd Edition.</a>
+ * <cite>The Java™ Virtual Machine Specification</cite>.
*
* @return a string containing the generic signature, or <code>null</code>
* if there is no generic signature.
--- a/jdk/src/share/classes/com/sun/jdi/Method.java Wed Apr 13 11:59:18 2011 -0700
+++ b/jdk/src/share/classes/com/sun/jdi/Method.java Wed Apr 13 12:16:13 2011 -0700
@@ -164,10 +164,8 @@
/**
* Determine if this method is a bridge method. Bridge
- * methods are defined in the
- * <a href="http://java.sun.com/docs/books/jls">
- * "Java<sup><font size=-2>TM</font></sup>
- * Language Specification, 3rd Edition.</a>
+ * methods are defined in
+ * <cite>The Java™ Language Specification</cite>.
*
* @return <code>true</code> if the method is a bridge method,
* false otherwise.
--- a/jdk/src/share/classes/com/sun/jdi/ObjectReference.java Wed Apr 13 11:59:18 2011 -0700
+++ b/jdk/src/share/classes/com/sun/jdi/ObjectReference.java Wed Apr 13 12:16:13 2011 -0700
@@ -118,10 +118,8 @@
* enclosing class's class loader). Primitive values must be
* either assignment compatible with the field type or must be
* convertible to the field type without loss of information.
- * See the <a href="http://java.sun.com/docs/books/jls/">
- * Java<sup><font size=-2>TM</font></sup> Language Specification</a>.
- * section
- * <a href="http://java.sun.com/docs/books/jls/second_edition/html/conversions.doc.html#184206">5.2</a>
+ * See section 5.2 of
+ * <cite>The Java™ Language Specification</cite>
* for more information on assignment
* compatibility.
*
@@ -182,18 +180,13 @@
* component type is passed. The component type can be a primitive type.
* Autoboxing is not supported.
*
- * See the <a href="http://java.sun.com/docs/books/jls/">
- * Java Language Specification</a>.
- * section
- * <a href="http://java.sun.com/docs/books/jls/second_edition/html/conversions.doc.html#184206">5.2</a>
+ * See section 5.2 of
+ * <cite>The Java™ Language Specification</cite>
* for more information on assignment compatibility.
* <p>
* By default, the method is invoked using dynamic lookup as
- * documented in the
- * <a href="http://java.sun.com/docs/books/jls/">
- * Java Language Specification</a>
- * second edition, section
- * <a href="http://java.sun.com/docs/books/jls/second_edition/html/expressions.doc.html#45606">15.12.4.4</a>;
+ * documented in section 15.12.4.4 of
+ * <cite>The Java™ Language Specification</cite>
* in particular, overriding based on the runtime type of the object
* mirrored by this {@link ObjectReference} will occur. This
* behavior can be changed by specifying the
--- a/jdk/src/share/classes/com/sun/jdi/ReferenceType.java Wed Apr 13 11:59:18 2011 -0700
+++ b/jdk/src/share/classes/com/sun/jdi/ReferenceType.java Wed Apr 13 12:16:13 2011 -0700
@@ -30,9 +30,8 @@
/**
* The type of an object in a target VM. ReferenceType encompasses
- * classes, interfaces, and array types as defined in the
- * <a href="http://java.sun.com/docs/books/jls/">
- * Java<sup><font size=-2>TM</font></sup> Language Specification</a>.
+ * classes, interfaces, and array types as defined in
+ * <cite>The Java™ Language Specification</cite>.
* All ReferenceType objects belong to one of the following
* subinterfaces:
* {@link ClassType} for classes,
@@ -98,9 +97,7 @@
/**
* Gets the generic signature for this type if there is one.
* Generic signatures are described in the
- * <a href="http://java.sun.com/docs/books/vmspec">
- * "Java<sup><font size=-2>TM</font></sup>
- * Virtual Machine Specification, 3rd Edition.</a>
+ * <cite>The Java™ Virtual Machine Specification</cite>.
*
* @return a string containing the generic signature, or <code>null</code>
* if there is no generic signature.
--- a/jdk/src/share/classes/com/sun/jdi/TypeComponent.java Wed Apr 13 11:59:18 2011 -0700
+++ b/jdk/src/share/classes/com/sun/jdi/TypeComponent.java Wed Apr 13 12:16:13 2011 -0700
@@ -74,9 +74,7 @@
/**
* Gets the generic signature for this TypeComponent if there is one.
* Generic signatures are described in the
- * <a href="http://java.sun.com/docs/books/vmspec">
- * "Java<sup><font size=-2>TM</font></sup>
- * Virtual Machine Specification, 3rd Edition.</a>
+ * <cite>The Java™ Virtual Machine Specification</cite>.
*
* @return a string containing the generic signature, or <code>null</code>
* if there is no generic signature.
--- a/jdk/src/share/classes/java/awt/doc-files/AWTThreadIssues.html Wed Apr 13 11:59:18 2011 -0700
+++ b/jdk/src/share/classes/java/awt/doc-files/AWTThreadIssues.html Wed Apr 13 12:16:13 2011 -0700
@@ -40,10 +40,9 @@
<a name="Autoshutdown"></a>
<h2>Auto-shutdown</h2>
-According to <a href="http://java.sun.com/docs/books/vmspec/2nd-edition/html/VMSpecTOC.doc.html"><i>The
-Java</i><sup><small>TM</small></sup> <i>Virtual Machine Specification,
-Second edition</i></a> (see <a href="http://java.sun.com/docs/books/vmspec/2nd-edition/html/Concepts.doc.html#19152">§2.17.9</a>
-and <a href="http://java.sun.com/docs/books/vmspec/2nd-edition/html/Concepts.doc.html#33308">§2.19</a>),
+According to
+<cite>The Java™ Virtual Machine Specification</cite>,
+sections 2.17.9 and 2.19,
the Java virtual machine (JVM) initially starts up with a single non-daemon
thread, which typically calls the <code>main</code> method of some class.
The virtual machine terminates all its activity and exits when
@@ -183,7 +182,8 @@
<...>
</pre>
-The Java Virtual Machine Specification guarantees
+<cite>The Java™ Virtual Machine Specification</cite>
+ guarantees
that the JVM doesn't exit until this thread terminates.
</body>
</html>
--- a/jdk/src/share/classes/java/io/Console.java Wed Apr 13 11:59:18 2011 -0700
+++ b/jdk/src/share/classes/java/io/Console.java Wed Apr 13 12:16:13 2011 -0700
@@ -148,8 +148,8 @@
* extra arguments are ignored. The number of arguments is
* variable and may be zero. The maximum number of arguments is
* limited by the maximum dimension of a Java array as defined by
- * the <a href="http://java.sun.com/docs/books/vmspec/">Java
- * Virtual Machine Specification</a>. The behaviour on a
+ * <cite>The Java™ Virtual Machine Specification</cite>.
+ * The behaviour on a
* <tt>null</tt> argument depends on the <a
* href="../util/Formatter.html#syntax">conversion</a>.
*
@@ -187,8 +187,8 @@
* extra arguments are ignored. The number of arguments is
* variable and may be zero. The maximum number of arguments is
* limited by the maximum dimension of a Java array as defined by
- * the <a href="http://java.sun.com/docs/books/vmspec/">Java
- * Virtual Machine Specification</a>. The behaviour on a
+ * <cite>The Java™ Virtual Machine Specification</cite>.
+ * The behaviour on a
* <tt>null</tt> argument depends on the <a
* href="../util/Formatter.html#syntax">conversion</a>.
*
@@ -220,8 +220,7 @@
* string. If there are more arguments than format specifiers, the
* extra arguments are ignored. The maximum number of arguments is
* limited by the maximum dimension of a Java array as defined by
- * the <a href="http://java.sun.com/docs/books/vmspec/">Java
- * Virtual Machine Specification</a>.
+ * <cite>The Java™ Virtual Machine Specification</cite>.
*
* @throws IllegalFormatException
* If a format string contains an illegal syntax, a format
@@ -285,8 +284,7 @@
* string. If there are more arguments than format specifiers, the
* extra arguments are ignored. The maximum number of arguments is
* limited by the maximum dimension of a Java array as defined by
- * the <a href="http://java.sun.com/docs/books/vmspec/">Java
- * Virtual Machine Specification</a>.
+ * <cite>The Java™ Virtual Machine Specification</cite>.
*
* @throws IllegalFormatException
* If a format string contains an illegal syntax, a format
--- a/jdk/src/share/classes/java/io/PrintStream.java Wed Apr 13 11:59:18 2011 -0700
+++ b/jdk/src/share/classes/java/io/PrintStream.java Wed Apr 13 12:16:13 2011 -0700
@@ -846,8 +846,8 @@
* extra arguments are ignored. The number of arguments is
* variable and may be zero. The maximum number of arguments is
* limited by the maximum dimension of a Java array as defined by
- * the <a href="http://java.sun.com/docs/books/vmspec/">Java
- * Virtual Machine Specification</a>. The behaviour on a
+ * <cite>The Java™ Virtual Machine Specification</cite>.
+ * The behaviour on a
* <tt>null</tt> argument depends on the <a
* href="../util/Formatter.html#syntax">conversion</a>.
*
@@ -896,8 +896,8 @@
* extra arguments are ignored. The number of arguments is
* variable and may be zero. The maximum number of arguments is
* limited by the maximum dimension of a Java array as defined by
- * the <a href="http://java.sun.com/docs/books/vmspec/">Java
- * Virtual Machine Specification</a>. The behaviour on a
+ * <cite>The Java™ Virtual Machine Specification</cite>.
+ * The behaviour on a
* <tt>null</tt> argument depends on the <a
* href="../util/Formatter.html#syntax">conversion</a>.
*
@@ -939,8 +939,8 @@
* extra arguments are ignored. The number of arguments is
* variable and may be zero. The maximum number of arguments is
* limited by the maximum dimension of a Java array as defined by
- * the <a href="http://java.sun.com/docs/books/vmspec/">Java
- * Virtual Machine Specification</a>. The behaviour on a
+ * <cite>The Java™ Virtual Machine Specification</cite>.
+ * The behaviour on a
* <tt>null</tt> argument depends on the <a
* href="../util/Formatter.html#syntax">conversion</a>.
*
@@ -996,8 +996,8 @@
* extra arguments are ignored. The number of arguments is
* variable and may be zero. The maximum number of arguments is
* limited by the maximum dimension of a Java array as defined by
- * the <a href="http://java.sun.com/docs/books/vmspec/">Java
- * Virtual Machine Specification</a>. The behaviour on a
+ * <cite>The Java™ Virtual Machine Specification</cite>.
+ * The behaviour on a
* <tt>null</tt> argument depends on the <a
* href="../util/Formatter.html#syntax">conversion</a>.
*
--- a/jdk/src/share/classes/java/io/PrintWriter.java Wed Apr 13 11:59:18 2011 -0700
+++ b/jdk/src/share/classes/java/io/PrintWriter.java Wed Apr 13 12:16:13 2011 -0700
@@ -779,8 +779,8 @@
* extra arguments are ignored. The number of arguments is
* variable and may be zero. The maximum number of arguments is
* limited by the maximum dimension of a Java array as defined by
- * the <a href="http://java.sun.com/docs/books/vmspec/">Java
- * Virtual Machine Specification</a>. The behaviour on a
+ * <cite>The Java™ Virtual Machine Specification</cite>.
+ * The behaviour on a
* <tt>null</tt> argument depends on the <a
* href="../util/Formatter.html#syntax">conversion</a>.
*
@@ -830,8 +830,8 @@
* extra arguments are ignored. The number of arguments is
* variable and may be zero. The maximum number of arguments is
* limited by the maximum dimension of a Java array as defined by
- * the <a href="http://java.sun.com/docs/books/vmspec/">Java
- * Virtual Machine Specification</a>. The behaviour on a
+ * <cite>The Java™ Virtual Machine Specification</cite>.
+ * The behaviour on a
* <tt>null</tt> argument depends on the <a
* href="../util/Formatter.html#syntax">conversion</a>.
*
@@ -874,8 +874,8 @@
* extra arguments are ignored. The number of arguments is
* variable and may be zero. The maximum number of arguments is
* limited by the maximum dimension of a Java array as defined by
- * the <a href="http://java.sun.com/docs/books/vmspec/">Java
- * Virtual Machine Specification</a>. The behaviour on a
+ * <cite>The Java™ Virtual Machine Specification</cite>.
+ * The behaviour on a
* <tt>null</tt> argument depends on the <a
* href="../util/Formatter.html#syntax">conversion</a>.
*
@@ -934,8 +934,8 @@
* extra arguments are ignored. The number of arguments is
* variable and may be zero. The maximum number of arguments is
* limited by the maximum dimension of a Java array as defined by
- * the <a href="http://java.sun.com/docs/books/vmspec/">Java
- * Virtual Machine Specification</a>. The behaviour on a
+ * <cite>The Java™ Virtual Machine Specification</cite>.
+ * The behaviour on a
* <tt>null</tt> argument depends on the <a
* href="../util/Formatter.html#syntax">conversion</a>.
*
--- a/jdk/src/share/classes/java/lang/AssertionError.java Wed Apr 13 11:59:18 2011 -0700
+++ b/jdk/src/share/classes/java/lang/AssertionError.java Wed Apr 13 12:16:13 2011 -0700
@@ -34,11 +34,9 @@
* new AssertionError(<i>expression</i>)
* </pre>
* has as its detail message the <i>string conversion</i> of
- * <i>expression</i> (as defined in <a
- * href="http://java.sun.com/docs/books/jls/second_edition/html/j.title.doc.html">
- * <i>The Java Language Specification, Second Edition</i></a>,
- * <a href="http://java.sun.com/docs/books/jls/second_edition/html/expressions.doc.html#40220">
- * Section 15.18.1.1</a>), regardless of the type of <i>expression</i>.
+ * <i>expression</i> (as defined in section 15.18.1.1 of
+ * <cite>The Java™ Language Specification</cite>),
+ * regardless of the type of <i>expression</i>.
*
* @since 1.4
*/
@@ -63,8 +61,8 @@
/**
* Constructs an AssertionError with its detail message derived
* from the specified object, which is converted to a string as
- * defined in <i>The Java Language Specification, Second
- * Edition</i>, Section 15.18.1.1.
+ * defined in section 15.18.1.1 of
+ * <cite>The Java™ Language Specification</cite>.
*<p>
* If the specified object is an instance of {@code Throwable}, it
* becomes the <i>cause</i> of the newly constructed assertion error.
@@ -81,8 +79,8 @@
/**
* Constructs an AssertionError with its detail message derived
* from the specified <code>boolean</code>, which is converted to
- * a string as defined in <i>The Java Language Specification,
- * Second Edition</i>, Section 15.18.1.1.
+ * a string as defined in section 15.18.1.1 of
+ * <cite>The Java™ Language Specification</cite>.
*
* @param detailMessage value to be used in constructing detail message
*/
@@ -93,8 +91,8 @@
/**
* Constructs an AssertionError with its detail message derived
* from the specified <code>char</code>, which is converted to a
- * string as defined in <i>The Java Language Specification, Second
- * Edition</i>, Section 15.18.1.1.
+ * string as defined in section 15.18.1.1 of
+ * <cite>The Java™ Language Specification</cite>.
*
* @param detailMessage value to be used in constructing detail message
*/
@@ -105,8 +103,8 @@
/**
* Constructs an AssertionError with its detail message derived
* from the specified <code>int</code>, which is converted to a
- * string as defined in <i>The Java Language Specification, Second
- * Edition</i>, Section 15.18.1.1.
+ * string as defined in section 15.18.1.1 of
+ * <cite>The Java™ Language Specification</cite>.
*
* @param detailMessage value to be used in constructing detail message
*/
@@ -117,8 +115,8 @@
/**
* Constructs an AssertionError with its detail message derived
* from the specified <code>long</code>, which is converted to a
- * string as defined in <i>The Java Language Specification, Second
- * Edition</i>, Section 15.18.1.1.
+ * string as defined in section 15.18.1.1 of
+ * <cite>The Java™ Language Specification</cite>.
*
* @param detailMessage value to be used in constructing detail message
*/
@@ -129,8 +127,8 @@
/**
* Constructs an AssertionError with its detail message derived
* from the specified <code>float</code>, which is converted to a
- * string as defined in <i>The Java Language Specification, Second
- * Edition</i>, Section 15.18.1.1.
+ * string as defined in section 15.18.1.1 of
+ * <cite>The Java™ Language Specification</cite>.
*
* @param detailMessage value to be used in constructing detail message
*/
@@ -141,8 +139,8 @@
/**
* Constructs an AssertionError with its detail message derived
* from the specified <code>double</code>, which is converted to a
- * string as defined in <i>The Java Language Specification, Second
- * Edition</i>, Section 15.18.1.1.
+ * string as defined in section 15.18.1.1 of
+ * <cite>The Java™ Language Specification</cite>.
*
* @param detailMessage value to be used in constructing detail message
*/
--- a/jdk/src/share/classes/java/lang/Byte.java Wed Apr 13 11:59:18 2011 -0700
+++ b/jdk/src/share/classes/java/lang/Byte.java Wed Apr 13 12:16:13 2011 -0700
@@ -251,9 +251,9 @@
* </blockquote>
*
* <i>DecimalNumeral</i>, <i>HexDigits</i>, and <i>OctalDigits</i>
- * are defined in <a href="http://java.sun.com/docs/books/jls/second_edition/html/lexical.doc.html#48282">§3.10.1</a>
- * of the <a href="http://java.sun.com/docs/books/jls/html/">Java
- * Language Specification</a>.
+ * are as defined in section 3.10.1 of
+ * <cite>The Java™ Language Specification</cite>,
+ * except that underscores are not accepted between digits.
*
* <p>The sequence of characters following an optional
* sign and/or radix specifier ("{@code 0x}", "{@code 0X}",
--- a/jdk/src/share/classes/java/lang/Class.java Wed Apr 13 11:59:18 2011 -0700
+++ b/jdk/src/share/classes/java/lang/Class.java Wed Apr 13 12:16:13 2011 -0700
@@ -95,8 +95,8 @@
* </pre></blockquote>
*
* <p> It is also possible to get the {@code Class} object for a named
- * type (or for void) using a class literal
- * (JLS Section <A HREF="http://java.sun.com/docs/books/jls/second_edition/html/expressions.doc.html#251530">15.8.2</A>).
+ * type (or for void) using a class literal. See Section 15.8.2 of
+ * <cite>The Java™ Language Specification</cite>.
* For example:
*
* <p> <blockquote>
@@ -521,7 +521,8 @@
*
* <p> If this class object represents a reference type that is not an
* array type then the binary name of the class is returned, as specified
- * by the Java Language Specification, Second Edition.
+ * by
+ * <cite>The Java™ Language Specification</cite>.
*
* <p> If this class object represents a primitive type or void, then the
* name returned is a {@code String} equal to the Java language
@@ -630,8 +631,8 @@
* the type variables declared by this generic declaration
* @throws java.lang.reflect.GenericSignatureFormatError if the generic
* signature of this generic declaration does not conform to
- * the format specified in the Java Virtual Machine Specification,
- * 3rd edition
+ * the format specified in
+ * <cite>The Java™ Virtual Machine Specification</cite>
* @since 1.5
*/
public TypeVariable<Class<T>>[] getTypeParameters() {
@@ -675,8 +676,8 @@
* returned.
*
* @throws java.lang.reflect.GenericSignatureFormatError if the generic
- * class signature does not conform to the format specified in the
- * Java Virtual Machine Specification, 3rd edition
+ * class signature does not conform to the format specified in
+ * <cite>The Java™ Virtual Machine Specification</cite>
* @throws TypeNotPresentException if the generic superclass
* refers to a non-existent type declaration
* @throws java.lang.reflect.MalformedParameterizedTypeException if the
@@ -798,7 +799,8 @@
*
* @throws java.lang.reflect.GenericSignatureFormatError
* if the generic class signature does not conform to the format
- * specified in the Java Virtual Machine Specification, 3rd edition
+ * specified in
+ * <cite>The Java™ Virtual Machine Specification</cite>
* @throws TypeNotPresentException if any of the generic
* superinterfaces refers to a non-existent type declaration
* @throws java.lang.reflect.MalformedParameterizedTypeException
--- a/jdk/src/share/classes/java/lang/ClassLoader.java Wed Apr 13 11:59:18 2011 -0700
+++ b/jdk/src/share/classes/java/lang/ClassLoader.java Wed Apr 13 12:16:13 2011 -0700
@@ -160,8 +160,8 @@
* <h4> <a name="name">Binary names</a> </h4>
*
* <p> Any class name provided as a {@link String} parameter to methods in
- * <tt>ClassLoader</tt> must be a binary name as defined by the <a
- * href="http://java.sun.com/docs/books/jls/">Java Language Specification</a>.
+ * <tt>ClassLoader</tt> must be a binary name as defined by
+ * <cite>The Java™ Language Specification</cite>.
*
* <p> Examples of valid class names include:
* <blockquote><pre>
@@ -531,9 +531,8 @@
* @param b
* The bytes that make up the class data. The bytes in positions
* <tt>off</tt> through <tt>off+len-1</tt> should have the format
- * of a valid class file as defined by the <a
- * href="http://java.sun.com/docs/books/vmspec/">Java Virtual
- * Machine Specification</a>.
+ * of a valid class file as defined by
+ * <cite>The Java™ Virtual Machine Specification</cite>.
*
* @param off
* The start offset in <tt>b</tt> of the class data
@@ -597,9 +596,8 @@
* @param b
* The bytes that make up the class data. The bytes in positions
* <tt>off</tt> through <tt>off+len-1</tt> should have the format
- * of a valid class file as defined by the <a
- * href="http://java.sun.com/docs/books/vmspec/">Java Virtual
- * Machine Specification</a>.
+ * of a valid class file as defined by
+ * <cite>The Java™ Virtual Machine Specification</cite>.
*
* @param off
* The start offset in <tt>b</tt> of the class data
@@ -748,9 +746,8 @@
* @param b
* The bytes that make up the class data. The bytes in positions
* <tt>off</tt> through <tt>off+len-1</tt> should have the format
- * of a valid class file as defined by the <a
- * href="http://java.sun.com/docs/books/vmspec/">Java Virtual
- * Machine Specification</a>.
+ * of a valid class file as defined by
+ * <cite>The Java™ Virtual Machine Specification</cite>.
*
* @param off
* The start offset in <tt>b</tt> of the class data
@@ -838,8 +835,7 @@
* The bytes that make up the class data. The bytes from positions
* <tt>b.position()</tt> through <tt>b.position() + b.limit() -1
* </tt> should have the format of a valid class file as defined by
- * the <a href="http://java.sun.com/docs/books/vmspec/">Java Virtual
- * Machine Specification</a>.
+ * <cite>The Java™ Virtual Machine Specification</cite>.
*
* @param protectionDomain
* The ProtectionDomain of the class, or <tt>null</tt>.
@@ -998,9 +994,8 @@
* Links the specified class. This (misleadingly named) method may be
* used by a class loader to link a class. If the class <tt>c</tt> has
* already been linked, then this method simply returns. Otherwise, the
- * class is linked as described in the "Execution" chapter of the <a
- * href="http://java.sun.com/docs/books/jls/">Java Language
- * Specification</a>.
+ * class is linked as described in the "Execution" chapter of
+ * <cite>The Java™ Language Specification</cite>.
* </p>
*
* @param c
@@ -2034,8 +2029,8 @@
* The name of the package whose package default assertion status
* is to be set. A <tt>null</tt> value indicates the unnamed
* package that is "current"
- * (<a href="http://java.sun.com/docs/books/jls/">Java Language
- * Specification</a>, section 7.4.2).
+ * (see section 7.4.2 of
+ * <cite>The Java™ Language Specification</cite>.)
*
* @param enabled
* <tt>true</tt> if classes loaded by this classloader and
--- a/jdk/src/share/classes/java/lang/Double.java Wed Apr 13 11:59:18 2011 -0700
+++ b/jdk/src/share/classes/java/lang/Double.java Wed Apr 13 12:16:13 2011 -0700
@@ -392,9 +392,10 @@
* where <i>Sign</i>, <i>FloatingPointLiteral</i>,
* <i>HexNumeral</i>, <i>HexDigits</i>, <i>SignedInteger</i> and
* <i>FloatTypeSuffix</i> are as defined in the lexical structure
- * sections of the <a
- * href="http://java.sun.com/docs/books/jls/html/">Java Language
- * Specification</a>. If {@code s} does not have the form of
+ * sections of
+ * <cite>The Java™ Language Specification</cite>,
+ * except that underscores are not accepted between digits.
+ * If {@code s} does not have the form of
* a <i>FloatValue</i>, then a {@code NumberFormatException}
* is thrown. Otherwise, {@code s} is regarded as
* representing an exact decimal value in the usual
@@ -464,8 +465,8 @@
* // Since this method allows integer-only strings as input
* // in addition to strings of floating-point literals, the
* // two sub-patterns below are simplifications of the grammar
- * // productions from the Java Language Specification, 2nd
- * // edition, section 3.10.2.
+ * // productions from section 3.10.2 of
+ * // <cite>The Java™ Language Specification</cite>.
*
* // Digits ._opt Digits_opt ExponentPart_opt FloatTypeSuffix_opt
* "((("+Digits+"(\\.)?("+Digits+"?)("+Exp+")?)|"+
--- a/jdk/src/share/classes/java/lang/Enum.java Wed Apr 13 11:59:18 2011 -0700
+++ b/jdk/src/share/classes/java/lang/Enum.java Wed Apr 13 12:16:13 2011 -0700
@@ -36,9 +36,8 @@
*
* More information about enums, including descriptions of the
* implicitly declared methods synthesized by the compiler, can be
- * found in <i>The Java™ Language Specification, Third
- * Edition</i>, <a
- * href="http://java.sun.com/docs/books/jls/third_edition/html/classes.html#8.9">§8.9</a>.
+ * found in section 8.9 of
+ * <cite>The Java™ Language Specification</cite>.
*
* <p> Note that when using an enumeration type as the type of a set
* or as the type of the keys in a map, specialized and efficient
--- a/jdk/src/share/classes/java/lang/Error.java Wed Apr 13 11:59:18 2011 -0700
+++ b/jdk/src/share/classes/java/lang/Error.java Wed Apr 13 12:16:13 2011 -0700
@@ -43,7 +43,7 @@
*
* @author Frank Yellin
* @see java.lang.ThreadDeath
- * @jls3 11.2 Compile-Time Checking of Exceptions
+ * @jls 11.2 Compile-Time Checking of Exceptions
* @since JDK1.0
*/
public class Error extends Throwable {
--- a/jdk/src/share/classes/java/lang/Exception.java Wed Apr 13 11:59:18 2011 -0700
+++ b/jdk/src/share/classes/java/lang/Exception.java Wed Apr 13 12:16:13 2011 -0700
@@ -39,7 +39,7 @@
*
* @author Frank Yellin
* @see java.lang.Error
- * @jls3 11.2 Compile-Time Checking of Exceptions
+ * @jls 11.2 Compile-Time Checking of Exceptions
* @since JDK1.0
*/
public class Exception extends Throwable {
--- a/jdk/src/share/classes/java/lang/Float.java Wed Apr 13 11:59:18 2011 -0700
+++ b/jdk/src/share/classes/java/lang/Float.java Wed Apr 13 12:16:13 2011 -0700
@@ -353,9 +353,10 @@
* where <i>Sign</i>, <i>FloatingPointLiteral</i>,
* <i>HexNumeral</i>, <i>HexDigits</i>, <i>SignedInteger</i> and
* <i>FloatTypeSuffix</i> are as defined in the lexical structure
- * sections of the <a
- * href="http://java.sun.com/docs/books/jls/html/">Java Language
- * Specification</a>. If {@code s} does not have the form of
+ * sections of
+ * <cite>The Java™ Language Specification</cite>,
+ * except that underscores are not accepted between digits.
+ * If {@code s} does not have the form of
* a <i>FloatValue</i>, then a {@code NumberFormatException}
* is thrown. Otherwise, {@code s} is regarded as
* representing an exact decimal value in the usual
--- a/jdk/src/share/classes/java/lang/Integer.java Wed Apr 13 11:59:18 2011 -0700
+++ b/jdk/src/share/classes/java/lang/Integer.java Wed Apr 13 12:16:13 2011 -0700
@@ -918,9 +918,9 @@
* </blockquote>
*
* <i>DecimalNumeral</i>, <i>HexDigits</i>, and <i>OctalDigits</i>
- * are defined in <a href="http://java.sun.com/docs/books/jls/second_edition/html/lexical.doc.html#48282">§3.10.1</a>
- * of the <a href="http://java.sun.com/docs/books/jls/html/">Java
- * Language Specification</a>.
+ * are as defined in section 3.10.1 of
+ * <cite>The Java™ Language Specification</cite>,
+ * except that underscores are not accepted between digits.
*
* <p>The sequence of characters following an optional
* sign and/or radix specifier ("{@code 0x}", "{@code 0X}",
--- a/jdk/src/share/classes/java/lang/Long.java Wed Apr 13 11:59:18 2011 -0700
+++ b/jdk/src/share/classes/java/lang/Long.java Wed Apr 13 12:16:13 2011 -0700
@@ -598,9 +598,9 @@
* </blockquote>
*
* <i>DecimalNumeral</i>, <i>HexDigits</i>, and <i>OctalDigits</i>
- * are defined in <a href="http://java.sun.com/docs/books/jls/second_edition/html/lexical.doc.html#48282">§3.10.1</a>
- * of the <a href="http://java.sun.com/docs/books/jls/html/">Java
- * Language Specification</a>.
+ * are as defined in section 3.10.1 of
+ * <cite>The Java™ Language Specification</cite>,
+ * except that underscores are not accepted between digits.
*
* <p>The sequence of characters following an optional
* sign and/or radix specifier ("{@code 0x}", "{@code 0X}",
--- a/jdk/src/share/classes/java/lang/Object.java Wed Apr 13 11:59:18 2011 -0700
+++ b/jdk/src/share/classes/java/lang/Object.java Wed Apr 13 12:16:13 2011 -0700
@@ -58,9 +58,8 @@
*
* @return The {@code Class} object that represents the runtime
* class of this object.
- * @see <a href="http://java.sun.com/docs/books/jls/">The Java
- * Language Specification, Third Edition (15.8.2 Class
- * Literals)</a>
+ * @see Class Literals, section 15.8.2 of
+ * <cite>The Java™ Language Specification</cite>.
*/
public final native Class<?> getClass();
--- a/jdk/src/share/classes/java/lang/Override.java Wed Apr 13 11:59:18 2011 -0700
+++ b/jdk/src/share/classes/java/lang/Override.java Wed Apr 13 12:16:13 2011 -0700
@@ -43,7 +43,7 @@
*
* @author Peter von der Ahé
* @author Joshua Bloch
- * @jls3 9.6.1.4 Override
+ * @jls 9.6.1.4 Override
* @since 1.5
*/
@Target(ElementType.METHOD)
--- a/jdk/src/share/classes/java/lang/Package.java Wed Apr 13 11:59:18 2011 -0700
+++ b/jdk/src/share/classes/java/lang/Package.java Wed Apr 13 12:16:13 2011 -0700
@@ -109,10 +109,9 @@
/**
* Return the name of this package.
*
- * @return The fully-qualified name of this package as defined in the
- * <em>Java Language Specification, Third Edition</em>
- * <a href="http://java.sun.com/docs/books/jls/third_edition/html/names.html#6.5.3">
- * §6.5.3</a>, for example, {@code java.lang}
+ * @return The fully-qualified name of this package as defined in section 6.5.3 of
+ * <cite>The Java™ Language Specification</cite>,
+ * for example, {@code java.lang}
*/
public String getName() {
return pkgName;
--- a/jdk/src/share/classes/java/lang/RuntimeException.java Wed Apr 13 11:59:18 2011 -0700
+++ b/jdk/src/share/classes/java/lang/RuntimeException.java Wed Apr 13 12:16:13 2011 -0700
@@ -37,7 +37,7 @@
* propagate outside the method or constructor boundary.
*
* @author Frank Yellin
- * @jls3 11.2 Compile-Time Checking of Exceptions
+ * @jls 11.2 Compile-Time Checking of Exceptions
* @since JDK1.0
*/
public class RuntimeException extends Exception {
--- a/jdk/src/share/classes/java/lang/SafeVarargs.java Wed Apr 13 11:59:18 2011 -0700
+++ b/jdk/src/share/classes/java/lang/SafeVarargs.java Wed Apr 13 12:16:13 2011 -0700
@@ -70,8 +70,8 @@
*
* </ul>
*
- * @jls3 4.7 Reifiable Types
- * @jls3 8.4.1 Formal Parameters
+ * @jls 4.7 Reifiable Types
+ * @jls 8.4.1 Formal Parameters
*/
@Documented
@Retention(RetentionPolicy.RUNTIME)
--- a/jdk/src/share/classes/java/lang/Short.java Wed Apr 13 11:59:18 2011 -0700
+++ b/jdk/src/share/classes/java/lang/Short.java Wed Apr 13 12:16:13 2011 -0700
@@ -256,9 +256,9 @@
* </blockquote>
*
* <i>DecimalNumeral</i>, <i>HexDigits</i>, and <i>OctalDigits</i>
- * are defined in <a href="http://java.sun.com/docs/books/jls/second_edition/html/lexical.doc.html#48282">§3.10.1</a>
- * of the <a href="http://java.sun.com/docs/books/jls/html/">Java
- * Language Specification</a>.
+ * are as defined in section 3.10.1 of
+ * <cite>The Java™ Language Specification</cite>,
+ * except that underscores are not accepted between digits.
*
* <p>The sequence of characters following an optional
* sign and/or radix specifier ("{@code 0x}", "{@code 0X}",
--- a/jdk/src/share/classes/java/lang/String.java Wed Apr 13 11:59:18 2011 -0700
+++ b/jdk/src/share/classes/java/lang/String.java Wed Apr 13 12:16:13 2011 -0700
@@ -2819,8 +2819,8 @@
* extra arguments are ignored. The number of arguments is
* variable and may be zero. The maximum number of arguments is
* limited by the maximum dimension of a Java array as defined by
- * the <a href="http://java.sun.com/docs/books/vmspec/">Java
- * Virtual Machine Specification</a>. The behaviour on a
+ * <cite>The Java™ Virtual Machine Specification</cite>.
+ * The behaviour on a
* <tt>null</tt> argument depends on the <a
* href="../util/Formatter.html#syntax">conversion</a>.
*
@@ -2863,8 +2863,8 @@
* extra arguments are ignored. The number of arguments is
* variable and may be zero. The maximum number of arguments is
* limited by the maximum dimension of a Java array as defined by
- * the <a href="http://java.sun.com/docs/books/vmspec/">Java
- * Virtual Machine Specification</a>. The behaviour on a
+ * <cite>The Java™ Virtual Machine Specification</cite>.
+ * The behaviour on a
* <tt>null</tt> argument depends on the <a
* href="../util/Formatter.html#syntax">conversion</a>.
*
@@ -3066,9 +3066,8 @@
* if and only if <code>s.equals(t)</code> is <code>true</code>.
* <p>
* All literal strings and string-valued constant expressions are
- * interned. String literals are defined in §3.10.5 of the
- * <a href="http://java.sun.com/docs/books/jls/html/">Java Language
- * Specification</a>
+ * interned. String literals are defined in section 3.10.5 of the
+ * <cite>The Java™ Language Specification</cite>.
*
* @return a string that has the same contents as this string, but is
* guaranteed to be from a pool of unique strings.
--- a/jdk/src/share/classes/java/lang/Throwable.java Wed Apr 13 11:59:18 2011 -0700
+++ b/jdk/src/share/classes/java/lang/Throwable.java Wed Apr 13 12:16:13 2011 -0700
@@ -108,7 +108,7 @@
* @author unascribed
* @author Josh Bloch (Added exception chaining and programmatic access to
* stack trace in 1.4.)
- * @jls3 11.2 Compile-Time Checking of Exceptions
+ * @jls 11.2 Compile-Time Checking of Exceptions
* @since JDK1.0
*/
public class Throwable implements Serializable {
--- a/jdk/src/share/classes/java/lang/annotation/Annotation.java Wed Apr 13 11:59:18 2011 -0700
+++ b/jdk/src/share/classes/java/lang/annotation/Annotation.java Wed Apr 13 12:16:13 2011 -0700
@@ -31,9 +31,8 @@
* an annotation type. Also note that this interface does not itself
* define an annotation type.
*
- * More information about annotation types can be found in <i>The
- * Java™ Language Specification, Third Edition</i>, <a
- * href="http://java.sun.com/docs/books/jls/third_edition/html/interfaces.html#9.6">§9.6</a>.
+ * More information about annotation types can be found in section 9.6 of
+ * <cite>The Java™ Language Specification</cite>.
*
* @author Josh Bloch
* @since 1.5
--- a/jdk/src/share/classes/java/lang/instrument/ClassFileTransformer.java Wed Apr 13 11:59:18 2011 -0700
+++ b/jdk/src/share/classes/java/lang/instrument/ClassFileTransformer.java Wed Apr 13 12:16:13 2011 -0700
@@ -36,9 +36,9 @@
* to transform class files.
* The transformation occurs before the class is defined by the JVM.
* <P>
- * Note the term <i>class file</i> is used as defined in the chapter
- * <a href="http://java.sun.com/docs/books/vmspec/2nd-edition/html/ClassFile.doc.html#80959">The class File Format</a>
- * of <i>The Java Virtual Machine Specification</i>, to mean a sequence
+ * Note the term <i>class file</i> is used as defined in section 3.1 of
+ * <cite>The Java™ Virtual Machine Specification</cite>,
+ * to mean a sequence
* of bytes in class file format, whether or not they reside in a file.
*
* @see java.lang.instrument.Instrumentation
--- a/jdk/src/share/classes/java/lang/instrument/Instrumentation.java Wed Apr 13 11:59:18 2011 -0700
+++ b/jdk/src/share/classes/java/lang/instrument/Instrumentation.java Wed Apr 13 12:16:13 2011 -0700
@@ -434,8 +434,9 @@
* avoiding these types of issues, is to use a unique package name for the
* instrumentation classes.
*
- * <p> The <a href="http://java.sun.com/docs/books/vmspec/">Java Virtual Machine
- * Specification</a> specifies that a subsequent attempt to resolve a symbolic
+ * <p>
+ * <cite>The Java™ Virtual Machine Specification</cite>
+ * specifies that a subsequent attempt to resolve a symbolic
* reference that the Java virtual machine has previously unsuccessfully attempted
* to resolve always fails with the same error that was thrown as a result of the
* initial resolution attempt. Consequently, if the JAR file contains an entry
@@ -487,8 +488,9 @@
* getName()} method on the <code>jarfile</code> and this is provided as the
* parameter to the <code>appendToClassPathForInstrumentation</code> method.
*
- * <p> The <a href="http://java.sun.com/docs/books/vmspec/">Java Virtual Machine
- * Specification</a> specifies that a subsequent attempt to resolve a symbolic
+ * <p>
+ * <cite>The Java™ Virtual Machine Specification</cite>
+ * specifies that a subsequent attempt to resolve a symbolic
* reference that the Java virtual machine has previously unsuccessfully attempted
* to resolve always fails with the same error that was thrown as a result of the
* initial resolution attempt. Consequently, if the JAR file contains an entry
--- a/jdk/src/share/classes/java/lang/invoke/package-info.java Wed Apr 13 11:59:18 2011 -0700
+++ b/jdk/src/share/classes/java/lang/invoke/package-info.java Wed Apr 13 12:16:13 2011 -0700
@@ -194,8 +194,8 @@
* Method handle constants for subtags {@code REF_getStatic}, {@code REF_putStatic}, and {@code REF_invokeStatic}
* may force class initialization on their first invocation, just like the corresponding bytecodes.
* <p>
- * The rules of section 5.4.3 of the
- * <a href="http://java.sun.com/docs/books/jvms/second_edition/html/ConstantPool.doc.html#73492">JVM Specification</a>
+ * The rules of section 5.4.3 of
+ * <cite>The Java™ Virtual Machine Specification</cite>
* apply to the resolution of {@code CONSTANT_MethodType}, {@code CONSTANT_MethodHandle},
* and {@code CONSTANT_InvokeDynamic} constants,
* by the execution of {@code invokedynamic} and {@code ldc} instructions.
--- a/jdk/src/share/classes/java/lang/reflect/Constructor.java Wed Apr 13 11:59:18 2011 -0700
+++ b/jdk/src/share/classes/java/lang/reflect/Constructor.java Wed Apr 13 12:16:13 2011 -0700
@@ -186,8 +186,8 @@
* the type variables declared by this generic declaration
* @throws GenericSignatureFormatError if the generic
* signature of this generic declaration does not conform to
- * the format specified in the Java Virtual Machine Specification,
- * 3rd edition
+ * the format specified in
+ * <cite>The Java™ Virtual Machine Specification</cite>
* @since 1.5
*/
public TypeVariable<Constructor<T>>[] getTypeParameters() {
@@ -229,7 +229,8 @@
* parameter types of the underlying method, in declaration order
* @throws GenericSignatureFormatError
* if the generic method signature does not conform to the format
- * specified in the Java Virtual Machine Specification, 3rd edition
+ * specified in
+ * <cite>The Java™ Virtual Machine Specification</cite>
* @throws TypeNotPresentException if any of the parameter
* types of the underlying method refers to a non-existent type
* declaration
@@ -273,7 +274,8 @@
* thrown by the underlying method
* @throws GenericSignatureFormatError
* if the generic method signature does not conform to the format
- * specified in the Java Virtual Machine Specification, 3rd edition
+ * specified in
+ * <cite>The Java™ Virtual Machine Specification</cite>
* @throws TypeNotPresentException if the underlying method's
* {@code throws} clause refers to a non-existent type declaration
* @throws MalformedParameterizedTypeException if
@@ -468,8 +470,8 @@
*
* <p>If the constructor's declaring class is an inner class in a
* non-static context, the first argument to the constructor needs
- * to be the enclosing instance; see <i>The Java Language
- * Specification</i>, section 15.9.3.
+ * to be the enclosing instance; see section 15.9.3 of
+ * <cite>The Java™ Language Specification</cite>.
*
* <p>If the required access and argument checks succeed and the
* instantiation will proceed, the constructor's declaring class
@@ -541,7 +543,8 @@
* constructor; returns {@code false} otherwise.
*
* @return true if and only if this constructor is a synthetic
- * constructor as defined by the Java Language Specification.
+ * constructor as defined by
+ * <cite>The Java™ Language Specification</cite>.
* @since 1.5
*/
public boolean isSynthetic() {
--- a/jdk/src/share/classes/java/lang/reflect/Field.java Wed Apr 13 11:59:18 2011 -0700
+++ b/jdk/src/share/classes/java/lang/reflect/Field.java Wed Apr 13 12:16:13 2011 -0700
@@ -221,8 +221,8 @@
* @return a {@code Type} object that represents the declared type for
* the field represented by this {@code Field} object
* @throws GenericSignatureFormatError if the generic field
- * signature does not conform to the format specified in the Java
- * Virtual Machine Specification, 3rd edition
+ * signature does not conform to the format specified in
+ * <cite>The Java™ Virtual Machine Specification</cite>
* @throws TypeNotPresentException if the generic type
* signature of the underlying field refers to a non-existent
* type declaration
--- a/jdk/src/share/classes/java/lang/reflect/GenericDeclaration.java Wed Apr 13 11:59:18 2011 -0700
+++ b/jdk/src/share/classes/java/lang/reflect/GenericDeclaration.java Wed Apr 13 12:16:13 2011 -0700
@@ -42,8 +42,8 @@
* the type variables declared by this generic declaration
* @throws GenericSignatureFormatError if the generic
* signature of this generic declaration does not conform to
- * the format specified in the Java Virtual Machine Specification,
- * 3rd edition
+ * the format specified in
+ * <cite>The Java™ Virtual Machine Specification</cite>
*/
public TypeVariable<?>[] getTypeParameters();
}
--- a/jdk/src/share/classes/java/lang/reflect/Method.java Wed Apr 13 11:59:18 2011 -0700
+++ b/jdk/src/share/classes/java/lang/reflect/Method.java Wed Apr 13 12:16:13 2011 -0700
@@ -194,8 +194,8 @@
* the type variables declared by this generic declaration
* @throws GenericSignatureFormatError if the generic
* signature of this generic declaration does not conform to
- * the format specified in the Java Virtual Machine Specification,
- * 3rd edition
+ * the format specified in
+ * <cite>The Java™ Virtual Machine Specification</cite>
* @since 1.5
*/
public TypeVariable<Method>[] getTypeParameters() {
@@ -230,7 +230,8 @@
* type of the underlying method
* @throws GenericSignatureFormatError
* if the generic method signature does not conform to the format
- * specified in the Java Virtual Machine Specification, 3rd edition
+ * specified in
+ * <cite>The Java™ Virtual Machine Specification</cite>
* @throws TypeNotPresentException if the underlying method's
* return type refers to a non-existent type declaration
* @throws MalformedParameterizedTypeException if the
@@ -275,7 +276,8 @@
* parameter types of the underlying method, in declaration order
* @throws GenericSignatureFormatError
* if the generic method signature does not conform to the format
- * specified in the Java Virtual Machine Specification, 3rd edition
+ * specified in
+ * <cite>The Java™ Virtual Machine Specification</cite>
* @throws TypeNotPresentException if any of the parameter
* types of the underlying method refers to a non-existent type
* declaration
@@ -319,7 +321,8 @@
* thrown by the underlying method
* @throws GenericSignatureFormatError
* if the generic method signature does not conform to the format
- * specified in the Java Virtual Machine Specification, 3rd edition
+ * specified in
+ * <cite>The Java™ Virtual Machine Specification</cite>
* @throws TypeNotPresentException if the underlying method's
* {@code throws} clause refers to a non-existent type declaration
* @throws MalformedParameterizedTypeException if
--- a/jdk/src/share/classes/java/lang/reflect/Modifier.java Wed Apr 13 11:59:18 2011 -0700
+++ b/jdk/src/share/classes/java/lang/reflect/Modifier.java Wed Apr 13 12:16:13 2011 -0700
@@ -34,14 +34,8 @@
* constants to decode class and member access modifiers. The sets of
* modifiers are represented as integers with distinct bit positions
* representing different modifiers. The values for the constants
- * representing the modifiers are taken from <a
- * href="http://java.sun.com/docs/books/vmspec/2nd-edition/html/VMSpecTOC.doc.html"><i>The
- * Java</i><sup><small>TM</small></sup> <i>Virtual Machine Specification, Second
- * edition</i></a> tables
- * <a href="http://java.sun.com/docs/books/vmspec/2nd-edition/html/ClassFile.doc.html#75734">4.1</a>,
- * <a href="http://java.sun.com/docs/books/vmspec/2nd-edition/html/ClassFile.doc.html#88358">4.4</a>,
- * <a href="http://java.sun.com/docs/books/vmspec/2nd-edition/html/ClassFile.doc.html#75568">4.5</a>, and
- * <a href="http://java.sun.com/docs/books/vmspec/2nd-edition/html/ClassFile.doc.html#88478">4.7</a>.
+ * representing the modifiers are taken from the tables in sections 4.1, 4.4, 4.5, and 4.7 of
+ * <cite>The Java™ Virtual Machine Specification</cite>.
*
* @see Class#getModifiers()
* @see Member#getModifiers()
@@ -214,14 +208,8 @@
* public final synchronized strictfp
* </pre></blockquote>
* The modifier names are returned in an order consistent with the
- * suggested modifier orderings given in <a
- * href="http://java.sun.com/docs/books/jls/second_edition/html/j.title.doc.html"><em>The
- * Java Language Specification, Second Edition</em></a> sections
- * <a href="http://java.sun.com/docs/books/jls/second_edition/html/classes.doc.html#21613">§8.1.1</a>,
- * <a href="http://java.sun.com/docs/books/jls/second_edition/html/classes.doc.html#78091">§8.3.1</a>,
- * <a href="http://java.sun.com/docs/books/jls/second_edition/html/classes.doc.html#78188">§8.4.3</a>,
- * <a href="http://java.sun.com/docs/books/jls/second_edition/html/classes.doc.html#42018">§8.8.3</a>, and
- * <a href="http://java.sun.com/docs/books/jls/second_edition/html/interfaces.doc.html#235947">§9.1.1</a>.
+ * suggested modifier orderings given in sections 8.1.1, 8.3.1, 8.4.3, 8.8.3, and 9.1.1 of
+ * <cite>The Java™ Language Specification</cite>.
* The full modifier ordering used by this method is:
* <blockquote> {@code
* public protected private abstract static final transient
@@ -269,9 +257,8 @@
}
/*
- * Access modifier flag constants from <em>The Java Virtual
- * Machine Specification, Second Edition</em>, tables 4.1, 4.4,
- * 4.5, and 4.7.
+ * Access modifier flag constants from tables 4.1, 4.4, 4.5, and 4.7 of
+ * <cite>The Java™ Virtual Machine Specification</cite>
*/
/**
@@ -403,7 +390,7 @@
* @return an {@code int} value OR-ing together the source language
* modifiers that can be applied to a class.
*
- * @jls3 8.1.1 Class Modifiers
+ * @jls 8.1.1 Class Modifiers
* @since 1.7
*/
public static int classModifiers() {
@@ -416,7 +403,7 @@
* @return an {@code int} value OR-ing together the source language
* modifiers that can be applied to an inteface.
*
- * @jls3 9.1.1 Interface Modifiers
+ * @jls 9.1.1 Interface Modifiers
* @since 1.7
*/
public static int interfaceModifiers() {
@@ -429,7 +416,7 @@
* @return an {@code int} value OR-ing together the source language
* modifiers that can be applied to a constructor.
*
- * @jls3 8.8.3 Constructor Modifiers
+ * @jls 8.8.3 Constructor Modifiers
* @since 1.7
*/
public static int constructorModifiers() {
@@ -442,7 +429,7 @@
* @return an {@code int} value OR-ing together the source language
* modifiers that can be applied to a method.
*
- * @jls3 8.4.3 Method Modifiers
+ * @jls 8.4.3 Method Modifiers
* @since 1.7
*/
public static int methodModifiers() {
@@ -456,7 +443,7 @@
* @return an {@code int} value OR-ing together the source language
* modifiers that can be applied to a field.
*
- * @jls3 8.3.1 Field Modifiers
+ * @jls 8.3.1 Field Modifiers
* @since 1.7
*/
public static int fieldModifiers() {
--- a/jdk/src/share/classes/java/math/BigDecimal.java Wed Apr 13 11:59:18 2011 -0700
+++ b/jdk/src/share/classes/java/math/BigDecimal.java Wed Apr 13 12:16:13 2011 -0700
@@ -2905,12 +2905,11 @@
/**
* Converts this {@code BigDecimal} to a {@code BigInteger}.
- * This conversion is analogous to a <a
- * href="http://java.sun.com/docs/books/jls/second_edition/html/conversions.doc.html#25363"><i>narrowing
- * primitive conversion</i></a> from {@code double} to
- * {@code long} as defined in the <a
- * href="http://java.sun.com/docs/books/jls/html/">Java Language
- * Specification</a>: any fractional part of this
+ * This conversion is analogous to the
+ * <i>narrowing primitive conversion</i> from {@code double} to
+ * {@code long} as defined in section 5.1.3 of
+ * <cite>The Java™ Language Specification</cite>:
+ * any fractional part of this
* {@code BigDecimal} will be discarded. Note that this
* conversion can lose information about the precision of the
* {@code BigDecimal} value.
@@ -2942,13 +2941,12 @@
}
/**
- * Converts this {@code BigDecimal} to a {@code long}. This
- * conversion is analogous to a <a
- * href="http://java.sun.com/docs/books/jls/second_edition/html/conversions.doc.html#25363"><i>narrowing
- * primitive conversion</i></a> from {@code double} to
- * {@code short} as defined in the <a
- * href="http://java.sun.com/docs/books/jls/html/">Java Language
- * Specification</a>: any fractional part of this
+ * Converts this {@code BigDecimal} to a {@code long}.
+ * This conversion is analogous to the
+ * <i>narrowing primitive conversion</i> from {@code double} to
+ * {@code short} as defined in section 5.1.3 of
+ * <cite>The Java™ Language Specification</cite>:
+ * any fractional part of this
* {@code BigDecimal} will be discarded, and if the resulting
* "{@code BigInteger}" is too big to fit in a
* {@code long}, only the low-order 64 bits are returned.
@@ -3011,13 +3009,12 @@
}
/**
- * Converts this {@code BigDecimal} to an {@code int}. This
- * conversion is analogous to a <a
- * href="http://java.sun.com/docs/books/jls/second_edition/html/conversions.doc.html#25363"><i>narrowing
- * primitive conversion</i></a> from {@code double} to
- * {@code short} as defined in the <a
- * href="http://java.sun.com/docs/books/jls/html/">Java Language
- * Specification</a>: any fractional part of this
+ * Converts this {@code BigDecimal} to an {@code int}.
+ * This conversion is analogous to the
+ * <i>narrowing primitive conversion</i> from {@code double} to
+ * {@code short} as defined in section 5.1.3 of
+ * <cite>The Java™ Language Specification</cite>:
+ * any fractional part of this
* {@code BigDecimal} will be discarded, and if the resulting
* "{@code BigInteger}" is too big to fit in an
* {@code int}, only the low-order 32 bits are returned.
@@ -3095,12 +3092,11 @@
/**
* Converts this {@code BigDecimal} to a {@code float}.
- * This conversion is similar to the <a
- * href="http://java.sun.com/docs/books/jls/second_edition/html/conversions.doc.html#25363"><i>narrowing
- * primitive conversion</i></a> from {@code double} to
- * {@code float} defined in the <a
- * href="http://java.sun.com/docs/books/jls/html/">Java Language
- * Specification</a>: if this {@code BigDecimal} has too great a
+ * This conversion is similar to the
+ * <i>narrowing primitive conversion</i> from {@code double} to
+ * {@code float} as defined in section 5.1.3 of
+ * <cite>The Java™ Language Specification</cite>:
+ * if this {@code BigDecimal} has too great a
* magnitude to represent as a {@code float}, it will be
* converted to {@link Float#NEGATIVE_INFINITY} or {@link
* Float#POSITIVE_INFINITY} as appropriate. Note that even when
@@ -3119,12 +3115,11 @@
/**
* Converts this {@code BigDecimal} to a {@code double}.
- * This conversion is similar to the <a
- * href="http://java.sun.com/docs/books/jls/second_edition/html/conversions.doc.html#25363"><i>narrowing
- * primitive conversion</i></a> from {@code double} to
- * {@code float} as defined in the <a
- * href="http://java.sun.com/docs/books/jls/html/">Java Language
- * Specification</a>: if this {@code BigDecimal} has too great a
+ * This conversion is similar to the
+ * <i>narrowing primitive conversion</i> from {@code double} to
+ * {@code float} as defined in section 5.1.3 of
+ * <cite>The Java™ Language Specification</cite>:
+ * if this {@code BigDecimal} has too great a
* magnitude represent as a {@code double}, it will be
* converted to {@link Double#NEGATIVE_INFINITY} or {@link
* Double#POSITIVE_INFINITY} as appropriate. Note that even when
--- a/jdk/src/share/classes/java/math/BigInteger.java Wed Apr 13 11:59:18 2011 -0700
+++ b/jdk/src/share/classes/java/math/BigInteger.java Wed Apr 13 12:16:13 2011 -0700
@@ -2719,12 +2719,11 @@
/**
* Converts this BigInteger to an {@code int}. This
- * conversion is analogous to a <a
- * href="http://java.sun.com/docs/books/jls/second_edition/html/conversions.doc.html#25363"><i>narrowing
- * primitive conversion</i></a> from {@code long} to
- * {@code int} as defined in the <a
- * href="http://java.sun.com/docs/books/jls/html/">Java Language
- * Specification</a>: if this BigInteger is too big to fit in an
+ * conversion is analogous to a
+ * <i>narrowing primitive conversion</i> from {@code long} to
+ * {@code int} as defined in section 5.1.3 of
+ * <cite>The Java™ Language Specification</cite>:
+ * if this BigInteger is too big to fit in an
* {@code int}, only the low-order 32 bits are returned.
* Note that this conversion can lose information about the
* overall magnitude of the BigInteger value as well as return a
@@ -2740,12 +2739,11 @@
/**
* Converts this BigInteger to a {@code long}. This
- * conversion is analogous to a <a
- * href="http://java.sun.com/docs/books/jls/second_edition/html/conversions.doc.html#25363"><i>narrowing
- * primitive conversion</i></a> from {@code long} to
- * {@code int} as defined in the <a
- * href="http://java.sun.com/docs/books/jls/html/">Java Language
- * Specification</a>: if this BigInteger is too big to fit in a
+ * conversion is analogous to a
+ * <i>narrowing primitive conversion</i> from {@code long} to
+ * {@code int} as defined in section 5.1.3 of
+ * <cite>The Java™ Language Specification</cite>:
+ * if this BigInteger is too big to fit in a
* {@code long}, only the low-order 64 bits are returned.
* Note that this conversion can lose information about the
* overall magnitude of the BigInteger value as well as return a
@@ -2763,12 +2761,11 @@
/**
* Converts this BigInteger to a {@code float}. This
- * conversion is similar to the <a
- * href="http://java.sun.com/docs/books/jls/second_edition/html/conversions.doc.html#25363"><i>narrowing
- * primitive conversion</i></a> from {@code double} to
- * {@code float} defined in the <a
- * href="http://java.sun.com/docs/books/jls/html/">Java Language
- * Specification</a>: if this BigInteger has too great a magnitude
+ * conversion is similar to the
+ * <i>narrowing primitive conversion</i> from {@code double} to
+ * {@code float} as defined in section 5.1.3 of
+ * <cite>The Java™ Language Specification</cite>:
+ * if this BigInteger has too great a magnitude
* to represent as a {@code float}, it will be converted to
* {@link Float#NEGATIVE_INFINITY} or {@link
* Float#POSITIVE_INFINITY} as appropriate. Note that even when
@@ -2784,12 +2781,11 @@
/**
* Converts this BigInteger to a {@code double}. This
- * conversion is similar to the <a
- * href="http://java.sun.com/docs/books/jls/second_edition/html/conversions.doc.html#25363"><i>narrowing
- * primitive conversion</i></a> from {@code double} to
- * {@code float} defined in the <a
- * href="http://java.sun.com/docs/books/jls/html/">Java Language
- * Specification</a>: if this BigInteger has too great a magnitude
+ * conversion is similar to the
+ * <i>narrowing primitive conversion</i> from {@code double} to
+ * {@code float} as defined in section 5.1.3 of
+ * <cite>The Java™ Language Specification</cite>:
+ * if this BigInteger has too great a magnitude
* to represent as a {@code double}, it will be converted to
* {@link Double#NEGATIVE_INFINITY} or {@link
* Double#POSITIVE_INFINITY} as appropriate. Note that even when
--- a/jdk/src/share/classes/java/security/SecureClassLoader.java Wed Apr 13 11:59:18 2011 -0700
+++ b/jdk/src/share/classes/java/security/SecureClassLoader.java Wed Apr 13 12:16:13 2011 -0700
@@ -118,10 +118,8 @@
* and without a trailing ".class" suffix.
* @param b the bytes that make up the class data. The bytes in
* positions <code>off</code> through <code>off+len-1</code>
- * should have the format of a valid class file as defined
- * by the
- * <a href="http://java.sun.com/docs/books/vmspec/">Java
- * Virtual Machine Specification</a>.
+ * should have the format of a valid class file as defined by
+ * <cite>The Java™ Virtual Machine Specification</cite>.
* @param off the start offset in <code>b</code> of the class data
* @param len the length of the class data
* @param cs the associated CodeSource, or <code>null</code> if none
@@ -157,9 +155,8 @@
* and without a trailing ".class" suffix.
* @param b the bytes that make up the class data. The bytes from positions
* <tt>b.position()</tt> through <tt>b.position() + b.limit() -1</tt>
- * should have the format of a valid class file as defined by the
- * <a href="http://java.sun.com/docs/books/vmspec/">Java Virtual
- * Machine Specification</a>.
+ * should have the format of a valid class file as defined by
+ * <cite>The Java™ Virtual Machine Specification</cite>.
* @param cs the associated CodeSource, or <code>null</code> if none
* @return the <code>Class</code> object created from the data,
* and optional CodeSource.
--- a/jdk/src/share/classes/java/util/Formatter.java Wed Apr 13 11:59:18 2011 -0700
+++ b/jdk/src/share/classes/java/util/Formatter.java Wed Apr 13 12:16:13 2011 -0700
@@ -1818,9 +1818,9 @@
* </pre></blockquote>
*
* <p> The maximum number of arguments is limited by the maximum dimension of a
- * Java array as defined by the <a
- * href="http://java.sun.com/docs/books/vmspec/">Java Virtual Machine
- * Specification</a>. If the argument index is does not correspond to an
+ * Java array as defined by
+ * <cite>The Java™ Virtual Machine Specification</cite>.
+ * If the argument index is does not correspond to an
* available argument, then a {@link MissingFormatArgumentException} is thrown.
*
* <p> If there are more arguments than format specifiers, the extra arguments
@@ -2403,8 +2403,7 @@
* string. If there are more arguments than format specifiers, the
* extra arguments are ignored. The maximum number of arguments is
* limited by the maximum dimension of a Java array as defined by
- * the <a href="http://java.sun.com/docs/books/vmspec/">Java
- * Virtual Machine Specification</a>.
+ * <cite>The Java™ Virtual Machine Specification</cite>.
*
* @throws IllegalFormatException
* If a format string contains an illegal syntax, a format
@@ -2443,8 +2442,7 @@
* string. If there are more arguments than format specifiers, the
* extra arguments are ignored. The maximum number of arguments is
* limited by the maximum dimension of a Java array as defined by
- * the <a href="http://java.sun.com/docs/books/vmspec/">Java
- * Virtual Machine Specification</a>
+ * <cite>The Java™ Virtual Machine Specification</cite>.
*
* @throws IllegalFormatException
* If a format string contains an illegal syntax, a format
--- a/jdk/src/share/classes/java/util/Properties.java Wed Apr 13 11:59:18 2011 -0700
+++ b/jdk/src/share/classes/java/util/Properties.java Wed Apr 13 12:16:13 2011 -0700
@@ -68,8 +68,9 @@
* methods work the same way as the load(Reader)/store(Writer, String) pair, except
* the input/output stream is encoded in ISO 8859-1 character encoding.
* Characters that cannot be directly represented in this encoding can be written using
- * <a href="http://java.sun.com/docs/books/jls/third_edition/html/lexical.html#3.3">Unicode escapes</a>
- * ; only a single 'u' character is allowed in an escape
+ * Unicode escapes as defined in section 3.3 of
+ * <cite>The Java™ Language Specification</cite>;
+ * only a single 'u' character is allowed in an escape
* sequence. The native2ascii tool can be used to convert property files to and
* from other character encodings.
*
@@ -272,11 +273,8 @@
* <a name="unicodeescapes"></a>
* Characters in keys and elements can be represented in escape
* sequences similar to those used for character and string literals
- * (see <a
- * href="http://java.sun.com/docs/books/jls/third_edition/html/lexical.html#3.3">§3.3</a>
- * and <a
- * href="http://java.sun.com/docs/books/jls/third_edition/html/lexical.html#3.10.6">§3.10.6</a>
- * of the <i>Java Language Specification</i>).
+ * (see sections 3.3 and 3.10.6 of
+ * <cite>The Java™ Language Specification</cite>).
*
* The differences from the character escape sequences and Unicode
* escapes used for characters and strings are:
@@ -326,8 +324,9 @@
* {@link #load(java.io.Reader) load(Reader)} and is assumed to use
* the ISO 8859-1 character encoding; that is each byte is one Latin1
* character. Characters not in Latin1, and certain special characters,
- * are represented in keys and elements using
- * <a href="http://java.sun.com/docs/books/jls/third_edition/html/lexical.html#3.3">Unicode escapes</a>.
+ * are represented in keys and elements using Unicode escapes as defined in
+ * section 3.3 of
+ * <cite>The Java™ Language Specification</cite>.
* <p>
* The specified stream remains open after this method returns.
*
--- a/jdk/src/share/classes/java/util/PropertyResourceBundle.java Wed Apr 13 11:59:18 2011 -0700
+++ b/jdk/src/share/classes/java/util/PropertyResourceBundle.java Wed Apr 13 12:16:13 2011 -0700
@@ -104,8 +104,9 @@
* from an InputStream or a Reader, which represents a property file.
* Constructing a PropertyResourceBundle instance from an InputStream requires
* that the input stream be encoded in ISO-8859-1. In that case, characters
- * that cannot be represented in ISO-8859-1 encoding must be represented by
- * <a href="http://java.sun.com/docs/books/jls/third_edition/html/lexical.html#3.3">Unicode Escapes</a>,
+ * that cannot be represented in ISO-8859-1 encoding must be represented by Unicode Escapes
+ * as defined in section 3.3 of
+ * <cite>The Java™ Language Specification</cite>
* whereas the other constructor which takes a Reader does not have that limitation.
*
* @see ResourceBundle
--- a/jdk/src/share/classes/java/util/concurrent/atomic/package-info.java Wed Apr 13 11:59:18 2011 -0700
+++ b/jdk/src/share/classes/java/util/concurrent/atomic/package-info.java Wed Apr 13 12:16:13 2011 -0700
@@ -80,9 +80,8 @@
* </pre>
*
* <p>The memory effects for accesses and updates of atomics generally
- * follow the rules for volatiles, as stated in
- * <a href="http://java.sun.com/docs/books/jls/"> The Java Language
- * Specification, Third Edition (17.4 Memory Model)</a>:
+ * follow the rules for volatiles, as stated in section 17.4 of
+ * <cite>The Java™ Language Specification</cite>.
*
* <ul>
*
--- a/jdk/src/share/classes/java/util/concurrent/locks/Lock.java Wed Apr 13 11:59:18 2011 -0700
+++ b/jdk/src/share/classes/java/util/concurrent/locks/Lock.java Wed Apr 13 12:16:13 2011 -0700
@@ -120,8 +120,8 @@
*
* <p>All {@code Lock} implementations <em>must</em> enforce the same
* memory synchronization semantics as provided by the built-in monitor
- * lock, as described in <a href="http://java.sun.com/docs/books/jls/">
- * The Java Language Specification, Third Edition (17.4 Memory Model)</a>:
+ * lock, as described in section 17.4 of
+ * <cite>The Java™ Language Specification</cite>:
* <ul>
* <li>A successful {@code lock} operation has the same memory
* synchronization effects as a successful <em>Lock</em> action.
--- a/jdk/src/share/classes/java/util/concurrent/package-info.java Wed Apr 13 11:59:18 2011 -0700
+++ b/jdk/src/share/classes/java/util/concurrent/package-info.java Wed Apr 13 12:16:13 2011 -0700
@@ -218,8 +218,9 @@
*
* <h2><a name="MemoryVisibility">Memory Consistency Properties</a></h2>
*
- * <a href="http://java.sun.com/docs/books/jls/third_edition/html/memory.html">
- * Chapter 17 of the Java Language Specification</a> defines the
+ * Chapter 17 of
+ * <cite>The Java™ Language Specification</cite>
+ * defines the
* <i>happens-before</i> relation on memory operations such as reads and
* writes of shared variables. The results of a write by one thread are
* guaranteed to be visible to a read by another thread only if the write
--- a/jdk/src/share/classes/java/util/jar/Pack200.java Wed Apr 13 11:59:18 2011 -0700
+++ b/jdk/src/share/classes/java/util/jar/Pack200.java Wed Apr 13 12:16:13 2011 -0700
@@ -181,8 +181,8 @@
* The class files will not contain identical bytes, since the unpacker
* is free to change minor class file features such as constant pool order.
* However, the class files will be semantically identical,
- * as specified in the Java Virtual Machine Specification
- * <a href="http://java.sun.com/docs/books/vmspec/html/ClassFile.doc.html">http://java.sun.com/docs/books/vmspec/html/ClassFile.doc.html</a>.
+ * as specified in
+ * <cite>The Java™ Virtual Machine Specification</cite>.
* <p>
* By default, the packer does not change the order of JAR elements.
* Also, the modification time and deflation hint of each
--- a/jdk/src/share/classes/java/util/regex/Pattern.java Wed Apr 13 11:59:18 2011 -0700
+++ b/jdk/src/share/classes/java/util/regex/Pattern.java Wed Apr 13 12:16:13 2011 -0700
@@ -369,13 +369,10 @@
* part of an unescaped construct.
*
* <p> Backslashes within string literals in Java source code are interpreted
- * as required by the <a
- * href="http://java.sun.com/docs/books/jls">Java Language
- * Specification</a> as either <a
- * href="http://java.sun.com/docs/books/jls/third_edition/html/lexical.html#100850">Unicode
- * escapes</a> or other <a
- * href="http://java.sun.com/docs/books/jls/third_edition/html/lexical.html#101089">character
- * escapes</a>. It is therefore necessary to double backslashes in string
+ * as required by
+ * <cite>The Java™ Language Specification</cite>
+ * as either Unicode escapes (section 3.3) or other character escapes (section 3.10.6)
+ * It is therefore necessary to double backslashes in string
* literals that represent regular expressions to protect them from
* interpretation by the Java bytecode compiler. The string literal
* <tt>"\b"</tt>, for example, matches a single backspace character when
@@ -525,9 +522,9 @@
* Canonical Equivalents.
*
* <p> Unicode escape sequences such as <tt>\u2014</tt> in Java source code
- * are processed as described in <a
- * href="http://java.sun.com/docs/books/jls/third_edition/html/lexical.html#100850">\u00A73.3</a>
- * of the Java Language Specification. Such escape sequences are also
+ * are processed as described in section 3.3 of
+ * <cite>The Java™ Language Specification</cite>.
+ * Such escape sequences are also
* implemented directly by the regular-expression parser so that Unicode
* escapes can be used in expressions that are read from files or from the
* keyboard. Thus the strings <tt>"\u2014"</tt> and <tt>"\\u2014"</tt>,
--- a/jdk/src/share/classes/javax/management/remote/package.html Wed Apr 13 11:59:18 2011 -0700
+++ b/jdk/src/share/classes/javax/management/remote/package.html Wed Apr 13 12:16:13 2011 -0700
@@ -154,11 +154,8 @@
</pre>
<p>The formal grammar for connection ids that follow this
- convention is as follows (using the <a
- href="http://java.sun.com/docs/books/jls/second_edition/html/grammars.doc.html#90767">grammar
- notation</a> from <em>The Java Language Specification, Second
- Edition</em>):</p>
-
+ convention is as follows (using the grammar notation from section 2.4 of
+ <em>The Java™ Language Specification</em>):</p>
<pre>
<em>ConnectionId:</em>
<em>Protocol</em> : <em>ClientAddress<sub>opt</sub></em> Space <em>ClientId<sub>opt</sub></em> Space <em>ArbitraryText</em>
--- a/jdk/src/share/classes/sun/misc/FpUtils.java Wed Apr 13 11:59:18 2011 -0700
+++ b/jdk/src/share/classes/sun/misc/FpUtils.java Wed Apr 13 12:16:13 2011 -0700
@@ -531,10 +531,9 @@
* Return {@code d} ×
* 2<sup>{@code scale_factor}</sup> rounded as if performed
* by a single correctly rounded floating-point multiply to a
- * member of the double value set. See <a
- * href="http://java.sun.com/docs/books/jls/second_edition/html/typesValues.doc.html#9208">§4.2.3</a>
- * of the <a href="http://java.sun.com/docs/books/jls/html/">Java
- * Language Specification</a> for a discussion of floating-point
+ * member of the double value set. See section 4.2.3 of
+ * <cite>The Java™ Language Specification</cite>
+ * for a discussion of floating-point
* value sets. If the exponent of the result is between the
* {@code double}'s minimum exponent and maximum exponent,
* the answer is calculated exactly. If the exponent of the
@@ -641,11 +640,10 @@
* Return {@code f} ×
* 2<sup>{@code scale_factor}</sup> rounded as if performed
* by a single correctly rounded floating-point multiply to a
- * member of the float value set. See <a
- * href="http://java.sun.com/docs/books/jls/second_edition/html/typesValues.doc.html#9208">§4.2.3</a>
- * of the <a href="http://java.sun.com/docs/books/jls/html/">Java
- * Language Specification</a> for a discussion of floating-point
- * value set. If the exponent of the result is between the
+ * member of the float value set. See section 4.2.3 of
+ * <cite>The Java™ Language Specification</cite>
+ * for a discussion of floating-point
+ * value sets. If the exponent of the result is between the
* {@code float}'s minimum exponent and maximum exponent, the
* answer is calculated exactly. If the exponent of the result
* would be larger than {@code float}'s maximum exponent, an