rbs 3.3.2 → 3.4.0

data/core/string_io.rbs

@@ -131,8 +131,6 @@ class StringIO
   # Calls the block with each remaining line read from the stream; does nothing if
   # already at end-of-file; returns `self`. See [Line IO](rdoc-ref:IO@Line+IO).
   #
-  # StringIO#each is an alias for StringIO#each_line.
-  #
   def each: (?String sep, ?Integer limit, ?chomp: boolish) { (String) -> untyped } -> self
           | (?String sep, ?Integer limit, ?chomp: boolish) -> ::Enumerator[String, self]
 
@@ -177,12 +175,10 @@ class StringIO
   #   - eof? -> true or false
   # -->
   # Returns `true` if positioned at end-of-stream, `false` otherwise; see
-  # [Position](rdoc-ref:File@Position).
+  # [Position](rdoc-ref:IO@Position).
   #
   # Raises IOError if the stream is not opened for reading.
   #
-  # StreamIO#eof is an alias for StreamIO#eof?.
-  #
   def eof: () -> bool
 
   # <!--
@@ -304,8 +300,6 @@ class StringIO
   # -->
   # Returns the current position (in bytes); see [Position](rdoc-ref:IO@Position).
   #
-  # StringIO#tell is an alias for StringIO#pos.
-  #
   def pos: () -> Integer
 
   # <!--
@@ -491,8 +485,6 @@ class StringIO
   # -->
   # Returns the current position (in bytes); see [Position](rdoc-ref:IO@Position).
   #
-  # StringIO#tell is an alias for StringIO#pos.
-  #
   def tell: () -> Integer
 
   # <!--
@@ -557,19 +549,15 @@ class StringIO
   # Calls the block with each remaining line read from the stream; does nothing if
   # already at end-of-file; returns `self`. See [Line IO](rdoc-ref:IO@Line+IO).
   #
-  # StringIO#each is an alias for StringIO#each_line.
-  #
   def each_line: (?String sep, ?Integer limit, ?chomp: boolish) { (String) -> untyped } -> self
                | (?String sep, ?Integer limit, ?chomp: boolish) -> ::Enumerator[String, self]
 
   # <!-- rdoc-file=ext/stringio/stringio.c -->
   # Returns `true` if positioned at end-of-stream, `false` otherwise; see
-  # [Position](rdoc-ref:File@Position).
+  # [Position](rdoc-ref:IO@Position).
   #
   # Raises IOError if the stream is not opened for reading.
   #
-  # StreamIO#eof is an alias for StreamIO#eof?.
-  #
   def eof?: () -> bool
 
   # This is a deprecated alias for #each_line.

data/core/struct.rbs

@@ -112,15 +112,18 @@
 # *   #inspect, #to_s: Returns a string representation of `self`.
 # *   #to_h: Returns a hash of the member name/value pairs in `self`.
 #
-class Struct[Elem] < Object
-  include Enumerable[Elem?]
+class Struct[Elem]
+  include Enumerable[Elem]
 
-  type attribute_name = interned
+  # The types that can be used when "indexing" into a `Struct` via `[]`, `[]=`, `dig`, and
+  # `deconstruct_keys`.
+  #
+  type index = String | Symbol | int
 
   # <!--
   #   rdoc-file=struct.c
-  #   - Struct.new(*member_names, keyword_init: false){|Struct_subclass| ... } -> Struct_subclass
-  #   - Struct.new(class_name, *member_names, keyword_init: false){|Struct_subclass| ... } -> Struct_subclass
+  #   - Struct.new(*member_names, keyword_init: nil){|Struct_subclass| ... } -> Struct_subclass
+  #   - Struct.new(class_name, *member_names, keyword_init: nil){|Struct_subclass| ... } -> Struct_subclass
   #   - Struct_subclass.new(*member_names) -> Struct_subclass_instance
   #   - Struct_subclass.new(**member_names) -> Struct_subclass_instance
   # -->
@@ -203,8 +206,6 @@ class Struct[Elem] < Object
   #         Foo.new(foo: 0, bar: 1, baz: 2)
   #         # Raises ArgumentError: unknown keywords: baz
   #
