rbs 2.8.4 → 3.8.1

data/stdlib/securerandom/0/securerandom.rbs

@@ -14,7 +14,6 @@
 # *   /dev/urandom
 # *   Win32
 #
-#
 # SecureRandom is extended by the Random::Formatter module which defines the
 # following methods:
 #
@@ -29,7 +28,6 @@
 # *   urlsafe_base64
 # *   uuid
 #
-#
 # These methods are usable as class methods of SecureRandom such as
 # `SecureRandom.hex`.
 #
@@ -39,6 +37,13 @@
 module SecureRandom
   extend Random::Formatter
 
+  # <!--
+  #   rdoc-file=lib/securerandom.rb
+  #   - alphanumeric(n = nil, chars: ALPHANUMERIC)
+  # -->
+  # Compatibility methods for Ruby 3.2, we can remove this after dropping to
+  # support Ruby 3.2
+  #
   def self.alphanumeric: (?Integer?) -> String
 
   def self.base64: (?Integer?) -> String

data/stdlib/shellwords/0/shellwords.rbs

@@ -4,9 +4,11 @@
 # This module manipulates strings according to the word parsing rules of the
 # UNIX Bourne shell.
 #
-# The shellwords() function was originally a port of shellwords.pl, but modified
-# to conform to the Shell & Utilities volume of the IEEE Std 1003.1-2008, 2016
-# Edition [1].
+# The `shellwords()` function was originally a port of shellwords.pl, but
+# modified to conform to [the Shell & Utilities volume of the IEEE Std
+# 1003.1-2008, 2016
+# Edition](http://pubs.opengroup.org/onlinepubs/9699919799/utilities/contents.ht
+# ml)
 #
 # ### Usage
 #
@@ -58,17 +60,9 @@
 # *   Wakou Aoyama
 # *   Akinori MUSHA <knu@iDaemons.org>
 #
-#
 # ### Contact
 # *   Akinori MUSHA <knu@iDaemons.org> (current maintainer)
 #
-#
-# ### Resources
-#
-# 1: [IEEE Std 1003.1-2008, 2016 Edition, the Shell & Utilities
-# volume](http://pubs.opengroup.org/onlinepubs/9699919799/utilities/contents.htm
-# l)
-#
 module Shellwords
   # <!--
   #   rdoc-file=lib/shellwords.rb
@@ -77,6 +71,8 @@ module Shellwords
   # Escapes a string so that it can be safely used in a Bourne shell command line.
   #  `str` can be a non-string object that responds to `to_s`.
   #
+  # `str` must not contain NUL characters because of nature of `exec` system call.
+  #
   # Note that a resulted string should be used unquoted and is not intended for
   # use in double quotes nor in single quotes.
   #
@@ -114,7 +110,7 @@ module Shellwords
   #
   # All elements are joined into a single string with fields separated by a space,
   # where each element is escaped for the Bourne shell and stringified using
-  # `to_s`.
+  # `to_s`. See also Shellwords.shellescape.
   #
   #     ary = ["There's", "a", "time", "and", "place", "for", "everything"]
   #     argv = Shellwords.join(ary)
@@ -142,6 +138,9 @@ module Shellwords
   #     argv = Shellwords.split('here are "two words"')
   #     argv #=> ["here", "are", "two words"]
   #
+  # `line` must not contain NUL characters because of nature of `exec` system
+  # call.
+  #
   # Note, however, that this is not a command line parser.  Shell metacharacters
   # except for the single and double quotes and backslash are not treated as such.
   #

data/stdlib/singleton/0/singleton.rbs

@@ -53,7 +53,6 @@
 # *   Overriding Klass#clone and Klass#dup to raise TypeErrors to prevent
 #     cloning or duping.
 #
-#
 # ## Singleton and Marshal
 #
 # By default Singleton's #_dump(depth) returns the empty string. Marshalling by
@@ -101,8 +100,6 @@ module Singleton
   #
   def self.instance: () -> instance
 
-  public
-
   # <!--
   #   rdoc-file=lib/singleton.rb
   #   - _dump(depth = -1)

data/stdlib/socket/0/addrinfo.rbs

