rbs 3.9.4 → 3.10.2

data/core/rubygems/rubygems.rbs

@@ -17,7 +17,7 @@
 # Further RubyGems documentation can be found at:
 #
 # *   [RubyGems Guides](https://guides.rubygems.org)
-# *   [RubyGems API](https://www.rubydoc.info/github/rubygems/rubygems) (also
+# *   [RubyGems API](https://www.rubydoc.info/github/ruby/rubygems) (also
 #     available from `gem server`)
 #
 # ## RubyGems Plugins
@@ -48,7 +48,7 @@
 # ## Bugs
 #
 # You can submit bugs to the [RubyGems bug
-# tracker](https://github.com/rubygems/rubygems/issues) on GitHub
+# tracker](https://github.com/ruby/rubygems/issues) on GitHub
 #
 # ## Credits
 #
@@ -83,80 +83,13 @@
 #
 # ## License
 #
-# See
-# [LICENSE.txt](https://github.com/rubygems/rubygems/blob/master/LICENSE.txt)
+# See [LICENSE.txt](https://github.com/ruby/rubygems/blob/master/LICENSE.txt)
 # for permissions.
 #
 # Thanks!
 #
 # -The RubyGems Team
 #
-# <!-- rdoc-file=lib/rubygems/deprecate.rb -->
-# Provides 3 methods for declaring when something is going away.
-#
-# +deprecate(name, repl, year, month)+:
-#     Indicate something may be removed on/after a certain date.
-#
-# +rubygems_deprecate(name, replacement=:none)+:
-#     Indicate something will be removed in the next major RubyGems version,
-#     and (optionally) a replacement for it.
-#
-# `rubygems_deprecate_command`:
-#     Indicate a RubyGems command (in +lib/rubygems/commands/*.rb+) will be
-#     removed in the next RubyGems version.
-#
-# Also provides `skip_during` for temporarily turning off deprecation warnings.
-# This is intended to be used in the test suite, so deprecation warnings don't
-# cause test failures if you need to make sure stderr is otherwise empty.
-#
-# Example usage of `deprecate` and `rubygems_deprecate`:
-#
-#     class Legacy
-#       def self.some_class_method
-#         # ...
-#       end
-#
-#       def some_instance_method
-#         # ...
-#       end
-#
-#       def some_old_method
-#         # ...
-#       end
-#
-#       extend Gem::Deprecate
-#       deprecate :some_instance_method, "X.z", 2011, 4
-#       rubygems_deprecate :some_old_method, "Modern#some_new_method"
-#
-#       class << self
-#         extend Gem::Deprecate
-#         deprecate :some_class_method, :none, 2011, 4
-#       end
-#     end
-#
-# Example usage of `rubygems_deprecate_command`:
-#
-#     class Gem::Commands::QueryCommand < Gem::Command
-#       extend Gem::Deprecate
-#       rubygems_deprecate_command
-#
-#       # ...
-#     end
-#
-# Example usage of `skip_during`:
-#
-#     class TestSomething < Gem::Testcase
-#       def test_some_thing_with_deprecations
-#         Gem::Deprecate.skip_during do
-#           actual_stdout, actual_stderr = capture_output do
-#             Gem.something_deprecated
-#           end
-#           assert_empty actual_stdout
-#           assert_equal(expected, actual_stderr)
-#         end
-#       end
-#     end
-#
 module Gem
   interface _HashLike[K, V]
     def each_pair: () { ([ K, V ]) -> untyped } -> self
@@ -204,7 +137,7 @@ module Gem
 
   VERSION: String
 
-  # <!-- rdoc-file=lib/rubygems.rb -->
+  # <!-- rdoc-file=lib/rubygems/win_platform.rb -->
   # An Array of Regexps that match windows Ruby platforms.
   #
   WIN_PATTERNS: Array[Regexp]
@@ -251,7 +184,7 @@ module Gem
 
   # <!--
   #   rdoc-file=lib/rubygems.rb
-  #   - bindir(install_dir=Gem.dir)
+  #   - bindir(install_dir = Gem.dir)
   # -->
   # The path where gem executables are to be installed.
   #
@@ -509,7 +442,7 @@ module Gem
 
   # <!--
   #   rdoc-file=lib/rubygems.rb
-  #   - find_files(glob, check_load_path=true)
+  #   - find_files(glob, check_load_path = true)
   # -->
   # Returns a list of paths matching `glob` that can be used by a gem to pick up
   # features from other gems.  For example:
@@ -526,7 +459,7 @@ module Gem
 
   # <!--
   #   rdoc-file=lib/rubygems.rb
-  #   - find_latest_files(glob, check_load_path=true)
+  #   - find_latest_files(glob, check_load_path = true)
   # -->
   # Returns a list of paths matching `glob` from the latest gems that can be used
   # by a gem to pick up features from other gems.  For example:
@@ -551,7 +484,7 @@ module Gem
 
   # <!--
   #   rdoc-file=lib/rubygems.rb
-  #   - finish_resolve(request_set=Gem::RequestSet.new)
+  #   - finish_resolve(request_set = Gem::RequestSet.new)
   # -->
   #
   def self.finish_resolve: (?RequestSet request_set) -> void
@@ -804,7 +737,7 @@ module Gem
 
   # <!--
   #   rdoc-file=lib/rubygems.rb
-  #   - plugindir(install_dir=Gem.dir)
+  #   - plugindir(install_dir = Gem.dir)
   # -->
   # The path were rubygems plugins are to be installed.
   #
@@ -1009,8 +942,7 @@ module Gem
   #   - source_date_epoch_string()
   # -->
   # If the SOURCE_DATE_EPOCH environment variable is set, returns it's value.
-  # Otherwise, returns the time that `Gem.source_date_epoch_string` was first
-  # called in the same format as SOURCE_DATE_EPOCH.
+  # Otherwise, returns DEFAULT_SOURCE_DATE_EPOCH as a string.
   #
   # NOTE(@duckinator): The implementation is a tad weird because we want to:
   #     1. Make builds reproducible by default, by having this function always
@@ -1154,7 +1086,7 @@ module Gem
   def self.user_home: () -> String
 
   # <!--
-  #   rdoc-file=lib/rubygems.rb
+  #   rdoc-file=lib/rubygems/win_platform.rb
   #   - win_platform?()
   # -->
   # Is this a windows platform?

data/core/rubygems/version.rbs

@@ -180,7 +180,6 @@ module Gem
     #
     #     ver1 = Version.create('1.3.17')   # -> (Version object)
     #     ver2 = Version.create(ver1)       # -> (ver1)
-    #     ver3 = Version.create(nil)        # -> nil
     #
     def self.create: (_ToS | Version input) -> instance
                    | (nil input) -> nil
@@ -199,8 +198,8 @@ module Gem
     #   - <=>(other)
     # -->
     # Compares this version with `other` returning -1, 0, or 1 if the other version
-    # is larger, the same, or smaller than this one. Attempts to compare to
-    # something that's not a `Gem::Version` or a valid version String return `nil`.
+    # is larger, the same, or smaller than this one. `other` must be an instance of
+    # Gem::Version, comparing with other types may raise an exception.
     #
     def <=>: (untyped other) -> Integer?