-  #     Method `::[]` is an alias for method `::new`.
-  #
   # *   Method `:inspect` returns a string representation of the subclass:
   #
   #         Foo.inspect
@@ -243,7 +244,192 @@ class Struct[Elem] < Object
   #     Any.new(1, 2)
   #     # => #<struct Any foo=1, bar=2>
   #
-  def initialize: (attribute_name, *attribute_name, ?keyword_init: boolish) ?{ () -> void } -> void
+  def self.new: (string? classname, *interned fields, ?keyword_init: boolish?) ?{ (singleton(Struct)) [self: singleton(Struct)] -> void } -> untyped
+              | (Symbol field1, *interned fields, ?keyword_init: boolish?) ?{ (singleton(Struct)) [self: singleton(Struct)] -> void } -> untyped
+
+  # <!--
+  #   rdoc-file=struct.c
+  #   - StructClass::members -> array_of_symbols
+  # -->
+  # Returns the member names of the Struct descendant as an array:
+  #
+  #     Customer = Struct.new(:name, :address, :zip)
+  #     Customer.members # => [:name, :address, :zip]
+  #
+  def self.members: () -> Array[Symbol]
+
+  # <!--
+  #   rdoc-file=struct.c
+  #   - StructClass::keyword_init? -> true or falsy value
+  # -->
+  # Returns `true` if the class was initialized with `keyword_init: true`.
+  # Otherwise returns `nil` or `false`.
+  #
+  # Examples:
+  #     Foo = Struct.new(:a)
+  #     Foo.keyword_init? # => nil
+  #     Bar = Struct.new(:a, keyword_init: true)
+  #     Bar.keyword_init? # => true
+  #     Baz = Struct.new(:a, keyword_init: false)
+  #     Baz.keyword_init? # => false
+  #
+  def self.keyword_init?: () -> bool?
+
+  # <!--
+  #   rdoc-file=struct.c
+  #   - self == other -> true or false
+  # -->
+  # Returns  `true` if and only if the following are true; otherwise returns
+  # `false`:
+  #
+  # *   `other.class == self.class`.
+  # *   For each member name `name`, `other.name == self.name`.
+  #
+  #
+  # Examples:
+  #
+  #     Customer = Struct.new(:name, :address, :zip)
+  #     joe    = Customer.new("Joe Smith", "123 Maple, Anytown NC", 12345)
+  #     joe_jr = Customer.new("Joe Smith", "123 Maple, Anytown NC", 12345)
+  #     joe_jr == joe # => true
+  #     joe_jr[:name] = 'Joe Smith, Jr.'
+  #     # => "Joe Smith, Jr."
+  #     joe_jr == joe # => false
+  #
+  def ==: (untyped other) -> bool
+
+  # <!--
+  #   rdoc-file=struct.c
+  #   - eql?(other) -> true or false
+  # -->
+  # Returns `true` if and only if the following are true; otherwise returns
+  # `false`:
+  #
+  # *   `other.class == self.class`.
+  # *   For each member name `name`, `other.name.eql?(self.name)`.
+  #
+  #         Customer = Struct.new(:name, :address, :zip)
+  #         joe    = Customer.new("Joe Smith", "123 Maple, Anytown NC", 12345)
+  #         joe_jr = Customer.new("Joe Smith", "123 Maple, Anytown NC", 12345)
+  #         joe_jr.eql?(joe) # => true
+  #         joe_jr[:name] = 'Joe Smith, Jr.'
+  #         joe_jr.eql?(joe) # => false
+  #
+  #
+  # Related: Object#==.
+  #
+  def eql?: (untyped other) -> bool
+
+  # <!--
+  #   rdoc-file=struct.c
+  #   - hash -> integer
+  # -->
+  # Returns the integer hash value for `self`.
+  #
+  # Two structs of the same class and with the same content will have the same
+  # hash code (and will compare using Struct#eql?):
+  #
+  #     Customer = Struct.new(:name, :address, :zip)
+  #     joe    = Customer.new("Joe Smith", "123 Maple, Anytown NC", 12345)
+  #     joe_jr = Customer.new("Joe Smith", "123 Maple, Anytown NC", 12345)
+  #     joe.hash == joe_jr.hash # => true
+  #     joe_jr[:name] = 'Joe Smith, Jr.'
+  #     joe.hash == joe_jr.hash # => false
+  #
+  # Related: Object#hash.
+  #
+  def hash: () -> Integer
+
+  # <!--
+  #   rdoc-file=struct.c
+  #   - inspect -> string
+  # -->
+  # Returns a string representation of `self`:
+  #
+  #     Customer = Struct.new(:name, :address, :zip) # => Customer
+  #     joe = Customer.new("Joe Smith", "123 Maple, Anytown NC", 12345)
+  #     joe.inspect # => "#<struct Customer name=\"Joe Smith\", address=\"123 Maple, Anytown NC\", zip=12345>"
+  #
+  def inspect: () -> String
+
+  # <!-- rdoc-file=struct.c -->
+  # Returns a string representation of `self`:
+  #
+  #     Customer = Struct.new(:name, :address, :zip) # => Customer
+  #     joe = Customer.new("Joe Smith", "123 Maple, Anytown NC", 12345)
+  #     joe.inspect # => "#<struct Customer name=\"Joe Smith\", address=\"123 Maple, Anytown NC\", zip=12345>"
+  #
+  alias to_s inspect
+
+  # <!--
+  #   rdoc-file=struct.c
+  #   - to_a     -> array
+  # -->
+  # Returns the values in `self` as an array:
+  #
+  #     Customer = Struct.new(:name, :address, :zip)
+  #     joe = Customer.new("Joe Smith", "123 Maple, Anytown NC", 12345)
+  #     joe.to_a # => ["Joe Smith", "123 Maple, Anytown NC", 12345]
+  #
+  # Related: #members.
+  #
+  def to_a: () -> Array[Elem]
+
+  # <!--
+  #   rdoc-file=struct.c
+  #   - to_h -> hash
+  #   - to_h {|name, value| ... } -> hash
+  # -->
+  # Returns a hash containing the name and value for each member:
+  #
+  #     Customer = Struct.new(:name, :address, :zip)
+  #     joe = Customer.new("Joe Smith", "123 Maple, Anytown NC", 12345)
+  #     h = joe.to_h
+  #     h # => {:name=>"Joe Smith", :address=>"123 Maple, Anytown NC", :zip=>12345}
+  #
+  # If a block is given, it is called with each name/value pair; the block should
+  # return a 2-element array whose elements will become a key/value pair in the
+  # returned hash:
+  #
+  #     h = joe.to_h{|name, value| [name.upcase, value.to_s.upcase]}
+  #     h # => {:NAME=>"JOE SMITH", :ADDRESS=>"123 MAPLE, ANYTOWN NC", :ZIP=>"12345"}
+  #
+  # Raises ArgumentError if the block returns an inappropriate value.
+  #
+  def to_h: () -> Hash[Symbol, Elem]
+          | [K, V] () { (Symbol key, Elem value) -> [K, V] } -> Hash[K, V]
+
+  # <!-- rdoc-file=struct.c -->
+  # Returns the values in `self` as an array:
+  #
+  #     Customer = Struct.new(:name, :address, :zip)
+  #     joe = Customer.new("Joe Smith", "123 Maple, Anytown NC", 12345)
+  #     joe.to_a # => ["Joe Smith", "123 Maple, Anytown NC", 12345]
+  #
+  # Related: #members.
+  #
+  alias values to_a
+
+  # <!--
+  #   rdoc-file=struct.c
+  #   - size -> integer
+  # -->
+  # Returns the number of members.
+  #
+  #     Customer = Struct.new(:name, :address, :zip)
+  #     joe = Customer.new("Joe Smith", "123 Maple, Anytown NC", 12345)
+  #     joe.size #=> 3
+  #
+  def size: () -> Integer
+
+  # <!-- rdoc-file=struct.c -->
+  # Returns the number of members.
+  #
+  #     Customer = Struct.new(:name, :address, :zip)
+  #     joe = Customer.new("Joe Smith", "123 Maple, Anytown NC", 12345)
+  #     joe.size #=> 3
+  #
+  alias length size
 
   # <!--
   #   rdoc-file=struct.c
