rbs 3.9.5 → 4.0.0

data/stdlib/resolv/0/resolv.rbs

@@ -427,15 +427,9 @@ end
 class Resolv::DNS::Config::OtherResolvError < Resolv::ResolvError
 end
 
-# <!-- rdoc-file=lib/resolv.rb -->
-# Indicates that the DNS response was unable to be decoded.
-#
 class Resolv::DNS::DecodeError < StandardError
 end
 
-# <!-- rdoc-file=lib/resolv.rb -->
-# Indicates that the DNS request was unable to be encoded.
-#
 class Resolv::DNS::EncodeError < StandardError
 end
 
@@ -585,9 +579,6 @@ class Resolv::DNS::Message::MessageEncoder
   def initialize: () -> untyped
 end
 
-# <!-- rdoc-file=lib/resolv.rb -->
-# A representation of a DNS name.
-#
 class Resolv::DNS::Name
   # <!--
   #   rdoc-file=lib/resolv.rb
@@ -677,9 +668,6 @@ Resolv::DNS::OpCode::Status: Integer
 
 Resolv::DNS::OpCode::Update: Integer
 
-# <!-- rdoc-file=lib/resolv.rb -->
-# A DNS query abstract class.
-#
 class Resolv::DNS::Query
   def self.decode_rdata: (Resolv::DNS::Message::MessageDecoder msg) -> instance
 
@@ -817,9 +805,6 @@ class Resolv::DNS::Requester::UnconnectedUDP::Sender < Resolv::DNS::Requester::S
   def initialize: (Resolv::DNS::Message msg, String data, UDPSocket sock, String host, Integer port) -> untyped
 end
 
-# <!-- rdoc-file=lib/resolv.rb -->
-# A DNS resource abstract class.
-#
 class Resolv::DNS::Resource < Resolv::DNS::Query
   def self.decode_rdata: (Resolv::DNS::Message::MessageDecoder msg) -> instance
 