@@ -1,3 +1,7 @@
+# <!-- rdoc-file=ext/socket/raddrinfo.c -->
+# The Addrinfo class maps `struct addrinfo` to ruby.  This structure identifies
+# an Internet host and a service.
+#
 class Addrinfo
   # <!--
   #   rdoc-file=ext/socket/lib/socket.rb
@@ -106,8 +110,6 @@ class Addrinfo
   #
   def self.unix: (String path, ?Symbol socktype) -> Addrinfo
 
-  public
-
   # <!--
   #   rdoc-file=ext/socket/raddrinfo.c
   #   - addrinfo.afamily => integer
@@ -403,7 +405,7 @@ class Addrinfo
   #   rdoc-file=ext/socket/raddrinfo.c
   #   - ipv6_linklocal?()
   # -->
-  # Returns true for IPv6 link local address (ff80::/10). It returns false
+  # Returns true for IPv6 link local address (fe80::/10). It returns false
   # otherwise.
   #
   def ipv6_linklocal?: () -> bool
@@ -474,7 +476,7 @@ class Addrinfo
   #   rdoc-file=ext/socket/raddrinfo.c
   #   - ipv6_sitelocal?()
   # -->
-  # Returns true for IPv6 site local address (ffc0::/10). It returns false
+  # Returns true for IPv6 site local address (fec0::/10). It returns false
   # otherwise.
   #
   def ipv6_sitelocal?: () -> bool
@@ -632,20 +634,13 @@ class Addrinfo
   # sockaddr as generated by Socket.sockaddr_in or Socket.unpack_sockaddr_un.
   #
   # sockaddr examples:
-  #
-  #     "AF_INET", 46102, "localhost.localdomain", "127.0.0.1"
-  # :
-  #
-  #     "AF_INET6", 42304, "ip6-localhost", "::1"
-  # :
-  #
-  #     "AF_UNIX", "/tmp/sock"
-  # :
-  # *   Socket.sockaddr_in("smtp", "2001:DB8::1")
-  # *   Socket.sockaddr_in(80, "172.18.22.42")
-  # *   Socket.sockaddr_in(80, "www.ruby-lang.org")
-  # *   Socket.sockaddr_un("/tmp/sock")
-  #
+  # *   `["AF_INET", 46102, "localhost.localdomain", "127.0.0.1"]`
+  # *   `["AF_INET6", 42304, "ip6-localhost", "::1"]`
+  # *   `["AF_UNIX", "/tmp/sock"]`
+  # *   `Socket.sockaddr_in("smtp", "2001:DB8::1")`
+  # *   `Socket.sockaddr_in(80, "172.18.22.42")`
+  # *   `Socket.sockaddr_in(80, "www.ruby-lang.org")`
+  # *   `Socket.sockaddr_un("/tmp/sock")`
   #
   # In an AF_INET/AF_INET6 sockaddr array, the 4th element, numeric IP address, is
   # used to construct socket address in the Addrinfo instance. If the 3rd element,

data/stdlib/socket/0/basic_socket.rbs

@@ -41,8 +41,6 @@ class BasicSocket < IO
   #
   def self.for_fd: (Integer fileno) -> BasicSocket
 
-  public
-
   # <!--
   #   rdoc-file=ext/socket/basicsocket.c
   #   - basicsocket.close_read => nil
@@ -84,7 +82,6 @@ class BasicSocket < IO
   #     (127.0.0.1).
   # *   IPv6 unspecified address (::) is replaced by IPv6 loopback address (::1).
   #
-  #
   # If the local address is not suitable for connect, SocketError is raised. IPv4
   # and IPv6 address which port is 0 is not suitable for connect. Unix domain
   # socket which has no path is not suitable for connect.
@@ -204,7 +201,6 @@ class BasicSocket < IO
   #     Socket::SO_REUSEADDR. A string or symbol of the name, possibly without
   #     prefix, is also accepted.
   #
-  #
   # ### Examples
   #
   # Some socket options are integers with boolean values, in this case #getsockopt
@@ -293,8 +289,10 @@ class BasicSocket < IO
   # is set for the underlying file descriptor. *flags* is zero or more of the
   # `MSG_` options. The result, *mesg*, is the data received.
   #
