From b6db783eedb1e7d2b03ea0f16ca525eda211e752 Mon Sep 17 00:00:00 2001 From: stomar Date: Tue, 7 Nov 2017 20:13:00 +0000 Subject: socket.c,tcpsocket.c: improve deprecation notices * ext/socket/socket.c: [DOC] fix grammar in deprecation notices. * ext/socket/tcpsocket.c: [DOC] ditto. git-svn-id: svn+ssh://ci.ruby-lang.org/ruby/trunk@60709 b2dd03c8-39d4-4d8f-98ff-823fe69b080e --- ext/socket/socket.c | 16 ++++++++-------- ext/socket/tcpsocket.c | 8 ++++---- 2 files changed, 12 insertions(+), 12 deletions(-) (limited to 'ext') diff --git a/ext/socket/socket.c b/ext/socket/socket.c index 8cb461cbf3..8846770097 100644 --- a/ext/socket/socket.c +++ b/ext/socket/socket.c @@ -984,13 +984,13 @@ sock_sockaddr(struct sockaddr *addr, socklen_t len) * Socket.gethostbyname(hostname) => [official_hostname, alias_hostnames, address_family, *address_list] * * Use Addrinfo.getaddrinfo instead. - * This method is deprecated since following reasons: + * This method is deprecated for the following reasons: * - * - The 3rd element of result is the address family of the first address. - * The address families of rest addresses are not returned. + * - The 3rd element of the result is the address family of the first address. + * The address families of the rest of the addresses are not returned. * - Uncommon address representation: * 4/16-bytes binary string to represent IPv4/IPv6 address. - * - gethostbyname() is may take long time and it may block other threads. + * - gethostbyname() may take a long time and it may block other threads. * (GVL cannot be released since gethostbyname() is not thread safe.) * - This method uses gethostbyname() function already removed from POSIX. * @@ -1012,11 +1012,11 @@ sock_s_gethostbyname(VALUE obj, VALUE host) * Socket.gethostbyaddr(address_string [, address_family]) => hostent * * Use Addrinfo#getnameinfo instead. - * This method is deprecated since following reasons: + * This method is deprecated for the following reasons: * * - Uncommon address representation: * 4/16-bytes binary string to represent IPv4/IPv6 address. - * - gethostbyaddr() is may take long time and it may block other threads. + * - gethostbyaddr() may take a long time and it may block other threads. * (GVL cannot be released since gethostbyname() is not thread safe.) * - This method uses gethostbyname() function already removed from POSIX. * @@ -1164,8 +1164,8 @@ sock_s_getservbyport(int argc, VALUE *argv) * * Obtains address information for _nodename_:_servname_. * - * Note that Addrinfo.getaddrinfo provides same functionality in - * object oriented style. + * Note that Addrinfo.getaddrinfo provides the same functionality in + * an object oriented style. * * _family_ should be an address family such as: :INET, :INET6, etc. * diff --git a/ext/socket/tcpsocket.c b/ext/socket/tcpsocket.c index 012a8f5a64..29a3eda45f 100644 --- a/ext/socket/tcpsocket.c +++ b/ext/socket/tcpsocket.c @@ -42,11 +42,11 @@ tcp_sockaddr(struct sockaddr *addr, socklen_t len) * TCPSocket.gethostbyname(hostname) => [official_hostname, alias_hostnames, address_family, *address_list] * * Use Addrinfo.getaddrinfo instead. - * This method is deprecated since following reasons: + * This method is deprecated for the following reasons: * - * - The 3rd element of result is the address family of the first address. - * The address families of rest addresses are not returned. - * - gethostbyname() is may take long time and it may block other threads. + * - The 3rd element of the result is the address family of the first address. + * The address families of the rest of the addresses are not returned. + * - gethostbyname() may take a long time and it may block other threads. * (GVL cannot be released since gethostbyname() is not thread safe.) * - This method uses gethostbyname() function already removed from POSIX. * -- cgit v1.2.3