The set of characters from U+0000 to U+FFFF is
+ * The set of characters from U+0000 to U+FFFF is
* sometimes referred to as the Basic Multilingual Plane (BMP).
* Characters whose code points are greater
* than U+FFFF are called supplementary characters. The Java
@@ -4599,6 +4599,7 @@ class Character implements java.io.Serializable, Comparable {
*
* @since 1.8
*
+ * @param value The {@code char} for which to return a hash code.
* @return a hash code value for a {@code char} value.
*/
public static int hashCode(char value) {
@@ -6637,7 +6638,7 @@ class Character implements java.io.Serializable, Comparable {
* Determines if the specified character is ISO-LATIN-1 white space.
* This method returns {@code true} for the following five
* characters only:
- *
+ *
* {@code '\t'} | {@code U+0009} |
* {@code HORIZONTAL TABULATION} |
* {@code '\n'} | {@code U+000A} |
@@ -7174,6 +7175,7 @@ class Character implements java.io.Serializable, Comparable {
* Returns the value obtained by reversing the order of the bytes in the
* specified char value.
*
+ * @param ch The {@code char} of which to reverse the byte order.
* @return the value obtained by reversing (or, equivalently, swapping)
* the bytes in the specified char value.
* @since 1.5
diff --git a/src/share/classes/java/lang/ClassLoader.java b/src/share/classes/java/lang/ClassLoader.java
index f26eafd980a503d354b503975a33017faf4a5d7e..c3f2aa2045818e310bbfcd6abfa8dc9441e73cbd 100644
--- a/src/share/classes/java/lang/ClassLoader.java
+++ b/src/share/classes/java/lang/ClassLoader.java
@@ -157,7 +157,7 @@ import sun.security.util.SecurityConstants;
* }
*
*
- *
+ *
*
* Any class name provided as a {@link String} parameter to methods in
* ClassLoader must be a binary name as defined by
@@ -342,7 +342,7 @@ public abstract class ClassLoader {
* #loadClass(String, boolean)} method. It is invoked by the Java virtual
* machine to resolve class references. Invoking this method is equivalent
* to invoking {@link #loadClass(String, boolean) loadClass(name,
- * false)}.
+ * false)}.
*
* @param name
* The binary name of the class
@@ -441,7 +441,7 @@ public abstract class ClassLoader {
* behaves as follows. If this ClassLoader object is registered as
* parallel capable, the method returns a dedicated object associated
* with the specified class name. Otherwise, the method returns this
- * ClassLoader object.
+ * ClassLoader object.
*
* @param className
* The name of the to-be-loaded class
@@ -506,7 +506,7 @@ public abstract class ClassLoader {
* follow the delegation model for loading classes, and will be invoked by
* the {@link #loadClass loadClass} method after checking the
* parent class loader for the requested class. The default implementation
- * throws a ClassNotFoundException.
+ * throws a ClassNotFoundException.
*
* @param name
* The binary name of the class
@@ -772,16 +772,16 @@ public abstract class ClassLoader {
* bBuffer, pd) yields exactly the same
* result as the statements
*
- *
+ *
* ...
- * byte[] temp = new byte[bBuffer.{@link
+ * byte[] temp = new byte[bBuffer.{@link
* java.nio.ByteBuffer#remaining remaining}()];
- * bBuffer.{@link java.nio.ByteBuffer#get(byte[])
+ * bBuffer.{@link java.nio.ByteBuffer#get(byte[])
* get}(temp);
* return {@link #defineClass(String, byte[], int, int, ProtectionDomain)
- * cl.defineClass}(name, temp, 0,
- * temp.length, pd);
- *
+ * cl.defineClass}(name, temp, 0,
+ * temp.length, pd);
+ *
*
* @param name
* The expected binary name. of the class, or
@@ -940,7 +940,6 @@ public abstract class ClassLoader {
* already been linked, then this method simply returns. Otherwise, the
* class is linked as described in the "Execution" chapter of
* The Java™ Language Specification.
- *
*
* @param c
* The class to link
@@ -1012,7 +1011,7 @@ public abstract class ClassLoader {
* Returns the class with the given binary name if this
* loader has been recorded by the Java virtual machine as an initiating
* loader of a class with that binary name. Otherwise
- * null is returned.
+ * null is returned.
*
* @param name
* The binary name of the class
@@ -1032,7 +1031,7 @@ public abstract class ClassLoader {
/**
* Sets the signers of a class. This should be invoked after defining a
- * class.
+ * class.
*
* @param c
* The Class object
@@ -1125,7 +1124,7 @@ public abstract class ClassLoader {
/**
* Finds the resource with the given name. Class loader implementations
- * should override this method to specify where to find resources.
+ * should override this method to specify where to find resources.
*
* @param name
* The resource name
@@ -1143,7 +1142,7 @@ public abstract class ClassLoader {
* Returns an enumeration of {@link java.net.URL URL} objects
* representing all the resources with the given name. Class loader
* implementations should override this method to specify where to load
- * resources from.
+ * resources from.
*
* @param name
* The resource name
@@ -1161,14 +1160,16 @@ public abstract class ClassLoader {
}
/**
- * Registers the caller as parallel capable.
+ * Registers the caller as parallel capable.
* The registration succeeds if and only if all of the following
- * conditions are met:
- * 1. no instance of the caller has been created
- * 2. all of the super classes (except class Object) of the caller are
- * registered as parallel capable
- * Note that once a class loader is registered as parallel capable, there
- * is no way to change it back.
+ * conditions are met:
+ *
+ * - no instance of the caller has been created
+ * - all of the super classes (except class Object) of the caller are
+ * registered as parallel capable
+ *
+ * Note that once a class loader is registered as parallel capable, there
+ * is no way to change it back.
*
* @return true if the caller is successfully registered as
* parallel capable and false if otherwise.
@@ -1185,7 +1186,7 @@ public abstract class ClassLoader {
/**
* Find a resource of the specified name from the search path used to load
* classes. This method locates the resource through the system class
- * loader (see {@link #getSystemClassLoader()}).
+ * loader (see {@link #getSystemClassLoader()}).
*
* @param name
* The resource name
@@ -1292,7 +1293,7 @@ public abstract class ClassLoader {
/**
* Open for reading, a resource of the specified name from the search path
* used to load classes. This method locates the resource through the
- * system class loader (see {@link #getSystemClassLoader()}).
+ * system class loader (see {@link #getSystemClassLoader()}).
*
* @param name
* The resource name
@@ -1515,7 +1516,7 @@ public abstract class ClassLoader {
* class loaders to define the packages for their classes. Packages must
* be created before the class is defined, and package names must be
* unique within a class loader and cannot be redefined or changed once
- * created.
+ * created.
*
* @param name
* The package name
@@ -1572,7 +1573,7 @@ public abstract class ClassLoader {
/**
* Returns a Package that has been defined by this class loader
- * or any of its ancestors.
+ * or any of its ancestors.
*
* @param name
* The package name
@@ -1609,7 +1610,7 @@ public abstract class ClassLoader {
/**
* Returns all of the Packages defined by this class loader and
- * its ancestors.
+ * its ancestors.
*
* @return The array of Package objects defined by this
* ClassLoader
@@ -1646,7 +1647,7 @@ public abstract class ClassLoader {
* method to locate the native libraries that belong to classes loaded with
* this class loader. If this method returns null, the VM
* searches the library along the path specified as the
- * "java.library.path" property.
+ * "java.library.path" property.
*
* @param libname
* The library name
@@ -1966,7 +1967,7 @@ public abstract class ClassLoader {
* in the future will have assertions enabled or disabled by default.
* This setting may be overridden on a per-package or per-class basis by
* invoking {@link #setPackageAssertionStatus(String, boolean)} or {@link
- * #setClassAssertionStatus(String, boolean)}.
+ * #setClassAssertionStatus(String, boolean)}.
*
* @param enabled
* true if classes loaded by this class loader will
@@ -2068,7 +2069,6 @@ public abstract class ClassLoader {
* status settings associated with the class loader. This method is
* provided so that class loaders can be made to ignore any command line or
* persistent assertion status settings and "start with a clean slate."
- *
*
* @since 1.4
*/
diff --git a/src/share/classes/java/lang/Double.java b/src/share/classes/java/lang/Double.java
index 113cdf81a4c06052d4caa95911380ae6ef09f5e8..1b1aece8122321617cd8a0d1a0f794ef0517c1a6 100644
--- a/src/share/classes/java/lang/Double.java
+++ b/src/share/classes/java/lang/Double.java
@@ -256,7 +256,7 @@ public final class Double extends Number implements Comparable {
*
*
*
- * Examples
+ * Examples
* Floating-point Value | Hexadecimal String |
*
---|
{@code 1.0} | {@code 0x1.0p0} |
*
{@code -1.0} | {@code -0x1.0p0} |
diff --git a/src/share/classes/java/lang/Float.java b/src/share/classes/java/lang/Float.java
index 2f2b6b224443f92f9889c6310206eef0a92ef8ff..e130e92314e43f4d73d0a696df9b0132a7183b6c 100644
--- a/src/share/classes/java/lang/Float.java
+++ b/src/share/classes/java/lang/Float.java
@@ -258,7 +258,7 @@ public final class Float extends Number implements Comparable {
*
*
*
- * Examples
+ * Examples
* Floating-point Value | Hexadecimal String |
*
---|
{@code 1.0} | {@code 0x1.0p0} |
*
{@code -1.0} | {@code -0x1.0p0} |
diff --git a/src/share/classes/java/lang/ProcessBuilder.java b/src/share/classes/java/lang/ProcessBuilder.java
index b467f45c3510630cd31be7b7ff790999167a4f01..0cb7febe533df4ef2dc5cc88cb473e741ddb948e 100644
--- a/src/share/classes/java/lang/ProcessBuilder.java
+++ b/src/share/classes/java/lang/ProcessBuilder.java
@@ -65,7 +65,7 @@ import java.util.Map;
* working directory of the current process, usually the directory
* named by the system property {@code user.dir}.
*
- * a source of standard input.
+ * a source of standard input.
* By default, the subprocess reads input from a pipe. Java code
* can access this pipe via the output stream returned by
* {@link Process#getOutputStream()}. However, standard input may
@@ -81,7 +81,7 @@ import java.util.Map;
*
*
* a destination for standard output
- * and standard error. By default, the subprocess writes standard
+ * and standard error. By default, the subprocess writes standard
* output and standard error to pipes. Java code can access these pipes
* via the input streams returned by {@link Process#getInputStream()} and
* {@link Process#getErrorStream()}. However, standard output and
@@ -554,6 +554,7 @@ public final class ProcessBuilder
* Redirect.from(file).type() == Redirect.Type.READ
* }
*
+ * @param file The {@code File} for the {@code Redirect}.
* @throws NullPointerException if the specified file is null
* @return a redirect to read from the specified file
*/
@@ -580,6 +581,7 @@ public final class ProcessBuilder
* Redirect.to(file).type() == Redirect.Type.WRITE
* }
*
+ * @param file The {@code File} for the {@code Redirect}.
* @throws NullPointerException if the specified file is null
* @return a redirect to write to the specified file
*/
@@ -610,6 +612,7 @@ public final class ProcessBuilder
* Redirect.appendTo(file).type() == Redirect.Type.APPEND
* }
*
+ * @param file The {@code File} for the {@code Redirect}.
* @throws NullPointerException if the specified file is null
* @return a redirect to append to the specified file
*/
diff --git a/src/share/classes/java/lang/Runtime.java b/src/share/classes/java/lang/Runtime.java
index 5ff1aac0bce4f7d59f5fa29713fbefe03a6b974b..9e53dc939ecbe93804ba6d42eedbefff7f2835d9 100644
--- a/src/share/classes/java/lang/Runtime.java
+++ b/src/share/classes/java/lang/Runtime.java
@@ -661,7 +661,7 @@ public class Runtime {
/**
* Returns the maximum amount of memory that the Java virtual machine will
* attempt to use. If there is no inherent limit then the value {@link
- * java.lang.Long#MAX_VALUE} will be returned.
+ * java.lang.Long#MAX_VALUE} will be returned.
*
* @return the maximum amount of memory that the virtual machine will
* attempt to use, measured in bytes
diff --git a/src/share/classes/java/lang/Thread.java b/src/share/classes/java/lang/Thread.java
index eb89670d14995fabd378e8b0c39c1671e52c55b2..d8a9ee2a58235eabcf2a95465b1701a5baea3eff 100644
--- a/src/share/classes/java/lang/Thread.java
+++ b/src/share/classes/java/lang/Thread.java
@@ -865,8 +865,8 @@ class Thread implements Runnable {
* will receive an {@link InterruptedException}.
*
* If this thread is blocked in an I/O operation upon an {@link
- * java.nio.channels.InterruptibleChannel interruptible
- * channel} then the channel will be closed, the thread's interrupt
+ * java.nio.channels.InterruptibleChannel InterruptibleChannel}
+ * then the channel will be closed, the thread's interrupt
* status will be set, and the thread will receive a {@link
* java.nio.channels.ClosedByInterruptException}.
*
@@ -1883,6 +1883,7 @@ class Thread implements Runnable {
* there is no default.
* @since 1.5
* @see #setDefaultUncaughtExceptionHandler
+ * @return the default uncaught exception handler for all threads
*/
public static UncaughtExceptionHandler getDefaultUncaughtExceptionHandler(){
return defaultUncaughtExceptionHandler;
@@ -1895,6 +1896,7 @@ class Thread implements Runnable {
* ThreadGroup object is returned, unless this thread
* has terminated, in which case null is returned.
* @since 1.5
+ * @return the uncaught exception handler for this thread
*/
public UncaughtExceptionHandler getUncaughtExceptionHandler() {
return uncaughtExceptionHandler != null ?
diff --git a/src/share/classes/java/lang/ThreadLocal.java b/src/share/classes/java/lang/ThreadLocal.java
index b337fc5f2e6eb7eb3670e58972fb91b4712259c5..91d3df940d6258e21b9853871cbe2095e97c690f 100644
--- a/src/share/classes/java/lang/ThreadLocal.java
+++ b/src/share/classes/java/lang/ThreadLocal.java
@@ -131,12 +131,13 @@ public class ThreadLocal {
* Creates a thread local variable. The initial value of the variable is
* determined by invoking the {@code get} method on the {@code Supplier}.
*
+ * @param the type of the thread local's value
* @param supplier the supplier to be used to determine the initial value
* @return a new thread local variable
* @throws NullPointerException if the specified supplier is null
* @since 1.8
*/
- public static ThreadLocal withInitial(Supplier extends T> supplier) {
+ public static ThreadLocal withInitial(Supplier extends S> supplier) {
return new SuppliedThreadLocal<>(supplier);
}