-  # When recvfrom(2) returns 0, Socket#recv_nonblock returns an empty string as
-  # data. The meaning depends on the socket: EOF on TCP, empty packet on UDP, etc.
+  # When recvfrom(2) returns 0, Socket#recv_nonblock returns nil. In most cases it
+  # means the connection was closed, but for UDP connections it may mean an empty
+  # packet was received, as the underlying API makes it impossible to distinguish
+  # these two cases.
   #
   # ### Parameters
   # *   `maxlen` - the number of bytes to receive from the socket
@@ -302,7 +300,6 @@ class BasicSocket < IO
   # *   `buf` - destination String buffer
   # *   `options` - keyword hash, supporting `exception: false`
   #
-  #
   # ### Example
   #     serv = TCPServer.new("127.0.0.1", 0)
   #     af, port, host, addr = serv.addr
@@ -518,10 +515,8 @@ class BasicSocket < IO
   #         int is passed as for an Integer. Note that `false` must be passed, not
   #         `nil`.
   #     *   String: the string's data and length is passed to the socket.
-  #
   # *   `socketoption` is an instance of Socket::Option
   #
-  #
   # ### Examples
   #
   # Some socket options are integers with boolean values, in this case #setsockopt
@@ -579,7 +574,7 @@ class BasicSocket < IO
   #
   #     }
   #
-  def shutdown: (Symbol | String | Integer flags) -> void
+  def shutdown: (interned | Integer flags) -> void
 
   private
 

data/stdlib/socket/0/ip_socket.rbs

@@ -15,8 +15,6 @@ class IPSocket < BasicSocket
   #
   def self.getaddress: (String host) -> String
 
-  public
-
   # <!--
   #   rdoc-file=ext/socket/ipsocket.c
   #   - ipsocket.addr([reverse_lookup]) => [address_family, port, hostname, numeric_address]

data/stdlib/socket/0/socket.rbs

@@ -22,12 +22,10 @@
 # *   Socket::PF_UNIX
 # *   etc.
 #
-#
 # **type:** The type of communications between the two endpoints, typically
 # *   Socket::SOCK_STREAM
 # *   Socket::SOCK_DGRAM.
 #
-#
 # **protocol:** Typically *zero*. This may be used to identify a variant of a
 # protocol.
 #
@@ -37,7 +35,6 @@
 # *   a zero-length string which specifies INADDR_ANY
 # *   an integer (interpreted as binary address in host byte order).
 #
-#
 # ### Quick start
 #
 # Many of the classes, such as TCPSocket, UDPSocket or UNIXSocket, ease the use
@@ -94,10 +91,13 @@
 #
 # TCP client socket
 # :   Socket.tcp, TCPSocket.open
+#
 # TCP server socket
 # :   Socket.tcp_server_loop, TCPServer.open
+#
 # UNIX client socket
 # :   Socket.unix, UNIXSocket.open
+#
 # UNIX server socket
 # :   Socket.unix_server_loop, UNIXServer.open
 #
@@ -108,7 +108,6 @@
 # *   Sam Roberts
 # *   *Programming Ruby* from The Pragmatic Bookshelf.
 #
-#
 # Much material in this documentation is taken with permission from *Programming
 # Ruby* from The Pragmatic Bookshelf.
 #
@@ -180,7 +179,6 @@ class Socket < BasicSocket
   #     cannot be released since gethostbyname() is not thread safe.)
   # *   This method uses gethostbyname() function already removed from POSIX.
   #
-  #
   # This method obtains the host information for *address*.
   #
   #     p Socket.gethostbyaddr([221,186,184,68].pack("CCCC"))
@@ -209,7 +207,6 @@ class Socket < BasicSocket
   #     cannot be released since gethostbyname() is not thread safe.)
   # *   This method uses gethostbyname() function already removed from POSIX.
   #
-  #
   # This method obtains the host information for *hostname*.
   #
   #     p Socket.gethostbyname("hal") #=> ["localhost", ["hal"], 2, "\x7F\x00\x00\x01"]
@@ -281,7 +278,6 @@ class Socket < BasicSocket
   # *   3-elements array such as ["AF_INET", 80, "127.0.0.1"]
   # *   4-elements array such as ["AF_INET", 80, ignored, "127.0.0.1"]
   #
-  #
   # *flags* should be bitwise OR of Socket::NI_* constants.
   #
   # Note: The last form is compatible with IPSocket#addr and IPSocket#peeraddr.