@@ -266,34 +452,228 @@ class Struct[Elem] < Object
   #
   # Related: #each_pair.
   #
-  def each: () -> ::Enumerator[Elem?, self]
-          | () { (Elem? item) -> void } -> self
+  def each: () -> Enumerator[Elem, self]
+          | () { (Elem value) -> void } -> self
 
   # <!--
   #   rdoc-file=struct.c
-  #   - StructClass::members -> array_of_symbols
+  #   - each_pair {|(name, value)| ... } -> self
+  #   - each_pair -> enumerator
   # -->
-  # Returns the member names of the Struct descendant as an array:
+  # Calls the given block with each member name/value pair; returns `self`:
+  #
+  #     Customer = Struct.new(:name, :address, :zip) # => Customer
+  #     joe = Customer.new("Joe Smith", "123 Maple, Anytown NC", 12345)
+  #     joe.each_pair {|(name, value)| p "#{name} => #{value}" }
+  #
+  # Output:
+  #
+  #     "name => Joe Smith"
+  #     "address => 123 Maple, Anytown NC"
+  #     "zip => 12345"
+  #
+  # Returns an Enumerator if no block is given.
+  #
+  # Related: #each.
+  #
+  def each_pair: () -> Enumerator[[Symbol, Elem], self]
+               | () { ([Symbol, Elem] key_value) -> void } -> self
+
+  # <!--
+  #   rdoc-file=struct.c
+  #   - struct[name] -> object
+  #   - struct[n] -> object
+  # -->
+  # Returns a value from `self`.
+  #
+  # With symbol or string argument `name` given, returns the value for the named
+  # member:
   #
   #     Customer = Struct.new(:name, :address, :zip)
