rbs 4.1.0.pre.1 → 4.1.0

data/src/util/rbs_allocator.c

@@ -25,10 +25,7 @@
 #ifdef _WIN32
 #include <windows.h>
 #else
-#include <unistd.h>
-#include <sys/types.h>
-#include <sys/mman.h>
-#include <fcntl.h>
+#include <unistd.h> // for sysconf()
 #endif
 
 typedef struct rbs_allocator_page {
@@ -42,15 +39,24 @@ typedef struct rbs_allocator_page {
     size_t used;
 } rbs_allocator_page_t;
 
+// Normalize a raw page size to a safe value for payload_size subtraction.
+// Falls back to 4096 when the raw value is <= 0 or smaller than the page
+// header struct, preventing underflow in rbs_allocator_init.
+// Internal API, intentionally omitted from the public header.
+size_t rbs_allocator_normalize_page_size(long raw) {
+    if (raw <= 0) return 4096;
+    size_t page_size = (size_t) raw;
+    if (page_size <= sizeof(rbs_allocator_page_t)) return 4096;
+    return page_size;
+}
+
 static size_t get_system_page_size(void) {
 #ifdef _WIN32
     SYSTEM_INFO si;
     GetSystemInfo(&si);
-    return si.dwPageSize;
+    return rbs_allocator_normalize_page_size((long) si.dwPageSize);
 #else
-    long sz = sysconf(_SC_PAGESIZE);
-    if (sz == -1) return 4096; // Fallback to the common 4KB page size
-    return (size_t) sz;
+    return rbs_allocator_normalize_page_size(sysconf(_SC_PAGESIZE));
 #endif
 }
 

data/stdlib/abbrev/0/array.rbs

@@ -1,5 +1,5 @@
 %a{annotate:rdoc:skip}
-class Array[unchecked out Elem]
+class Array[unchecked out E]
   # <!--
   #   rdoc-file=lib/abbrev.rb
   #   - abbrev(pattern = nil)

data/stdlib/csv/0/csv.rbs

@@ -2964,8 +2964,8 @@ end
 #     table['Name'] = ['Foo', 'Bar', 'Baz']
 #     table['Name'] # => ["Foo", "Bar", "Baz"]
 #
-class CSV::Table[out Elem] < Object
-  include Enumerable[Elem]
+class CSV::Table[out E] < Object
+  include Enumerable[E]
   extend Forwardable
 
   # <!--
@@ -3587,8 +3587,8 @@ class CSV::Table[out Elem] < Object
   # Returns a new Enumerator if no block is given:
   #     table.each # => #<Enumerator: #<CSV::Table mode:col row_count:4>:each>
   #
-  def each: () -> Enumerator[Elem, self]
-          | () { (Elem) -> void } -> self
+  def each: () -> Enumerator[E, self]
+          | () { (E) -> void } -> self
           | () { (*untyped) -> void } -> self
 
   def empty?: (*untyped args) { (*untyped) -> untyped } -> untyped
@@ -3758,7 +3758,7 @@ class CSV::Table[out Elem] < Object
 end
 
 %a{annotate:rdoc:skip}
-class Array[unchecked out Elem] < Object
+class Array[unchecked out E] < Object
   # Equivalent to CSV::generate_line(self, options)
   #
   #   ["CSV", "data"].to_csv

data/stdlib/delegate/0/delegator.rbs

@@ -94,7 +94,7 @@ class Delegator < BasicObject
   #   rdoc-file=lib/delegate.rb
   #   - freeze()
   # -->
-  # :method: freeze Freeze both the object returned by `__getobj__` and self.
+  # Freeze both the object returned by `__getobj__` and self.
   #
   def freeze: () -> self
 
@@ -118,6 +118,7 @@ class Delegator < BasicObject
   #   rdoc-file=lib/delegate.rb
   #   - method_missing(m, *args, &block)
   # -->
+  # Handles the magic of delegation through `__getobj__`.
   #
   def method_missing: (Symbol m, *untyped args, **untyped) { (*untyped, **untyped) -> untyped } -> untyped
 

data/stdlib/digest/0/digest.rbs

@@ -303,7 +303,7 @@ module Digest::Instance
   # uninitialized.  Do not call this method from outside.  Use #digest!() instead,
   # which ensures that internal data be reset for security reasons.
   #
-  def finish: () -> self
+  def finish: () -> String
 end
 
 # <!-- rdoc-file=ext/digest/digest.c -->
@@ -536,13 +536,19 @@ class Digest::SHA2 < Digest::Class
   #
   def update: (String) -> self
 
-  private def finish: () -> String
-
   # <!--
-  #   rdoc-file=ext/digest/sha2/lib/sha2.rb
-  #   - <<(str)
+  #   rdoc-file=ext/digest/digest.c
+  #   - digest_obj.instance_eval { finish } -> digest_obj
   # -->
+  # Finishes the digest and returns the resulting hash value.
   #
+  # This method is overridden by each implementation subclass and often made
+  # private, because some of those subclasses may leave internal data
+  # uninitialized.  Do not call this method from outside.  Use #digest!() instead,
+  # which ensures that internal data be reset for security reasons.
+  #
+  private def finish: () -> String
+
   alias << update
 
   # <!--

data/stdlib/erb/0/erb.rbs

@@ -633,7 +633,7 @@ class ERB
   # # => "The time is 2025-09-18 15:58:08 -0500."
   #
   # In a more readable format:
-  #     # puts erb.src.split('; ')
+  #       # puts erb.src.split('; ')
   #   # #coding:UTF-8
   #   # _erbout = +''
   #   # _erbout.<< "The time is ".freeze

data/stdlib/etc/0/etc.rbs

@@ -295,7 +295,7 @@ module Etc
   #     Etc.sysconf(Etc::SC_ARG_MAX) #=> 2097152
   #     Etc.sysconf(Etc::SC_LOGIN_NAME_MAX) #=> 256
   #
-  def self?.sysconf: (::Integer p1) -> ::Integer
+  def self?.sysconf: (::Integer p1) -> ::Integer?
 
   # <!--
   #   rdoc-file=ext/etc/etc.c
@@ -318,7 +318,7 @@ module Etc
   # -->
   # Returns system temporary directory; typically "/tmp".
   #
-  def self?.systmpdir: () -> ::String
+  def self?.systmpdir: () -> ::String?
 
   # <!--
   #   rdoc-file=ext/etc/etc.c
@@ -709,7 +709,8 @@ module Etc
     #     Etc::Group.collect {|g| g.name}
     #     Etc::Group.select {|g| !g.mem.empty?}
     #
-    def self.each: () -> untyped
+    def self.each: () { (::Etc::Group) -> void } -> singleton(::Etc::Group)
+                 | () -> ::Enumerator[::Etc::Group]
 
     def self.inspect: () -> untyped
 
@@ -817,7 +818,8 @@ module Etc
     #     Etc::Passwd.collect {|u| u.gecos}
     #     Etc::Passwd.collect {|u| u.gecos}
     #
-    def self.each: () -> untyped
+    def self.each: () { (::Etc::Passwd) -> void } -> singleton(::Etc::Passwd)
+                 | () -> ::Enumerator[::Etc::Passwd]
 
     def self.inspect: () -> untyped
 
@@ -827,10 +829,18 @@ module Etc
 
     def self.new: (*untyped) -> untyped
 
+    def age: () -> Integer
+
+    def age=: (Integer new_age) -> void
+
     def change: () -> Integer
 
     def change=: (Integer new_change) -> void
 
+    def comment: () -> String
+
+    def comment=: (String new_comment) -> void
+
     def dir: () -> String
 
     def dir=: (String new_dir) -> void
@@ -855,6 +865,10 @@ module Etc
 
     def passwd=: (String new_passwd) -> void
 
+    def quota: () -> Integer
+
+    def quota=: (Integer new_quota) -> void
+
     def shell: () -> String
 
     def shell=: (String new_shell) -> void

data/stdlib/fileutils/0/fileutils.rbs

@@ -189,7 +189,7 @@ module FileUtils
   %a{deprecated: Use top-level `path` instead}
   type path = ::path
 
-  type pathlist = path | Array[path]
+  type pathlist = ::path | Array[::path]
 
   # <!--
   #   rdoc-file=lib/fileutils.rb
@@ -228,8 +228,8 @@ module FileUtils
   #
   # Related: FileUtils.pwd.
   #
-  def self?.cd: (path dir, ?verbose: boolish) -> void
-              | [X] (path dir, ?verbose: boolish) { (String) -> X } -> X
+  def self?.cd: (::path dir, ?verbose: boolish) -> void
+              | [X] (::path dir, ?verbose: boolish) { (String) -> X } -> X
 
   # <!--
   #   rdoc-file=lib/fileutils.rb
@@ -444,7 +444,7 @@ module FileUtils
   #
   # Related: FileUtils.compare_stream.
   #
-  def self?.compare_file: (path a, path b) -> bool
+  def self?.compare_file: (::path a, ::path b) -> bool
 
   # <!--
   #   rdoc-file=lib/fileutils.rb
@@ -538,7 +538,7 @@ module FileUtils
   #
   # Related: [methods for copying](rdoc-ref:FileUtils@Copying).
   #
-  def self?.copy_entry: (path src, path dest, ?boolish preserve, ?boolish dereference_root, ?boolish remove_destination) -> void
+  def self?.copy_entry: (::path src, ::path dest, ?boolish preserve, ?boolish dereference_root, ?boolish remove_destination) -> void
 
   # <!--
   #   rdoc-file=lib/fileutils.rb
@@ -565,7 +565,7 @@ module FileUtils
   #
   # Related: [methods for copying](rdoc-ref:FileUtils@Copying).
   #
-  def self?.copy_file: (path src, path dest, ?boolish preserve, ?boolish dereference) -> void
+  def self?.copy_file: (::path src, ::path dest, ?boolish preserve, ?boolish dereference) -> void
 
   # <!--
   #   rdoc-file=lib/fileutils.rb
@@ -633,7 +633,7 @@ module FileUtils
   #
   # Related: [methods for copying](rdoc-ref:FileUtils@Copying).
   #
-  def self?.cp: (pathlist src, path dest, ?preserve: boolish, ?noop: boolish, ?verbose: boolish) -> void
+  def self?.cp: (pathlist src, ::path dest, ?preserve: boolish, ?noop: boolish, ?verbose: boolish) -> void
 
   # <!--
   #   rdoc-file=lib/fileutils.rb
@@ -750,7 +750,7 @@ module FileUtils
   #
   # Related: [methods for copying](rdoc-ref:FileUtils@Copying).
   #
-  def self?.cp_lr: (pathlist src, path dest, ?noop: boolish, ?verbose: boolish, ?dereference_root: boolish, ?remove_destination: boolish) -> void
+  def self?.cp_lr: (pathlist src, ::path dest, ?noop: boolish, ?verbose: boolish, ?dereference_root: boolish, ?remove_destination: boolish) -> void
 
   # <!--
   #   rdoc-file=lib/fileutils.rb
@@ -856,7 +856,7 @@ module FileUtils
   #
   # Related: [methods for copying](rdoc-ref:FileUtils@Copying).
   #
-  def self?.cp_r: (pathlist src, path dest, ?preserve: boolish, ?noop: boolish, ?verbose: boolish, ?dereference_root: boolish, ?remove_destination: boolish) -> void
+  def self?.cp_r: (pathlist src, ::path dest, ?preserve: boolish, ?noop: boolish, ?verbose: boolish, ?dereference_root: boolish, ?remove_destination: boolish) -> void
 
   # <!--
   #   rdoc-file=lib/fileutils.rb
@@ -937,7 +937,7 @@ module FileUtils
   #
   # Related: [methods for copying](rdoc-ref:FileUtils@Copying).
   #
-  def self?.install: (path src, path dest, ?mode: mode?, ?owner: String?, ?group: String?, ?preserve: boolish, ?noop: boolish, ?verbose: boolish) -> void
+  def self?.install: (::path src, ::path dest, ?mode: mode?, ?owner: String?, ?group: String?, ?preserve: boolish, ?noop: boolish, ?verbose: boolish) -> void
 
   # <!--
   #   rdoc-file=lib/fileutils.rb
@@ -986,7 +986,7 @@ module FileUtils
   #
   # Related: FileUtils.ln (has different options).
   #
-  def self?.link_entry: (path src, path dest, ?boolish dereference_root, ?boolish remove_destination) -> void
+  def self?.link_entry: (::path src, ::path dest, ?boolish dereference_root, ?boolish remove_destination) -> void
 
   # <!--
   #   rdoc-file=lib/fileutils.rb
@@ -1044,7 +1044,7 @@ module FileUtils
   #
   # Related: FileUtils.link_entry (has different options).
   #
-  def self?.ln: (pathlist src, path dest, ?force: boolish, ?noop: boolish, ?verbose: boolish) -> void
+  def self?.ln: (pathlist src, ::path dest, ?force: boolish, ?noop: boolish, ?verbose: boolish) -> void
 
   # <!--
   #   rdoc-file=lib/fileutils.rb
@@ -1131,7 +1131,7 @@ module FileUtils
   #
   # Related: FileUtils.ln_sf.
   #
-  def self?.ln_s: (pathlist src, path dest, ?force: boolish, ?relative: boolish, ?target_directory: boolish, ?noop: boolish, ?verbose: boolish) -> void
+  def self?.ln_s: (pathlist src, ::path dest, ?force: boolish, ?relative: boolish, ?target_directory: boolish, ?noop: boolish, ?verbose: boolish) -> void
 
   # <!--
   #   rdoc-file=lib/fileutils.rb
@@ -1154,7 +1154,7 @@ module FileUtils
   # Like FileUtils.ln_s, but always with keyword argument <code>force: true</code>
   # given.
   #
-  def self?.ln_sf: (pathlist src, path dest, ?noop: boolish, ?verbose: boolish) -> void
+  def self?.ln_sf: (pathlist src, ::path dest, ?noop: boolish, ?verbose: boolish) -> void
 
   # <!--
   #   rdoc-file=lib/fileutils.rb
@@ -1162,7 +1162,7 @@ module FileUtils
   # -->
   # Like FileUtils.ln_s, but create links relative to `dest`.
   #
-  def self?.ln_sr: (pathlist src, path dest, ?target_directory: boolish, ?noop: boolish, ?verbose: boolish) -> void
+  def self?.ln_sr: (pathlist src, ::path dest, ?target_directory: boolish, ?noop: boolish, ?verbose: boolish) -> void
 
   # <!--
   #   rdoc-file=lib/fileutils.rb
@@ -1339,7 +1339,7 @@ module FileUtils
   #         mv src0 dest0
   #         mv src1.txt src1 dest1
   #
-  def self?.mv: (pathlist src, path dest, ?force: boolish, ?noop: boolish, ?verbose: boolish, ?secure: boolish) -> void
+  def self?.mv: (pathlist src, ::path dest, ?force: boolish, ?noop: boolish, ?verbose: boolish, ?secure: boolish) -> void
 
   # <!--
   #   rdoc-file=lib/fileutils.rb
@@ -1418,7 +1418,7 @@ module FileUtils
   #
   # Related: [methods for deleting](rdoc-ref:FileUtils@Deleting).
   #
-  def self?.remove_dir: (path path, ?boolish force) -> void
+  def self?.remove_dir: (::path path, ?boolish force) -> void
 
   # <!--
   #   rdoc-file=lib/fileutils.rb
@@ -1435,7 +1435,7 @@ module FileUtils
   #
   # Related: FileUtils.remove_entry_secure.
   #
-  def self?.remove_entry: (path path, ?boolish force) -> void
+  def self?.remove_entry: (::path path, ?boolish force) -> void
 
   # <!--
   #   rdoc-file=lib/fileutils.rb
@@ -1456,7 +1456,7 @@ module FileUtils
   #
   # Related: [methods for deleting](rdoc-ref:FileUtils@Deleting).
   #
-  def self?.remove_entry_secure: (path path, ?boolish force) -> void
+  def self?.remove_entry_secure: (::path path, ?boolish force) -> void
 
   # <!--
   #   rdoc-file=lib/fileutils.rb
@@ -1473,7 +1473,7 @@ module FileUtils
   #
   # Related: [methods for deleting](rdoc-ref:FileUtils@Deleting).
   #
-  def self?.remove_file: (path path, ?boolish force) -> void
+  def self?.remove_file: (::path path, ?boolish force) -> void
 
   # <!--
   #   rdoc-file=lib/fileutils.rb
@@ -1749,5 +1749,5 @@ module FileUtils
   #
   # Related: FileUtils.touch.
   #
-  def self?.uptodate?: (path new, _Each[path] old_list) -> bool
+  def self?.uptodate?: (::path new, _Each[::path] old_list) -> bool
 end

data/stdlib/ipaddr/0/ipaddr.rbs

@@ -98,11 +98,6 @@ class IPAddr
   #
   def ==: (untyped other) -> bool
 
-  # <!--
-  #   rdoc-file=lib/ipaddr.rb
-  #   - ===(other)
-  # -->
-  #
   alias === include?
 
   # <!--

data/stdlib/json/0/json.rbs

@@ -1307,7 +1307,7 @@ class Hash[unchecked out K, unchecked out V]
 end
 
 %a{annotate:rdoc:skip}
-class Array[unchecked out Elem]
+class Array[unchecked out E]
   # Returns a JSON string containing a JSON array, that is generated from
   # this Array instance.
   # _state_ is a JSON::State object, that can also be used to configure the
@@ -1616,7 +1616,7 @@ class OpenStruct
 end
 
 %a{annotate:rdoc:skip}
-class Range[out Elem]
+class Range[out E]
   # <!--
   #   rdoc-file=ext/json/lib/json/add/range.rb
   #   - json_create(object)
@@ -1648,7 +1648,7 @@ class Range[out Elem]
   #     Range.json_create(y) # => 1...4
   #     Range.json_create(z) # => "a".."d"
   #
-  def as_json: (*untyped) -> Hash[String, String | [ Elem, Elem, bool ]]
+  def as_json: (*untyped) -> Hash[String, String | [ E, E, bool ]]
 
   # <!--
   #   rdoc-file=ext/json/lib/json/add/range.rb
@@ -1815,14 +1815,14 @@ class Set[unchecked out A]
 end
 
 %a{annotate:rdoc:skip}
-class Struct[Elem]
+class Struct[E]
   # <!--
   #   rdoc-file=ext/json/lib/json/add/struct.rb
   #   - json_create(object)
   # -->
   # See #as_json.
   #
-  def self.json_create: [Elem] (Hash[String, String | Array[Elem]] object) -> Struct[Elem]
+  def self.json_create: [E] (Hash[String, String | Array[E]] object) -> Struct[E]
 
   # <!--
   #   rdoc-file=ext/json/lib/json/add/struct.rb
@@ -1846,7 +1846,7 @@ class Struct[Elem]
   #     Struct::Customer.json_create(x)
   #     # => #<struct Struct::Customer name=nil, address=nil, zip=nil>
   #
-  def as_json: (*untyped) -> Hash[String, String | Array[Elem]]
+  def as_json: (*untyped) -> Hash[String, String | Array[E]]
 
   # <!--
   #   rdoc-file=ext/json/lib/json/add/struct.rb

data/stdlib/monitor/0/monitor.rbs

@@ -338,7 +338,7 @@ class MonitorMixin::ConditionVariable
 
   # <!--
   #   rdoc-file=ext/monitor/lib/monitor.rb
-  #   - wait_until()
+  #   - wait_until() { || ... }
   # -->
   # Calls wait repeatedly until the given block yields a truthy value.
   #
@@ -346,7 +346,7 @@ class MonitorMixin::ConditionVariable
 
   # <!--
   #   rdoc-file=ext/monitor/lib/monitor.rb
-  #   - wait_while()
+  #   - wait_while() { || ... }
   # -->
   # Calls wait repeatedly while the given block yields a truthy value.
   #

data/stdlib/openssl/0/openssl.rbs

@@ -2100,7 +2100,7 @@ module OpenSSL
     #
     # See IO#read for full details.
     #
-    def read: (?Integer? size, ?String buf) -> String?
+    def read: (?Integer? size, ?String? buf) -> String?
 
     # <!--
     #   rdoc-file=ext/openssl/lib/openssl/buffering.rb
@@ -2139,8 +2139,8 @@ module OpenSSL
     # symbol <code>:wait_writable</code> or <code>:wait_readable</code> instead. At
     # EOF, it will return `nil` instead of raising EOFError.
     #
-    def read_nonblock: (Integer maxlen, ?String buf, ?exception: true) -> String
-                     | (Integer maxlen, ?String buf, exception: false) -> (String | :wait_writable | :wait_readable | nil)
+    def read_nonblock: (Integer maxlen, ?String? buf, ?exception: true) -> String
+                     | (Integer maxlen, ?String? buf, exception: false) -> (String | :wait_writable | :wait_readable | nil)
 
     # <!--
     #   rdoc-file=ext/openssl/lib/openssl/buffering.rb
@@ -2180,7 +2180,7 @@ module OpenSSL
     #
     # See IO#readpartial for full details.
     #
-    def readpartial: (Integer maxlen, ?String buf) -> String
+    def readpartial: (Integer maxlen, ?String? buf) -> String
 
     # <!-- rdoc-file=ext/openssl/lib/openssl/buffering.rb -->
     # The "sync mode" of the SSLSocket.
@@ -5913,10 +5913,17 @@ module OpenSSL
       def initialize_copy: (self) -> void
     end
 
-    # <!-- rdoc-file=ext/openssl/ossl_pkey_dh.c -->
-    # Generic exception that is raised if an operation on a DH PKey fails
-    # unexpectedly or in case an instantiation of an instance of DH fails due to
-    # non-conformant input data.
+    # <!-- rdoc-file=ext/openssl/ossl_pkey.c -->
+    # Raised when errors occur during PKey#sign or PKey#verify.
+    #
+    # Before version 4.0.0, OpenSSL::PKey::PKeyError had the following subclasses.
+    # These subclasses have been removed and the constants are now defined as
+    # aliases of OpenSSL::PKey::PKeyError.
+    #
+    # *   OpenSSL::PKey::DHError
+    # *   OpenSSL::PKey::DSAError
+    # *   OpenSSL::PKey::ECError
+    # *   OpenSSL::PKey::RSAError
     #
     class DHError < OpenSSL::PKey::PKeyError
     end
@@ -6304,10 +6311,17 @@ module OpenSSL
       def initialize_copy: (self) -> void
     end
 
-    # <!-- rdoc-file=ext/openssl/ossl_pkey_dsa.c -->
-    # Generic exception that is raised if an operation on a DSA PKey fails
-    # unexpectedly or in case an instantiation of an instance of DSA fails due to
-    # non-conformant input data.
+    # <!-- rdoc-file=ext/openssl/ossl_pkey.c -->
+    # Raised when errors occur during PKey#sign or PKey#verify.
+    #
+    # Before version 4.0.0, OpenSSL::PKey::PKeyError had the following subclasses.
+    # These subclasses have been removed and the constants are now defined as
+    # aliases of OpenSSL::PKey::PKeyError.
+    #
+    # *   OpenSSL::PKey::DHError
+    # *   OpenSSL::PKey::DSAError
+    # *   OpenSSL::PKey::ECError
+    # *   OpenSSL::PKey::RSAError
     #
     class DSAError < OpenSSL::PKey::PKeyError
     end
@@ -7011,6 +7025,18 @@ module OpenSSL
       end
     end
 
+    # <!-- rdoc-file=ext/openssl/ossl_pkey.c -->
+    # Raised when errors occur during PKey#sign or PKey#verify.
+    #
+    # Before version 4.0.0, OpenSSL::PKey::PKeyError had the following subclasses.
+    # These subclasses have been removed and the constants are now defined as
+    # aliases of OpenSSL::PKey::PKeyError.
+    #
+    # *   OpenSSL::PKey::DHError
+    # *   OpenSSL::PKey::DSAError
+    # *   OpenSSL::PKey::ECError
+    # *   OpenSSL::PKey::RSAError
+    #
     class ECError < OpenSSL::PKey::PKeyError
     end
 
@@ -9235,7 +9261,7 @@ module OpenSSL
       # Reads *length* bytes from the SSL connection.  If a pre-allocated *buffer* is
       # provided the data will be written into it.
       #
-      def sysread: (Integer length, ?String buffer) -> String
+      def sysread: (Integer length, ?String? buffer) -> String
 
       # <!--
       #   rdoc-file=ext/openssl/ossl_ssl.c
@@ -9282,6 +9308,7 @@ module OpenSSL
       #   rdoc-file=ext/openssl/ossl_ssl.c
       #   - SSLSocket.new(io) => aSSLSocket
       #   - SSLSocket.new(io, ctx) => aSSLSocket
+      #   - SSLSocket.new(io, ctx, sync_close:) => aSSLSocket
       # -->
       # Creates a new SSL socket from *io* which must be a real IO object (not an
       # IO-like object that responds to read/write).
@@ -9289,6 +9316,10 @@ module OpenSSL
       # If *ctx* is provided the SSL Sockets initial params will be taken from the
       # context.
       #
+      # The optional *sync_close* keyword parameter sets the *sync_close* instance
+      # variable. Setting this to `true` will cause the underlying socket to be closed
+      # when the SSL/TLS connection is shut down.
+      #
       # The OpenSSL::Buffering module provides additional IO methods.
       #
       # This method will freeze the SSLContext if one is provided; however, session
@@ -10390,11 +10421,6 @@ module OpenSSL
 
       extend OpenSSL::Marshal::ClassMethods
 
-      # <!--
-      #   rdoc-file=ext/openssl/lib/openssl/x509.rb
-      #   - ==(other)
-      # -->
-      #
       def ==: (self other) -> bool
 
       # <!--
@@ -10462,11 +10488,6 @@ module OpenSSL
 
       extend OpenSSL::Marshal::ClassMethods
 
-      # <!--
-      #   rdoc-file=ext/openssl/lib/openssl/x509.rb
-      #   - ==(other)
-      # -->
-      #
       def ==: (self other) -> bool
 
       # <!--
@@ -10982,11 +11003,6 @@ module OpenSSL
 
       extend OpenSSL::Marshal::ClassMethods
 
-      # <!--
-      #   rdoc-file=ext/openssl/lib/openssl/x509.rb
-      #   - ==(other)
-      # -->
-      #
       def ==: (self other) -> bool
 
       # <!--
@@ -11610,11 +11626,6 @@ module OpenSSL
 
       extend OpenSSL::Marshal::ClassMethods
 
-      # <!--
-      #   rdoc-file=ext/openssl/lib/openssl/x509.rb
-      #   - ==(other)
-      # -->
-      #
       def ==: (untyped other) -> bool
 
       # <!--
@@ -11755,11 +11766,6 @@ module OpenSSL
     end
 
     class Revoked
-      # <!--
-      #   rdoc-file=ext/openssl/lib/openssl/x509.rb
-      #   - ==(other)
-      # -->
-      #
       def ==: (untyped other) -> bool
 
       # <!--

data/stdlib/resolv/0/resolv.rbs

@@ -134,7 +134,7 @@ class Resolv
   # DNS resolver.  If `resolvers` is a hash, uses the hash as configuration for
   # the DNS resolver.
   #
-  def initialize: (?Resolv::Hosts | Resolv::DNS resolvers) -> untyped
+  def initialize: (?(Array[Resolv::Hosts | Resolv::DNS] | Hash[Symbol, untyped])? resolvers, ?use_ipv6: bool?) -> untyped
 end
 
 # <!-- rdoc-file=lib/resolv.rb -->

data/stdlib/shellwords/0/shellwords.rbs

@@ -191,7 +191,7 @@ module Shellwords
 end
 
 %a{annotate:rdoc:skip}
-class Array[unchecked out Elem]
+class Array[unchecked out E]
   # <!--
   #   rdoc-file=lib/shellwords.rb
   #   - array.shelljoin => string