@@ -462,15 +458,38 @@ class Socket < BasicSocket
   # -->
   # creates a new socket object connected to host:port using TCP/IP.
   #
+  # Starting from Ruby 3.4, this method operates according to the Happy Eyeballs
+  # Version 2 ([RFC 8305](https://datatracker.ietf.org/doc/html/rfc8305))
+  # algorithm by default.
+  #
+  # For details on Happy Eyeballs Version 2, see
+  # [Socket.tcp_fast_fallback=](rdoc-ref:Socket.tcp_fast_fallback=).
+  #
+  # To make it behave the same as in Ruby 3.3 and earlier, explicitly specify the
+  # option fast_fallback:false. Or, setting Socket.tcp_fast_fallback=false will
+  # disable Happy Eyeballs Version 2 not only for this method but for all Socket
+  # globally.
+  #
   # If local_host:local_port is given, the socket is bound to it.
   #
   # The optional last argument *opts* is options represented by a hash. *opts* may
   # have following options:
   #
-  # :connect_timeout
-  # :   specify the timeout in seconds.
   # :resolv_timeout
-  # :   specify the name resolution timeout in seconds.
+  # :   Specifies the timeout in seconds from when the hostname resolution starts.
+  #
+  # :connect_timeout
+  # :   This method sequentially attempts connecting to all candidate destination
+  #     addresses.
+  #     The `connect_timeout` specifies the timeout in seconds from the start of
+  #     the connection attempt to the last candidate.
+  #     By default, all connection attempts continue until the timeout occurs.
+  #     When `fast_fallback:false` is explicitly specified,
+  #     a timeout is set for each connection attempt and any connection attempt
+  #     that exceeds its timeout will be canceled.
+  #
+  # :fast_fallback
+  # :   Enables the Happy Eyeballs Version 2 algorithm (enabled by default).
   #
   #
   # If a block is given, the block is called with the socket. The value of the
@@ -484,8 +503,8 @@ class Socket < BasicSocket
   #       puts sock.read
   #     }
   #
-  def self.tcp: (String host, Integer port, ?String local_host, ?Integer local_port, ?resolv_timeout: Numeric, ?connect_timeout: Numeric) -> instance
-              | (String host, Integer port, ?String local_host, ?Integer local_port, ?resolv_timeout: Numeric, ?connect_timeout: Numeric) { (instance) -> void } -> void
+  def self.tcp: (String host, Integer port, ?String local_host, ?Integer local_port, ?resolv_timeout: Time::_Timeout, ?connect_timeout: Time::_Timeout) -> instance
+              | (String host, Integer port, ?String local_host, ?Integer local_port, ?resolv_timeout: Time::_Timeout, ?connect_timeout: Time::_Timeout) { (instance) -> void } -> void
 
   # <!--
   #   rdoc-file=ext/socket/lib/socket.rb
@@ -754,8 +773,6 @@ class Socket < BasicSocket
   #
   def self.unpack_sockaddr_un: (String path) -> String
 
-  public
-
   # <!--
   #   rdoc-file=ext/socket/socket.c
   #   - socket.accept => [client_socket, client_addrinfo]
@@ -836,7 +853,6 @@ class Socket < BasicSocket
   # *   `local_sockaddr` - the `struct` sockaddr contained in a string or an
   #     Addrinfo object
   #
-  #
   # ### Example
   #     require 'socket'
   #
@@ -877,7 +893,6 @@ class Socket < BasicSocket
   # *   Errno::EOPNOTSUPP - the socket type of the `socket` does not support
   #     binding to an address
   #
-  #
   # On unix-based based systems if the address family of the calling `socket` is
   # Socket::AF_UNIX the follow exceptions may be raised if the call to *bind*
   # fails:
@@ -896,7 +911,6 @@ class Socket < BasicSocket
   #     *sockaddr* is not a directory
   # *   Errno::EROFS - the name would reside on a read only filesystem
   #
-  #
   # ### Windows Exceptions
   # On Windows systems the following system exceptions may be raised if the call
   # to *bind* fails:
@@ -912,7 +926,6 @@ class Socket < BasicSocket
   # *   Errno::ENOBUFS - no buffer space is available
   # *   Errno::ENOTSOCK - the `socket` argument does not refer to a socket
   #