-  #     Customer.members # => [:name, :address, :zip]
+  #     joe = Customer.new("Joe Smith", "123 Maple, Anytown NC", 12345)
+  #     joe[:zip] # => 12345
+  #
+  # Raises NameError if `name` is not the name of a member.
+  #
+  # With integer argument `n` given, returns `self.values[n]` if `n` is in range;
+  # see Array@Array+Indexes:
+  #
+  #     joe[2]  # => 12345
+  #     joe[-2] # => "123 Maple, Anytown NC"
+  #
+  # Raises IndexError if `n` is out of range.
   #
-  def self.members: () -> ::Array[Symbol]
+  def []: (index name_or_position) -> Elem
 
   # <!--
   #   rdoc-file=struct.c
-  #   - StructClass::keyword_init? -> true or falsy value
+  #   - struct[name] = value -> value
+  #   - struct[n] = value -> value
   # -->
-  # Returns `true` if the class was initialized with `keyword_init: true`.
-  # Otherwise returns `nil` or `false`.
+  # Assigns a value to a member.
+  #
+  # With symbol or string argument `name` given, assigns the given `value` to the
+  # named member; returns `value`:
+  #
+  #     Customer = Struct.new(:name, :address, :zip)
+  #     joe = Customer.new("Joe Smith", "123 Maple, Anytown NC", 12345)
+  #     joe[:zip] = 54321 # => 54321
+  #     joe # => #<struct Customer name="Joe Smith", address="123 Maple, Anytown NC", zip=54321>
+  #
+  # Raises NameError if `name` is not the name of a member.
+  #
+  # With integer argument `n` given, assigns the given `value` to the `n`-th
+  # member if `n` is in range; see Array@Array+Indexes:
+  #
+  #     joe = Customer.new("Joe Smith", "123 Maple, Anytown NC", 12345)
+  #     joe[2] = 54321           # => 54321
+  #     joe[-3] = 'Joseph Smith' # => "Joseph Smith"
+  #     joe # => #<struct Customer name="Joseph Smith", address="123 Maple, Anytown NC", zip=54321>
+  #
+  # Raises IndexError if `n` is out of range.
+  #
+  def []=: (index name_or_position, Elem value) -> Elem
+
+  # <!--
+  #   rdoc-file=struct.c
+  #   - select {|value| ... } -> array
+  #   - select -> enumerator
+  # -->
+  # With a block given, returns an array of values from `self` for which the block
+  # returns a truthy value:
+  #
+  #     Customer = Struct.new(:name, :address, :zip)
+  #     joe = Customer.new("Joe Smith", "123 Maple, Anytown NC", 12345)
+  #     a = joe.select {|value| value.is_a?(String) }
+  #     a # => ["Joe Smith", "123 Maple, Anytown NC"]
+  #     a = joe.select {|value| value.is_a?(Integer) }
+  #     a # => [12345]
+  #
+  # With no block given, returns an Enumerator.
+  #
+  def select: () -> Enumerator[Elem, Array[Elem]]
+            | () { (Elem value) -> boolish } -> Array[Elem]
+
+  # <!-- rdoc-file=struct.c -->
+  # With a block given, returns an array of values from `self` for which the block
+  # returns a truthy value:
+  #
+  #     Customer = Struct.new(:name, :address, :zip)
+  #     joe = Customer.new("Joe Smith", "123 Maple, Anytown NC", 12345)
+  #     a = joe.select {|value| value.is_a?(String) }
+  #     a # => ["Joe Smith", "123 Maple, Anytown NC"]
+  #     a = joe.select {|value| value.is_a?(Integer) }
+  #     a # => [12345]
+  #
+  # With no block given, returns an Enumerator.
+  #
+  alias filter select
+
+  # <!--
+  #   rdoc-file=struct.c
+  #   - values_at(*integers) -> array
+  #   - values_at(integer_range) -> array
+  # -->
+  # Returns an array of values from `self`.
+  #
+  # With integer arguments `integers` given, returns an array containing each
+  # value given by one of `integers`:
+  #
+  #     Customer = Struct.new(:name, :address, :zip)
+  #     joe = Customer.new("Joe Smith", "123 Maple, Anytown NC", 12345)
+  #     joe.values_at(0, 2)    # => ["Joe Smith", 12345]
+  #     joe.values_at(2, 0)    # => [12345, "Joe Smith"]
+  #     joe.values_at(2, 1, 0) # => [12345, "123 Maple, Anytown NC", "Joe Smith"]
+  #     joe.values_at(0, -3)   # => ["Joe Smith", "Joe Smith"]
+  #
+  # Raises IndexError if any of `integers` is out of range; see
+  # Array@Array+Indexes.
+  #
+  # With integer range argument `integer_range` given, returns an array containing
+  # each value given by the elements of the range; fills with `nil` values for
+  # range elements larger than the structure:
+  #
+  #     joe.values_at(0..2)
+  #     # => ["Joe Smith", "123 Maple, Anytown NC", 12345]
+  #     joe.values_at(-3..-1)
+  #     # => ["Joe Smith", "123 Maple, Anytown NC", 12345]
+  #     joe.values_at(1..4) # => ["123 Maple, Anytown NC", 12345, nil, nil]
+  #
+  # Raises RangeError if any element of the range is negative and out of range;
+  # see Array@Array+Indexes.
+  #
+  def values_at: (*int | range[int?] positions) -> Array[Elem]
+
+  # <!--
+  #   rdoc-file=struct.c
+  #   - members -> array_of_symbols
+  # -->
+  # Returns the member names from `self` as an array:
+  #
+  #     Customer = Struct.new(:name, :address, :zip)
+  #     Customer.new.members # => [:name, :address, :zip]
+  #
+  # Related: #to_a.
+  #
+  def members: () -> Array[Symbol]
+
+  # <!--
+  #   rdoc-file=struct.c
+  #   - dig(name, *identifiers) -> object
+  #   - dig(n, *identifiers) -> object
+  # -->
+  # Finds and returns an object among nested objects. The nested objects may be
+  # instances of various classes. See [Dig Methods](rdoc-ref:dig_methods.rdoc).
+  #
+  # Given symbol or string argument `name`, returns the object that is specified
+  # by `name` and `identifiers`:
   #
