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>
--- 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