diff --git a/jdk/src/share/classes/java/net/DatagramSocket.java b/jdk/src/share/classes/java/net/DatagramSocket.java index 1e095dec731..31344b4391c 100644 --- a/jdk/src/share/classes/java/net/DatagramSocket.java +++ b/jdk/src/share/classes/java/net/DatagramSocket.java @@ -104,7 +104,7 @@ class DatagramSocket implements java.io.Closeable { /** * Connects this socket to a remote socket address (IP address + port number). * Binds socket if not already bound. - *

+ * * @param address The remote address. * @param port The remote port * @throws SocketException if binding the socket fails. @@ -338,7 +338,7 @@ class DatagramSocket implements java.io.Closeable { *

* If the address is {@code null}, then the system will pick up * an ephemeral port and a valid local address to bind the socket. - *

+ * * @param addr The address and port to bind to. * @throws SocketException if any error happens during the bind, or if the * socket is already bound. @@ -1240,10 +1240,8 @@ class DatagramSocket implements java.io.Closeable { * datagram socket factory. * @exception SocketException if the factory is already defined. * @exception SecurityException if a security manager exists and its - * {@code checkSetFactory} method doesn't allow the - operation. - * @see - java.net.DatagramSocketImplFactory#createDatagramSocketImpl() + * {@code checkSetFactory} method doesn't allow the operation. + * @see java.net.DatagramSocketImplFactory#createDatagramSocketImpl() * @see SecurityManager#checkSetFactory * @since 1.3 */ diff --git a/jdk/src/share/classes/java/net/InetSocketAddress.java b/jdk/src/share/classes/java/net/InetSocketAddress.java index e8a804fa601..87fce160fb2 100644 --- a/jdk/src/share/classes/java/net/InetSocketAddress.java +++ b/jdk/src/share/classes/java/net/InetSocketAddress.java @@ -157,7 +157,7 @@ public class InetSocketAddress * A valid port value is between 0 and 65535. * A port number of {@code zero} will let the system pick up an * ephemeral port in a {@code bind} operation. - *

+ * * @param port The port number * @throws IllegalArgumentException if the port parameter is outside the specified * range of valid port values. @@ -175,7 +175,7 @@ public class InetSocketAddress * ephemeral port in a {@code bind} operation. *

* A {@code null} address will assign the wildcard address. - *

+ * * @param addr The IP address * @param port The port number * @throws IllegalArgumentException if the port parameter is outside the specified @@ -202,7 +202,7 @@ public class InetSocketAddress * A valid port value is between 0 and 65535. * A port number of {@code zero} will let the system pick up an * ephemeral port in a {@code bind} operation. - *

+ * * @param hostname the Host name * @param port The port number * @throws IllegalArgumentException if the port parameter is outside the range @@ -239,7 +239,7 @@ public class InetSocketAddress * A valid port value is between 0 and 65535. * A port number of {@code zero} will let the system pick up an * ephemeral port in a {@code bind} operation. - *

+ * * @param host the Host name * @param port The port number * @throws IllegalArgumentException if the port parameter is outside diff --git a/jdk/src/share/classes/java/net/ServerSocket.java b/jdk/src/share/classes/java/net/ServerSocket.java index 2ee3420d548..e94790dd620 100644 --- a/jdk/src/share/classes/java/net/ServerSocket.java +++ b/jdk/src/share/classes/java/net/ServerSocket.java @@ -157,7 +157,6 @@ class ServerSocket implements java.io.Closeable { * or may choose to ignore the parameter altogther. The value provided * should be greater than {@code 0}. If it is less than or equal to * {@code 0}, then an implementation specific default will be used. - *

* * @param port the port number, or {@code 0} to use a port * number that is automatically allocated. @@ -206,7 +205,7 @@ class ServerSocket implements java.io.Closeable { * or may choose to ignore the parameter altogther. The value provided * should be greater than {@code 0}. If it is less than or equal to * {@code 0}, then an implementation specific default will be used. - *

+ * * @param port the port number, or {@code 0} to use a port * number that is automatically allocated. * @param backlog requested maximum length of the queue of incoming @@ -315,7 +314,7 @@ class ServerSocket implements java.io.Closeable { *

* If the address is {@code null}, then the system will pick up * an ephemeral port and a valid local address to bind the socket. - *

+ * * @param endpoint The IP address and port number to bind to. * @throws IOException if the bind operation fails, or if the socket * is already bound. diff --git a/jdk/src/share/classes/java/net/Socket.java b/jdk/src/share/classes/java/net/Socket.java index dedc8ca1b85..b6df988d14b 100644 --- a/jdk/src/share/classes/java/net/Socket.java +++ b/jdk/src/share/classes/java/net/Socket.java @@ -153,7 +153,7 @@ class Socket implements java.io.Closeable { /** * Creates an unconnected Socket with a user-specified * SocketImpl. - *

+ * * @param impl an instance of a SocketImpl * the subclass wishes to use on the Socket. * @@ -1245,7 +1245,7 @@ class Socket implements java.io.Closeable { *

    *
  1. For sockets accepted from a ServerSocket, this must be done by calling * {@link ServerSocket#setReceiveBufferSize(int)} before the ServerSocket - * is bound to a local address.

    2. + * is bound to a local address. *
  2. For client sockets, setReceiveBufferSize() must be called before * connecting the socket to its remote peer.
* @param size the size to which to set the receive buffer diff --git a/jdk/src/share/classes/java/net/SocketOptions.java b/jdk/src/share/classes/java/net/SocketOptions.java index 7e1b0fc85b6..cd1539c3530 100644 --- a/jdk/src/share/classes/java/net/SocketOptions.java +++ b/jdk/src/share/classes/java/net/SocketOptions.java @@ -38,7 +38,7 @@ import java.lang.annotation.Native; * DatagramSocketImpl, you won't use these directly. There are * type-safe methods to get/set each of these options in Socket, ServerSocket, * DatagramSocket and MulticastSocket. - *

+ * * @author David Brown */ diff --git a/jdk/src/share/classes/java/net/SocketPermission.java b/jdk/src/share/classes/java/net/SocketPermission.java index 0f720c52283..51777d90385 100644 --- a/jdk/src/share/classes/java/net/SocketPermission.java +++ b/jdk/src/share/classes/java/net/SocketPermission.java @@ -1001,7 +1001,7 @@ public final class SocketPermission extends Permission /** * Checks two SocketPermission objects for equality. - *

+ * * @param obj the object to test for equality with this object. * * @return true if obj is a SocketPermission, and has the diff --git a/jdk/src/share/classes/java/net/URL.java b/jdk/src/share/classes/java/net/URL.java index 86d0bf78794..d2042094bc6 100644 --- a/jdk/src/share/classes/java/net/URL.java +++ b/jdk/src/share/classes/java/net/URL.java @@ -867,7 +867,7 @@ public final class URL implements java.io.Serializable { * Creates an integer suitable for hash table indexing.

* * The hash code is based upon all the URL components relevant for URL - * comparison. As such, this operation is a blocking operation.

+ * comparison. As such, this operation is a blocking operation. * * @return a hash code for this {@code URL}. */ diff --git a/jdk/src/share/classes/java/net/URLClassLoader.java b/jdk/src/share/classes/java/net/URLClassLoader.java index f272346ce2f..e448a120bdc 100644 --- a/jdk/src/share/classes/java/net/URLClassLoader.java +++ b/jdk/src/share/classes/java/net/URLClassLoader.java @@ -271,7 +271,7 @@ public class URLClassLoader extends SecureClassLoader implements Closeable { * by catching {@link IOException}s internally. Unchecked exceptions * and errors are not caught. Calling close on an already closed * loader has no effect. - *

+ * * @exception IOException if closing any file opened by this class loader * resulted in an IOException. Any such exceptions are caught internally. * If only one is caught, then it is re-thrown. If more than one exception diff --git a/jdk/src/share/classes/java/net/doc-files/net-properties.html b/jdk/src/share/classes/java/net/doc-files/net-properties.html index 5aac0c8e3bd..d8e8949fc32 100644 --- a/jdk/src/share/classes/java/net/doc-files/net-properties.html +++ b/jdk/src/share/classes/java/net/doc-files/net-properties.html @@ -35,7 +35,8 @@ alter the mechanisms and behavior of the various classes of the java.net package. Some are checked only once at startup of the VM, and therefore are best set using the -D option of the java command, while others have a more dynamic nature and can also be changed using -the System.setProperty() API. The purpose of this document is to list +the System.setProperty() API. +The purpose of this document is to list and detail all of these properties.

If there is no special note, a property value is checked every time it is used.

diff --git a/jdk/src/share/classes/java/rmi/activation/ActivationGroup.java b/jdk/src/share/classes/java/rmi/activation/ActivationGroup.java index aa636a7724d..86736549153 100644 --- a/jdk/src/share/classes/java/rmi/activation/ActivationGroup.java +++ b/jdk/src/share/classes/java/rmi/activation/ActivationGroup.java @@ -172,7 +172,7 @@ public abstract class ActivationGroup * *

This method simply informs the group's monitor that the object * is inactive. It is up to the concrete subclass of ActivationGroup - * to fulfill the additional requirement of unexporting the object.

+ * to fulfill the additional requirement of unexporting the object. * * @param id the object's activation identifier * @return true if the object was successfully deactivated; otherwise diff --git a/jdk/src/share/classes/java/rmi/activation/ActivationGroupDesc.java b/jdk/src/share/classes/java/rmi/activation/ActivationGroupDesc.java index ca088c63f77..af9df9ef7da 100644 --- a/jdk/src/share/classes/java/rmi/activation/ActivationGroupDesc.java +++ b/jdk/src/share/classes/java/rmi/activation/ActivationGroupDesc.java @@ -49,7 +49,7 @@ import java.util.Properties; * *

  • the group's ActivationGroupID, and *
  • the group's initialization data (in a - * java.rmi.MarshalledObject)

    + * java.rmi.MarshalledObject) * * @author Ann Wollrath * @since 1.2 diff --git a/jdk/src/share/classes/java/rmi/activation/ActivationMonitor.java b/jdk/src/share/classes/java/rmi/activation/ActivationMonitor.java index 116aaf4e559..81fdec02c5e 100644 --- a/jdk/src/share/classes/java/rmi/activation/ActivationMonitor.java +++ b/jdk/src/share/classes/java/rmi/activation/ActivationMonitor.java @@ -63,7 +63,7 @@ public interface ActivationMonitor extends Remote { * reference associated with id as a stale reference. * Since the reference is considered stale, a subsequent * activate call for the same activation identifier - * results in re-activating the remote object.

    + * results in re-activating the remote object. * * @param id the object's activation identifier * @exception UnknownObjectException if object is unknown diff --git a/jdk/src/share/classes/java/rmi/activation/ActivationSystem.java b/jdk/src/share/classes/java/rmi/activation/ActivationSystem.java index 25b218804c5..ddcb4da1d5d 100644 --- a/jdk/src/share/classes/java/rmi/activation/ActivationSystem.java +++ b/jdk/src/share/classes/java/rmi/activation/ActivationSystem.java @@ -61,7 +61,7 @@ public interface ActivationSystem extends Remote { * receives an activate request for a specific identifier, it * looks up the activation descriptor (registered previously) for * the specified identifier and uses that information to activate - * the object.

    + * the object. * * @param desc the object's activation descriptor * @return the activation id that can be used to activate the object diff --git a/jdk/src/share/classes/java/rmi/activation/Activator.java b/jdk/src/share/classes/java/rmi/activation/Activator.java index 9dae603a1bb..18fd82ca3a1 100644 --- a/jdk/src/share/classes/java/rmi/activation/Activator.java +++ b/jdk/src/share/classes/java/rmi/activation/Activator.java @@ -53,7 +53,7 @@ import java.rmi.activation.UnknownObjectException; * * The activator is responsible for monitoring and detecting when * activation groups fail so that it can remove stale remote references - * to groups and active object's within those groups.

    + * to groups and active object's within those groups. * * @author Ann Wollrath * @see ActivationInstantiator @@ -95,7 +95,7 @@ public interface Activator extends Remote { * collection for that object. If the activator kept a strong * reference to the remote object, the activator would then * prevent the object from being garbage collected under the - * normal distributed garbage collection mechanism.

    + * normal distributed garbage collection mechanism. * * @param id the activation identifier for the object being activated * @param force if true, the activator contacts the group to obtain diff --git a/jdk/src/share/classes/java/time/format/DateTimeFormatterBuilder.java b/jdk/src/share/classes/java/time/format/DateTimeFormatterBuilder.java index f04d59b2303..0a167e45c26 100644 --- a/jdk/src/share/classes/java/time/format/DateTimeFormatterBuilder.java +++ b/jdk/src/share/classes/java/time/format/DateTimeFormatterBuilder.java @@ -939,7 +939,7 @@ public final class DateTimeFormatterBuilder { * During parsing, the offset is parsed using the format defined above. * If the offset cannot be parsed then an exception is thrown unless the * section of the formatter is optional. - *

    + * * @param style the format style to use, not null * @return this, for chaining, not null * @throws IllegalArgumentException if style is neither {@link TextStyle#FULL