[cp-patches] Patch: FYI: core javadoc fixes

[Tom Tromey]

I'm checking this in.

This fixes some javadoc buglets in the "core".
We're down to 13 warnings in java.{lang,io,net,util}; 11 of those
have to do with classes that are only available on the generics
branch.

Tom

2005-10-02  Tom Tromey  <address@hidden>

        * java/net/URLStreamHandler.java (hostsEqual): Javadoc fix.
        * java/net/URLClassLoader.java (definePackage): Javadoc fixes.
        * java/net/Inet4Address.java (Inet4Address): Javadoc fix.
        * java/net/Socket.java (getLocalAddress): Javadoc fix.
        * java/net/DatagramSocket.java (connect): Javadoc fix.

Index: java/net/DatagramSocket.java
===================================================================
RCS file: /cvsroot/classpath/classpath/java/net/DatagramSocket.java,v
retrieving revision 1.46
diff -u -r1.46 DatagramSocket.java
--- java/net/DatagramSocket.java        7 Aug 2005 20:04:59 -0000       1.46
+++ java/net/DatagramSocket.java        2 Oct 2005 22:52:26 -0000
@@ -484,7 +484,6 @@
    * @param address The address to connect this socket to.
    * @param port The port to connect this socket to.
    *
-   * @exception SocketException If an error occurs.
    * @exception IllegalArgumentException If address or port are invalid.
    * @exception SecurityException If the caller is not allowed to send
    * datagrams to or receive from this address and port.
Index: java/net/Inet4Address.java
===================================================================
RCS file: /cvsroot/classpath/classpath/java/net/Inet4Address.java,v
retrieving revision 1.17
diff -u -r1.17 Inet4Address.java
--- java/net/Inet4Address.java  26 Jul 2005 22:45:47 -0000      1.17
+++ java/net/Inet4Address.java  2 Oct 2005 22:52:26 -0000
@@ -70,7 +70,7 @@
    * only by static methods in this class.
    *
    * @param addr The IP number of this address as an array of bytes
-   * @param hostname The hostname of this IP address.
+   * @param host The hostname of this IP address.
    */
   Inet4Address(byte[] addr, String host)
   {
Index: java/net/Socket.java
===================================================================
RCS file: /cvsroot/classpath/classpath/java/net/Socket.java,v
retrieving revision 1.51
diff -u -r1.51 Socket.java
--- java/net/Socket.java        2 Jul 2005 20:32:39 -0000       1.51
+++ java/net/Socket.java        2 Oct 2005 22:52:27 -0000
@@ -481,7 +481,7 @@
   /**
    * Returns the local address to which this socket is bound.  If this socket
    * is not connected, then a wildcard address, for which
-   * @see isAnyLocalAddress() is <code>true</code>, is returned.
+   * @see InetAddress#isAnyLocalAddress() is <code>true</code>, is returned.
    *
    * @return The local address
    *
Index: java/net/URLClassLoader.java
===================================================================
RCS file: /cvsroot/classpath/classpath/java/net/URLClassLoader.java,v
retrieving revision 1.39
diff -u -r1.39 URLClassLoader.java
--- java/net/URLClassLoader.java        1 Oct 2005 11:04:11 -0000       1.39
+++ java/net/URLClassLoader.java        2 Oct 2005 22:52:27 -0000
@@ -785,13 +785,13 @@
    * package is sealed. If the Manifest indicates that the package is sealed
    * then the Package will be sealed with respect to the supplied URL.
    *
-   * @exception IllegalArgumentException If this package name already exists
-   * in this class loader
    * @param name The name of the package
    * @param manifest The manifest describing the specification,
    * implementation and sealing details of the package
    * @param url the code source url to seal the package
    * @return the defined Package
+   * @throws IllegalArgumentException If this package name already exists
+   * in this class loader
    */
   protected Package definePackage(String name, Manifest manifest, URL url)
     throws IllegalArgumentException
Index: java/net/URLStreamHandler.java
===================================================================
RCS file: /cvsroot/classpath/classpath/java/net/URLStreamHandler.java,v
retrieving revision 1.34
diff -u -r1.34 URLStreamHandler.java
--- java/net/URLStreamHandler.java      15 Sep 2005 14:42:36 -0000      1.34
+++ java/net/URLStreamHandler.java      2 Oct 2005 22:52:27 -0000
@@ -411,8 +411,6 @@
    * @param url2 The second URL.
    *
    * @return True if both URLs contain the same host.
-   *
-   * @exception UnknownHostException If an unknown host is found
    */
   protected boolean hostsEqual(URL url1, URL url2)
   {