-  # Examples:
   #     Foo = Struct.new(:a)
-  #     Foo.keyword_init? # => nil
-  #     Bar = Struct.new(:a, keyword_init: true)
-  #     Bar.keyword_init? # => true
-  #     Baz = Struct.new(:a, keyword_init: false)
-  #     Baz.keyword_init? # => false
+  #     f = Foo.new(Foo.new({b: [1, 2, 3]}))
+  #     f.dig(:a) # => #<struct Foo a={:b=>[1, 2, 3]}>
+  #     f.dig(:a, :a) # => {:b=>[1, 2, 3]}
+  #     f.dig(:a, :a, :b) # => [1, 2, 3]
+  #     f.dig(:a, :a, :b, 0) # => 1
+  #     f.dig(:b, 0) # => nil
+  #
+  # Given integer argument `n`, returns the object that is specified by `n` and
+  # `identifiers`:
+  #
+  #     f.dig(0) # => #<struct Foo a={:b=>[1, 2, 3]}>
+  #     f.dig(0, 0) # => {:b=>[1, 2, 3]}
+  #     f.dig(0, 0, :b) # => [1, 2, 3]
+  #     f.dig(0, 0, :b, 0) # => 1
+  #     f.dig(:b, 0) # => nil
+  #
+  def dig: (index name_or_position) -> Elem
+         | (index name_or_position, untyped, *untyped) -> untyped
+
+  # <!-- rdoc-file=struct.c -->
+  # Returns the values in `self` as an array:
+  #
+  #     Customer = Struct.new(:name, :address, :zip)
+  #     joe = Customer.new("Joe Smith", "123 Maple, Anytown NC", 12345)
+  #     joe.to_a # => ["Joe Smith", "123 Maple, Anytown NC", 12345]
+  #
+  # Related: #members.
+  #
+  alias deconstruct to_a
+
+  # <!--
+  #   rdoc-file=struct.c
+  #   - deconstruct_keys(array_of_names) -> hash
+  # -->
+  # Returns a hash of the name/value pairs for the given member names.
+  #
+  #     Customer = Struct.new(:name, :address, :zip)
+  #     joe = Customer.new("Joe Smith", "123 Maple, Anytown NC", 12345)
+  #     h = joe.deconstruct_keys([:zip, :address])
+  #     h # => {:zip=>12345, :address=>"123 Maple, Anytown NC"}
+  #
+  # Returns all names and values if `array_of_names` is `nil`:
+  #
+  #     h = joe.deconstruct_keys(nil)
+  #     h # => {:name=>"Joseph Smith, Jr.", :address=>"123 Maple, Anytown NC", :zip=>12345}
   #
