8249205: Remove unnecessary trademark symbols
Reviewed-by: darcy, lancea, bpb, prr, jjg, cjplummer, iris, dfuchs, weijun, joehw, wetmore, bchristi
This commit is contained in:
parent
24f4f14c3d
commit
55039aa1c6
@ -530,7 +530,7 @@ JDWP "Java(tm) Debug Wire Protocol"
|
||||
"returned for each class. "
|
||||
"Generic signatures are described in the signature attribute "
|
||||
"section in "
|
||||
"<cite>The Java™ Virtual Machine Specification</cite>. "
|
||||
"<cite>The Java Virtual Machine Specification</cite>. "
|
||||
"Since JDWP version 1.5."
|
||||
(Out
|
||||
)
|
||||
@ -643,7 +643,7 @@ JDWP "Java(tm) Debug Wire Protocol"
|
||||
)
|
||||
(Reply
|
||||
(int modBits "Modifier bits as defined in Chapter 4 of "
|
||||
"<cite>The Java™ Virtual Machine Specification</cite>")
|
||||
"<cite>The Java Virtual Machine Specification</cite>")
|
||||
)
|
||||
(ErrorSet
|
||||
(Error INVALID_CLASS "refType is not the ID of a reference "
|
||||
@ -671,7 +671,7 @@ JDWP "Java(tm) Debug Wire Protocol"
|
||||
"which provide additional information on the "
|
||||
"field declaration. Individual flag values are "
|
||||
"defined in Chapter 4 of "
|
||||
"<cite>The Java™ Virtual Machine Specification</cite>. "
|
||||
"<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.")
|
||||
@ -706,7 +706,7 @@ JDWP "Java(tm) Debug Wire Protocol"
|
||||
"which provide additional information on the "
|
||||
"method declaration. Individual flag values are "
|
||||
"defined in Chapter 4 of "
|
||||
"<cite>The Java™ Virtual Machine Specification</cite>. "
|
||||
"<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.")
|
||||
@ -793,7 +793,7 @@ JDWP "Java(tm) Debug Wire Protocol"
|
||||
"Returns the current status of the reference type. The status "
|
||||
"indicates the extent to which the reference type has been "
|
||||
"initialized, as described in section 2.1.6 of "
|
||||
"<cite>The Java™ Virtual Machine Specification</cite>. "
|
||||
"<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 "
|
||||
@ -872,7 +872,7 @@ JDWP "Java(tm) Debug Wire Protocol"
|
||||
"generic signature if there is one. "
|
||||
"Generic signatures are described in the signature attribute "
|
||||
"section in "
|
||||
"<cite>The Java™ Virtual Machine Specification</cite>. "
|
||||
"<cite>The Java Virtual Machine Specification</cite>. "
|
||||
"Since JDWP version 1.5."
|
||||
(Out
|
||||
(referenceType refType "The reference type ID.")
|
||||
@ -900,7 +900,7 @@ JDWP "Java(tm) Debug Wire Protocol"
|
||||
"Fields are returned in the order they occur in the class file. "
|
||||
"Generic signatures are described in the signature attribute "
|
||||
"section in "
|
||||
"<cite>The Java™ Virtual Machine Specification</cite>. "
|
||||
"<cite>The Java Virtual Machine Specification</cite>. "
|
||||
"Since JDWP version 1.5."
|
||||
(Out
|
||||
(referenceType refType "The reference type ID.")
|
||||
@ -917,7 +917,7 @@ JDWP "Java(tm) Debug Wire Protocol"
|
||||
"which provide additional information on the "
|
||||
"field declaration. Individual flag values are "
|
||||
"defined in Chapter 4 of "
|
||||
"<cite>The Java™ Virtual Machine Specification</cite>. "
|
||||
"<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.")
|
||||
@ -942,7 +942,7 @@ JDWP "Java(tm) Debug Wire Protocol"
|
||||
"Methods are returned in the order they occur in the class file. "
|
||||
"Generic signatures are described in the signature attribute "
|
||||
"section in "
|
||||
"<cite>The Java™ Virtual Machine Specification</cite>. "
|
||||
"<cite>The Java Virtual Machine Specification</cite>. "
|
||||
"Since JDWP version 1.5."
|
||||
(Out
|
||||
(referenceType refType "The reference type ID.")
|
||||
@ -959,7 +959,7 @@ JDWP "Java(tm) Debug Wire Protocol"
|
||||
"which provide additional information on the "
|
||||
"method declaration. Individual flag values are "
|
||||
"defined in Chapter 4 of "
|
||||
"<cite>The Java™ Virtual Machine Specification</cite>. "
|
||||
"<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.")
|
||||
@ -1022,7 +1022,7 @@ JDWP "Java(tm) Debug Wire Protocol"
|
||||
(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 "
|
||||
"<cite>The Java™ Virtual Machine Specification</cite>. "
|
||||
"<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
|
||||
@ -1032,7 +1032,7 @@ JDWP "Java(tm) Debug Wire Protocol"
|
||||
(int count "Total number of constant pool entries plus one. This "
|
||||
"corresponds to the constant_pool_count item of the "
|
||||
"Class File Format in "
|
||||
"<cite>The Java™ Virtual Machine Specification</cite>. ")
|
||||
"<cite>The Java Virtual Machine Specification</cite>. ")
|
||||
(Repeat bytes
|
||||
(byte cpbytes "Raw bytes of constant pool")
|
||||
)
|
||||
@ -1435,7 +1435,7 @@ JDWP "Java(tm) Debug Wire Protocol"
|
||||
)
|
||||
(Command Bytecodes=3
|
||||
"Retrieve the method's bytecodes as defined in "
|
||||
"<cite>The Java™ Virtual Machine Specification</cite>. "
|
||||
"<cite>The Java Virtual Machine Specification</cite>. "
|
||||
"Requires canGetBytecodes capability - see "
|
||||
"<a href=\"#JDWP_VirtualMachine_CapabilitiesNew\">CapabilitiesNew</a>."
|
||||
(Out
|
||||
@ -1491,7 +1491,7 @@ JDWP "Java(tm) Debug Wire Protocol"
|
||||
"table. Also, synthetic variables may be present. "
|
||||
"Generic signatures are described in the signature attribute "
|
||||
"section in "
|
||||
"<cite>The Java™ Virtual Machine Specification</cite>. "
|
||||
"<cite>The Java Virtual Machine Specification</cite>. "
|
||||
"Since JDWP version 1.5."
|
||||
(Out
|
||||
(referenceType refType "The class.")
|
||||
@ -2082,7 +2082,7 @@ JDWP "Java(tm) Debug Wire Protocol"
|
||||
"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 "
|
||||
"<cite>The Java™ Virtual Machine Specification</cite>) "
|
||||
"<cite>The Java Virtual Machine Specification</cite>) "
|
||||
"for the specified thread at the time this command "
|
||||
"is received. "
|
||||
"<p>"
|
||||
|
@ -152,7 +152,7 @@ public final class Console implements Flushable
|
||||
* 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
|
||||
* <cite>The Java™ Virtual Machine Specification</cite>.
|
||||
* <cite>The Java Virtual Machine Specification</cite>.
|
||||
* The behaviour on a
|
||||
* {@code null} argument depends on the <a
|
||||
* href="../util/Formatter.html#syntax">conversion</a>.
|
||||
@ -192,7 +192,7 @@ public final class Console implements Flushable
|
||||
* 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
|
||||
* <cite>The Java™ Virtual Machine Specification</cite>.
|
||||
* <cite>The Java Virtual Machine Specification</cite>.
|
||||
* The behaviour on a
|
||||
* {@code null} argument depends on the <a
|
||||
* href="../util/Formatter.html#syntax">conversion</a>.
|
||||
@ -225,7 +225,7 @@ public final class Console implements Flushable
|
||||
* 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
|
||||
* <cite>The Java™ Virtual Machine Specification</cite>.
|
||||
* <cite>The Java Virtual Machine Specification</cite>.
|
||||
*
|
||||
* @throws IllegalFormatException
|
||||
* If a format string contains an illegal syntax, a format
|
||||
@ -289,7 +289,7 @@ public final class Console implements Flushable
|
||||
* 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
|
||||
* <cite>The Java™ Virtual Machine Specification</cite>.
|
||||
* <cite>The Java Virtual Machine Specification</cite>.
|
||||
*
|
||||
* @throws IllegalFormatException
|
||||
* If a format string contains an illegal syntax, a format
|
||||
|
@ -1080,7 +1080,7 @@ public class PrintStream extends FilterOutputStream
|
||||
* 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
|
||||
* <cite>The Java™ Virtual Machine Specification</cite>.
|
||||
* <cite>The Java Virtual Machine Specification</cite>.
|
||||
* The behaviour on a
|
||||
* {@code null} argument depends on the <a
|
||||
* href="../util/Formatter.html#syntax">conversion</a>.
|
||||
@ -1132,7 +1132,7 @@ public class PrintStream extends FilterOutputStream
|
||||
* 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
|
||||
* <cite>The Java™ Virtual Machine Specification</cite>.
|
||||
* <cite>The Java Virtual Machine Specification</cite>.
|
||||
* The behaviour on a
|
||||
* {@code null} argument depends on the <a
|
||||
* href="../util/Formatter.html#syntax">conversion</a>.
|
||||
@ -1177,7 +1177,7 @@ public class PrintStream extends FilterOutputStream
|
||||
* 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
|
||||
* <cite>The Java™ Virtual Machine Specification</cite>.
|
||||
* <cite>The Java Virtual Machine Specification</cite>.
|
||||
* The behaviour on a
|
||||
* {@code null} argument depends on the <a
|
||||
* href="../util/Formatter.html#syntax">conversion</a>.
|
||||
@ -1236,7 +1236,7 @@ public class PrintStream extends FilterOutputStream
|
||||
* 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
|
||||
* <cite>The Java™ Virtual Machine Specification</cite>.
|
||||
* <cite>The Java Virtual Machine Specification</cite>.
|
||||
* The behaviour on a
|
||||
* {@code null} argument depends on the <a
|
||||
* href="../util/Formatter.html#syntax">conversion</a>.
|
||||
|
@ -863,7 +863,7 @@ public class PrintWriter extends Writer {
|
||||
* 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
|
||||
* <cite>The Java™ Virtual Machine Specification</cite>.
|
||||
* <cite>The Java Virtual Machine Specification</cite>.
|
||||
* The behaviour on a
|
||||
* {@code null} argument depends on the <a
|
||||
* href="../util/Formatter.html#syntax">conversion</a>.
|
||||
@ -916,7 +916,7 @@ public class PrintWriter extends Writer {
|
||||
* 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
|
||||
* <cite>The Java™ Virtual Machine Specification</cite>.
|
||||
* <cite>The Java Virtual Machine Specification</cite>.
|
||||
* The behaviour on a
|
||||
* {@code null} argument depends on the <a
|
||||
* href="../util/Formatter.html#syntax">conversion</a>.
|
||||
@ -960,7 +960,7 @@ public class PrintWriter extends Writer {
|
||||
* 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
|
||||
* <cite>The Java™ Virtual Machine Specification</cite>.
|
||||
* <cite>The Java Virtual Machine Specification</cite>.
|
||||
* The behaviour on a
|
||||
* {@code null} argument depends on the <a
|
||||
* href="../util/Formatter.html#syntax">conversion</a>.
|
||||
@ -1020,7 +1020,7 @@ public class PrintWriter extends Writer {
|
||||
* 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
|
||||
* <cite>The Java™ Virtual Machine Specification</cite>.
|
||||
* <cite>The Java Virtual Machine Specification</cite>.
|
||||
* The behaviour on a
|
||||
* {@code null} argument depends on the <a
|
||||
* href="../util/Formatter.html#syntax">conversion</a>.
|
||||
|
@ -35,7 +35,7 @@ package java.lang;
|
||||
* </pre>
|
||||
* has as its detail message the <i>string conversion</i> of
|
||||
* <i>expression</i> (as defined in section 15.18.1.1 of
|
||||
* <cite>The Java™ Language Specification</cite>),
|
||||
* <cite>The Java Language Specification</cite>),
|
||||
* regardless of the type of <i>expression</i>.
|
||||
*
|
||||
* @since 1.4
|
||||
@ -63,7 +63,7 @@ public class AssertionError extends Error {
|
||||
* Constructs an AssertionError with its detail message derived
|
||||
* from the specified object, which is converted to a string as
|
||||
* defined in section 15.18.1.1 of
|
||||
* <cite>The Java™ Language Specification</cite>.
|
||||
* <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,7 +81,7 @@ public class AssertionError extends Error {
|
||||
* Constructs an AssertionError with its detail message derived
|
||||
* from the specified {@code boolean}, which is converted to
|
||||
* a string as defined in section 15.18.1.1 of
|
||||
* <cite>The Java™ Language Specification</cite>.
|
||||
* <cite>The Java Language Specification</cite>.
|
||||
*
|
||||
* @param detailMessage value to be used in constructing detail message
|
||||
*/
|
||||
@ -93,7 +93,7 @@ public class AssertionError extends Error {
|
||||
* Constructs an AssertionError with its detail message derived
|
||||
* from the specified {@code char}, which is converted to a
|
||||
* string as defined in section 15.18.1.1 of
|
||||
* <cite>The Java™ Language Specification</cite>.
|
||||
* <cite>The Java Language Specification</cite>.
|
||||
*
|
||||
* @param detailMessage value to be used in constructing detail message
|
||||
*/
|
||||
@ -105,7 +105,7 @@ public class AssertionError extends Error {
|
||||
* Constructs an AssertionError with its detail message derived
|
||||
* from the specified {@code int}, which is converted to a
|
||||
* string as defined in section 15.18.1.1 of
|
||||
* <cite>The Java™ Language Specification</cite>.
|
||||
* <cite>The Java Language Specification</cite>.
|
||||
*
|
||||
* @param detailMessage value to be used in constructing detail message
|
||||
*/
|
||||
@ -117,7 +117,7 @@ public class AssertionError extends Error {
|
||||
* Constructs an AssertionError with its detail message derived
|
||||
* from the specified {@code long}, which is converted to a
|
||||
* string as defined in section 15.18.1.1 of
|
||||
* <cite>The Java™ Language Specification</cite>.
|
||||
* <cite>The Java Language Specification</cite>.
|
||||
*
|
||||
* @param detailMessage value to be used in constructing detail message
|
||||
*/
|
||||
@ -129,7 +129,7 @@ public class AssertionError extends Error {
|
||||
* Constructs an AssertionError with its detail message derived
|
||||
* from the specified {@code float}, which is converted to a
|
||||
* string as defined in section 15.18.1.1 of
|
||||
* <cite>The Java™ Language Specification</cite>.
|
||||
* <cite>The Java Language Specification</cite>.
|
||||
*
|
||||
* @param detailMessage value to be used in constructing detail message
|
||||
*/
|
||||
@ -141,7 +141,7 @@ public class AssertionError extends Error {
|
||||
* Constructs an AssertionError with its detail message derived
|
||||
* from the specified {@code double}, which is converted to a
|
||||
* string as defined in section 15.18.1.1 of
|
||||
* <cite>The Java™ Language Specification</cite>.
|
||||
* <cite>The Java Language Specification</cite>.
|
||||
*
|
||||
* @param detailMessage value to be used in constructing detail message
|
||||
*/
|
||||
|
@ -290,7 +290,7 @@ public final class Byte extends Number implements Comparable<Byte>, Constable {
|
||||
*
|
||||
* <i>DecimalNumeral</i>, <i>HexDigits</i>, and <i>OctalDigits</i>
|
||||
* are as defined in section 3.10.1 of
|
||||
* <cite>The Java™ Language Specification</cite>,
|
||||
* <cite>The Java Language Specification</cite>,
|
||||
* except that underscores are not accepted between digits.
|
||||
*
|
||||
* <p>The sequence of characters following an optional
|
||||
|
@ -413,7 +413,7 @@ public final class Class<T> implements java.io.Serializable,
|
||||
*
|
||||
* Note that this method throws errors related to loading, linking
|
||||
* or initializing as specified in Sections {@jls 12.2}, {@jls
|
||||
* 12.3}, and {@jls 12.4} of <cite>The Java™ Language
|
||||
* 12.3}, and {@jls 12.4} of <cite>The Java Language
|
||||
* Specification</cite>.
|
||||
* Note that this method does not check whether the requested class
|
||||
* is accessible to its caller.
|
||||
@ -422,7 +422,7 @@ public final class Class<T> implements java.io.Serializable,
|
||||
|
||||
* @param initialize if {@code true} the class will be initialized
|
||||
* (which implies linking). See Section {@jls
|
||||
* 12.4} of <cite>The Java™ Language
|
||||
* 12.4} of <cite>The Java Language
|
||||
* Specification</cite>.
|
||||
* @param loader class loader from which the class must be loaded
|
||||
* @return class object representing the desired class
|
||||
@ -700,7 +700,7 @@ public final class Class<T> implements java.io.Serializable,
|
||||
* <p> Specifically, this method tests whether the type represented by the
|
||||
* specified {@code Class} parameter can be converted to the type
|
||||
* represented by this {@code Class} object via an identity conversion
|
||||
* or via a widening reference conversion. See <cite>The Java™ Language
|
||||
* or via a widening reference conversion. See <cite>The Java Language
|
||||
* Specification</cite>, sections {@jls 5.1.1} and {@jls 5.1.4},
|
||||
* for details.
|
||||
*
|
||||
@ -952,7 +952,7 @@ public final class Class<T> implements java.io.Serializable,
|
||||
* @throws java.lang.reflect.GenericSignatureFormatError if the generic
|
||||
* signature of this generic declaration does not conform to
|
||||
* the format specified in section {@jvms 4.7.9} of
|
||||
* <cite>The Java™ Virtual Machine Specification</cite>
|
||||
* <cite>The Java Virtual Machine Specification</cite>
|
||||
* @since 1.5
|
||||
*/
|
||||
@SuppressWarnings("unchecked")
|
||||
@ -1000,7 +1000,7 @@ public final class Class<T> implements java.io.Serializable,
|
||||
*
|
||||
* @throws java.lang.reflect.GenericSignatureFormatError if the generic
|
||||
* class signature does not conform to the format specified in
|
||||
* section {@jvms 4.7.9} of <cite>The Java™ Virtual
|
||||
* section {@jvms 4.7.9} of <cite>The Java Virtual
|
||||
* Machine Specification</cite>
|
||||
* @throws TypeNotPresentException if the generic superclass
|
||||
* refers to a non-existent type declaration
|
||||
@ -1197,7 +1197,7 @@ public final class Class<T> implements java.io.Serializable,
|
||||
* @throws java.lang.reflect.GenericSignatureFormatError
|
||||
* if the generic class signature does not conform to the
|
||||
* format specified in section {@jvms 4.7.9} of <cite>The
|
||||
* Java™ Virtual Machine Specification</cite>
|
||||
* 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
|
||||
@ -1269,7 +1269,7 @@ public final class Class<T> implements java.io.Serializable,
|
||||
* by this specification.
|
||||
*
|
||||
* <p> The modifier encodings are defined in section {@jvms 4.1}
|
||||
* of <cite>The Java™ Virtual Machine Specification</cite>.
|
||||
* of <cite>The Java Virtual Machine Specification</cite>.
|
||||
*
|
||||
* @return the {@code int} representing the modifiers for this class
|
||||
* @see java.lang.reflect.Modifier
|
||||
@ -1678,7 +1678,7 @@ public final class Class<T> implements java.io.Serializable,
|
||||
|
||||
/**
|
||||
* Returns the canonical name of the underlying class as
|
||||
* defined by <cite>The Java™ Language Specification</cite>.
|
||||
* defined by <cite>The Java Language Specification</cite>.
|
||||
* Returns {@code null} if the underlying class does not have a canonical
|
||||
* name. Classes without canonical names include:
|
||||
* <ul>
|
||||
@ -2478,7 +2478,7 @@ public final class Class<T> implements java.io.Serializable,
|
||||
* object represents an interface, a primitive type, an array class, or
|
||||
* void.
|
||||
*
|
||||
* <p> See <cite>The Java™ Language Specification</cite>,
|
||||
* <p> See <cite>The Java Language Specification</cite>,
|
||||
* section {@jls 8.2}.
|
||||
*
|
||||
* @return the array of {@code Constructor} objects representing all the
|
||||
|
@ -207,7 +207,7 @@ import sun.security.util.SecurityConstants;
|
||||
*
|
||||
* <p> Any class name provided as a {@code String} parameter to methods in
|
||||
* {@code ClassLoader} must be a binary name as defined by
|
||||
* <cite>The Java™ Language Specification</cite>.
|
||||
* <cite>The Java Language Specification</cite>.
|
||||
*
|
||||
* <p> Examples of valid class names include:
|
||||
* <blockquote><pre>
|
||||
@ -220,7 +220,7 @@ import sun.security.util.SecurityConstants;
|
||||
* <p> Any package name provided as a {@code String} parameter to methods in
|
||||
* {@code ClassLoader} must be either the empty string (denoting an unnamed package)
|
||||
* or a fully qualified name as defined by
|
||||
* <cite>The Java™ Language Specification</cite>.
|
||||
* <cite>The Java Language Specification</cite>.
|
||||
*
|
||||
* @jls 6.7 Fully Qualified Names
|
||||
* @jls 13.1 The Form of a Binary
|
||||
@ -765,7 +765,7 @@ public abstract class ClassLoader {
|
||||
* The bytes that make up the class data. The bytes in positions
|
||||
* {@code off} through {@code off+len-1} should have the format
|
||||
* of a valid class file as defined by
|
||||
* <cite>The Java™ Virtual Machine Specification</cite>.
|
||||
* <cite>The Java Virtual Machine Specification</cite>.
|
||||
*
|
||||
* @param off
|
||||
* The start offset in {@code b} of the class data
|
||||
@ -838,7 +838,7 @@ public abstract class ClassLoader {
|
||||
* The bytes that make up the class data. The bytes in positions
|
||||
* {@code off} through {@code off+len-1} should have the format
|
||||
* of a valid class file as defined by
|
||||
* <cite>The Java™ Virtual Machine Specification</cite>.
|
||||
* <cite>The Java Virtual Machine Specification</cite>.
|
||||
*
|
||||
* @param off
|
||||
* The start offset in {@code b} of the class data
|
||||
@ -972,7 +972,7 @@ public abstract class ClassLoader {
|
||||
* The bytes that make up the class data. The bytes in positions
|
||||
* {@code off} through {@code off+len-1} should have the format
|
||||
* of a valid class file as defined by
|
||||
* <cite>The Java™ Virtual Machine Specification</cite>.
|
||||
* <cite>The Java Virtual Machine Specification</cite>.
|
||||
*
|
||||
* @param off
|
||||
* The start offset in {@code b} of the class data
|
||||
@ -1056,7 +1056,7 @@ public abstract class ClassLoader {
|
||||
* The bytes that make up the class data. The bytes from positions
|
||||
* {@code b.position()} through {@code b.position() + b.limit() -1
|
||||
* } should have the format of a valid class file as defined by
|
||||
* <cite>The Java™ Virtual Machine Specification</cite>.
|
||||
* <cite>The Java Virtual Machine Specification</cite>.
|
||||
*
|
||||
* @param protectionDomain
|
||||
* The {@code ProtectionDomain} of the class, or {@code null}.
|
||||
@ -1213,7 +1213,7 @@ public abstract class ClassLoader {
|
||||
* used by a class loader to link a class. If the class {@code c} has
|
||||
* already been linked, then this method simply returns. Otherwise, the
|
||||
* class is linked as described in the "Execution" chapter of
|
||||
* <cite>The Java™ Language Specification</cite>.
|
||||
* <cite>The Java Language Specification</cite>.
|
||||
*
|
||||
* @param c
|
||||
* The class to link
|
||||
@ -2532,7 +2532,7 @@ public abstract class ClassLoader {
|
||||
* is to be set. A {@code null} value indicates the unnamed
|
||||
* package that is "current"
|
||||
* (see section 7.4.2 of
|
||||
* <cite>The Java™ Language Specification</cite>.)
|
||||
* <cite>The Java Language Specification</cite>.)
|
||||
*
|
||||
* @param enabled
|
||||
* {@code true} if classes loaded by this classloader and
|
||||
|
@ -403,7 +403,7 @@ public final class Double extends Number
|
||||
* <i>HexNumeral</i>, <i>HexDigits</i>, <i>SignedInteger</i> and
|
||||
* <i>FloatTypeSuffix</i> are as defined in the lexical structure
|
||||
* sections of
|
||||
* <cite>The Java™ Language Specification</cite>,
|
||||
* <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}
|
||||
|
@ -44,7 +44,7 @@ import static java.util.Objects.requireNonNull;
|
||||
*
|
||||
* More information about enums, including descriptions of the
|
||||
* implicitly declared methods synthesized by the compiler, can be
|
||||
* found in section {@jls 8.9} of <cite>The Java™ Language
|
||||
* found in section {@jls 8.9} of <cite>The Java Language
|
||||
* Specification</cite>.
|
||||
*
|
||||
* Enumeration types are all serializable and receive special handling
|
||||
|
@ -362,7 +362,7 @@ public final class Float extends Number
|
||||
* <i>HexNumeral</i>, <i>HexDigits</i>, <i>SignedInteger</i> and
|
||||
* <i>FloatTypeSuffix</i> are as defined in the lexical structure
|
||||
* sections of
|
||||
* <cite>The Java™ Language Specification</cite>,
|
||||
* <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}
|
||||
|
@ -1377,7 +1377,7 @@ public final class Integer extends Number
|
||||
*
|
||||
* <i>DecimalNumeral</i>, <i>HexDigits</i>, and <i>OctalDigits</i>
|
||||
* are as defined in section 3.10.1 of
|
||||
* <cite>The Java™ Language Specification</cite>,
|
||||
* <cite>The Java Language Specification</cite>,
|
||||
* except that underscores are not accepted between digits.
|
||||
*
|
||||
* <p>The sequence of characters following an optional
|
||||
|
@ -1229,7 +1229,7 @@ public final class Long extends Number
|
||||
*
|
||||
* <i>DecimalNumeral</i>, <i>HexDigits</i>, and <i>OctalDigits</i>
|
||||
* are as defined in section 3.10.1 of
|
||||
* <cite>The Java™ Language Specification</cite>,
|
||||
* <cite>The Java Language Specification</cite>,
|
||||
* except that underscores are not accepted between digits.
|
||||
*
|
||||
* <p>The sequence of characters following an optional
|
||||
|
@ -85,7 +85,7 @@ import sun.security.util.SecurityConstants;
|
||||
*
|
||||
* <p> The package names that are parameters or returned by methods defined in
|
||||
* this class are the fully-qualified names of the packages as defined in
|
||||
* section 6.5.3 of <cite>The Java™ Language Specification</cite>, for
|
||||
* section 6.5.3 of <cite>The Java Language Specification</cite>, for
|
||||
* example, {@code "java.lang"}. </p>
|
||||
*
|
||||
* <p> Unless otherwise specified, passing a {@code null} argument to a method
|
||||
@ -672,7 +672,7 @@ public final class Module implements AnnotatedElement {
|
||||
* <p> This method has no effect if the package is already exported (or
|
||||
* <em>open</em>) to the given module. </p>
|
||||
*
|
||||
* @apiNote As specified in section 5.4.3 of the <cite>The Java™
|
||||
* @apiNote As specified in section 5.4.3 of the <cite>The Java
|
||||
* Virtual Machine Specification </cite>, if an attempt to resolve a
|
||||
* symbolic reference fails because of a linkage error, then subsequent
|
||||
* attempts to resolve the reference always fail with the same error that
|
||||
|
@ -37,7 +37,7 @@ package java.lang;
|
||||
*
|
||||
* For platform classes, the conversion is often analogous to a
|
||||
* narrowing primitive conversion or a widening primitive conversion
|
||||
* as defined in <cite>The Java™ Language Specification</cite>
|
||||
* as defined in <cite>The Java Language Specification</cite>
|
||||
* for converting between primitive types. Therefore, conversions may
|
||||
* lose information about the overall magnitude of a numeric value, may
|
||||
* lose precision, and may even return a result of a different sign
|
||||
|
@ -462,7 +462,7 @@ public class Object {
|
||||
* system resources or to perform other cleanup.
|
||||
* <p>
|
||||
* The general contract of {@code finalize} is that it is invoked
|
||||
* if and when the Java™ virtual
|
||||
* if and when the Java virtual
|
||||
* machine has determined that there is no longer any
|
||||
* means by which this object can be accessed by any thread that has
|
||||
* not yet died, except as a result of an action taken by the
|
||||
|
@ -122,7 +122,7 @@ public class Package extends NamedPackage implements java.lang.reflect.Annotated
|
||||
* Return the name of this package.
|
||||
*
|
||||
* @return The fully-qualified name of this package as defined in section 6.5.3 of
|
||||
* <cite>The Java™ Language Specification</cite>,
|
||||
* <cite>The Java Language Specification</cite>,
|
||||
* for example, {@code java.lang}
|
||||
*/
|
||||
public String getName() {
|
||||
|
@ -38,10 +38,10 @@ package java.lang;
|
||||
* <p>More information about records, including descriptions of the
|
||||
* implicitly declared methods synthesized by the compiler, can be
|
||||
* found in section 8.10 of
|
||||
* <cite>The Java™ Language Specification</cite>.
|
||||
* <cite>The Java Language Specification</cite>.
|
||||
*
|
||||
* <p>A <em>record class</em> is a shallowly immutable, transparent carrier for
|
||||
* a fixed set of values, called the <em>record components</em>. The Java™
|
||||
* a fixed set of values, called the <em>record components</em>. The Java
|
||||
* language provides concise syntax for declaring record classes, whereby the
|
||||
* record components are declared in the record header. The list of record
|
||||
* components declared in the record header form the <em>record descriptor</em>.
|
||||
|
@ -295,7 +295,7 @@ public final class Short extends Number implements Comparable<Short>, Constable
|
||||
*
|
||||
* <i>DecimalNumeral</i>, <i>HexDigits</i>, and <i>OctalDigits</i>
|
||||
* are as defined in section 3.10.1 of
|
||||
* <cite>The Java™ Language Specification</cite>,
|
||||
* <cite>The Java Language Specification</cite>,
|
||||
* except that underscores are not accepted between digits.
|
||||
*
|
||||
* <p>The sequence of characters following an optional
|
||||
|
@ -90,7 +90,7 @@ import static java.util.function.Predicate.not;
|
||||
* The Java language provides special support for the string
|
||||
* concatenation operator ( + ), and for conversion of
|
||||
* other objects to strings. For additional information on string
|
||||
* concatenation and conversion, see <i>The Java™ Language Specification</i>.
|
||||
* concatenation and conversion, see <i>The Java Language Specification</i>.
|
||||
*
|
||||
* <p> Unless otherwise noted, passing a {@code null} argument to a constructor
|
||||
* or method in this class will cause a {@link NullPointerException} to be
|
||||
@ -113,7 +113,7 @@ import static java.util.function.Predicate.not;
|
||||
*
|
||||
* @implNote The implementation of the string concatenation operator is left to
|
||||
* the discretion of a Java compiler, as long as the compiler ultimately conforms
|
||||
* to <i>The Java™ Language Specification</i>. For example, the {@code javac} compiler
|
||||
* to <i>The Java Language Specification</i>. For example, the {@code javac} compiler
|
||||
* may implement the operator with {@code StringBuffer}, {@code StringBuilder},
|
||||
* or {@code java.lang.invoke.StringConcatFactory} depending on the JDK version. The
|
||||
* implementation of string conversion is typically through the method {@code toString},
|
||||
@ -3269,7 +3269,7 @@ public final class String
|
||||
* 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
|
||||
* <cite>The Java™ Virtual Machine Specification</cite>.
|
||||
* <cite>The Java Virtual Machine Specification</cite>.
|
||||
* The behaviour on a
|
||||
* {@code null} argument depends on the <a
|
||||
* href="../util/Formatter.html#syntax">conversion</a>.
|
||||
@ -3310,7 +3310,7 @@ public final class String
|
||||
* 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
|
||||
* <cite>The Java™ Virtual Machine Specification</cite>.
|
||||
* <cite>The Java Virtual Machine Specification</cite>.
|
||||
* The behaviour on a
|
||||
* {@code null} argument depends on the
|
||||
* <a href="../util/Formatter.html#syntax">conversion</a>.
|
||||
@ -3534,7 +3534,7 @@ public final class String
|
||||
* <p>
|
||||
* All literal strings and string-valued constant expressions are
|
||||
* interned. String literals are defined in section 3.10.5 of the
|
||||
* <cite>The Java™ Language Specification</cite>.
|
||||
* <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.
|
||||
|
@ -32,7 +32,7 @@ package java.lang.annotation;
|
||||
* define an annotation type.
|
||||
*
|
||||
* More information about annotation types can be found in section 9.6 of
|
||||
* <cite>The Java™ Language Specification</cite>.
|
||||
* <cite>The Java Language Specification</cite>.
|
||||
*
|
||||
* The {@link java.lang.reflect.AnnotatedElement} interface discusses
|
||||
* compatibility concerns when evolving an annotation type from being
|
||||
|
@ -1489,7 +1489,7 @@ public class ModuleDescriptor
|
||||
* <p> The module names, package names, and class names that are parameters
|
||||
* specified to the builder methods are the module names, package names,
|
||||
* and qualified names of classes (in named packages) as defined in the
|
||||
* <cite>The Java™ Language Specification</cite>. </p>
|
||||
* <cite>The Java Language Specification</cite>. </p>
|
||||
*
|
||||
* <p> Example usage: </p>
|
||||
* <pre>{@code ModuleDescriptor descriptor = ModuleDescriptor.newModule("stats.core")
|
||||
|
@ -419,7 +419,7 @@ public abstract class Reference<T> {
|
||||
* facilities are not possible or do not provide the desired control. This
|
||||
* method is applicable only when reclamation may have visible effects,
|
||||
* which is possible for objects with finalizers (See Section 12.6
|
||||
* of <cite>The Java™ Language Specification</cite>) that
|
||||
* of <cite>The Java Language Specification</cite>) that
|
||||
* are implemented in ways that rely on ordering control for
|
||||
* correctness.
|
||||
*
|
||||
|
@ -440,7 +440,7 @@ public class AccessibleObject implements AnnotatedElement {
|
||||
* <p> This method returns {@code true} if the {@code accessible} flag
|
||||
* is set to {@code true}, i.e. the checks for Java language access control
|
||||
* are suppressed, or if the caller can access the member as
|
||||
* specified in <cite>The Java™ Language Specification</cite>,
|
||||
* specified in <cite>The Java Language Specification</cite>,
|
||||
* with the variation noted in the class description. </p>
|
||||
*
|
||||
* @param obj an instance object of the declaring class of this reflected
|
||||
|
@ -45,7 +45,7 @@ import sun.reflect.annotation.AnnotationType;
|
||||
* element are on a <em>declaration</em>, whereas annotations on a
|
||||
* type are on a specific <em>use</em> of a type name.
|
||||
*
|
||||
* As defined by <cite>The Java™ Language Specification</cite>
|
||||
* As defined by <cite>The Java Language Specification</cite>
|
||||
* section {@jls 9.7.4}, an annotation on an element is a
|
||||
* <em>declaration annotation</em> and an annotation on a type is a
|
||||
* <em>type annotation</em>.
|
||||
|
@ -437,7 +437,7 @@ public final class Constructor<T> extends Executable {
|
||||
* <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 section 15.9.3 of
|
||||
* <cite>The Java™ Language Specification</cite>.
|
||||
* <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
|
||||
|
@ -217,7 +217,7 @@ public abstract class Executable extends AccessibleObject
|
||||
* @throws GenericSignatureFormatError if the generic
|
||||
* signature of this generic declaration does not conform to
|
||||
* the format specified in
|
||||
* <cite>The Java™ Virtual Machine Specification</cite>
|
||||
* <cite>The Java Virtual Machine Specification</cite>
|
||||
*/
|
||||
public abstract TypeVariable<?>[] getTypeParameters();
|
||||
|
||||
@ -276,7 +276,7 @@ public abstract class Executable extends AccessibleObject
|
||||
* @throws GenericSignatureFormatError
|
||||
* if the generic method signature does not conform to the format
|
||||
* specified in
|
||||
* <cite>The Java™ Virtual Machine Specification</cite>
|
||||
* <cite>The Java Virtual Machine Specification</cite>
|
||||
* @throws TypeNotPresentException if any of the parameter
|
||||
* types of the underlying executable refers to a non-existent type
|
||||
* declaration
|
||||
@ -474,7 +474,7 @@ public abstract class Executable extends AccessibleObject
|
||||
* @throws GenericSignatureFormatError
|
||||
* if the generic method signature does not conform to the format
|
||||
* specified in
|
||||
* <cite>The Java™ Virtual Machine Specification</cite>
|
||||
* <cite>The Java Virtual Machine Specification</cite>
|
||||
* @throws TypeNotPresentException if the underlying executable's
|
||||
* {@code throws} clause refers to a non-existent type declaration
|
||||
* @throws MalformedParameterizedTypeException if
|
||||
@ -515,7 +515,7 @@ public abstract class Executable extends AccessibleObject
|
||||
*
|
||||
* @return true if and only if this executable is a synthetic
|
||||
* construct as defined by
|
||||
* <cite>The Java™ Language Specification</cite>.
|
||||
* <cite>The Java Language Specification</cite>.
|
||||
* @jls 13.1 The Form of a Binary
|
||||
*/
|
||||
public boolean isSynthetic() {
|
||||
|
@ -255,7 +255,7 @@ class Field extends AccessibleObject implements Member {
|
||||
* the field represented by this {@code Field} object
|
||||
* @throws GenericSignatureFormatError if the generic field
|
||||
* signature does not conform to the format specified in
|
||||
* <cite>The Java™ Virtual Machine Specification</cite>
|
||||
* <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
|
||||
|
@ -43,7 +43,7 @@ public interface GenericDeclaration extends AnnotatedElement {
|
||||
* @throws GenericSignatureFormatError if the generic
|
||||
* signature of this generic declaration does not conform to
|
||||
* the format specified in
|
||||
* <cite>The Java™ Virtual Machine Specification</cite>
|
||||
* <cite>The Java Virtual Machine Specification</cite>
|
||||
*/
|
||||
public TypeVariable<?>[] getTypeParameters();
|
||||
}
|
||||
|
@ -277,7 +277,7 @@ public final class Method extends Executable {
|
||||
* @throws GenericSignatureFormatError
|
||||
* if the generic method signature does not conform to the format
|
||||
* specified in
|
||||
* <cite>The Java™ Virtual Machine Specification</cite>
|
||||
* <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
|
||||
|
@ -33,7 +33,7 @@ import java.util.StringJoiner;
|
||||
* modifiers are represented as integers with distinct bit positions
|
||||
* representing different modifiers. The values for the constants
|
||||
* 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>.
|
||||
* <cite>The Java Virtual Machine Specification</cite>.
|
||||
*
|
||||
* @see Class#getModifiers()
|
||||
* @see Member#getModifiers()
|
||||
@ -201,7 +201,7 @@ public class Modifier {
|
||||
* </pre></blockquote>
|
||||
* The modifier names are returned in an order consistent with the
|
||||
* 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>.
|
||||
* <cite>The Java Language Specification</cite>.
|
||||
* The full modifier ordering used by this method is:
|
||||
* <blockquote> {@code
|
||||
* public protected private abstract static final transient
|
||||
@ -247,7 +247,7 @@ public class Modifier {
|
||||
|
||||
/*
|
||||
* Access modifier flag constants from tables 4.1, 4.4, 4.5, and 4.7 of
|
||||
* <cite>The Java™ Virtual Machine Specification</cite>
|
||||
* <cite>The Java Virtual Machine Specification</cite>
|
||||
*/
|
||||
|
||||
/**
|
||||
|
@ -112,7 +112,7 @@ public final class Parameter implements AnnotatedElement {
|
||||
/**
|
||||
* Returns a string describing this parameter. The format is the
|
||||
* modifiers for the parameter, if any, in canonical order as
|
||||
* recommended by <cite>The Java™ Language
|
||||
* recommended by <cite>The Java Language
|
||||
* Specification</cite>, followed by the fully-qualified type of
|
||||
* the parameter (excluding the last [] if the parameter is
|
||||
* variable arity), followed by "..." if the parameter is variable
|
||||
@ -247,7 +247,7 @@ public final class Parameter implements AnnotatedElement {
|
||||
* in source code; returns {@code false} otherwise.
|
||||
*
|
||||
* @return true if and only if this parameter is implicitly
|
||||
* declared as defined by <cite>The Java™ Language
|
||||
* declared as defined by <cite>The Java Language
|
||||
* Specification</cite>.
|
||||
*/
|
||||
public boolean isImplicit() {
|
||||
@ -262,7 +262,7 @@ public final class Parameter implements AnnotatedElement {
|
||||
* @jls 13.1 The Form of a Binary
|
||||
* @return true if and only if this parameter is a synthetic
|
||||
* construct as defined by
|
||||
* <cite>The Java™ Language Specification</cite>.
|
||||
* <cite>The Java Language Specification</cite>.
|
||||
*/
|
||||
public boolean isSynthetic() {
|
||||
return Modifier.isSynthetic(getModifiers());
|
||||
|
@ -120,7 +120,7 @@ public final class RecordComponent implements AnnotatedElement {
|
||||
* this record component
|
||||
* @throws GenericSignatureFormatError if the generic record component
|
||||
* signature does not conform to the format specified in
|
||||
* <cite>The Java™ Virtual Machine Specification</cite>
|
||||
* <cite>The Java Virtual Machine Specification</cite>
|
||||
* @throws TypeNotPresentException if the generic type
|
||||
* signature of the underlying record component refers to a non-existent
|
||||
* type declaration
|
||||
|
@ -48,7 +48,7 @@ import java.util.Objects;
|
||||
* Bootstrap methods for state-driven implementations of core methods,
|
||||
* including {@link Object#equals(Object)}, {@link Object#hashCode()}, and
|
||||
* {@link Object#toString()}. These methods may be used, for example, by
|
||||
* Java™ compiler implementations to implement the bodies of {@link Object}
|
||||
* Java compiler implementations to implement the bodies of {@link Object}
|
||||
* methods for record classes.
|
||||
*
|
||||
* @since 14
|
||||
|
@ -3455,7 +3455,7 @@ public class BigDecimal extends Number implements Comparable<BigDecimal> {
|
||||
* This conversion is analogous to the
|
||||
* <i>narrowing primitive conversion</i> from {@code double} to
|
||||
* {@code long} as defined in
|
||||
* <cite>The Java™ Language Specification</cite>:
|
||||
* <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
|
||||
@ -3493,7 +3493,7 @@ public class BigDecimal extends Number implements Comparable<BigDecimal> {
|
||||
* This conversion is analogous to the
|
||||
* <i>narrowing primitive conversion</i> from {@code double} to
|
||||
* {@code short} as defined in
|
||||
* <cite>The Java™ Language Specification</cite>:
|
||||
* <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
|
||||
@ -3591,7 +3591,7 @@ public class BigDecimal extends Number implements Comparable<BigDecimal> {
|
||||
* This conversion is analogous to the
|
||||
* <i>narrowing primitive conversion</i> from {@code double} to
|
||||
* {@code short} as defined in
|
||||
* <cite>The Java™ Language Specification</cite>:
|
||||
* <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
|
||||
@ -3675,7 +3675,7 @@ public class BigDecimal extends Number implements Comparable<BigDecimal> {
|
||||
* This conversion is similar to the
|
||||
* <i>narrowing primitive conversion</i> from {@code double} to
|
||||
* {@code float} as defined in
|
||||
* <cite>The Java™ Language Specification</cite>:
|
||||
* <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
|
||||
@ -3720,7 +3720,7 @@ public class BigDecimal extends Number implements Comparable<BigDecimal> {
|
||||
* This conversion is similar to the
|
||||
* <i>narrowing primitive conversion</i> from {@code double} to
|
||||
* {@code float} as defined in
|
||||
* <cite>The Java™ Language Specification</cite>:
|
||||
* <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
|
||||
|
@ -54,7 +54,7 @@ import jdk.internal.vm.annotation.ForceInline;
|
||||
* and a few other miscellaneous operations.
|
||||
*
|
||||
* <p>Semantics of arithmetic operations exactly mimic those of Java's integer
|
||||
* arithmetic operators, as defined in <i>The Java™ Language Specification</i>.
|
||||
* arithmetic operators, as defined in <i>The Java Language Specification</i>.
|
||||
* For example, division by zero throws an {@code ArithmeticException}, and
|
||||
* division of a negative by a positive yields a negative (or zero) remainder.
|
||||
*
|
||||
@ -4152,7 +4152,7 @@ public class BigInteger extends Number implements Comparable<BigInteger> {
|
||||
* conversion is analogous to a
|
||||
* <i>narrowing primitive conversion</i> from {@code long} to
|
||||
* {@code int} as defined in
|
||||
* <cite>The Java™ Language Specification</cite>:
|
||||
* <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
|
||||
@ -4174,7 +4174,7 @@ public class BigInteger extends Number implements Comparable<BigInteger> {
|
||||
* conversion is analogous to a
|
||||
* <i>narrowing primitive conversion</i> from {@code long} to
|
||||
* {@code int} as defined in
|
||||
* <cite>The Java™ Language Specification</cite>:
|
||||
* <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
|
||||
@ -4198,7 +4198,7 @@ public class BigInteger extends Number implements Comparable<BigInteger> {
|
||||
* conversion is similar to the
|
||||
* <i>narrowing primitive conversion</i> from {@code double} to
|
||||
* {@code float} as defined in
|
||||
* <cite>The Java™ Language Specification</cite>:
|
||||
* <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
|
||||
@ -4283,7 +4283,7 @@ public class BigInteger extends Number implements Comparable<BigInteger> {
|
||||
* conversion is similar to the
|
||||
* <i>narrowing primitive conversion</i> from {@code double} to
|
||||
* {@code float} as defined in
|
||||
* <cite>The Java™ Language Specification</cite>:
|
||||
* <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
|
||||
|
@ -128,7 +128,7 @@ public class SecureClassLoader extends ClassLoader {
|
||||
* @param b the bytes that make up the class data. The bytes in
|
||||
* positions {@code off} through {@code off+len-1}
|
||||
* should have the format of a valid class file as defined by
|
||||
* <cite>The Java™ Virtual Machine Specification</cite>.
|
||||
* <cite>The Java Virtual Machine Specification</cite>.
|
||||
* @param off the start offset in {@code b} of the class data
|
||||
* @param len the length of the class data
|
||||
* @param cs the associated CodeSource, or {@code null} if none
|
||||
@ -165,7 +165,7 @@ public class SecureClassLoader extends ClassLoader {
|
||||
* @param b the bytes that make up the class data. The bytes from positions
|
||||
* {@code b.position()} through {@code b.position() + b.limit() -1}
|
||||
* should have the format of a valid class file as defined by
|
||||
* <cite>The Java™ Virtual Machine Specification</cite>.
|
||||
* <cite>The Java Virtual Machine Specification</cite>.
|
||||
* @param cs the associated CodeSource, or {@code null} if none
|
||||
* @return the {@code Class} object created from the data,
|
||||
* and optional CodeSource.
|
||||
|
@ -1898,7 +1898,7 @@ import sun.util.locale.provider.ResourceBundleBasedAdapter;
|
||||
*
|
||||
* <p> The maximum number of arguments is limited by the maximum dimension of a
|
||||
* Java array as defined by
|
||||
* <cite>The Java™ Virtual Machine Specification</cite>.
|
||||
* <cite>The Java Virtual Machine Specification</cite>.
|
||||
* If the argument index does not correspond to an
|
||||
* available argument, then a {@link MissingFormatArgumentException} is thrown.
|
||||
*
|
||||
@ -2589,7 +2589,7 @@ public final class Formatter implements Closeable, Flushable {
|
||||
* 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
|
||||
* <cite>The Java™ Virtual Machine Specification</cite>.
|
||||
* <cite>The Java Virtual Machine Specification</cite>.
|
||||
*
|
||||
* @throws IllegalFormatException
|
||||
* If a format string contains an illegal syntax, a format
|
||||
@ -2628,7 +2628,7 @@ public final class Formatter implements Closeable, Flushable {
|
||||
* 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
|
||||
* <cite>The Java™ Virtual Machine Specification</cite>.
|
||||
* <cite>The Java Virtual Machine Specification</cite>.
|
||||
*
|
||||
* @throws IllegalFormatException
|
||||
* If a format string contains an illegal syntax, a format
|
||||
|
@ -95,7 +95,7 @@ import jdk.internal.util.xml.PropertiesDefaultHandler;
|
||||
* 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
|
||||
* Unicode escapes as defined in section 3.3 of
|
||||
* <cite>The Java™ Language Specification</cite>;
|
||||
* <cite>The Java Language Specification</cite>;
|
||||
* only a single 'u' character is allowed in an escape
|
||||
* sequence.
|
||||
*
|
||||
@ -337,7 +337,7 @@ public class Properties extends Hashtable<Object,Object> {
|
||||
* Characters in keys and elements can be represented in escape
|
||||
* sequences similar to those used for character and string literals
|
||||
* (see sections 3.3 and 3.10.6 of
|
||||
* <cite>The Java™ Language Specification</cite>).
|
||||
* <cite>The Java Language Specification</cite>).
|
||||
*
|
||||
* The differences from the character escape sequences and Unicode
|
||||
* escapes used for characters and strings are:
|
||||
@ -391,7 +391,7 @@ public class Properties extends Hashtable<Object,Object> {
|
||||
* character. Characters not in Latin1, and certain special characters,
|
||||
* are represented in keys and elements using Unicode escapes as defined in
|
||||
* section 3.3 of
|
||||
* <cite>The Java™ Language Specification</cite>.
|
||||
* <cite>The Java Language Specification</cite>.
|
||||
* <p>
|
||||
* The specified stream remains open after this method returns.
|
||||
*
|
||||
|
@ -120,7 +120,7 @@ import sun.util.ResourceBundleEnumeration;
|
||||
* and throws the exception if it encounters an invalid sequence.
|
||||
* If "ISO-8859-1" is specified, characters 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>
|
||||
* 3.3 of <cite>The Java Language Specification</cite>
|
||||
* whereas the other constructor which takes a {@code Reader} does not have that limitation.
|
||||
* Other encoding values are ignored for this system property.
|
||||
* The system property is read and evaluated when initializing this class.
|
||||
|
@ -123,7 +123,7 @@ import java.util.concurrent.TimeUnit;
|
||||
* memory synchronization semantics as provided by the built-in monitor
|
||||
* lock, as described in
|
||||
* Chapter 17 of
|
||||
* <cite>The Java™ Language Specification</cite>:
|
||||
* <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.
|
||||
|
@ -132,7 +132,7 @@ import jdk.internal.vm.annotation.ReservedStackAccess;
|
||||
* <p><b>Memory Synchronization.</b> Methods with the effect of
|
||||
* successfully locking in any mode have the same memory
|
||||
* synchronization effects as a <em>Lock</em> action, as described in
|
||||
* Chapter 17 of <cite>The Java™ Language Specification</cite>.
|
||||
* Chapter 17 of <cite>The Java Language Specification</cite>.
|
||||
* Methods successfully unlocking in write mode have the same memory
|
||||
* synchronization effects as an <em>Unlock</em> action. In optimistic
|
||||
* read usages, actions prior to the most recent write mode unlock action
|
||||
|
@ -227,7 +227,7 @@
|
||||
* <h2 id="MemoryVisibility">Memory Consistency Properties</h2>
|
||||
*
|
||||
* Chapter 17 of
|
||||
* <cite>The Java™ Language Specification</cite> defines the
|
||||
* <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
|
||||
|
@ -53,7 +53,7 @@ framework is based on more than a dozen collection interfaces. It
|
||||
includes implementations of these interfaces and algorithms to
|
||||
manipulate them.</p>
|
||||
<p>The documents in this section are non-normative portions of
|
||||
the Java™ Platform, Standard Edition API Specification.</p>
|
||||
the Java Platform, Standard Edition API Specification.</p>
|
||||
<ul>
|
||||
<li><b><a href="coll-overview.html">Overview</a></b> - An overview of
|
||||
the collections framework.</li>
|
||||
|
@ -395,7 +395,7 @@ import jdk.internal.util.ArraysSupport;
|
||||
*
|
||||
* <p> Backslashes within string literals in Java source code are interpreted
|
||||
* as required by
|
||||
* <cite>The Java™ Language Specification</cite>
|
||||
* <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
|
||||
@ -544,7 +544,7 @@ import jdk.internal.util.ArraysSupport;
|
||||
* <p>
|
||||
* <b>Unicode escape sequences</b> such as <code>\u2014</code> in Java source code
|
||||
* are processed as described in section 3.3 of
|
||||
* <cite>The Java™ Language Specification</cite>.
|
||||
* <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 <code>"\u2014"</code> and
|
||||
|
@ -32,7 +32,7 @@
|
||||
*
|
||||
* <ul>
|
||||
* <li><a href="{@docRoot}/../specs/security/standard-names.html">
|
||||
* <b>Java™ Security Standard Algorithm Names Specification
|
||||
* <b>Java Security Standard Algorithm Names Specification
|
||||
* </b></a></li>
|
||||
* </ul>
|
||||
*
|
||||
|
@ -29,7 +29,7 @@
|
||||
*
|
||||
* <ul>
|
||||
* <li><a href="{@docRoot}/../specs/security/standard-names.html">
|
||||
* <b>Java™ Security Standard Algorithm Names Specification
|
||||
* <b>Java Security Standard Algorithm Names Specification
|
||||
* </b></a></li>
|
||||
* </ul>
|
||||
*
|
||||
|
@ -56,7 +56,7 @@ import jdk.internal.access.SharedSecrets;
|
||||
* code that need to link to supporting classes.
|
||||
*
|
||||
* The parameters that are package names in this API are the fully-qualified
|
||||
* names of the packages as defined in section 6.5.3 of <cite>The Java™
|
||||
* names of the packages as defined in section 6.5.3 of <cite>The Java
|
||||
* Language Specification </cite>, for example, {@code "java.lang"}.
|
||||
*/
|
||||
|
||||
|
@ -286,7 +286,7 @@ public interface Processor {
|
||||
* </blockquote>
|
||||
*
|
||||
* where <i>TypeName</i> and <i>ModuleName</i> are as defined in
|
||||
* <cite>The Java™ Language Specification</cite>.
|
||||
* <cite>The Java Language Specification</cite>.
|
||||
*
|
||||
* @apiNote When running in an environment which supports modules,
|
||||
* processors are encouraged to include the module prefix when
|
||||
|
@ -39,7 +39,7 @@ import javax.lang.model.type.*;
|
||||
* are on a <em>declaration</em>, whereas annotations on a type are on
|
||||
* a specific <em>use</em> of a type name.
|
||||
*
|
||||
* As defined by <cite>The Java™ Language Specification</cite>
|
||||
* As defined by <cite>The Java Language Specification</cite>
|
||||
* section {@jls 9.7.4}, an annotation on an element is a
|
||||
* <em>declaration annotation</em> and an annotation on a type is a
|
||||
* <em>type annotation</em>.
|
||||
@ -74,7 +74,7 @@ import javax.lang.model.type.*;
|
||||
* down to affiliated mandated members. Type annotations modifying the
|
||||
* type of a record component can be also propagated to mandated
|
||||
* members. Propagation of the annotations to mandated members is
|
||||
* governed by rules given in the <cite>The Java™ Language
|
||||
* governed by rules given in the <cite>The Java Language
|
||||
* Specification</cite>.
|
||||
*
|
||||
* If there are multiple annotations of type <i>AT</i> present on
|
||||
|
@ -30,10 +30,10 @@ import java.util.Set;
|
||||
import java.util.HashSet;
|
||||
|
||||
/**
|
||||
* Source versions of the Java™ programming language.
|
||||
* Source versions of the Java programming language.
|
||||
*
|
||||
* See the appropriate edition of
|
||||
* <cite>The Java™ Language Specification</cite>
|
||||
* <cite>The Java Language Specification</cite>
|
||||
* for information about a particular source version.
|
||||
*
|
||||
* <p>Note that additional source version constants will be added to
|
||||
@ -69,7 +69,7 @@ public enum SourceVersion {
|
||||
* The original version.
|
||||
*
|
||||
* The language described in
|
||||
* <cite>The Java™ Language Specification, First Edition</cite>.
|
||||
* <cite>The Java Language Specification, First Edition</cite>.
|
||||
*/
|
||||
RELEASE_0,
|
||||
|
||||
@ -77,7 +77,7 @@ public enum SourceVersion {
|
||||
* The version recognized by the Java Platform 1.1.
|
||||
*
|
||||
* The language is {@code RELEASE_0} augmented with nested classes as described in the 1.1 update to
|
||||
* <cite>The Java™ Language Specification, First Edition</cite>.
|
||||
* <cite>The Java Language Specification, First Edition</cite>.
|
||||
*/
|
||||
RELEASE_1,
|
||||
|
||||
@ -86,7 +86,7 @@ public enum SourceVersion {
|
||||
* v 1.2.
|
||||
*
|
||||
* The language described in
|
||||
* <cite>The Java™ Language Specification,
|
||||
* <cite>The Java Language Specification,
|
||||
* Second Edition</cite>, which includes the {@code
|
||||
* strictfp} modifier.
|
||||
*/
|
||||
@ -113,7 +113,7 @@ public enum SourceVersion {
|
||||
* Edition 5.0.
|
||||
*
|
||||
* The language described in
|
||||
* <cite>The Java™ Language Specification,
|
||||
* <cite>The Java Language Specification,
|
||||
* Third Edition</cite>. First release to support
|
||||
* generics, annotations, autoboxing, var-args, enhanced {@code
|
||||
* for} loop, and hexadecimal floating-point literals.
|
||||
|
@ -51,7 +51,7 @@ import javax.lang.model.util.*;
|
||||
* @apiNote
|
||||
* <strong>WARNING:</strong> It is possible that methods will be added
|
||||
* to this interface to accommodate new, currently unknown, language
|
||||
* structures added to future versions of the Java™ programming
|
||||
* structures added to future versions of the Java programming
|
||||
* language.
|
||||
*
|
||||
* Such additions have already occurred in another visitor interface in
|
||||
|
@ -30,7 +30,7 @@ package javax.lang.model.element;
|
||||
*
|
||||
* <p>Note that it is possible additional element kinds will be added
|
||||
* to accommodate new, currently unknown, language structures added to
|
||||
* future versions of the Java™ programming language.
|
||||
* future versions of the Java programming language.
|
||||
*
|
||||
* @author Joseph D. Darcy
|
||||
* @author Scott Seligman
|
||||
|
@ -43,7 +43,7 @@ import javax.lang.model.util.*;
|
||||
* @apiNote
|
||||
* <strong>WARNING:</strong> It is possible that methods will be added
|
||||
* to this interface to accommodate new, currently unknown, language
|
||||
* structures added to future versions of the Java™ programming
|
||||
* structures added to future versions of the Java programming
|
||||
* language.
|
||||
*
|
||||
* Such additions have already occurred to support language features
|
||||
|
@ -107,7 +107,7 @@ public enum Modifier {
|
||||
|
||||
/**
|
||||
* Returns this modifier's name as defined in <cite>The
|
||||
* Java™ Language Specification</cite>.
|
||||
* Java Language Specification</cite>.
|
||||
* The modifier name is the {@linkplain #name() name of the enum
|
||||
* constant} in lowercase and with any underscores ("{@code _}")
|
||||
* replaced with hyphens ("{@code -}").
|
||||
|
@ -132,7 +132,7 @@ public interface ModuleElement extends Element, QualifiedNameable {
|
||||
*
|
||||
* <p>Note that it is possible additional directive kinds will be added
|
||||
* to accommodate new, currently unknown, language structures added to
|
||||
* future versions of the Java™ programming language.
|
||||
* future versions of the Java programming language.
|
||||
*
|
||||
* @since 9
|
||||
* @spec JPMS
|
||||
@ -211,7 +211,7 @@ public interface ModuleElement extends Element, QualifiedNameable {
|
||||
*
|
||||
* <p> <b>WARNING:</b> It is possible that methods will be added to
|
||||
* this interface to accommodate new, currently unknown, language
|
||||
* structures added to future versions of the Java™ programming
|
||||
* structures added to future versions of the Java programming
|
||||
* language. Methods to accommodate new language constructs will
|
||||
* be added in a source <em>compatible</em> way using
|
||||
* <em>default methods</em>.
|
||||
|
@ -31,7 +31,7 @@ package javax.lang.model.type;
|
||||
*
|
||||
* <p>Note that it is possible additional type kinds will be added to
|
||||
* accommodate new, currently unknown, language structures added to
|
||||
* future versions of the Java™ programming language.
|
||||
* future versions of the Java programming language.
|
||||
*
|
||||
* @author Joseph D. Darcy
|
||||
* @author Scott Seligman
|
||||
|
@ -39,7 +39,7 @@ import javax.lang.model.util.Types;
|
||||
* A type variable may also be declared implicitly, as by
|
||||
* the capture conversion of a wildcard type argument
|
||||
* (see chapter 5 of
|
||||
* <cite>The Java™ Language Specification</cite>).
|
||||
* <cite>The Java Language Specification</cite>).
|
||||
*
|
||||
* @author Joseph D. Darcy
|
||||
* @author Scott Seligman
|
||||
|
@ -44,7 +44,7 @@ import javax.lang.model.util.*;
|
||||
* @apiNote
|
||||
* <strong>WARNING:</strong> It is possible that methods will be added
|
||||
* to this interface to accommodate new, currently unknown, language
|
||||
* structures added to future versions of the Java™ programming
|
||||
* structures added to future versions of the Java programming
|
||||
* language.
|
||||
*
|
||||
* Such additions have already occurred to support language features
|
||||
|
@ -42,7 +42,7 @@ import javax.annotation.processing.SupportedSourceVersion;
|
||||
* AnnotationValueVisitor} interface implemented by this class may
|
||||
* have methods added to it in the future to accommodate new,
|
||||
* currently unknown, language structures added to future versions of
|
||||
* the Java™ programming language. Therefore, methods whose
|
||||
* the Java programming language. Therefore, methods whose
|
||||
* names begin with {@code "visit"} may be added to this class in the
|
||||
* future; to avoid incompatibilities, classes and subclasses which
|
||||
* extend this class should not declare any instance methods with
|
||||
|
@ -41,7 +41,7 @@ import static javax.lang.model.SourceVersion.*;
|
||||
* ElementVisitor} interface implemented by this class may have
|
||||
* methods added to it in the future to accommodate new, currently
|
||||
* unknown, language structures added to future versions of the
|
||||
* Java™ programming language. Therefore, methods whose names
|
||||
* Java programming language. Therefore, methods whose names
|
||||
* begin with {@code "visit"} may be added to this class in the
|
||||
* future; to avoid incompatibilities, classes and subclasses which
|
||||
* extend this class should not declare any instance methods with
|
||||
|
@ -39,7 +39,7 @@ import static javax.lang.model.SourceVersion.*;
|
||||
* <p id=note_for_subclasses><strong>WARNING:</strong> The {@code
|
||||
* TypeVisitor} interface implemented by this class may have methods
|
||||
* added to it in the future to accommodate new, currently unknown,
|
||||
* language structures added to future versions of the Java™
|
||||
* language structures added to future versions of the Java
|
||||
* programming language. Therefore, methods whose names begin with
|
||||
* {@code "visit"} may be added to this class in the future; to avoid
|
||||
* incompatibilities, classes and subclasses which extend this class
|
||||
|
@ -52,7 +52,7 @@ import javax.lang.model.SourceVersion;
|
||||
* methods added to it or the {@link ElementKind ElementKind enum}
|
||||
* used in this class may have constants added to it in the future to
|
||||
* accommodate new, currently unknown, language structures added to
|
||||
* future versions of the Java™ programming language.
|
||||
* future versions of the Java programming language.
|
||||
* Therefore, methods whose names begin with {@code "visit"} may be
|
||||
* added to this class in the future; to avoid incompatibilities,
|
||||
* classes and subclasses which extend this class should not declare
|
||||
|
@ -63,7 +63,7 @@ import static javax.lang.model.SourceVersion.*;
|
||||
* <p id=note_for_subclasses><strong>WARNING:</strong> The {@code ElementVisitor} interface
|
||||
* implemented by this class may have methods added to it in the
|
||||
* future to accommodate new, currently unknown, language structures
|
||||
* added to future versions of the Java™ programming language.
|
||||
* added to future versions of the Java programming language.
|
||||
* Therefore, methods whose names begin with {@code "visit"} may be
|
||||
* added to this class in the future; to avoid incompatibilities,
|
||||
* classes which extend this class should not declare any instance
|
||||
|
@ -49,7 +49,7 @@ import javax.annotation.processing.SupportedSourceVersion;
|
||||
* AnnotationValueVisitor} interface implemented by this class may
|
||||
* have methods added to it in the future to accommodate new,
|
||||
* currently unknown, language structures added to future versions of
|
||||
* the Java™ programming language. Therefore, methods whose
|
||||
* the Java programming language. Therefore, methods whose
|
||||
* names begin with {@code "visit"} may be added to this class in the
|
||||
* future; to avoid incompatibilities, classes and subclasses which
|
||||
* extend this class should not declare any instance methods with
|
||||
|
@ -52,7 +52,7 @@ import static javax.lang.model.SourceVersion.*;
|
||||
* ElementVisitor} interface implemented by this class may have
|
||||
* methods added to it in the future to accommodate new, currently
|
||||
* unknown, language structures added to future versions of the
|
||||
* Java™ programming language. Therefore, methods whose names
|
||||
* Java programming language. Therefore, methods whose names
|
||||
* begin with {@code "visit"} may be added to this class in the
|
||||
* future; to avoid incompatibilities, classes and subclasses which
|
||||
* extend this class should not declare any instance methods with
|
||||
|
@ -50,7 +50,7 @@ import static javax.lang.model.SourceVersion.*;
|
||||
* <p id=note_for_subclasses><strong>WARNING:</strong> The {@code
|
||||
* TypeVisitor} interface implemented by this class may have methods
|
||||
* added to it in the future to accommodate new, currently unknown,
|
||||
* language structures added to future versions of the Java™
|
||||
* language structures added to future versions of the Java
|
||||
* programming language. Therefore, methods whose names begin with
|
||||
* {@code "visit"} may be added to this class in the future; to avoid
|
||||
* incompatibilities, classes and subclasses which extend this class
|
||||
|
@ -50,7 +50,7 @@ import static javax.lang.model.SourceVersion.*;
|
||||
* added to it or the {@link TypeKind TypeKind enum} used in this
|
||||
* class may have constants added to it in the future to accommodate
|
||||
* new, currently unknown, language structures added to future
|
||||
* versions of the Java™ programming language. Therefore,
|
||||
* versions of the Java programming language. Therefore,
|
||||
* methods whose names begin with {@code "visit"} may be added to this
|
||||
* class in the future; to avoid incompatibilities, classes and
|
||||
* subclasses which extend this class should not declare any instance
|
||||
|
@ -71,7 +71,7 @@ public interface Diagnostic<S> {
|
||||
WARNING,
|
||||
/**
|
||||
* Problem similar to a warning, but is mandated by the tool's
|
||||
* specification. For example, the Java™ Language
|
||||
* specification. For example, the Java Language
|
||||
* Specification mandates warnings on certain
|
||||
* unchecked operations and the use of deprecated methods.
|
||||
*/
|
||||
|
@ -31,7 +31,7 @@ import java.util.Locale;
|
||||
import java.util.concurrent.Callable;
|
||||
|
||||
/**
|
||||
* Interface to invoke Java™ programming language documentation tools from
|
||||
* Interface to invoke Java programming language documentation tools from
|
||||
* programs.
|
||||
*
|
||||
* @since 1.8
|
||||
|
@ -32,7 +32,7 @@ import java.util.concurrent.Callable;
|
||||
import javax.annotation.processing.Processor;
|
||||
|
||||
/**
|
||||
* Interface to invoke Java™ programming language compilers from
|
||||
* Interface to invoke Java programming language compilers from
|
||||
* programs.
|
||||
*
|
||||
* <p>The compiler might generate diagnostics during compilation (for
|
||||
@ -56,9 +56,9 @@ import javax.annotation.processing.Processor;
|
||||
* #getStandardFileManager getStandardFileManager}.
|
||||
*
|
||||
* <p>An instance implementing this interface must conform to
|
||||
* <cite>The Java™ Language Specification</cite>
|
||||
* <cite>The Java Language Specification</cite>
|
||||
* and generate class files conforming to
|
||||
* <cite>The Java™ Virtual Machine Specification</cite>.
|
||||
* <cite>The Java Virtual Machine Specification</cite>.
|
||||
* The versions of these
|
||||
* specifications are defined in the {@linkplain Tool} interface.
|
||||
*
|
||||
|
@ -35,7 +35,7 @@ import java.util.Set;
|
||||
import static javax.tools.JavaFileObject.Kind;
|
||||
|
||||
/**
|
||||
* File manager for tools operating on Java™ programming language
|
||||
* File manager for tools operating on Java programming language
|
||||
* source and class files. In this context, <em>file</em> means an
|
||||
* abstraction of regular files and other sources of data.
|
||||
*
|
||||
@ -52,14 +52,14 @@ import static javax.tools.JavaFileObject.Kind;
|
||||
* fully qualified class and interface names. For convenience '.'
|
||||
* and '/' are interchangeable. The internal form is defined in
|
||||
* chapter four of
|
||||
* <cite>The Java™ Virtual Machine Specification</cite>.
|
||||
* <cite>The Java Virtual Machine Specification</cite>.
|
||||
|
||||
* <blockquote><p>
|
||||
* <i>Discussion:</i> this means that the names
|
||||
* "java/lang.package-info", "java/lang/package-info",
|
||||
* "java.lang.package-info", are valid and equivalent. Compare to
|
||||
* binary name as defined in
|
||||
* <cite>The Java™ Language Specification</cite>,
|
||||
* <cite>The Java Language Specification</cite>,
|
||||
* section 13.1 "The Form of a Binary".
|
||||
* </p></blockquote>
|
||||
*
|
||||
@ -222,7 +222,7 @@ public interface JavaFileManager extends Closeable, Flushable, OptionChecker {
|
||||
/**
|
||||
* Infers a binary name of a file object based on a package-oriented location.
|
||||
* The binary name returned might not be a valid binary name according to
|
||||
* <cite>The Java™ Language Specification</cite>.
|
||||
* <cite>The Java Language Specification</cite>.
|
||||
*
|
||||
* @param location a location
|
||||
* @param file a file object
|
||||
|
@ -30,7 +30,7 @@ import javax.lang.model.element.Modifier;
|
||||
import java.util.Objects;
|
||||
|
||||
/**
|
||||
* File abstraction for tools operating on Java™ programming language
|
||||
* File abstraction for tools operating on Java programming language
|
||||
* source and class files.
|
||||
*
|
||||
* <p>All methods in this interface might throw a SecurityException if
|
||||
@ -94,7 +94,7 @@ public interface JavaFileObject extends FileObject {
|
||||
* Checks if this file object is compatible with the specified
|
||||
* simple name and kind. A simple name is a single identifier
|
||||
* (not qualified) as defined in
|
||||
* <cite>The Java™ Language Specification</cite>,
|
||||
* <cite>The Java Language Specification</cite>,
|
||||
* section 6.2 "Names and Identifiers".
|
||||
*
|
||||
* @param simpleName a simple name of a class
|
||||
|
@ -76,7 +76,7 @@ public interface Tool {
|
||||
int run(InputStream in, OutputStream out, OutputStream err, String... arguments);
|
||||
|
||||
/**
|
||||
* Returns the source versions of the Java™ programming language
|
||||
* Returns the source versions of the Java programming language
|
||||
* supported by this tool.
|
||||
* @return a set of supported source versions
|
||||
*/
|
||||
|
@ -51,7 +51,7 @@ public class ToolProvider {
|
||||
public ToolProvider() {}
|
||||
|
||||
/**
|
||||
* Returns the Java™ programming language compiler provided
|
||||
* Returns the Java programming language compiler provided
|
||||
* with this platform.
|
||||
* <p>The file manager returned by calling
|
||||
* {@link JavaCompiler#getStandardFileManager getStandardFileManager}
|
||||
@ -72,7 +72,7 @@ public class ToolProvider {
|
||||
private static final String systemDocumentationToolName = "jdk.javadoc.internal.api.JavadocTool";
|
||||
|
||||
/**
|
||||
* Returns the Java™ programming language documentation tool provided
|
||||
* Returns the Java programming language documentation tool provided
|
||||
* with this platform.
|
||||
* <p>The file manager returned by calling
|
||||
* {@link DocumentationTool#getStandardFileManager getStandardFileManager}
|
||||
|
@ -28,7 +28,7 @@
|
||||
* for example, compilers.
|
||||
*
|
||||
* <p>These interfaces and classes are required as part of the
|
||||
* Java™ Platform, Standard Edition (Java SE),
|
||||
* Java Platform, Standard Edition (Java SE),
|
||||
* but there is no requirement to provide any tools implementing them.
|
||||
*
|
||||
* <p>Unless explicitly allowed, all methods in this package might
|
||||
|
@ -224,7 +224,7 @@ public final class TypeResolver {
|
||||
* Converts the given {@code type} to the corresponding class.
|
||||
* This method implements the concept of type erasure,
|
||||
* that is described in section 4.6 of
|
||||
* <cite>The Java™ Language Specification</cite>.
|
||||
* <cite>The Java Language Specification</cite>.
|
||||
*
|
||||
* @param type the array of types to convert
|
||||
* @return a corresponding class
|
||||
|
@ -160,7 +160,7 @@ public abstract class GraphicsDevice {
|
||||
* {@code GraphicsEnvironment}. Although there is
|
||||
* no public method to set this {@code String}, a programmer can
|
||||
* use the {@code String} for debugging purposes. Vendors of
|
||||
* the Java™ Runtime Environment can
|
||||
* the Java Runtime Environment can
|
||||
* format the return value of the {@code String}. To determine
|
||||
* how to interpret the value of the {@code String}, contact the
|
||||
* vendor of your Java Runtime. To find out who the vendor is, from
|
||||
|
@ -47,7 +47,7 @@ newly added listener is only notified on subsequent key events.
|
||||
<h2>Auto-shutdown</h2>
|
||||
|
||||
According to
|
||||
<cite>The Java™ Virtual Machine Specification</cite>,
|
||||
<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.
|
||||
@ -190,7 +190,7 @@ non-daemon thread that blocks forever.
|
||||
<...>
|
||||
</pre>
|
||||
|
||||
<cite>The Java™ Virtual Machine Specification</cite>
|
||||
<cite>The Java Virtual Machine Specification</cite>
|
||||
guarantees
|
||||
that the JVM doesn't exit until this thread terminates.
|
||||
</div>
|
||||
|
@ -36,7 +36,7 @@ import sun.reflect.misc.*;
|
||||
* is the delegate used by default for classes about
|
||||
* which no information is available. The {@code DefaultPersistenceDelegate}
|
||||
* provides, version resilient, public API-based persistence for
|
||||
* classes that follow the JavaBeans™ conventions without any class specific
|
||||
* classes that follow the JavaBeans conventions without any class specific
|
||||
* configuration.
|
||||
* <p>
|
||||
* The key assumptions are that the class has a nullary constructor
|
||||
|
@ -31,7 +31,7 @@ package java.beans;
|
||||
* of java.beans.beancontext.BeanContext, in order to propagate to its nested hierarchy
|
||||
* of java.beans.beancontext.BeanContextChild instances, the current "designTime" property.
|
||||
* <p>
|
||||
* The JavaBeans™ specification defines the notion of design time as is a
|
||||
* The JavaBeans specification defines the notion of design time as is a
|
||||
* mode in which JavaBeans instances should function during their composition
|
||||
* and customization in a interactive design, composition or construction tool,
|
||||
* as opposed to runtime when the JavaBean is part of an applet, application,
|
||||
|
@ -26,7 +26,7 @@ package java.beans;
|
||||
|
||||
/**
|
||||
* An "IndexedPropertyChange" event gets delivered whenever a component that
|
||||
* conforms to the JavaBeans™ specification (a "bean") changes a bound
|
||||
* conforms to the JavaBeans specification (a "bean") changes a bound
|
||||
* indexed property. This class is an extension of {@code PropertyChangeEvent}
|
||||
* but contains the index of the property that has changed.
|
||||
* <P>
|
||||
|
@ -87,7 +87,7 @@ import sun.reflect.misc.ReflectUtil;
|
||||
* <p>
|
||||
* For more information about introspection and design patterns, please
|
||||
* consult the
|
||||
* <a href="http://www.oracle.com/technetwork/java/javase/documentation/spec-136004.html">JavaBeans™ specification</a>.
|
||||
* <a href="http://www.oracle.com/technetwork/java/javase/documentation/spec-136004.html">JavaBeans specification</a>.
|
||||
*
|
||||
* @since 1.1
|
||||
*/
|
||||
@ -1122,7 +1122,7 @@ public class Introspector {
|
||||
try {
|
||||
type = ClassFinder.findClass(name, type.getClassLoader());
|
||||
// Each customizer should inherit java.awt.Component and implement java.beans.Customizer
|
||||
// according to the section 9.3 of JavaBeans™ specification
|
||||
// according to the section 9.3 of JavaBeans specification
|
||||
if (Component.class.isAssignableFrom(type) && Customizer.class.isAssignableFrom(type)) {
|
||||
return type;
|
||||
}
|
||||
|
@ -41,7 +41,7 @@ import java.util.Map.Entry;
|
||||
* or for a property specified by name.
|
||||
* <p>
|
||||
* Here is an example of {@code PropertyChangeSupport} usage that follows
|
||||
* the rules and recommendations laid out in the JavaBeans™ specification:
|
||||
* the rules and recommendations laid out in the JavaBeans specification:
|
||||
* <pre>
|
||||
* public class MyBean {
|
||||
* private final PropertyChangeSupport pcs = new PropertyChangeSupport(this);
|
||||
|
@ -41,7 +41,7 @@ import java.util.Map.Entry;
|
||||
* or for a property specified by name.
|
||||
* <p>
|
||||
* Here is an example of {@code VetoableChangeSupport} usage that follows
|
||||
* the rules and recommendations laid out in the JavaBeans™ specification:
|
||||
* the rules and recommendations laid out in the JavaBeans specification:
|
||||
* <pre>{@code
|
||||
* public class MyBean {
|
||||
* private final VetoableChangeSupport vcs = new VetoableChangeSupport(this);
|
||||
|
@ -25,7 +25,7 @@
|
||||
|
||||
/**
|
||||
* Contains classes related to developing <em>beans</em> -- components based on
|
||||
* the JavaBeans™ architecture. A few of the classes are used by beans
|
||||
* the JavaBeans architecture. A few of the classes are used by beans
|
||||
* while they run in an application. For example, the event classes are used by
|
||||
* beans that fire property and vetoable change events (see
|
||||
* {@link java.beans.PropertyChangeEvent}). However, most of the classes in this
|
||||
|
@ -57,7 +57,7 @@
|
||||
* accessible name, description, <a href="#AccessibleRole">role</a>, and
|
||||
* <a href="#AccessibleState">state</a> of the object, as well as information
|
||||
* about the parent and children of the object. In addition,
|
||||
* JavaBeans™ property change support is also included to allow assistive
|
||||
* JavaBeans property change support is also included to allow assistive
|
||||
* technologies learn when the values of the accessible properties change.
|
||||
* AccessibleContext also contains methods for obtaining more specific
|
||||
* accessibility information about a component. If the component supports it,
|
||||
|
@ -24,7 +24,7 @@
|
||||
*/
|
||||
|
||||
/**
|
||||
* Provides classes and interfaces that describe the types of Java™ Print
|
||||
* Provides classes and interfaces that describe the types of Java Print
|
||||
* Service attributes and how they can be collected into attribute sets.
|
||||
*
|
||||
* <h2>What is an Attribute?</h2>
|
||||
|
@ -24,7 +24,7 @@
|
||||
*/
|
||||
|
||||
/**
|
||||
* Provides the principal classes and interfaces for the Java™ Print
|
||||
* Provides the principal classes and interfaces for the Java Print
|
||||
* Service API. The Java Print Service API enables client and server
|
||||
* applications to:
|
||||
* <ul>
|
||||
|
@ -48,7 +48,7 @@ package javax.sound.midi;
|
||||
* Setting them is a subclass responsibility.
|
||||
* <p>
|
||||
* <a id="integersVsBytes"></a>The MIDI standard expresses MIDI data in bytes.
|
||||
* However, because Java™ uses signed bytes, the Java Sound API uses
|
||||
* However, because Java uses signed bytes, the Java Sound API uses
|
||||
* integers instead of bytes when expressing MIDI data. For example, the
|
||||
* {@link #getStatus()} method of {@code MidiMessage} returns MIDI status bytes
|
||||
* as integers. If you are processing MIDI data that originated outside Java
|
||||
|
@ -49,7 +49,7 @@ import sun.security.action.GetPropertyAction;
|
||||
* future Swing releases. The current serialization support is
|
||||
* appropriate for short term storage or RMI between applications running
|
||||
* the same version of Swing. As of 1.4, support for long term storage
|
||||
* of all JavaBeans™
|
||||
* of all JavaBeans
|
||||
* has been added to the <code>java.beans</code> package.
|
||||
* Please see {@link java.beans.XMLEncoder}.
|
||||
*
|
||||
|
@ -62,7 +62,7 @@ import javax.swing.text.*;
|
||||
* future Swing releases. The current serialization support is
|
||||
* appropriate for short term storage or RMI between applications running
|
||||
* the same version of Swing. As of 1.4, support for long term storage
|
||||
* of all JavaBeans™
|
||||
* of all JavaBeans
|
||||
* has been added to the <code>java.beans</code> package.
|
||||
* Please see {@link java.beans.XMLEncoder}.
|
||||
*
|
||||
@ -1918,7 +1918,7 @@ public abstract class AbstractButton extends JComponent implements ItemSelectabl
|
||||
* future Swing releases. The current serialization support is
|
||||
* appropriate for short term storage or RMI between applications running
|
||||
* the same version of Swing. As of 1.4, support for long term storage
|
||||
* of all JavaBeans™
|
||||
* of all JavaBeans
|
||||
* has been added to the <code>java.beans</code> package.
|
||||
* Please see {@link java.beans.XMLEncoder}.
|
||||
*/
|
||||
@ -2341,7 +2341,7 @@ public abstract class AbstractButton extends JComponent implements ItemSelectabl
|
||||
* future Swing releases. The current serialization support is
|
||||
* appropriate for short term storage or RMI between applications running
|
||||
* the same version of Swing. As of 1.4, support for long term storage
|
||||
* of all JavaBeans™
|
||||
* of all JavaBeans
|
||||
* has been added to the <code>java.beans</code> package.
|
||||
* Please see {@link java.beans.XMLEncoder}.
|
||||
* @since 1.4
|
||||
|
@ -43,7 +43,7 @@ import java.io.Serializable;
|
||||
* future Swing releases. The current serialization support is
|
||||
* appropriate for short term storage or RMI between applications running
|
||||
* the same version of Swing. As of 1.4, support for long term storage
|
||||
* of all JavaBeans™
|
||||
* of all JavaBeans
|
||||
* has been added to the <code>java.beans</code> package.
|
||||
* Please see {@link java.beans.XMLEncoder}.
|
||||
*
|
||||
|
@ -38,7 +38,7 @@ import java.util.EventListener;
|
||||
* future Swing releases. The current serialization support is
|
||||
* appropriate for short term storage or RMI between applications running
|
||||
* the same version of Swing. As of 1.4, support for long term storage
|
||||
* of all JavaBeans™
|
||||
* of all JavaBeans
|
||||
* has been added to the <code>java.beans</code> package.
|
||||
* Please see {@link java.beans.XMLEncoder}.
|
||||
*
|
||||
|
@ -65,7 +65,7 @@ import javax.accessibility.*;
|
||||
* future Swing releases. The current serialization support is
|
||||
* appropriate for short term storage or RMI between applications running
|
||||
* the same version of Swing. As of 1.4, support for long term storage
|
||||
* of all JavaBeans™
|
||||
* of all JavaBeans
|
||||
* has been added to the <code>java.beans</code> package.
|
||||
* Please see {@link java.beans.XMLEncoder}.
|
||||
*
|
||||
@ -297,7 +297,7 @@ public class Box extends JComponent implements Accessible {
|
||||
* future Swing releases. The current serialization support is
|
||||
* appropriate for short term storage or RMI between applications running
|
||||
* the same version of Swing. As of 1.4, support for long term storage
|
||||
* of all JavaBeans™
|
||||
* of all JavaBeans
|
||||
* has been added to the <code>java.beans</code> package.
|
||||
* Please see {@link java.beans.XMLEncoder}.
|
||||
*/
|
||||
|
@ -121,7 +121,7 @@ import java.io.PrintStream;
|
||||
* future Swing releases. The current serialization support is
|
||||
* appropriate for short term storage or RMI between applications running
|
||||
* the same version of Swing. As of 1.4, support for long term storage
|
||||
* of all JavaBeans™
|
||||
* of all JavaBeans
|
||||
* has been added to the {@code java.beans} package.
|
||||
* Please see {@link java.beans.XMLEncoder}.
|
||||
*
|
||||
|
@ -59,7 +59,7 @@ import java.io.Serializable;
|
||||
* future Swing releases. The current serialization support is
|
||||
* appropriate for short term storage or RMI between applications running
|
||||
* the same version of Swing. As of 1.4, support for long term storage
|
||||
* of all JavaBeans™
|
||||
* of all JavaBeans
|
||||
* has been added to the <code>java.beans</code> package.
|
||||
* Please see {@link java.beans.XMLEncoder}.
|
||||
*
|
||||
|
@ -57,7 +57,7 @@ import javax.accessibility.*;
|
||||
* future Swing releases. The current serialization support is
|
||||
* appropriate for short term storage or RMI between applications running
|
||||
* the same version of Swing. As of 1.4, support for long term storage
|
||||
* of all JavaBeans™
|
||||
* of all JavaBeans
|
||||
* has been added to the <code>java.beans</code> package.
|
||||
* Please see {@link java.beans.XMLEncoder}.
|
||||
*
|
||||
|
@ -37,7 +37,7 @@ import java.util.EventListener;
|
||||
* future Swing releases. The current serialization support is
|
||||
* appropriate for short term storage or RMI between applications running
|
||||
* the same version of Swing. As of 1.4, support for long term storage
|
||||
* of all JavaBeans™
|
||||
* of all JavaBeans
|
||||
* has been added to the <code>java.beans</code> package.
|
||||
* Please see {@link java.beans.XMLEncoder}.
|
||||
*
|
||||
|
@ -39,7 +39,7 @@ import javax.swing.event.*;
|
||||
* future Swing releases. The current serialization support is
|
||||
* appropriate for short term storage or RMI between applications running
|
||||
* the same version of Swing. As of 1.4, support for long term storage
|
||||
* of all JavaBeans™
|
||||
* of all JavaBeans
|
||||
* has been added to the <code>java.beans</code> package.
|
||||
* Please see {@link java.beans.XMLEncoder}.
|
||||
*
|
||||
|
Some files were not shown because too many files have changed in this diff Show More
Loading…
x
Reference in New Issue
Block a user