-  #
   # ### See
   # *   bind manual pages on unix-based systems
   # *   bind function in Microsoft's Winsock functions reference
@@ -930,7 +943,6 @@ class Socket < BasicSocket
   # *   `remote_sockaddr` - the `struct` sockaddr contained in a string or
   #     Addrinfo object
   #
-  #
   # ### Example:
   #     # Pull down Google's web page
   #     require 'socket'
@@ -985,7 +997,6 @@ class Socket < BasicSocket
   # *   Errno::ETIMEDOUT - the attempt to connect timed out before a connection
   #     was made.
   #
-  #
   # On unix-based systems if the address family of the calling `socket` is AF_UNIX
   # the follow exceptions may be raised if the call to *connect* fails:
   # *   Errno::EIO - an i/o error occurred while reading from or writing to the
@@ -999,7 +1010,6 @@ class Socket < BasicSocket
   # *   Errno::ENOTDIR - a component of the path prefix of the pathname in
   #     *sockaddr* is not a directory
   #
-  #
   # ### Windows Exceptions
   # On Windows systems the following system exceptions may be raised if the call
   # to *connect* fails:
@@ -1032,7 +1042,6 @@ class Socket < BasicSocket
   # *   Errno::EACCES - the attempt to connect the datagram socket to the
   #     broadcast address failed
   #
-  #
   # ### See
   # *   connect manual pages on unix-based systems
   # *   connect function in Microsoft's Winsock functions reference
@@ -1048,7 +1057,8 @@ class Socket < BasicSocket
   # otherwise an exception is raised.
   #
   # ### Parameter
-  #     # +remote_sockaddr+ - the +struct+ sockaddr contained in a string or Addrinfo object
+  # *   `remote_sockaddr` - the `struct` sockaddr contained in a string or
+  #     Addrinfo object
   #
   # ### Example:
   #     # Pull down Google's web page
@@ -1083,7 +1093,7 @@ class Socket < BasicSocket
   # the symbol `:wait_writable` instead.
   #
   # ### See
-  #     # Socket#connect
+  # *   Socket#connect
   #
   def connect_nonblock: (untyped addr, ?exception: untyped) -> (Integer | :wait_writable)
 
@@ -1106,7 +1116,6 @@ class Socket < BasicSocket
   # ### Parameter
   # *   `backlog` - the maximum length of the queue for pending connections.
   #
-  #
   # ### Example 1
   #     require 'socket'
   #     include Socket::Constants
@@ -1143,7 +1152,6 @@ class Socket < BasicSocket
   # *   Errno::ENOBUFS - insufficient resources are available in the system to
   #     complete the call
   #
-  #
   # ### Windows Exceptions
   # On Windows systems the following system exceptions may be raised if the call
   # to *listen* fails:
@@ -1163,7 +1171,6 @@ class Socket < BasicSocket
   # *   Errno::EOPNOTSUPP - the referenced `socket` is not a type that supports
   #     the *listen* method
   #
-  #
   # ### See
   # *   listen manual pages on unix-based systems
   # *   listen function in Microsoft's Winsock functions reference
@@ -1184,7 +1191,6 @@ class Socket < BasicSocket
   # *   `maxlen` - the maximum number of bytes to receive from the socket
   # *   `flags` - zero or more of the `MSG_` options
   #
-  #
   # ### Example
   #     # In one file, start this first
   #     require 'socket'
@@ -1240,7 +1246,6 @@ class Socket < BasicSocket
   # *   Errno::ETIMEDOUT - the connection timed out during connection
   #     establishment or due to a transmission timeout on an active connection
   #
-  #
   # ### Windows Exceptions
   # On Windows systems the following system exceptions may be raised if the call
   # to *recvfrom* fails:
@@ -1291,9 +1296,10 @@ class Socket < BasicSocket
   # received. The second element, *sender_addrinfo*, contains protocol-specific
   # address information of the sender.
   #
-  # When recvfrom(2) returns 0, Socket#recvfrom_nonblock returns an empty string
-  # as data. The meaning depends on the socket: EOF on TCP, empty packet on UDP,
-  # etc.
+  # When recvfrom(2) returns 0, Socket#recv_nonblock returns nil. In most cases it
+  # means the connection was closed, but for UDP connections it may mean an empty
+  # packet was received, as the underlying API makes it impossible to distinguish
+  # these two cases.
   #
   # ### Parameters
   # *   `maxlen` - the maximum number of bytes to receive from the socket