-  def self.keyword_init?: () -> (true | false | nil)
+  def deconstruct_keys: (Array[index & Hash::_Key]? indices) -> Hash[index & Hash::_Key, Elem]
 end

data/core/symbol.rbs

@@ -161,15 +161,11 @@ class Symbol
   # -->
   # Returns `true` if `object` is the same object as `self`, `false` otherwise.
   #
-  # Symbol#=== is an alias for Symbol#==.
-  #
   def ==: (untyped obj) -> bool
 
   # <!-- rdoc-file=string.c -->
   # Returns `true` if `object` is the same object as `self`, `false` otherwise.
   #
-  # Symbol#=== is an alias for Symbol#==.
-  #
   def ===: (untyped obj) -> bool
 
   # <!--
@@ -311,7 +307,7 @@ class Symbol
 
   # <!--
   #   rdoc-file=string.c
-  #   - end_with?(*string_or_regexp) -> true or false
+  #   - end_with?(*strings) -> true or false
   # -->
   # Equivalent to `self.to_s.end_with?`; see String#end_with?.
   #
@@ -322,8 +318,6 @@ class Symbol
   #
   #     :foo.to_s # => "foo"
   #
-  # Symbol#id2name is an alias for Symbol#to_s.
-  #
   # Related: Symbol#inspect, Symbol#name.
   #
   def id2name: () -> String
@@ -353,8 +347,6 @@ class Symbol
   # -->
   # Equivalent to `self.to_s.length`; see String#length.
   #
-  # Symbol#size is an alias for Symbol#length.
-  #
   def length: () -> Integer
 
   # <!--
@@ -381,8 +373,6 @@ class Symbol
   #
   #     :foo.succ # => :fop
   #
-  # Symbol#next is an alias for Symbol#succ.
-  #
   # Related: String#succ.
   #
   def next: () -> Symbol
