DESCRIPTION: Add reference to inet_addr(3) for dotted notation.

SEE ALSO: add inet(3).
Added BUGS section noting that gethostbyname() does not
recognize hexadecimal components in dotted address strings;
See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=482973

diff --git a/man3/gethostbyname.3 b/man3/gethostbyname.3
index a1f6a956aff8ef437d6dff3a68472f9517a2a90c..513f44b63e9167ccfe387b391df5aa3767f833c7 100644 (file)
--- a/man3/gethostbyname.3
+++ b/man3/gethostbyname.3
@@ -33,7 +33,7 @@
 .\" Modified 2002-08-05, Michael Kerrisk
 .\" Modified 2004-10-31, Andries Brouwer
 .\"
-.TH GETHOSTBYNAME 3 2007-10-16 "" "Linux Programmer's Manual"
+.TH GETHOSTBYNAME 3 2008-06-19 "" "Linux Programmer's Manual"
 .SH NAME
 gethostbyname, gethostbyaddr, sethostent, gethostent, endhostent,
 h_errno,
@@ -114,7 +114,8 @@ for the given host
 .IR name .
 Here
 .I name
-is either a host name, or an IPv4 address in standard dot notation,
+is either a host name, or an IPv4 address in standard dot notation (as for
+.BR inet_addr (3)),
 or an IPv6 address in colon (and possibly dot) notation.
 (See RFC\ 1884 for the description of IPv6 addresses.)
 If
@@ -398,11 +399,17 @@ The global variable
 is not modified, but the address of a variable in which to store error numbers
 is passed in
 .IR h_errnop .
+.SH BUGS
+.BR gethostbyname ()
+does not recognize components of a dotted IPv4 address string
+that are expressed in hexadecimal.
+.\" http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=482973
 .SH "SEE ALSO"
 .BR getaddrinfo (3),
 .\" .BR getipnodebyaddr (3),
 .\" .BR getipnodebyname (3),
 .BR getnameinfo (3),
+.BR inet (3),
 .BR inet_ntop (3),
 .BR inet_pton (3),
 .BR resolver (3),