[Patch] java.net.InetAddress and java.net.ServerSocket

[Michael Koch]

Hi list,


I just commited the attached patch to merge javadocs for
java.net.InetAddress and java.net.ServerSocket from GNU classpath.


Michael


2005-04-19  Michael Koch  <konqueror@gmx.de>

	* java/net/InetAddress.java
	(InetAddress): Fixed javadoc comment.
	(aton): Likewise.
	(lookup): Added javadoc.
	(getFamily): Likewise.
	* java/net/ServerSocket.java
	(getChannel): Improved javadoc comment.

-------------- next part --------------
Index: java/net/InetAddress.java
===================================================================
RCS file: /cvs/gcc/gcc/libjava/java/net/InetAddress.java,v
retrieving revision 1.36
diff -u -r1.36 InetAddress.java
--- java/net/InetAddress.java	3 Feb 2005 17:44:20 -0000	1.36
+++ java/net/InetAddress.java	19 Apr 2005 18:49:26 -0000
@@ -115,7 +115,7 @@
 
   /**
    * Initializes this object's addr instance variable from the passed in
-   * int array.  Note that this constructor is protected and is called
+   * byte array.  Note that this constructor is protected and is called
    * only by static methods in this class.
    *
    * @param ipaddr The IP number of this address as an array of bytes
@@ -541,15 +541,33 @@
   }
 
   /**
-   * If host is a valid numeric IP address, return the numeric address.
+   * If hostname  is a valid numeric IP address, return the numeric address.
    * Otherwise, return null.
+   *
+   * @param hostname the name of the host
    */
-  private static native byte[] aton (String host);
+  private static native byte[] aton(String hostname);
 
+  /**
+   * Looks up all addresses of a given host.
+   *
+   * @param hostname the host to lookup
+   * @param ipaddr FIXME
+   * @param all FIXME
+   *
+   * @return an array with all found addresses
+   */
   private static native InetAddress[] lookup (String hostname,
-		                              InetAddress addr, boolean all);
+		                              InetAddress ipaddr, boolean all);
 
-  private static native int getFamily (byte[] address);
+  /**
+   * Returns tha family type of an IP address.
+   *
+   * @param addr the IP address
+   *
+   * @return the family
+   */
+  private static native int getFamily (byte[] ipaddr);
 
   /**
    * Returns an InetAddress object representing the IP address of the given
Index: java/net/ServerSocket.java
===================================================================
RCS file: /cvs/gcc/gcc/libjava/java/net/ServerSocket.java,v
retrieving revision 1.41
diff -u -r1.41 ServerSocket.java
--- java/net/ServerSocket.java	17 Oct 2004 08:29:54 -0000	1.41
+++ java/net/ServerSocket.java	19 Apr 2005 18:49:26 -0000
@@ -399,11 +399,11 @@
   }
 
   /**
-   * Returns the unique ServerSocketChannel object
+   * Returns the unique <code>ServerSocketChannel</code> object
    * associated with this socket, if any.
    *
-   * The socket only has a ServerSocketChannel if its created
-   * by ServerSocketChannel.open.
+   * <p>The socket only has a <code>ServerSocketChannel</code> if its created
+   * by <code>ServerSocketChannel.open()</code>.</p>
    *
    * @return the associated socket channel, null if none exists
    *