diff --git a/jdk/src/java.base/share/classes/java/net/InetSocketAddress.java b/jdk/src/java.base/share/classes/java/net/InetSocketAddress.java index 87fce160fb2..2bdfdc25102 100644 --- a/jdk/src/java.base/share/classes/java/net/InetSocketAddress.java +++ b/jdk/src/java.base/share/classes/java/net/InetSocketAddress.java @@ -206,7 +206,7 @@ public class InetSocketAddress * @param hostname the Host name * @param port The port number * @throws IllegalArgumentException if the port parameter is outside the range - * of valid port values, or if the hostname parameter is null. + * of valid port values, or if the hostname parameter is {@code null}. * @throws SecurityException if a security manager is present and * permission to resolve the host name is * denied. @@ -244,7 +244,7 @@ public class InetSocketAddress * @param port The port number * @throws IllegalArgumentException if the port parameter is outside * the range of valid port values, or if the hostname - * parameter is null. + * parameter is {@code null}. * @see #isUnresolved() * @return a {@code InetSocketAddress} representing the unresolved * socket address diff --git a/jdk/src/java.base/share/classes/java/net/spi/package-info.java b/jdk/src/java.base/share/classes/java/net/spi/package-info.java index 3be4ac8231f..06ddeccb00d 100644 --- a/jdk/src/java.base/share/classes/java/net/spi/package-info.java +++ b/jdk/src/java.base/share/classes/java/net/spi/package-info.java @@ -24,7 +24,7 @@ */ /** - * Service-provider classes for the {@link java.net} package. + * Service-provider classes for the {@link java.net} package. * *

Only developers who are defining new URL stream handler providers * should need to make direct use of this package. diff --git a/jdk/src/java.base/share/classes/javax/net/ssl/SSLContext.java b/jdk/src/java.base/share/classes/javax/net/ssl/SSLContext.java index ebdae178fd8..e5bd2b78259 100644 --- a/jdk/src/java.base/share/classes/javax/net/ssl/SSLContext.java +++ b/jdk/src/java.base/share/classes/javax/net/ssl/SSLContext.java @@ -39,7 +39,7 @@ import sun.security.jca.GetInstance; *

Every implementation of the Java platform is required to support the * following standard {@code SSLContext} protocol: *

