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.

From-SVN: r98419

libjava/ChangeLog

+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.
+
 2005-04-19  Andrew John Hughes  <gnu_andrew@member.fsf.org>
 
 	* gnu/xml/dom/html2/DomHTMLParser.java:

libjava/java/net/InetAddress.java

@@ -115,7 +115,7 @@ public class InetAddress implements Serializable
 
   /**
    * 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 @@ public class InetAddress implements Serializable
   }
 
   /**
-   * 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

libjava/java/net/ServerSocket.java

@@ -399,11 +399,11 @@ public class ServerSocket
   }
 
   /**
-   * 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
    *