archive/jdk
1
0
Fork 0
mirror of https://github.com/openjdk/jdk.git synced 2025-08-28 07:14:30 +02:00
Code Issues Projects Releases Packages Wiki Activity Actions

Merge

Browse source
This commit is contained in:
Mikael Vidstedt 2020-07-15 21:24:39 -07:00
commit 1f5e21a16e
1091 changed files with 1920 additions and 2277 deletions
Download patch file Download diff file Expand all files Collapse all files

8
src/java.base/share/classes/java/io/Console.java
View file

@ -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&trade; 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&trade; 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&trade; 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&trade; Virtual Machine Specification</cite>.
* <cite>The Java Virtual Machine Specification</cite>.
*
* @throws IllegalFormatException
* If a format string contains an illegal syntax, a format

8
src/java.base/share/classes/java/io/PrintStream.java
View file

@ -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&trade; 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&trade; 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&trade; 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&trade; 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>.

8
src/java.base/share/classes/java/io/PrintWriter.java
View file

@ -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&trade; 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&trade; 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&trade; 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&trade; 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>.

16
src/java.base/share/classes/java/lang/AssertionError.java
View file

@ -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&trade; 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&trade; 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&trade; 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&trade; 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&trade; 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&trade; 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&trade; 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&trade; Language Specification</cite>.
* <cite>The Java Language Specification</cite>.
*
* @param detailMessage value to be used in constructing detail message
*/

2
src/java.base/share/classes/java/lang/Byte.java
View file

@ -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&trade; 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

18
src/java.base/share/classes/java/lang/Class.java
View file

@ -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&trade; 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&trade; 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&trade; 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&trade; 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&trade; 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&trade; 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&trade; 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&trade; 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&trade; 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

16
src/java.base/share/classes/java/lang/ClassLoader.java
View file

@ -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&trade; 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&trade; 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&trade; 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&trade; 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&trade; 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&trade; 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&trade; 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&trade; Language Specification</cite>.)
* <cite>The Java Language Specification</cite>.)
*
* @param enabled
* {@code true} if classes loaded by this classloader and

2
src/java.base/share/classes/java/lang/Double.java
View file

@ -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&trade; 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}

2
src/java.base/share/classes/java/lang/Enum.java
View file

@ -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&trade; Language
* found in section {@jls 8.9} of <cite>The Java Language
* Specification</cite>.
*
* Enumeration types are all serializable and receive special handling

2
src/java.base/share/classes/java/lang/Float.java
View file

@ -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&trade; 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}

2
src/java.base/share/classes/java/lang/Integer.java
View file

@ -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&trade; 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

2
src/java.base/share/classes/java/lang/Long.java
View file

@ -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&trade; 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

4
src/java.base/share/classes/java/lang/Module.java
View file

@ -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&trade; 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&trade;
* @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

31
src/java.base/share/classes/java/lang/NullPointerException.java
View file

@ -70,6 +70,27 @@ public class NullPointerException extends RuntimeException {
super(s);
}
// 0: no backtrace filled in, no message computed.
// 1: backtrace filled in, no message computed.
// 2: message computed
private transient int extendedMessageState;
private transient String extendedMessage;
/**
* {@inheritDoc}
*/
public synchronized Throwable fillInStackTrace() {
// If the stack trace is changed the extended NPE algorithm
// will compute a wrong message. So compute it beforehand.
if (extendedMessageState == 0) {
extendedMessageState = 1;
} else if (extendedMessageState == 1) {
extendedMessage = getExtendedNPEMessage();
extendedMessageState = 2;
}
return super.fillInStackTrace();
}
/**
* Returns the detail message string of this throwable.
*
@ -89,7 +110,15 @@ public class NullPointerException extends RuntimeException {
public String getMessage() {
String message = super.getMessage();
if (message == null) {
return getExtendedNPEMessage();
synchronized(this) {
if (extendedMessageState == 1) {
// Only the original stack trace was filled in. Message will
// compute correctly.
extendedMessage = getExtendedNPEMessage();
extendedMessageState = 2;
}
return extendedMessage;
}
}
return message;
}

2
src/java.base/share/classes/java/lang/Number.java
View file

@ -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&trade; 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

2
src/java.base/share/classes/java/lang/Object.java
View file

@ -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&trade; 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

2
src/java.base/share/classes/java/lang/Package.java
View file

@ -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&trade; Language Specification</cite>,
* <cite>The Java Language Specification</cite>,
* for example, {@code java.lang}
*/
public String getName() {

4
src/java.base/share/classes/java/lang/Record.java
View file

@ -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&trade; 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&trade;
* 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>.

2
src/java.base/share/classes/java/lang/Short.java
View file

@ -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&trade; 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

10
src/java.base/share/classes/java/lang/String.java
View file

@ -90,7 +90,7 @@ import static java.util.function.Predicate.not;
* The Java language provides special support for the string
* concatenation operator (&nbsp;+&nbsp;), and for conversion of
* other objects to strings. For additional information on string
* concatenation and conversion, see <i>The Java&trade; 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&trade; 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&trade; 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&trade; 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&trade; 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.

2
src/java.base/share/classes/java/lang/annotation/Annotation.java
View file

@ -32,7 +32,7 @@ package java.lang.annotation;
* define an annotation type.
*
* More information about annotation types can be found in section {@jls 9.6} of
* <cite>The Java&trade; 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

2
src/java.base/share/classes/java/lang/module/ModuleDescriptor.java
View file

@ -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&trade; Language Specification</cite>. </p>
* <cite>The Java Language Specification</cite>. </p>
*
* <p> Example usage: </p>
* <pre>{@code ModuleDescriptor descriptor = ModuleDescriptor.newModule("stats.core")

2
src/java.base/share/classes/java/lang/ref/Reference.java
View file

@ -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&trade; Language Specification</cite>) that
* of <cite>The Java Language Specification</cite>) that
* are implemented in ways that rely on ordering control for
* correctness.
*

