+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:
/**
* 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
}
/**
- * 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
}
/**
- * 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
*