@@ -845,25 +830,16 @@ Resolv::DNS::Resource::ClassInsensitiveTypes: Array[singleton(Resolv::DNS::Resou
 
 Resolv::DNS::Resource::ClassValue: Integer?
 
-# <!-- rdoc-file=lib/resolv.rb -->
-# A Query type requesting any RR.
-#
 class Resolv::DNS::Resource::ANY < Resolv::DNS::Query
 end
 
 Resolv::DNS::Resource::ANY::TypeValue: Integer
 
-# <!-- rdoc-file=lib/resolv.rb -->
-# The canonical name for an alias.
-#
 class Resolv::DNS::Resource::CNAME < Resolv::DNS::Resource::DomainName
 end
 
 Resolv::DNS::Resource::CNAME::TypeValue: Integer
 
-# <!-- rdoc-file=lib/resolv.rb -->
-# Domain Name resource abstract class.
-#
 class Resolv::DNS::Resource::DomainName < Resolv::DNS::Resource
   def self.decode_rdata: (Resolv::DNS::Message::MessageDecoder msg) -> instance
 
@@ -885,9 +861,6 @@ class Resolv::DNS::Resource::DomainName < Resolv::DNS::Resource
   def initialize: (String name) -> untyped
 end
 
-# <!-- rdoc-file=lib/resolv.rb -->
-# A generic resource abstract class.
-#
 class Resolv::DNS::Resource::Generic < Resolv::DNS::Resource
   def self.create: (Integer type_value, Integer class_value) -> Class
 
@@ -911,9 +884,6 @@ class Resolv::DNS::Resource::Generic < Resolv::DNS::Resource
   def initialize: (String data) -> untyped
 end
 
-# <!-- rdoc-file=lib/resolv.rb -->
-# Host Information resource.
-#
 class Resolv::DNS::Resource::HINFO < Resolv::DNS::Resource
   def self.decode_rdata: (Resolv::DNS::Message::MessageDecoder msg) -> instance
 
@@ -942,17 +912,11 @@ end
 
 Resolv::DNS::Resource::HINFO::TypeValue: Integer
 
-# <!-- rdoc-file=lib/resolv.rb -->
-# module IN contains ARPA Internet specific RRs.
-#
 module Resolv::DNS::Resource::IN
 end
 
 Resolv::DNS::Resource::IN::ClassValue: Integer
 
-# <!-- rdoc-file=lib/resolv.rb -->
-# IPv4 Address resource
-#
 class Resolv::DNS::Resource::IN::A < Resolv::DNS::Resource
   def self.decode_rdata: (Resolv::DNS::Message::MessageDecoder msg) -> instance
 
@@ -978,9 +942,6 @@ Resolv::DNS::Resource::IN::A::ClassValue: Integer
 
 Resolv::DNS::Resource::IN::A::TypeValue: Integer
 
-# <!-- rdoc-file=lib/resolv.rb -->
-# An IPv6 address record.
-#
 class Resolv::DNS::Resource::IN::AAAA < Resolv::DNS::Resource
   def self.decode_rdata: (Resolv::DNS::Message::MessageDecoder msg) -> instance
 
@@ -1069,11 +1030,6 @@ Resolv::DNS::Resource::IN::SOA::ClassValue: Integer
 
 Resolv::DNS::Resource::IN::SOA::TypeValue: Integer
 
-# <!-- rdoc-file=lib/resolv.rb -->
-# SRV resource record defined in RFC 2782
-#
-# These records identify the hostname and port that a service is available at.
-#
 class Resolv::DNS::Resource::IN::SRV < Resolv::DNS::Resource
   def self.decode_rdata: (Resolv::DNS::Message::MessageDecoder msg) -> instance
 
@@ -1141,9 +1097,6 @@ Resolv::DNS::Resource::IN::TXT::ClassValue: Integer
 
 Resolv::DNS::Resource::IN::TXT::TypeValue: Integer
 
-# <!-- rdoc-file=lib/resolv.rb -->
-# Well Known Service resource.
-#
 class Resolv::DNS::Resource::IN::WKS < Resolv::DNS::Resource
   def self.decode_rdata: (Resolv::DNS::Message::MessageDecoder msg) -> instance
 
@@ -1182,9 +1135,6 @@ Resolv::DNS::Resource::IN::WKS::ClassValue: Integer
 
 Resolv::DNS::Resource::IN::WKS::TypeValue: Integer
 
-# <!-- rdoc-file=lib/resolv.rb -->
-# Location resource
-#
 class Resolv::DNS::Resource::LOC < Resolv::DNS::Resource
   def self.decode_rdata: (Resolv::DNS::Message::MessageDecoder msg) -> instance
 
@@ -1243,9 +1193,6 @@ end
 
 Resolv::DNS::Resource::LOC::TypeValue: Integer
 
-# <!-- rdoc-file=lib/resolv.rb -->
-# Mailing list or mailbox information.
-#
 class Resolv::DNS::Resource::MINFO < Resolv::DNS::Resource
   def self.decode_rdata: (Resolv::DNS::Message::MessageDecoder msg) -> instance
 
@@ -1273,9 +1220,6 @@ end
 
 Resolv::DNS::Resource::MINFO::TypeValue: Integer
 
-# <!-- rdoc-file=lib/resolv.rb -->
-# Mail Exchanger resource.
-#
 class Resolv::DNS::Resource::MX < Resolv::DNS::Resource
   def self.decode_rdata: (Resolv::DNS::Message::MessageDecoder msg) -> instance
 
@@ -1304,25 +1248,16 @@ end
 
 Resolv::DNS::Resource::MX::TypeValue: Integer
 
-# <!-- rdoc-file=lib/resolv.rb -->
-# An authoritative name server.
-#
 class Resolv::DNS::Resource::NS < Resolv::DNS::Resource::DomainName
 end
 
 Resolv::DNS::Resource::NS::TypeValue: Integer
 
-# <!-- rdoc-file=lib/resolv.rb -->
-# A Pointer to another DNS name.
-#
 class Resolv::DNS::Resource::PTR < Resolv::DNS::Resource::DomainName
 end
 
 Resolv::DNS::Resource::PTR::TypeValue: Integer
 
-# <!-- rdoc-file=lib/resolv.rb -->
-# Start Of Authority resource.
-#
 class Resolv::DNS::Resource::SOA < Resolv::DNS::Resource
   def self.decode_rdata: (Resolv::DNS::Message::MessageDecoder msg) -> instance
 
@@ -1380,9 +1315,6 @@ end
 
 Resolv::DNS::Resource::SOA::TypeValue: Integer
 
-# <!-- rdoc-file=lib/resolv.rb -->
-# Unstructured text resource.
-#
 class Resolv::DNS::Resource::TXT < Resolv::DNS::Resource
   def self.decode_rdata: (Resolv::DNS::Message::MessageDecoder msg) -> instance
 
@@ -1478,6 +1410,9 @@ class Resolv::Hosts
   def initialize: (?String filename) -> untyped
 end
 
+# <!-- rdoc-file=lib/resolv.rb -->
+# The default file name for host names
+#
 Resolv::Hosts::DefaultFileName: String
 
 # <!-- rdoc-file=lib/resolv.rb -->
@@ -1488,6 +1423,13 @@ class Resolv::IPv4
   #   rdoc-file=lib/resolv.rb
   #   - create(arg)
   # -->
+  # Creates a new IPv4 address from `arg` which may be:
+  #
+  # IPv4
+  # :   returns `arg`.
+  #
+  # String
+  # :   `arg` must match the IPv4::Regex constant
   #
   def self.create: (String | instance arg) -> instance
 
@@ -1519,6 +1461,9 @@ class Resolv::IPv4
   def initialize: (String address) -> untyped
 end
 
+# <!-- rdoc-file=lib/resolv.rb -->
+# Regular expression IPv4 addresses must match.
+#
 Resolv::IPv4::Regex: Regexp
 
 # <!-- rdoc-file=lib/resolv.rb -->
@@ -1649,10 +1594,14 @@ class Resolv::LOC::Alt
   #   rdoc-file=lib/resolv.rb
   #   - new(altitude)
   # -->
+  # Internal use; use self.create.
   #
   def initialize: (Integer altitude) -> untyped
 end
 
+# <!-- rdoc-file=lib/resolv.rb -->
+# Regular expression LOC Alt must match.
+#
 Resolv::LOC::Alt::Regex: Regexp
 
 # <!-- rdoc-file=lib/resolv.rb -->
@@ -1701,10 +1650,14 @@ class Resolv::LOC::Coord
   #   rdoc-file=lib/resolv.rb
   #   - new(coordinates,orientation)
   # -->
+  # Internal use; use self.create.
   #
   def initialize: (String coordinates, orientation orientation) -> untyped
 end
 
+# <!-- rdoc-file=lib/resolv.rb -->
+# Regular expression LOC Coord must match.
+#
 Resolv::LOC::Coord::Regex: Regexp
 
 # <!-- rdoc-file=lib/resolv.rb -->
@@ -1746,10 +1699,14 @@ class Resolv::LOC::Size
   #   rdoc-file=lib/resolv.rb
   #   - new(scalar)
   # -->
+  # Internal use; use self.create.
   #
   def initialize: (String scalar) -> untyped
 end
 
+# <!-- rdoc-file=lib/resolv.rb -->
+# Regular expression LOC size must match.
+#
 Resolv::LOC::Size::Regex: Regexp
 
 # <!-- rdoc-file=lib/resolv.rb -->

data/stdlib/ripper/0/ripper.rbs

@@ -31,23 +31,26 @@
 #               nil,
 #               nil]]]]
 #
-# You can see in the example above, the expression starts with `:program`.
+# You can see in the example above, the expression starts with
+# <code>:program</code>.
 #
-# From here, a method definition at `:def`, followed by the method's identifier
-# `:@ident`. After the method's identifier comes the parentheses `:paren` and
-# the method parameters under `:params`.
+# From here, a method definition at <code>:def</code>, followed by the method's
+# identifier <code>:@ident</code>. After the method's identifier comes the
+# parentheses <code>:paren</code> and the method parameters under
+# <code>:params</code>.
 #
-# Next is the method body, starting at `:bodystmt` (`stmt` meaning statement),
-# which contains the full definition of the method.
+# Next is the method body, starting at <code>:bodystmt</code> (`stmt` meaning
+# statement), which contains the full definition of the method.
 #
 # In our case, we're simply returning a String, so next we have the
-# `:string_literal` expression.
+# <code>:string_literal</code> expression.
 #
-# Within our `:string_literal` you'll notice two `@tstring_content`, this is the
-# literal part for `Hello, ` and `!`. Between the two `@tstring_content`
-# statements is a `:string_embexpr`, where *embexpr* is an embedded expression.
-# Our expression consists of a local variable, or `var_ref`, with the identifier
-# (`@ident`) of `world`.
+# Within our <code>:string_literal</code> you'll notice two
+# <code>@tstring_content</code>, this is the literal part for <code>Hello,
+# </code> and <code>!</code>. Between the two <code>@tstring_content</code>
+# statements is a <code>:string_embexpr</code>, where *embexpr* is an embedded
+# expression. Our expression consists of a local variable, or `var_ref`, with
+# the identifier (<code>@ident</code>) of `world`.
 #
 # ## Resources
 #
@@ -189,7 +192,7 @@ class Ripper
     #   - state()
     # -->
     # The scanner's state of the current token. This value is the bitwise OR of zero
-    # or more of the `Ripper::EXPR_*` constants.
+    # or more of the <code>Ripper::EXPR_*</code> constants.
     #
     def state: () -> Ripper::Lexer::State
 
@@ -247,8 +250,8 @@ class Ripper
       #   - to_a()
       # -->
       #
-      def to_a: () -> [ [ Integer, Integer ], Symbol, String, Ripper::Lexer::State, String ]
-              | () -> [ [ Integer, Integer ], Symbol, String, Ripper::Lexer::State ]
+      def to_a: () -> ( [ [ Integer, Integer ], Symbol, String, Ripper::Lexer::State, String ]
+                      | [ [ Integer, Integer ], Symbol, String, Ripper::Lexer::State ] )
     end
 
     class State
@@ -911,6 +914,7 @@ class Ripper
 
     class CompileError < Error
     end
+
     class Error < StandardError
     end
 
@@ -927,6 +931,7 @@ class Ripper
 
       def match: (?untyped n) -> untyped
     end
+
     class MatchError < Error
     end
     alias self.compile self.new
@@ -949,6 +954,7 @@ class Ripper
 
     def map_tokens: (untyped tokens) -> untyped
   end
+
   interface _Gets
     def gets: (?String sep, ?Integer limit) -> String?
   end
@@ -969,10 +975,10 @@ class Ripper
   #   - lex(src, filename = '-', lineno = 1, **kw)
   # -->
   # Tokenizes the Ruby program and returns an array of an array, which is
-  # formatted like `[[lineno, column], type, token, state]`. The `filename`
-  # argument is mostly ignored. By default, this method does not handle syntax
-  # errors in `src`, use the `raise_errors` keyword to raise a SyntaxError for an
-  # error in `src`.
+  # formatted like <code>[[lineno, column], type, token, state]</code>. The
+  # `filename` argument is mostly ignored. By default, this method does not handle
+  # syntax errors in `src`, use the `raise_errors` keyword to raise a SyntaxError
+  # for an error in `src`.
   #
   #     require 'ripper'
   #     require 'pp'

data/stdlib/securerandom/0/manifest.yaml

@@ -0,0 +1,2 @@
+dependencies:
+  - name: random-formatter

data/stdlib/securerandom/0/securerandom.rbs

@@ -29,34 +29,21 @@
 # *   uuid
 #
 # These methods are usable as class methods of SecureRandom such as
-# `SecureRandom.hex`.
+# <code>SecureRandom.hex</code>.
 #
 # If a secure random number generator is not available, `NotImplementedError` is
 # raised.
 #
 module SecureRandom
-  extend Random::Formatter
-
   # <!--
   #   rdoc-file=lib/securerandom.rb
-  #   - alphanumeric(n = nil, chars: ALPHANUMERIC)
+  #   - bytes(n)
   # -->
-  # Compatibility methods for Ruby 3.2, we can remove this after dropping to
-  # support Ruby 3.2
+  # Returns a random binary string containing `size` bytes.
   #
-  def self.alphanumeric: (?Integer?) -> String
-
-  def self.base64: (?Integer?) -> String
-
-  def self.hex: (?Integer?) -> String
-
-  def self.random_bytes: (?Integer?) -> String
-
-  def self.random_number: () -> Float
-                        | (Integer) -> Integer
-                        | (Numeric) -> Numeric
-
-  def self.urlsafe_base64: (?Integer?, ?bool?) -> String
+  # See Random.bytes
+  #
+  def self.bytes: (Integer) -> String
 
-  def self.uuid: () -> String
+  extend Random::Formatter
 end

data/stdlib/shellwords/0/shellwords.rbs

@@ -4,8 +4,8 @@
 # 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
+# The <code>shellwords()</code> 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)

data/stdlib/singleton/0/singleton.rbs

@@ -128,4 +128,7 @@ module Singleton
   end
 end
 
+# <!-- rdoc-file=lib/singleton.rb -->
+# The version string
+#
 Singleton::VERSION: String

data/stdlib/socket/0/addrinfo.rbs

@@ -61,8 +61,8 @@ class Addrinfo
   #     #=> [#<Addrinfo: 203.178.141.194:80 TCP (www.kame.net)>,
   #     #    #<Addrinfo: [2001:200:dff:fff1:216:3eff:feb1:44d7]:80 TCP (www.kame.net)>]
   #
-  def self.getaddrinfo: (String nodename, ?String | Integer | nil service, ?Symbol? family, ?Symbol | Integer protocol) -> Array[Addrinfo]
-                      | (String? nodename, ?String | Integer service, ?Symbol? family, ?Symbol | Integer protocol) -> Array[Addrinfo]
+  def self.getaddrinfo: (String nodename, ?(String | Integer)? service, ?(Symbol | Integer)? family, ?Symbol | Integer protocol) -> Array[Addrinfo]
+                      | (String? nodename, ?(String | Integer) service, ?(Symbol | Integer)? family, ?Symbol | Integer protocol) -> Array[Addrinfo]
 
   # <!--
   #   rdoc-file=ext/socket/raddrinfo.c
@@ -634,13 +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")`
+  # *   <code>["AF_INET", 46102, "localhost.localdomain", "127.0.0.1"]</code>
+  # *   <code>["AF_INET6", 42304, "ip6-localhost", "::1"]</code>
+  # *   <code>["AF_UNIX", "/tmp/sock"]</code>
+  # *   <code>Socket.sockaddr_in("smtp", "2001:DB8::1")</code>
+  # *   <code>Socket.sockaddr_in(80, "172.18.22.42")</code>
+  # *   <code>Socket.sockaddr_in(80, "www.ruby-lang.org")</code>
+  # *   <code>Socket.sockaddr_un("/tmp/sock")</code>
   #
   # 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

@@ -325,7 +325,7 @@ class BasicSocket < IO
   #
   # By specifying a keyword argument *exception* to `false`, you can indicate that
   # recv_nonblock should not raise an IO::WaitReadable exception, but return the
-  # symbol `:wait_readable` instead.
+  # symbol <code>:wait_readable</code> instead.
   #
   # ### See
   # *   Socket#recvfrom
@@ -399,7 +399,7 @@ class BasicSocket < IO
   #
   # By specifying a keyword argument *exception* to `false`, you can indicate that
   # recvmsg_nonblock should not raise an IO::WaitReadable exception, but return
-  # the symbol `:wait_readable` instead.
+  # the symbol <code>:wait_readable</code> instead.
   #
   def recvmsg_nonblock: (?Integer dlen, ?Integer flags, ?Integer clen, ?exception: boolish, ?scm_rights: boolish) -> ([ String, Addrinfo, Integer?, Array[Socket::AncillaryData] ] | :wait_readable)
 
@@ -487,7 +487,7 @@ class BasicSocket < IO
   #
   # By specifying a keyword argument *exception* to `false`, you can indicate that
   # sendmsg_nonblock should not raise an IO::WaitWritable exception, but return
-  # the symbol `:wait_writable` instead.
+  # the symbol <code>:wait_writable</code> instead.
   #
   def sendmsg_nonblock: (String mesg, ?Integer flags, ?Addrinfo | String dest_sockaddr, *Socket::AncillaryData controls, ?exception: boolish) -> (Integer | :wait_writable)
 

data/stdlib/socket/0/ip_socket.rbs

@@ -22,10 +22,11 @@ class IPSocket < BasicSocket
   # Returns the local address as an array which contains address_family, port,
   # hostname and numeric_address.
   #
-  # If `reverse_lookup` is `true` or `:hostname`, hostname is obtained from
-  # numeric_address using reverse lookup. Or if it is `false`, or `:numeric`,
-  # hostname is the same as numeric_address. Or if it is `nil` or omitted, obeys
-  # to `ipsocket.do_not_reverse_lookup`. See `Socket.getaddrinfo` also.
+  # If `reverse_lookup` is `true` or <code>:hostname</code>, hostname is obtained
+  # from numeric_address using reverse lookup. Or if it is `false`, or
+  # <code>:numeric</code>, hostname is the same as numeric_address. Or if it is
+  # `nil` or omitted, obeys to <code>ipsocket.do_not_reverse_lookup</code>. See
+  # <code>Socket.getaddrinfo</code> also.
   #
   #     TCPSocket.open("www.ruby-lang.org", 80) {|sock|
   #       p sock.addr #=> ["AF_INET", 49429, "hal", "192.168.0.128"]
@@ -53,10 +54,11 @@ class IPSocket < BasicSocket
   # hostname and numeric_address. It is defined for connection oriented socket
   # such as TCPSocket.
   #
-  # If `reverse_lookup` is `true` or `:hostname`, hostname is obtained from
-  # numeric_address using reverse lookup. Or if it is `false`, or `:numeric`,
-  # hostname is the same as numeric_address. Or if it is `nil` or omitted, obeys
-  # to `ipsocket.do_not_reverse_lookup`. See `Socket.getaddrinfo` also.
+  # If `reverse_lookup` is `true` or <code>:hostname</code>, hostname is obtained
+  # from numeric_address using reverse lookup. Or if it is `false`, or
+  # <code>:numeric</code>, hostname is the same as numeric_address. Or if it is
+  # `nil` or omitted, obeys to <code>ipsocket.do_not_reverse_lookup</code>. See
+  # <code>Socket.getaddrinfo</code> also.
   #
   #     TCPSocket.open("www.ruby-lang.org", 80) {|sock|
   #       p sock.peeraddr #=> ["AF_INET", 80, "carbon.ruby-lang.org", "221.186.184.68"]

data/stdlib/socket/0/socket.rbs

@@ -16,20 +16,21 @@
 #
 # Sockets have their own vocabulary:
 #
-# **domain:** The family of protocols:
+# <strong>domain:</strong> The family of protocols:
 # *   Socket::PF_INET
 # *   Socket::PF_INET6
 # *   Socket::PF_UNIX
 # *   etc.
 #
-# **type:** The type of communications between the two endpoints, typically
+# <strong>type:</strong> 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.
+# <strong>protocol:</strong> Typically *zero*. This may be used to identify a
+# variant of a protocol.
 #
-# **hostname:** The identifier of a network interface:
+# <strong>hostname:</strong> The identifier of a network interface:
 # *   a string (hostname, IPv4 or IPv6 address or `broadcast` which specifies a
 #     broadcast address)
 # *   a zero-length string which specifies INADDR_ANY
@@ -484,10 +485,17 @@ class Socket < BasicSocket
   #     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,
+  #     When <code>fast_fallback:false</code> is explicitly specified,
   #     a timeout is set for each connection attempt and any connection attempt
   #     that exceeds its timeout will be canceled.
   #
+  # :open_timeout
+  # :   Specifies the timeout in seconds from the start of the method execution.
+  #     If this timeout is reached while there are still addresses that have not
+  #     yet been attempted for connection, no further attempts will be made.
+  #     If this option is specified together with other timeout options, an
+  #     `ArgumentError` will be raised.
+  #
   # :fast_fallback
   # :   Enables the Happy Eyeballs Version 2 algorithm (enabled by default).
   #
@@ -504,7 +512,9 @@ class Socket < BasicSocket
   #     }
   #
   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
+              | (String host, Integer port, ?String local_host, ?Integer local_port, ?open_timeout: Time::_Timeout) -> instance
+              | [T] (String host, Integer port, ?String local_host, ?Integer local_port, ?resolv_timeout: Time::_Timeout, ?connect_timeout: Time::_Timeout) { (instance) -> T } -> T
+              | [T] (String host, Integer port, ?String local_host, ?Integer local_port, ?open_timeout: Time::_Timeout) { (instance) -> T } -> T
 
   # <!--
   #   rdoc-file=ext/socket/lib/socket.rb
@@ -836,7 +846,7 @@ class Socket < BasicSocket
   #
   # By specifying a keyword argument *exception* to `false`, you can indicate that
   # accept_nonblock should not raise an IO::WaitReadable exception, but return the
-  # symbol `:wait_readable` instead.
+  # symbol <code>:wait_readable</code> instead.
   #
   # ### See
   # *   Socket#accept
@@ -1090,7 +1100,7 @@ class Socket < BasicSocket
   #
   # By specifying a keyword argument *exception* to `false`, you can indicate that
   # connect_nonblock should not raise an IO::WaitWritable exception, but return
-  # the symbol `:wait_writable` instead.
+  # the symbol <code>:wait_writable</code> instead.
   #
   # ### See
   # *   Socket#connect
@@ -1348,7 +1358,7 @@ class Socket < BasicSocket
   #
   # By specifying a keyword argument *exception* to `false`, you can indicate that
   # recvfrom_nonblock should not raise an IO::WaitReadable exception, but return
-  # the symbol `:wait_readable` instead.
+  # the symbol <code>:wait_readable</code> instead.
   #
   # ### See
   # *   Socket#recvfrom
@@ -3769,6 +3779,9 @@ class Socket::Ifaddr
   # -->
   # Returns the flags of *ifaddr*.
   #
+  # The value is bitwise-or of Socket::IFF_* constants such as
+  # Socket::IFF_LOOPBACK.
+  #
   def flags: () -> Integer
 
   # <!--

data/stdlib/socket/0/tcp_server.rbs

@@ -72,7 +72,7 @@ class TCPServer < TCPSocket
   #
   # By specifying a keyword argument *exception* to `false`, you can indicate that
   # accept_nonblock should not raise an IO::WaitReadable exception, but return the
-  # symbol `:wait_readable` instead.
+  # symbol <code>:wait_readable</code> instead.
   #
   # ### See
   # *   TCPServer#accept

data/stdlib/socket/0/tcp_socket.rbs

@@ -38,7 +38,7 @@ class TCPSocket < IPSocket
 
   # <!--
   #   rdoc-file=ext/socket/tcpsocket.c
-  #   - TCPSocket.new(remote_host, remote_port, local_host=nil, local_port=nil, resolv_timeout: nil, connect_timeout: nil, fast_fallback: true)
+  #   - TCPSocket.new(remote_host, remote_port, local_host=nil, local_port=nil, resolv_timeout: nil, connect_timeout: nil, open_timeout: nil, fast_fallback: true)
   # -->
   # Opens a TCP connection to `remote_host` on `remote_port`.  If `local_host` and
   # `local_port` are specified, then those parameters are used on the local end to
@@ -68,12 +68,20 @@ class TCPSocket < IPSocket
   #     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,
+  #     When <code>fast_fallback:false</code> is explicitly specified,
   #     a timeout is set for each connection attempt and any connection attempt
   #     that exceeds its timeout will be canceled.
   #
+  # :open_timeout
+  # :   Specifies the timeout in seconds from the start of the method execution.
+  #     If this timeout is reached while there are still addresses that have not
+  #     yet been attempted for connection, no further attempts will be made.
+  #     If this option is specified together with other timeout options, an
+  #     `ArgumentError` will be raised.
+  #
   # :fast_fallback
   # :   Enables the Happy Eyeballs Version 2 algorithm (enabled by default).
   #
-  def initialize: (String remote_host, Integer remote_port, ?String local_host, ?Integer local_port) -> untyped
+  def initialize: (String remote_host, Integer remote_port, ?String local_host, ?Integer local_port, ?fast_fallback: boolish, ?resolv_timeout: Integer, ?connect_timeout: Integer) -> void
+                | (String remote_host, Integer remote_port, ?String local_host, ?Integer local_port, ?fast_fallback: boolish, ?open_timeout: Integer) -> void
 end