2
src/java.base/share/classes/java/lang/reflect/AccessibleObject.java
View file

@ -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&trade; 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

2
src/java.base/share/classes/java/lang/reflect/AnnotatedElement.java
View file

@ -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&trade; 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>.

2
src/java.base/share/classes/java/lang/reflect/Constructor.java
View file

@ -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&trade; 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

8
src/java.base/share/classes/java/lang/reflect/Executable.java
View file

@ -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&trade; 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&trade; 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&trade; 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&trade; Language Specification</cite>.
* <cite>The Java Language Specification</cite>.
* @jls 13.1 The Form of a Binary
*/
public boolean isSynthetic() {

2
src/java.base/share/classes/java/lang/reflect/Field.java
View file

@ -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&trade; 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

2
src/java.base/share/classes/java/lang/reflect/GenericDeclaration.java
View file

@ -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&trade; Virtual Machine Specification</cite>
* <cite>The Java Virtual Machine Specification</cite>
*/
public TypeVariable<?>[] getTypeParameters();
}

2
src/java.base/share/classes/java/lang/reflect/Method.java
View file

@ -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&trade; 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

6
src/java.base/share/classes/java/lang/reflect/Modifier.java
View file

@ -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&trade; 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&trade; 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&trade; Virtual Machine Specification</cite>
* <cite>The Java Virtual Machine Specification</cite>
*/
/**

6
src/java.base/share/classes/java/lang/reflect/Parameter.java
View file

@ -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&trade; 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&trade; 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&trade; Language Specification</cite>.
* <cite>The Java Language Specification</cite>.
*/
public boolean isSynthetic() {
return Modifier.isSynthetic(getModifiers());

2
src/java.base/share/classes/java/lang/reflect/RecordComponent.java
View file

@ -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&trade; 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

2
src/java.base/share/classes/java/lang/runtime/ObjectMethods.java
View file

@ -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&trade; 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

10
src/java.base/share/classes/java/math/BigDecimal.java
View file

@ -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&trade; 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&trade; 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&trade; 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&trade; 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&trade; 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

10
src/java.base/share/classes/java/math/BigInteger.java
View file

@ -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&trade; 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&trade; 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&trade; 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&trade; 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&trade; 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

4
src/java.base/share/classes/java/security/SecureClassLoader.java
View file

@ -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&trade; 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&trade; 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.

6
src/java.base/share/classes/java/util/Formatter.java
View file

@ -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&trade; 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&trade; 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&trade; Virtual Machine Specification</cite>.
* <cite>The Java Virtual Machine Specification</cite>.
*
* @throws IllegalFormatException
* If a format string contains an illegal syntax, a format

6
src/java.base/share/classes/java/util/Properties.java
View file

@ -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&trade; 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&trade; 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&trade; Language Specification</cite>.
* <cite>The Java Language Specification</cite>.
* <p>
* The specified stream remains open after this method returns.
*

2
src/java.base/share/classes/java/util/PropertyResourceBundle.java
View file

@ -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&trade; 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.

2
src/java.base/share/classes/java/util/concurrent/locks/Lock.java
View file

@ -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&trade; 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.

2
src/java.base/share/classes/java/util/concurrent/locks/StampedLock.java
View file

@ -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&trade; 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

2
src/java.base/share/classes/java/util/concurrent/package-info.java
View file

@ -227,7 +227,7 @@
* <h2 id="MemoryVisibility">Memory Consistency Properties</h2>
*
* Chapter 17 of
* <cite>The Java&trade; 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

2
src/java.base/share/classes/java/util/doc-files/coll-index.html
View file

@ -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&trade; 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>

4
src/java.base/share/classes/java/util/regex/Pattern.java
View file

@ -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&trade; 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>&#92;u2014</code> in Java source code
* are processed as described in section 3.3 of
* <cite>The Java&trade; 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>"&#92;u2014"</code> and