* This protocol is described in the diff --git a/jdk/src/java.base/share/classes/javax/net/ssl/SSLException.java b/jdk/src/java.base/share/classes/javax/net/ssl/SSLException.java index 98d8bd3cbf6..f5a1a87423f 100644 --- a/jdk/src/java.base/share/classes/javax/net/ssl/SSLException.java +++ b/jdk/src/java.base/share/classes/javax/net/ssl/SSLException.java @@ -53,13 +53,13 @@ class SSLException extends IOException } /** - * Creates a SSLException with the specified + * Creates a {@code SSLException} with the specified * detail message and cause. * * @param message the detail message (which is saved for later retrieval * by the {@link #getMessage()} method). * @param cause the cause (which is saved for later retrieval by the - * {@link #getCause()} method). (A null value is + * {@link #getCause()} method). (A {@code null} value is * permitted, and indicates that the cause is nonexistent or * unknown.) * @since 1.5 @@ -70,13 +70,13 @@ class SSLException extends IOException } /** - * Creates a SSLException with the specified cause - * and a detail message of (cause==null ? null : cause.toString()) + * Creates a {@code SSLException} with the specified cause + * and a detail message of {@code (cause==null ? null : cause.toString())} * (which typically contains the class and detail message of - * cause). + * {@code cause}). * * @param cause the cause (which is saved for later retrieval by the - * {@link #getCause()} method). (A null value is + * {@link #getCause()} method). (A {@code null} value is * permitted, and indicates that the cause is nonexistent or * unknown.) * @since 1.5 diff --git a/jdk/src/java.base/share/classes/sun/net/ftp/FtpClientProvider.java b/jdk/src/java.base/share/classes/sun/net/ftp/FtpClientProvider.java index 06deae65817..bbdb1cde5bd 100644 --- a/jdk/src/java.base/share/classes/sun/net/ftp/FtpClientProvider.java +++ b/jdk/src/java.base/share/classes/sun/net/ftp/FtpClientProvider.java @@ -52,7 +52,7 @@ public abstract class FtpClientProvider { * Initializes a new instance of this class. * * @throws SecurityException if a security manager is installed and it denies - * {@link RuntimePermission}("ftpClientProvider") + * {@link RuntimePermission}{@code ("ftpClientProvider")} */ protected FtpClientProvider() { SecurityManager sm = System.getSecurityManager(); @@ -108,7 +108,7 @@ public abstract class FtpClientProvider { *
    * *

  1. If the system property - * java.net.FtpClientProvider is defined then it is + * {@code java.net.FtpClientProvider} is defined then it is * taken to be the fully-qualified name of a concrete provider class. * The class is loaded and instantiated; if this process fails then an * unspecified unchecked error or exception is thrown.

    2. @@ -116,8 +116,8 @@ public abstract class FtpClientProvider { *

  2. If a provider class has been installed in a jar file that is * visible to the system class loader, and that jar file contains a * provider-configuration file named - * java.net.FtpClientProvider in the resource - * directory META-INF/services, then the first class name + * {@code java.net.FtpClientProvider} in the resource + * directory {@code META-INF/services}, then the first class name * specified in that file is taken. The class is loaded and * instantiated; if this process fails then an unspecified unchecked error or exception is * thrown.

    3. diff --git a/jdk/src/java.base/share/classes/sun/util/PreHashedMap.java b/jdk/src/java.base/share/classes/sun/util/PreHashedMap.java index 1bb05705c04..724af5412ef 100644 --- a/jdk/src/java.base/share/classes/sun/util/PreHashedMap.java +++ b/jdk/src/java.base/share/classes/sun/util/PreHashedMap.java @@ -56,7 +56,7 @@ import java.util.NoSuchElementException; * * } * - *

    The init method is invoked by the PreHashedMap + *

    The {@code init} method is invoked by the {@code PreHashedMap} * constructor with an object array long enough for the map's rows. The method * must construct the hash chain for each row and store it in the appropriate * element of the array. @@ -73,7 +73,7 @@ import java.util.NoSuchElementException; * methods in the {@link java.util.Collections} utility class. * *

    In the JDK build, subclasses of this class are typically created via the - * Hasher program in the make/tools/Hasher directory. + * {@code Hasher} program in the {@code make/tools/Hasher} directory. * * @author Mark Reinhold * @since 1.5 @@ -95,7 +95,7 @@ public abstract class PreHashedMap * Creates a new map. * *

    This constructor invokes the {@link #init init} method, passing it a - * newly-constructed row array that is rows elements long. + * newly-constructed row array that is {@code rows} elements long. * * @param rows * The number of rows in the map diff --git a/jdk/src/java.base/unix/classes/sun/net/www/protocol/file/Handler.java b/jdk/src/java.base/unix/classes/sun/net/www/protocol/file/Handler.java index 4fa76ae6df4..ce280dc455a 100644 --- a/jdk/src/java.base/unix/classes/sun/net/www/protocol/file/Handler.java +++ b/jdk/src/java.base/unix/classes/sun/net/www/protocol/file/Handler.java @@ -116,8 +116,8 @@ public class Handler extends URLStreamHandler { * Compares the host components of two URLs. * @param u1 the URL of the first host to compare * @param u2 the URL of the second host to compare - * @return true if and only if they - * are equal, false otherwise. + * @return {@code true} if and only if they + * are equal, {@code false} otherwise. */ protected boolean hostsEqual(URL u1, URL u2) { /* diff --git a/jdk/src/java.base/windows/classes/sun/io/Win32ErrorMode.java b/jdk/src/java.base/windows/classes/sun/io/Win32ErrorMode.java index 8ec417fd6e2..18626a76462 100644 --- a/jdk/src/java.base/windows/classes/sun/io/Win32ErrorMode.java +++ b/jdk/src/java.base/windows/classes/sun/io/Win32ErrorMode.java @@ -59,8 +59,8 @@ public class Win32ErrorMode { * Invoke at VM initialization time to disable the critical error message box. *

    * The critial error message box is disabled unless the system property - * sun.io.allowCriticalErrorMessageBox is set to something other than - * false. This includes the empty string. + * {@code sun.io.allowCriticalErrorMessageBox} is set to something other than + * {@code false}. This includes the empty string. *

    * This method does nothing if invoked after VM and class library initialization * has completed. diff --git a/jdk/src/java.base/windows/classes/sun/net/www/protocol/file/Handler.java b/jdk/src/java.base/windows/classes/sun/net/www/protocol/file/Handler.java index 8a5531268de..c2cb1d17f5d 100644 --- a/jdk/src/java.base/windows/classes/sun/net/www/protocol/file/Handler.java +++ b/jdk/src/java.base/windows/classes/sun/net/www/protocol/file/Handler.java @@ -134,8 +134,8 @@ public class Handler extends URLStreamHandler { * Compares the host components of two URLs. * @param u1 the URL of the first host to compare * @param u2 the URL of the second host to compare - * @return true if and only if they - * are equal, false otherwise. + * @return {@code true} if and only if they + * are equal, {@code false} otherwise. */ protected boolean hostsEqual(URL u1, URL u2) { /* diff --git a/jdk/src/java.corba/share/classes/com/sun/jndi/cosnaming/RemoteToCorba.java b/jdk/src/java.corba/share/classes/com/sun/jndi/cosnaming/RemoteToCorba.java index 69cc7b45523..9f8414a9573 100644 --- a/jdk/src/java.corba/share/classes/com/sun/jndi/cosnaming/RemoteToCorba.java +++ b/jdk/src/java.corba/share/classes/com/sun/jndi/cosnaming/RemoteToCorba.java @@ -56,7 +56,7 @@ public class RemoteToCorba implements StateFactory { * @param name Ignored * @param ctx The non-null CNCtx whose ORB to use. * @param env Ignored - * @return The CORBA object for orig or null. + * @return The CORBA object for {@code orig} or null. * @exception ConfigurationException If the CORBA object cannot be obtained * due to configuration problems, for instance, if RMI-IIOP not available. * @exception NamingException If some other problem prevented a CORBA diff --git a/jdk/src/java.corba/share/classes/com/sun/jndi/toolkit/corba/CorbaUtils.java b/jdk/src/java.corba/share/classes/com/sun/jndi/toolkit/corba/CorbaUtils.java index 2fa43bca79e..122c9df57f5 100644 --- a/jdk/src/java.corba/share/classes/com/sun/jndi/toolkit/corba/CorbaUtils.java +++ b/jdk/src/java.corba/share/classes/com/sun/jndi/toolkit/corba/CorbaUtils.java @@ -76,7 +76,7 @@ public class CorbaUtils { * * @param remoteObj The non-null remote object for * @param orb The non-null ORB to connect the remote object to - * @return The CORBA Object for remoteObj; null if remoteObj + * @return The CORBA Object for remoteObj; null if {@code remoteObj} * is a JRMP implementation or JRMP stub. * @exception ConfigurationException The CORBA Object cannot be obtained * because of configuration problems. diff --git a/jdk/src/java.rmi/share/classes/java/rmi/RemoteException.java b/jdk/src/java.rmi/share/classes/java/rmi/RemoteException.java index b125932c41e..b32558bc05f 100644 --- a/jdk/src/java.rmi/share/classes/java/rmi/RemoteException.java +++ b/jdk/src/java.rmi/share/classes/java/rmi/RemoteException.java @@ -26,11 +26,11 @@ package java.rmi; /** - * A RemoteException is the common superclass for a number of + * A {@code RemoteException} is the common superclass for a number of * communication-related exceptions that may occur during the execution of a * remote method call. Each method of a remote interface, an interface that - * extends java.rmi.Remote, must list - * RemoteException in its throws clause. + * extends {@code java.rmi.Remote}, must list + * {@code RemoteException} in its throws clause. * *

    As of release 1.4, this exception has been retrofitted to conform to * the general purpose exception-chaining mechanism. The "wrapped remote @@ -40,7 +40,7 @@ package java.rmi; * the aforementioned "legacy field." * *

    Invoking the method {@link Throwable#initCause(Throwable)} on an - * instance of RemoteException always throws {@link + * instance of {@code RemoteException} always throws {@link * IllegalStateException}. * * @author Ann Wollrath @@ -63,14 +63,14 @@ public class RemoteException extends java.io.IOException { public Throwable detail; /** - * Constructs a RemoteException. + * Constructs a {@code RemoteException}. */ public RemoteException() { initCause(null); // Disallow subsequent initCause } /** - * Constructs a RemoteException with the specified + * Constructs a {@code RemoteException} with the specified * detail message. * * @param s the detail message @@ -81,9 +81,9 @@ public class RemoteException extends java.io.IOException { } /** - * Constructs a RemoteException with the specified detail + * Constructs a {@code RemoteException} with the specified detail * message and cause. This constructor sets the {@link #detail} - * field to the specified Throwable. + * field to the specified {@code Throwable}. * * @param s the detail message * @param cause the cause @@ -113,7 +113,7 @@ public class RemoteException extends java.io.IOException { * Returns the cause of this exception. This method returns the value * of the {@link #detail} field. * - * @return the cause, which may be null. + * @return the cause, which may be {@code null}. * @since 1.4 */ public Throwable getCause() { diff --git a/jdk/src/java.rmi/share/classes/java/rmi/activation/ActivationException.java b/jdk/src/java.rmi/share/classes/java/rmi/activation/ActivationException.java index 7ac8bf7994d..5fc7323f529 100644 --- a/jdk/src/java.rmi/share/classes/java/rmi/activation/ActivationException.java +++ b/jdk/src/java.rmi/share/classes/java/rmi/activation/ActivationException.java @@ -36,7 +36,7 @@ package java.rmi.activation; * the aforementioned "legacy field." * *

    Invoking the method {@link Throwable#initCause(Throwable)} on an - * instance of ActivationException always throws {@link + * instance of {@code ActivationException} always throws {@link * IllegalStateException}. * * @author Ann Wollrath @@ -59,14 +59,14 @@ public class ActivationException extends Exception { private static final long serialVersionUID = -4320118837291406071L; /** - * Constructs an ActivationException. + * Constructs an {@code ActivationException}. */ public ActivationException() { initCause(null); // Disallow subsequent initCause } /** - * Constructs an ActivationException with the specified + * Constructs an {@code ActivationException} with the specified * detail message. * * @param s the detail message @@ -77,9 +77,9 @@ public class ActivationException extends Exception { } /** - * Constructs an ActivationException with the specified + * Constructs an {@code ActivationException} with the specified * detail message and cause. This constructor sets the {@link #detail} - * field to the specified Throwable. + * field to the specified {@code Throwable}. * * @param s the detail message * @param cause the cause @@ -109,7 +109,7 @@ public class ActivationException extends Exception { * Returns the cause of this exception. This method returns the value * of the {@link #detail} field. * - * @return the cause, which may be null. + * @return the cause, which may be {@code null}. * @since 1.4 */ public Throwable getCause() { diff --git a/jdk/src/java.rmi/share/classes/java/rmi/server/ServerCloneException.java b/jdk/src/java.rmi/share/classes/java/rmi/server/ServerCloneException.java index b93c56588ad..f48bd0d092f 100644 --- a/jdk/src/java.rmi/share/classes/java/rmi/server/ServerCloneException.java +++ b/jdk/src/java.rmi/share/classes/java/rmi/server/ServerCloneException.java @@ -26,8 +26,8 @@ package java.rmi.server; /** - * A ServerCloneException is thrown if a remote exception occurs - * during the cloning of a UnicastRemoteObject. + * A {@code ServerCloneException} is thrown if a remote exception occurs + * during the cloning of a {@code UnicastRemoteObject}. * *

    As of release 1.4, this exception has been retrofitted to conform to * the general purpose exception-chaining mechanism. The "nested exception" @@ -37,7 +37,7 @@ package java.rmi.server; * the aforementioned "legacy field." * *

    Invoking the method {@link Throwable#initCause(Throwable)} on an - * instance of ServerCloneException always throws {@link + * instance of {@code ServerCloneException} always throws {@link * IllegalStateException}. * * @author Ann Wollrath @@ -61,7 +61,7 @@ public class ServerCloneException extends CloneNotSupportedException { private static final long serialVersionUID = 6617456357664815945L; /** - * Constructs a ServerCloneException with the specified + * Constructs a {@code ServerCloneException} with the specified * detail message. * * @param s the detail message. @@ -72,7 +72,7 @@ public class ServerCloneException extends CloneNotSupportedException { } /** - * Constructs a ServerCloneException with the specified + * Constructs a {@code ServerCloneException} with the specified * detail message and cause. * * @param s the detail message. @@ -103,7 +103,7 @@ public class ServerCloneException extends CloneNotSupportedException { * Returns the cause of this exception. This method returns the value * of the {@link #detail} field. * - * @return the cause, which may be null. + * @return the cause, which may be {@code null}. * @since 1.4 */ public Throwable getCause() { diff --git a/jdk/src/java.sql.rowset/share/classes/com/sun/rowset/package.html b/jdk/src/java.sql.rowset/share/classes/com/sun/rowset/package.html index 00096524051..5945c539e56 100644 --- a/jdk/src/java.sql.rowset/share/classes/com/sun/rowset/package.html +++ b/jdk/src/java.sql.rowset/share/classes/com/sun/rowset/package.html @@ -26,51 +26,51 @@ - + com.sun.rowset Package -Provides five standard implementations of the standard JDBC RowSet implementation -interface definitions. These reference implementations are included with the J2SE version -1.5 platform and represent the benchmark standard RowSet implementations as verified +Provides five standard implementations of the standard JDBC RowSet implementation +interface definitions. These reference implementations are included with the J2SE version +1.5 platform and represent the benchmark standard RowSet implementations as verified by the Test Compatibility Kit (TCK) as mandated by the Java Community Process. -
    - +
    +

    1.0 Available JDBC RowSet Reference Implementations

    - The following implementations are provided:
    - -
    JdbcRowSetImpl - The javax.sql.rowset.JdbcRowSet +The following implementations are provided:
    + +
    JdbcRowSetImpl - The javax.sql.rowset.JdbcRowSet interface reference implementation.

    -CachedRowSetImpl - The javax.sql.rowset.CachedRowSet interface +CachedRowSetImpl - The javax.sql.rowset.CachedRowSet interface reference implementation.

    -WebRowSetImpl - The javax.sql.rowset.WebRowSet interface +WebRowSetImpl - The javax.sql.rowset.WebRowSet interface reference implementation.

    -FilteredRowSetImpl - The javax.sql.rowset.FilteredRowSet +FilteredRowSetImpl - The javax.sql.rowset.FilteredRowSet interface reference implementation.

    -JoinRowSetImpl - The javax.sql.rowset.JoinRowSet interface +JoinRowSetImpl - The javax.sql.rowset.JoinRowSet interface reference implementation.
    -All details on their expected behavior, including their interactions with the SyncProvider -SPI and helper classes are provided in the interface definitions in the javax.sql.rowset +All details on their expected behavior, including their interactions with the SyncProvider +SPI and helper classes are provided in the interface definitions in the javax.sql.rowset package specification.
    - +

    2.0 Usage

    The reference implementations represent robust implementations of the standard -RowSet interfaces defined in the javax.sql.rowset package. -All disconnected RowSet implementations, such as the CachedRowSetImpl -and WebRowSetImpl, are flexible enough to use the SyncFactory SPIs to -leverage non-reference implementation SyncProvider implementations to obtain -differing synchronization semantics. Furthermore, developers and vendors alike are free +RowSet interfaces defined in the javax.sql.rowset package. +All disconnected RowSet implementations, such as the CachedRowSetImpl +and WebRowSetImpl, are flexible enough to use the SyncFactory SPIs to +leverage non-reference implementation SyncProvider implementations to obtain +differing synchronization semantics. Furthermore, developers and vendors alike are free to use these implementations and integrate them into their products just as they can with to other components of the Java platform.
    - +

    3.0 Extending the JDBC RowSet Implementations

    The JDBC RowSet reference implementations are provided as non-final @@ -81,6 +81,6 @@ set to their their particular needs. The website for JDBC Technology will provider a portal where implementations can be listed, similar to the way it provides a site for JDBC drivers.
    -
    +
    diff --git a/jdk/src/java.sql.rowset/share/classes/com/sun/rowset/providers/package.html b/jdk/src/java.sql.rowset/share/classes/com/sun/rowset/providers/package.html index 7e7ff315b52..1910541538d 100644 --- a/jdk/src/java.sql.rowset/share/classes/com/sun/rowset/providers/package.html +++ b/jdk/src/java.sql.rowset/share/classes/com/sun/rowset/providers/package.html @@ -1,10 +1,10 @@ - + - +