@@ -1301,7 +1307,6 @@ class Socket < BasicSocket
   # *   `outbuf` - destination String buffer
   # *   `opts` - keyword hash, supporting `exception: false`
   #
-  #
   # ### Example
   #     # In one file, start this first
   #     require 'socket'
@@ -1416,7 +1421,7 @@ class Socket < BasicSocket
   #     Socket.new(:UNIX, :STREAM) # UNIX stream socket
   #     Socket.new(:UNIX, :DGRAM)  # UNIX datagram socket
   #
-  def initialize: (Symbol domain, Symbol socktype, ?Integer protocol) -> untyped
+  def initialize: (Symbol | Integer domain, Symbol | Integer socktype, ?Integer protocol) -> untyped
 end
 
 # <!-- rdoc-file=ext/socket/constdefs.c -->
@@ -1519,8 +1524,8 @@ Socket::AF_IMPLINK: Integer
 #
 Socket::AF_INET: Integer
 
-# <!-- rdoc-file=ext/socket/constdefs.c -->
-# IPv6 protocol
+# <!-- rdoc-file=lib/ipaddr.rb -->
+# IPv6 protocol family
 #
 Socket::AF_INET6: Integer
 
@@ -3346,6 +3351,16 @@ Socket::SO_ERROR: Integer
 #
 Socket::SO_GET_FILTER: Integer
 
+# <!-- rdoc-file=ext/socket/constdefs.c -->
+# Receive the cpu attached to the socket (Linux 3.19)
+#
+Socket::SO_INCOMING_CPU: Integer
+
+# <!-- rdoc-file=ext/socket/constdefs.c -->
+# Receive the napi ID attached to a RX queue (Linux 4.12)
+#
+Socket::SO_INCOMING_NAPI_ID: Integer
+
 # <!-- rdoc-file=ext/socket/constdefs.c -->
 # Keep connections alive
 #
@@ -3481,6 +3496,11 @@ Socket::SO_REUSEADDR: Integer
 #
 Socket::SO_REUSEPORT: Integer
 
+# <!-- rdoc-file=ext/socket/constdefs.c -->
+# Set the routing table for this socket (OpenBSD)
+#
+Socket::SO_RTABLE: Integer
+
 # <!-- rdoc-file=ext/socket/constdefs.c -->
 # Toggle cmsg for number of packets dropped (Linux 2.6.33)
 #
@@ -3494,6 +3514,11 @@ Socket::SO_SECURITY_ENCRYPTION_TRANSPORT: Integer
 #
 Socket::SO_SELECT_ERR_QUEUE: Integer
 
+# <!-- rdoc-file=ext/socket/constdefs.c -->
+# Set the associated routing table for the socket (FreeBSD)
+#
+Socket::SO_SETFIB: Integer
+
 # <!-- rdoc-file=ext/socket/constdefs.c -->
 # Send buffer size
 #
@@ -3539,6 +3564,11 @@ Socket::SO_TYPE: Integer
 #
 Socket::SO_USELOOPBACK: Integer
 
+# <!-- rdoc-file=ext/socket/constdefs.c -->
+# Setting an identifier for ipfw purpose mainly
+#
+Socket::SO_USER_COOKIE: Integer
+
 # <!-- rdoc-file=ext/socket/constdefs.c -->
 # Give a hint when more data is ready
 #
@@ -3554,6 +3584,11 @@ Socket::SO_WANTOOBFLAG: Integer
 #
 Socket::SO_WIFI_STATUS: Integer
 
+# <!-- rdoc-file=ext/socket/constdefs.c -->
+# Retrieve information about this socket (macOS)
+#
+Socket::TCP_CONNECTION_INFO: Integer
+
 # <!-- rdoc-file=ext/socket/constdefs.c -->
 # TCP congestion control algorithm (Linux 2.6.13, glibc 2.6)
 #
@@ -3584,6 +3619,11 @@ Socket::TCP_FASTOPEN: Integer
 #
 Socket::TCP_INFO: Integer
 
