Run bin/generate_docs.sh again

Author: soutaro

core/io/wait.rbs

@@ -3,17 +3,22 @@ class IO
   # <!--
   #   rdoc-file=io.c
   #   - io.wait(events, timeout) -> event mask, false or nil
-  #   - io.wait(timeout = nil, mode = :read) -> self, true, or false
+  #   - io.wait(*event_symbols[, timeout]) -> self, true, or false
   # -->
   # Waits until the IO becomes ready for the specified events and returns the
   # subset of events that become ready, or a falsy value when times out.
   #
   # The events can be a bit mask of `IO::READABLE`, `IO::WRITABLE` or
   # `IO::PRIORITY`.
   #
-  # Returns a truthy value immediately when buffered data is available.
+  # Returns an event mask (truthy value) immediately when buffered data is
+  # available.
   #
-  # Optional parameter `mode` is one of `:read`, `:write`, or `:read_write`.
+  # The second form: if one or more event symbols (`:read`, `:write`, or
+  # `:read_write`) are passed, the event mask is the bit OR of the bitmask
+  # corresponding to those symbols.  In this form, `timeout` is optional, the
+  # order of the arguments is arbitrary, and returns `io` if any of the events is
+  # ready.
   #
   def wait: (Integer events, ?Time::_Timeout timeout) -> (Integer | false | nil)
           | (?Time::_Timeout? timeout, *wait_mode mode) -> (self | true | false)

core/rubygems/rubygems.rbs

@@ -942,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

core/time.rbs

@@ -990,10 +990,20 @@ class Time < Object
   #     now = Time.now
   #     # => 2022-08-18 10:24:13.5398485 -0500
   #     now.utc? # => false
+  #     now.getutc.utc? # => true
   #     utc = Time.utc(2000, 1, 1, 20, 15, 1)
   #     # => 2000-01-01 20:15:01 UTC
   #     utc.utc? # => true
   #
+  # `Time` objects created with these methods are considered to be in UTC:
+  #
+  # *   Time.utc
+  # *   Time#utc
+  # *   Time#getutc
+  #
+  # Objects created in other ways will not be treated as UTC even if the
+  # environment variable "TZ" is "UTC".
+  #
   # Related: Time.utc.
   #
   def gmt?: () -> bool
@@ -1566,10 +1576,20 @@ class Time < Object
   #     now = Time.now
   #     # => 2022-08-18 10:24:13.5398485 -0500
   #     now.utc? # => false
+  #     now.getutc.utc? # => true
   #     utc = Time.utc(2000, 1, 1, 20, 15, 1)
   #     # => 2000-01-01 20:15:01 UTC
   #     utc.utc? # => true
   #
+  # `Time` objects created with these methods are considered to be in UTC:
+  #
+  # *   Time.utc
+  # *   Time#utc
+  # *   Time#getutc
+  #
+  # Objects created in other ways will not be treated as UTC even if the
+  # environment variable "TZ" is "UTC".
+  #
   # Related: Time.utc.
   #
   def utc?: () -> bool

stdlib/uri/0/common.rbs

@@ -535,6 +535,9 @@ URI::ABS_URI: Regexp
 
 URI::ABS_URI_REF: Regexp
 
+# <!-- rdoc-file=lib/uri/common.rb -->
+# The default parser instance.
+#
 URI::DEFAULT_PARSER: URI::RFC2396_Parser
 
 URI::ESCAPED: Regexp
@@ -557,6 +560,9 @@ URI::REL_URI: Regexp
 
 URI::REL_URI_REF: Regexp
 
+# <!-- rdoc-file=lib/uri/common.rb -->
+# The default parser instance for RFC 3986.
+#
 URI::RFC3986_PARSER: URI::RFC3986_Parser
 
 URI::SCHEME: Regexp

stdlib/uri/0/generic.rbs

@@ -1009,13 +1009,15 @@ module URI
     #   rdoc-file=lib/uri/generic.rb
     #   - hash()
     # -->
+    # Returns the hash value.
     #
     def hash: () -> Integer
 
     # <!--
     #   rdoc-file=lib/uri/generic.rb
     #   - eql?(oth)
     # -->
+    # Compares with *oth* for Hash.
     #
     def eql?: (URI::Generic oth) -> bool