8039172: Tidy warnings cleanup for java.net, java.math, java.time, java.rmi
authoryan
Fri, 04 Apr 2014 19:32:53 +0400
changeset 23720 7d5147c21927
parent 23719 7c9e2106906c
child 23721 83da5b498504
child 24161 29dc629ec823
8039172: Tidy warnings cleanup for java.net, java.math, java.time, java.rmi Reviewed-by: alanb, lancea Contributed-by: Alexander Stepanov <alexander.v.stepanov@oracle.com>
jdk/src/share/classes/java/net/DatagramSocket.java
jdk/src/share/classes/java/net/InetSocketAddress.java
jdk/src/share/classes/java/net/ServerSocket.java
jdk/src/share/classes/java/net/Socket.java
jdk/src/share/classes/java/net/SocketOptions.java
jdk/src/share/classes/java/net/SocketPermission.java
jdk/src/share/classes/java/net/URL.java
jdk/src/share/classes/java/net/URLClassLoader.java
jdk/src/share/classes/java/net/doc-files/net-properties.html
jdk/src/share/classes/java/rmi/activation/ActivationGroup.java
jdk/src/share/classes/java/rmi/activation/ActivationGroupDesc.java
jdk/src/share/classes/java/rmi/activation/ActivationMonitor.java
jdk/src/share/classes/java/rmi/activation/ActivationSystem.java
jdk/src/share/classes/java/rmi/activation/Activator.java
jdk/src/share/classes/java/time/format/DateTimeFormatterBuilder.java
--- a/jdk/src/share/classes/java/net/DatagramSocket.java	Fri Apr 04 19:27:17 2014 +0400
+++ b/jdk/src/share/classes/java/net/DatagramSocket.java	Fri Apr 04 19:32:53 2014 +0400
@@ -104,7 +104,7 @@
     /**
      * Connects this socket to a remote socket address (IP address + port number).
      * Binds socket if not already bound.
-     * <p>
+     *
      * @param   address The remote address.
      * @param   port    The remote port
      * @throws  SocketException if binding the socket fails.
@@ -338,7 +338,7 @@
      * <p>
      * If the address is {@code null}, then the system will pick up
      * an ephemeral port and a valid local address to bind the socket.
-     *<p>
+     *
      * @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 @@
      *              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
      */
--- a/jdk/src/share/classes/java/net/InetSocketAddress.java	Fri Apr 04 19:27:17 2014 +0400
+++ b/jdk/src/share/classes/java/net/InetSocketAddress.java	Fri Apr 04 19:32:53 2014 +0400
@@ -157,7 +157,7 @@
      * 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.
-     * <p>
+     *
      * @param   port    The port number
      * @throws IllegalArgumentException if the port parameter is outside the specified
      * range of valid port values.
@@ -175,7 +175,7 @@
      * ephemeral port in a {@code bind} operation.
      * <P>
      * A {@code null} address will assign the <i>wildcard</i> address.
-     * <p>
+     *
      * @param   addr    The IP address
      * @param   port    The port number
      * @throws IllegalArgumentException if the port parameter is outside the specified
@@ -202,7 +202,7 @@
      * 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.
-     * <P>
+     *
      * @param   hostname the Host name
      * @param   port    The port number
      * @throws IllegalArgumentException if the port parameter is outside the range
@@ -239,7 +239,7 @@
      * 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.
-     * <P>
+     *
      * @param   host    the Host name
      * @param   port    The port number
      * @throws IllegalArgumentException if the port parameter is outside
--- a/jdk/src/share/classes/java/net/ServerSocket.java	Fri Apr 04 19:27:17 2014 +0400
+++ b/jdk/src/share/classes/java/net/ServerSocket.java	Fri Apr 04 19:32:53 2014 +0400
@@ -157,7 +157,6 @@
      * 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.
-     * <P>
      *
      * @param      port     the port number, or {@code 0} to use a port
      *                      number that is automatically allocated.
@@ -206,7 +205,7 @@
      * 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.
-     * <P>
+     *
      * @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 @@
      * <p>
      * If the address is {@code null}, then the system will pick up
      * an ephemeral port and a valid local address to bind the socket.
-     * <p>
+     *
      * @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.
--- a/jdk/src/share/classes/java/net/Socket.java	Fri Apr 04 19:27:17 2014 +0400
+++ b/jdk/src/share/classes/java/net/Socket.java	Fri Apr 04 19:32:53 2014 +0400
@@ -153,7 +153,7 @@
     /**
      * Creates an unconnected Socket with a user-specified
      * SocketImpl.
-     * <P>
+     *
      * @param impl an instance of a <B>SocketImpl</B>
      * the subclass wishes to use on the Socket.
      *
@@ -1245,7 +1245,7 @@
      * <ol>
      * <li>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.<p></li>
+     * is bound to a local address.</li>
      * <li>For client sockets, setReceiveBufferSize() must be called before
      * connecting the socket to its remote peer.</li></ol>
      * @param size the size to which to set the receive buffer
--- a/jdk/src/share/classes/java/net/SocketOptions.java	Fri Apr 04 19:27:17 2014 +0400
+++ b/jdk/src/share/classes/java/net/SocketOptions.java	Fri Apr 04 19:32:53 2014 +0400
@@ -38,7 +38,7 @@
  * DatagramSocketImpl, <B>you won't use these directly.</B> There are
  * type-safe methods to get/set each of these options in Socket, ServerSocket,
  * DatagramSocket and MulticastSocket.
- * <P>
+ *
  * @author David Brown
  */
 
