kotovalexarian-likes-github/ruby--ruby
1
0
Fork 0
mirror of https://github.com/ruby/ruby.git synced 2022-11-09 12:17:21 -05:00
Code Releases Activity

socket.c,tcpsocket.c: improve deprecation notices

Browse source 
* 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
This commit is contained in:
stomar 2017-11-07 20:13:00 +00:00
parent 995fd6d720
commit b6db783eed
2 changed files with 12 additions and 12 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

16
ext/socket/socket.c
View file

@ -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.
*

8
ext/socket/tcpsocket.c
View file

@ -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.
*