+# <!-- rdoc-file=ext/socket/constdefs.c -->
+# Idle time before keepalive probes are sent (macOS)
+#
+Socket::TCP_KEEPALIVE: Integer
+
 # <!-- rdoc-file=ext/socket/constdefs.c -->
 # Maximum number of keepalive probes allowed before dropping a connection (Linux
 # 2.4, glibc 2.2)
@@ -3696,8 +3736,6 @@ Socket::UDP_CORK: Integer
 # Socket::Ifaddr represents a result of getifaddrs() function.
 #
 class Socket::Ifaddr
-  public
-
   # <!--
   #   rdoc-file=ext/socket/ifaddr.c
   #   - ifaddr.addr => addrinfo
@@ -3771,8 +3809,6 @@ end
 # UDP/IP address information used by Socket.udp_server_loop.
 #
 class Socket::UDPSource
-  public
-
   def inspect: () -> String
 
   # <!-- rdoc-file=ext/socket/lib/socket.rb -->
@@ -3877,8 +3913,6 @@ class Socket::AncillaryData
   #
   def self.unix_rights: (IO fd) -> instance
 
-  public
-
   # <!--
   #   rdoc-file=ext/socket/ancdata.c
   #   - ancillarydata.cmsg_is?(level, type) => true or false
@@ -4096,7 +4130,6 @@ class Socket::AncillaryData
   # *   Socket::AF_UNIX, "AF_UNIX", "UNIX", :AF_UNIX, :UNIX
   # *   etc.
   #
-  #
   # *cmsg_level* should be an integer, a string or a symbol.
   # *   Socket::SOL_SOCKET, "SOL_SOCKET", "SOCKET", :SOL_SOCKET and :SOCKET
   # *   Socket::IPPROTO_IP, "IP" and :IP
@@ -4104,7 +4137,6 @@ class Socket::AncillaryData
   # *   Socket::IPPROTO_TCP, "TCP" and :TCP
   # *   etc.
   #
-  #
   # *cmsg_type* should be an integer, a string or a symbol. If a string/symbol is
   # specified, it is interpreted depend on *cmsg_level*.
   # *   Socket::SCM_RIGHTS, "SCM_RIGHTS", "RIGHTS", :SCM_RIGHTS, :RIGHTS for
@@ -4113,7 +4145,6 @@ class Socket::AncillaryData
   # *   Socket::IPV6_PKTINFO, "PKTINFO" and :PKTINFO for IPPROTO_IPV6
   # *   etc.
   #
-  #
   # *cmsg_data* should be a string.
   #
   #     p Socket::AncillaryData.new(:INET, :TCP, :NODELAY, "")
@@ -4122,5 +4153,5 @@ class Socket::AncillaryData
   #     p Socket::AncillaryData.new(:INET6, :IPV6, :PKTINFO, "")
   #     #=> #<Socket::AncillaryData: INET6 IPV6 PKTINFO "">
   #
-  def initialize: (Symbol | String | Integer family, Symbol | String | Integer cmsg_level, Symbol | String | Integer cmsg_data, String cmsg_data) -> untyped
+  def initialize: (interned | Integer family, interned | Integer cmsg_level, interned | Integer cmsg_data, String cmsg_data) -> untyped
 end

data/stdlib/socket/0/tcp_server.rbs

@@ -27,8 +27,6 @@
 #     end
 #
 class TCPServer < TCPSocket
-  public
-
   # <!--
   #   rdoc-file=ext/socket/tcpserver.c
   #   - tcpserver.accept => tcpsocket
@@ -93,7 +91,6 @@ class TCPServer < TCPSocket
   # ### Parameter
   # *   `backlog` - the maximum length of the queue for pending connections.
   #
-  #
   # ### Example 1
   #     require 'socket'
   #     include Socket::Constants
@@ -130,7 +127,6 @@ class TCPServer < TCPSocket
   # *   Errno::ENOBUFS - insufficient resources are available in the system to
   #     complete the call
   #
-  #
   # ### Windows Exceptions
   # On Windows systems the following system exceptions may be raised if the call
   # to *listen* fails:
@@ -150,7 +146,6 @@ class TCPServer < TCPSocket
   # *   Errno::EOPNOTSUPP - the referenced `socket` is not a type that supports
   #     the *listen* method
   #
-  #
   # ### See
   # *   listen manual pages on unix-based systems
   # *   listen function in Microsoft's Winsock functions reference