rbs 3.6.1 → 3.9.5

data/core/enumerator.rbs

@@ -6,7 +6,6 @@
 # *   Object#enum_for
 # *   Enumerator.new
 #
-#
 # Most methods have two forms: a block form where the contents are evaluated for
 # each item in the enumeration, and a non-block form which returns a new
 # Enumerator wrapping the iteration.
@@ -75,7 +74,6 @@
 #     Enumerator Fiber, you need to use an extra indirection (e.g., use some
 #     object in the Fiber storage variable and mutate some ivar of it).
 #
-#
 # Concretely:
 #
 #     Thread.current[:fiber_local] = 1
@@ -615,7 +613,18 @@ end
 # This type of objects can be created by Enumerable#chain and Enumerator#+.
 #
 class Enumerator::Chain[out Elem] < Enumerator[Elem, void]
-  include Enumerable[Elem]
+  # <!--
+  #   rdoc-file=enumerator.c
+  #   - Enumerator::Chain.new(*enums) -> enum
+  # -->
+  # Generates a new enumerator object that iterates over the elements of given
+  # enumerable objects in sequence.
+  #
+  #     e = Enumerator::Chain.new(1..3, [4, 5])
+  #     e.to_a #=> [1, 2, 3, 4, 5]
+  #     e.size #=> 5
+  #
+  def initialize: (*_Each[Elem] enums) -> void
 
   # <!--
   #   rdoc-file=enumerator.c
@@ -628,5 +637,6 @@ class Enumerator::Chain[out Elem] < Enumerator[Elem, void]
   #
   # If no block is given, returns an enumerator.
   #
-  def each: () { (Elem) -> void } -> void
+  def each: () { (Elem) -> void } -> self
+          | () -> Enumerator[Elem, self]
 end

data/core/env.rbs

@@ -1,5 +1,5 @@
 # <!-- rdoc-file=hash.c -->
-# ENV is a Hash-like accessor for environment variables.
+# `ENV` is a Hash-like accessor for environment variables.
 #
 # See ENV (the class) for more details.
 #

data/core/errno.rbs

@@ -1,25 +1,42 @@
 # <!-- rdoc-file=error.c -->
-# Ruby exception objects are subclasses of Exception.  However, operating
-# systems typically report errors using plain integers. Module Errno is created
-# dynamically to map these operating system errors to Ruby classes, with each
-# error number generating its own subclass of SystemCallError.  As the subclass
-# is created in module Errno, its name will start `Errno::`.
+# When an operating system encounters an error, it typically reports the error
+# as an integer error code:
 #
-# The names of the `Errno::` classes depend on the environment in which Ruby
-# runs. On a typical Unix or Windows platform, there are Errno classes such as
-# Errno::EACCES, Errno::EAGAIN, Errno::EINTR, and so on.
+#     $ ls nosuch.txt
+#     ls: cannot access 'nosuch.txt': No such file or directory
+#     $ echo $? # Code for last error.
+#     2
 #
-# The integer operating system error number corresponding to a particular error
-# is available as the class constant `Errno::`*error*`::Errno`.
+# When the Ruby interpreter interacts with the operating system and receives
+# such an error code (e.g., `2`), it maps the code to a particular Ruby
+# exception class (e.g., `Errno::ENOENT`):
 #
-#     Errno::EACCES::Errno   #=> 13
-#     Errno::EAGAIN::Errno   #=> 11
-#     Errno::EINTR::Errno    #=> 4
+#     File.open('nosuch.txt')
+#     # => No such file or directory @ rb_sysopen - nosuch.txt (Errno::ENOENT)
 #
-# The full list of operating system errors on your particular platform are
-# available as the constants of Errno.
+# Each such class is:
 #
-#     Errno.constants   #=> :E2BIG, :EACCES, :EADDRINUSE, :EADDRNOTAVAIL, ...
+# *   A nested class in this module, `Errno`.
+# *   A subclass of class SystemCallError.
+# *   Associated with an error code.
+#
+# Thus:
+#
+#     Errno::ENOENT.superclass # => SystemCallError
+#     Errno::ENOENT::Errno     # => 2
+#
+# The names of nested classes are returned by method `Errno.constants`:
+#
+#     Errno.constants.size         # => 158
+#     Errno.constants.sort.take(5) # => [:E2BIG, :EACCES, :EADDRINUSE, :EADDRNOTAVAIL, :EADV]
+#
+# As seen above, the error code associated with each class is available as the
+# value of a constant; the value for a particular class may vary among operating
+# systems. If the class is not needed for the particular operating system, the
+# value is zero:
+#
+#     Errno::ENOENT::Errno      # => 2
+#     Errno::ENOTCAPABLE::Errno # => 0
 #
 module Errno
   class NOERROR < SystemCallError

data/core/errors.rbs

@@ -188,9 +188,13 @@ end
 #
 #     LoadError: no such file to load -- this/file/does/not/exist
 #
+# <!-- rdoc-file=lib/bundled_gems.rb -->
+# for RubyGems without Bundler environment. If loading library is not part of
+# the default gems and the bundled gems, warn it.
+#
 class LoadError < ScriptError
   # <!-- rdoc-file=error.c -->
-  # the path failed to load
+  # the path that failed to load
   #
   def path: () -> String?
 end
@@ -564,7 +568,7 @@ class SyntaxError < ScriptError
   def initialize: (?string msg) -> void
 
   # <!-- rdoc-file=error.c -->
-  # the path failed to parse
+  # the path that failed to parse
   #
   def path: () -> String?
 end