1 files changed, 20 insertions, 27 deletions

diff --git a/src/lib/libc/net/getaddrinfo.3 b/src/lib/libc/net/getaddrinfo.3
index cc5eaa4182..4fba44bb73 100644
--- a/src/lib/libc/net/getaddrinfo.3
+++ b/src/lib/libc/net/getaddrinfo.3
@@ -1,4 +1,4 @@
-.\"     $OpenBSD: getaddrinfo.3,v 1.34 2004/12/21 01:01:47 itojun Exp $
+.\"     $OpenBSD: getaddrinfo.3,v 1.35 2004/12/21 03:40:31 jaredy Exp $
 .\"
 .\" Copyright (C) 2004  Internet Systems Consortium, Inc. ("ISC")
 .\" Copyright (C) 2000, 2001  Internet Software Consortium.
@@ -27,7 +27,8 @@
 .Fd #include <sys/socket.h>
 .Fd #include <netdb.h>
 .Ft int
-.Fn getaddrinfo "const char *hostname" "const char *servname" "const struct addrinfo *hints" "struct addrinfo **res"
+.Fn getaddrinfo "const char *hostname" "const char *servname" \
+    "const struct addrinfo *hints" "struct addrinfo **res"
 .Ft void
 .Fn freeaddrinfo "struct addrinfo *ai"
 .Sh DESCRIPTION
@@ -98,7 +99,7 @@ operating system.
 .It Fa ai_socktype
 Denotes the type of socket that is wanted:
 .Dv SOCK_STREAM ,
-.Dv SOCK_DGRAM
+.Dv SOCK_DGRAM ,
 or
 .Dv SOCK_RAW .
 When
@@ -140,11 +141,11 @@ and no name resolution should be attempted.
 If the
 .Dv AI_PASSIVE
 bit is set it indicates that the returned socket address structure
-is intended for used in a call to
+is intended for use in a call to
 .Xr bind 2 .
 In this case, if the
 .Fa hostname
-argument is a the null pointer, then the IP address portion of the
+argument is the null pointer, then the IP address portion of the
 socket address structure will be set to
 .Dv INADDR_ANY
 for an IPv4 address or
@@ -158,7 +159,7 @@ for use in a call to
 .Xr connect 2
 for a connection-oriented protocol or
 .Xr connect 2 ,
-.Xr sendto 2
+.Xr sendto 2 ,
 or
 .Xr sendmsg 2
 if a connectionless protocol was chosen.
@@ -167,7 +168,7 @@ The
 address portion of the socket address structure will be set to the
 loopback address if
 .Fa hostname
-is the null pointer and the
+is the null pointer and
 .Dv AI_PASSIVE
 is not set.
 .El
@@ -203,7 +204,7 @@ The list can be traversed by following the
 pointer in each
 .Li addrinfo
 structure until a null pointer is encountered.
-The three members,
+The three members
 .Fa ai_family,
 .Fa ai_socktype,
 and
@@ -221,16 +222,17 @@ member points to a filled-in socket address structure of length
 .Pp
 This implementation of
 .Fn getaddrinfo
-allows experimental numeric IPv6 address notation with scope identifier.
+allows experimental numeric IPv6 address notation with scope identifiers.
 By appending the percent character and scope identifier to addresses,
-you can fill the
+one can fill the
 .Li sin6_scope_id
 field for addresses.
-This would make management of scoped address easier,
-and allows cut-and-paste input of scoped address.
+This would make management of scoped addresses easier
+and allows cut-and-paste input of scoped addresses.
 .Pp
 At this moment the code supports only link-local addresses with the format.
-Scope identifier is hardcoded to the name of the hardware interface associated
+The scope identifier is hardcoded to the name of the hardware interface
+associated
 with the link
 .Po
 such as
@@ -276,31 +278,22 @@ structure created by a call to
 returns zero on success or one of the error codes listed in
 .Xr gai_strerror 3
 if an error occurs.
-If both
-.Fa hostname
-and
-.Fa servname
-are
-.Dv NULL ,
-.Fn getaddrinfo
-returns
-.Dv EAI_NONAME .
 .Sh EXAMPLES
 The following code tries to connect to
 .Dq Li www.kame.net
 service
-.Dq Li http .
-via stream socket.
+.Dq Li http
+via a stream socket.
 It loops through all the addresses available, regardless of address family.
-If the destination resolves to an IPv4 address, it will use
+If the destination resolves to an IPv4 address, it will use an
 .Dv AF_INET
 socket.
-Similarly, if it resolves to IPv6,
+Similarly, if it resolves to IPv6, an
 .Dv AF_INET6
 socket is used.
 Observe that there is no hardcoded reference to a particular address family.
 The code works even if
-.Nm getaddrinfo
+.Fn getaddrinfo
 returns addresses that are not IPv4/v6.
 .Bd -literal -offset indent
 struct addrinfo hints, *res, *res0;