@@ -390,8 +380,6 @@ class Symbol
   # <!-- rdoc-file=string.c -->
   # Equivalent to `self.to_s.length`; see String#length.
   #
-  # Symbol#size is an alias for Symbol#length.
-  #
   alias size length
 
   # <!-- rdoc-file=string.c -->
@@ -415,8 +403,6 @@ class Symbol
   #
   #     :foo.succ # => :fop
   #
-  # Symbol#next is an alias for Symbol#succ.
-  #
   # Related: String#succ.
   #
   alias succ next
@@ -456,8 +442,6 @@ class Symbol
   #
   #     :foo.to_s # => "foo"
   #
-  # Symbol#id2name is an alias for Symbol#to_s.
-  #
   # Related: Symbol#inspect, Symbol#name.
   #
   alias to_s id2name
@@ -468,8 +452,6 @@ class Symbol
   # -->
   # Returns `self`.
   #
-  # Symbol#intern is an alias for Symbol#to_sym.
-  #
   # Related: String#to_sym.
   #
   alias to_sym intern

data/core/thread.rbs

@@ -991,9 +991,8 @@ class Thread < Object
   #      from prog.rb:2:in `new'
   #      from prog.rb:2
   #
-  def self?.raise: () -> bot
-                 | (String message, ?cause: Exception?) -> bot
-                 | (_Exception exception, ?untyped message, ?::Array[String] backtrace, ?cause: Exception?) -> bot
+  def raise: (?String message) -> nil
+           | (_Exception, ?_ToS message, ?Array[String] backtrace) -> nil
 
   # <!--
   #   rdoc-file=thread.c
@@ -1438,7 +1437,7 @@ class Thread::ConditionVariable < Object
   #
   # Returns the slept result on `mutex`.
   #
-  def wait: (Thread::Mutex mutex, ?Integer | Float? timeout) -> self
+  def wait: (Thread::Mutex mutex, ?Integer | Float? timeout) -> Integer?
 end
 
 # <!-- rdoc-file=thread_sync.c -->
@@ -1521,8 +1520,8 @@ end
 # exchanged safely between multiple threads. The Thread::Queue class implements
 # all the required locking semantics.
 #
-# The class implements FIFO type of queue. In a FIFO queue, the first tasks
-# added are the first retrieved.
+# The class implements FIFO (first in, first out) type of queue. In a FIFO
+# queue, the first tasks added are the first retrieved.
 #
 # Example:
 #
@@ -1530,17 +1529,17 @@ end
 #
 #     producer = Thread.new do
 #       5.times do |i|
-#          sleep rand(i) # simulate expense
-#          queue << i
-#          puts "#{i} produced"
+#         sleep rand(i) # simulate expense
+#         queue << i
+#         puts "#{i} produced"
 #       end
 #     end
 #
 #     consumer = Thread.new do
 #       5.times do |i|
-#          value = queue.pop
-#          sleep rand(i/2) # simulate expense
-#          puts "consumed #{value}"
+#         value = queue.pop
+#         sleep rand(i/2) # simulate expense
+#         puts "consumed #{value}"
 #       end
 #     end
 #
@@ -1623,6 +1622,15 @@ class Thread::Queue < Object
   #
   alias enq push
 
+  # <!--
+  #   rdoc-file=thread_sync.c
+  #   - freeze
+  # -->
+  # Raises an exception:
+  #     Queue.new.freeze # Raises TypeError (cannot freeze #<Thread::Queue:0x...>)
+  #
+  def freeze: () -> bot
+
   # <!--
   #   rdoc-file=thread_sync.c
   #   - length
@@ -1699,6 +1707,15 @@ class Thread::SizedQueue < Thread::Queue
   #
   alias enq push
 
+  # <!--
+  #   rdoc-file=thread_sync.c
+  #   - freeze
+  # -->
+  # Raises an exception:
+  #     Queue.new.freeze # Raises TypeError (cannot freeze #<Thread::Queue:0x...>)
+  #
+  def freeze: () -> bot
+
   # <!--
   #   rdoc-file=thread_sync.c
   #   - new(max)