--- a/jdk/src/share/classes/java/net/SocketPermission.java	Fri Apr 04 19:27:17 2014 +0400
+++ b/jdk/src/share/classes/java/net/SocketPermission.java	Fri Apr 04 19:32:53 2014 +0400
@@ -1001,7 +1001,7 @@
 
     /**
      * Checks two SocketPermission objects for equality.
-     * <P>
+     *
      * @param obj the object to test for equality with this object.
      *
      * @return true if <i>obj</i> is a SocketPermission, and has the
--- a/jdk/src/share/classes/java/net/URL.java	Fri Apr 04 19:27:17 2014 +0400
+++ b/jdk/src/share/classes/java/net/URL.java	Fri Apr 04 19:32:53 2014 +0400
@@ -867,7 +867,7 @@
      * Creates an integer suitable for hash table indexing.<p>
      *
      * The hash code is based upon all the URL components relevant for URL
-     * comparison. As such, this operation is a blocking operation.<p>
+     * comparison. As such, this operation is a blocking operation.
      *
      * @return  a hash code for this {@code URL}.
      */
--- a/jdk/src/share/classes/java/net/URLClassLoader.java	Fri Apr 04 19:27:17 2014 +0400
+++ b/jdk/src/share/classes/java/net/URLClassLoader.java	Fri Apr 04 19:32:53 2014 +0400
@@ -271,7 +271,7 @@
     * by catching {@link IOException}s internally. Unchecked exceptions
     * and errors are not caught. Calling close on an already closed
     * loader has no effect.
-    * <p>
+    *
     * @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
--- a/jdk/src/share/classes/java/net/doc-files/net-properties.html	Fri Apr 04 19:27:17 2014 +0400
+++ b/jdk/src/share/classes/java/net/doc-files/net-properties.html	Fri Apr 04 19:32:53 2014 +0400
@@ -35,7 +35,8 @@
 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 <a href="../../lang/System.html#setProperty(java.lang.String, java.lang.String)">System.setProperty()</a> API. The purpose of this document is to list
+the <a href="../../lang/System.html#setProperty(java.lang.String,%20java.lang.String)">System.setProperty()</a> API. 
+The purpose of this document is to list
 and detail all of these properties.</P>
 <P>If there is no special note, a property value is checked every time it is used.</P>
 <a name="Ipv4IPv6"></a>
--- a/jdk/src/share/classes/java/rmi/activation/ActivationGroup.java	Fri Apr 04 19:27:17 2014 +0400
+++ b/jdk/src/share/classes/java/rmi/activation/ActivationGroup.java	Fri Apr 04 19:32:53 2014 +0400
@@ -172,7 +172,7 @@
      *
      * <p>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. <p>
+     * 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
--- a/jdk/src/share/classes/java/rmi/activation/ActivationGroupDesc.java	Fri Apr 04 19:27:17 2014 +0400
+++ b/jdk/src/share/classes/java/rmi/activation/ActivationGroupDesc.java	Fri Apr 04 19:32:53 2014 +0400
@@ -49,7 +49,7 @@
  *
  * <li> the group's <code>ActivationGroupID</code>, and
  * <li> the group's initialization data (in a
- * <code>java.rmi.MarshalledObject</code>)</ul><p>
+ * <code>java.rmi.MarshalledObject</code>)</ul>
  *
  * @author      Ann Wollrath
  * @since       1.2
--- a/jdk/src/share/classes/java/rmi/activation/ActivationMonitor.java	Fri Apr 04 19:27:17 2014 +0400
+++ b/jdk/src/share/classes/java/rmi/activation/ActivationMonitor.java	Fri Apr 04 19:32:53 2014 +0400
@@ -63,7 +63,7 @@
      * reference associated with <code>id</code> as a stale reference.
      * Since the reference is considered stale, a subsequent
      * <code>activate</code> call for the same activation identifier
-     * results in re-activating the remote object.<p>
+     * results in re-activating the remote object.
      *
      * @param id the object's activation identifier
      * @exception UnknownObjectException if object is unknown
--- a/jdk/src/share/classes/java/rmi/activation/ActivationSystem.java	Fri Apr 04 19:27:17 2014 +0400
+++ b/jdk/src/share/classes/java/rmi/activation/ActivationSystem.java	Fri Apr 04 19:32:53 2014 +0400
@@ -61,7 +61,7 @@
      * receives an <code>activate</code> 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. <p>
+     * the object.
      *
      * @param desc the object's activation descriptor
      * @return the activation id that can be used to activate the object
--- a/jdk/src/share/classes/java/rmi/activation/Activator.java	Fri Apr 04 19:27:17 2014 +0400
+++ b/jdk/src/share/classes/java/rmi/activation/Activator.java	Fri Apr 04 19:32:53 2014 +0400
@@ -53,7 +53,7 @@
  *
  * 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.<p>
+ * to groups and active object's within those groups.
  *
  * @author      Ann Wollrath
  * @see         ActivationInstantiator
@@ -95,7 +95,7 @@
      * 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. <p>
+     * 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
--- a/jdk/src/share/classes/java/time/format/DateTimeFormatterBuilder.java	Fri Apr 04 19:27:17 2014 +0400
+++ b/jdk/src/share/classes/java/time/format/DateTimeFormatterBuilder.java	Fri Apr 04 19:32:53 2014 +0400
@@ -939,7 +939,7 @@
      * 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.
-     * <p>
+     *
      * @param style  the format style to use, not null
      * @return this, for chaining, not null
      * @throws IllegalArgumentException if style is neither {@link TextStyle#FULL