rbs 4.0.0.dev.4 → 4.0.0.dev.5

data/stdlib/date/0/date.rbs

@@ -5,7 +5,7 @@
 #
 # *   You need both dates and times; Date handles only dates.
 # *   You need only Gregorian dates (and not Julian dates); see [Julian and
-#     Gregorian Calendars](rdoc-ref:date/calendars.rdoc).
+#     Gregorian Calendars](rdoc-ref:language/calendars.rdoc).
 #
 # A Date object, once created, is immutable, and cannot be modified.
 #
@@ -53,7 +53,7 @@
 #
 # See also the specialized methods in ["Specialized Format Strings" in Formats
 # for Dates and
-# Times](rdoc-ref:strftime_formatting.rdoc@Specialized+Format+Strings)
+# Times](rdoc-ref:language/strftime_formatting.rdoc@Specialized+Format+Strings)
 #
 # ## Argument `limit`
 #
@@ -88,7 +88,7 @@ class Date
   # number of days in the month; when the argument is negative, counts backward
   # from the end of the month.
   #
-  # See argument [start](rdoc-ref:date/calendars.rdoc@Argument+start).
+  # See argument [start](rdoc-ref:language/calendars.rdoc@Argument+start).
   #
   # Related: Date.jd.
   #
@@ -101,7 +101,7 @@ class Date
   #   - Date._httpdate(string, limit: 128) -> hash
   # -->
   # Returns a hash of values parsed from `string`, which should be a valid [HTTP
-  # date format](rdoc-ref:strftime_formatting.rdoc@HTTP+Format):
+  # date format](rdoc-ref:language/strftime_formatting.rdoc@HTTP+Format):
   #
   #     d = Date.new(2001, 2, 3)
   #     s = d.httpdate # => "Sat, 03 Feb 2001 00:00:00 GMT"
@@ -118,7 +118,8 @@ class Date
   # -->
   # Returns a hash of values parsed from `string`, which should contain an [ISO
   # 8601 formatted
-  # date](rdoc-ref:strftime_formatting.rdoc@ISO+8601+Format+Specifications):
+  # date](rdoc-ref:language/strftime_formatting.rdoc@ISO+8601+Format+Specification
+  # s):
   #
   #     d = Date.new(2001, 2, 3)
   #     s = d.iso8601    # => "2001-02-03"
@@ -135,7 +136,8 @@ class Date
   #   - Date._jisx0301(string, limit: 128) -> hash
   # -->
   # Returns a hash of values parsed from `string`, which should be a valid [JIS X
-  # 0301 date format](rdoc-ref:strftime_formatting.rdoc@JIS+X+0301+Format):
+  # 0301 date
+  # format](rdoc-ref:language/strftime_formatting.rdoc@JIS+X+0301+Format):
   #
   #     d = Date.new(2001, 2, 3)
   #     s = d.jisx0301    # => "H13.02.03"
@@ -153,7 +155,8 @@ class Date
   # -->
   # **Note**: This method recognizes many forms in `string`, but it is not a
   # validator. For formats, see ["Specialized Format Strings" in Formats for Dates
-  # and Times](rdoc-ref:strftime_formatting.rdoc@Specialized+Format+Strings)
+  # and
+  # Times](rdoc-ref:language/strftime_formatting.rdoc@Specialized+Format+Strings)
   #
   # If `string` does not specify a valid date, the result is unpredictable;
   # consider using Date._strptime instead.
@@ -179,7 +182,7 @@ class Date
   #   - Date._rfc2822(string, limit: 128) -> hash
   # -->
   # Returns a hash of values parsed from `string`, which should be a valid [RFC
-  # 2822 date format](rdoc-ref:strftime_formatting.rdoc@RFC+2822+Format):
+  # 2822 date format](rdoc-ref:language/strftime_formatting.rdoc@RFC+2822+Format):
   #
   #     d = Date.new(2001, 2, 3)
   #     s = d.rfc2822 # => "Sat, 3 Feb 2001 00:00:00 +0000"
@@ -197,7 +200,7 @@ class Date
   #   - Date._rfc3339(string, limit: 128) -> hash
   # -->
   # Returns a hash of values parsed from `string`, which should be a valid [RFC
-  # 3339 format](rdoc-ref:strftime_formatting.rdoc@RFC+3339+Format):
+  # 3339 format](rdoc-ref:language/strftime_formatting.rdoc@RFC+3339+Format):
   #
   #     d = Date.new(2001, 2, 3)
   #     s = d.rfc3339     # => "2001-02-03T00:00:00+00:00"
@@ -215,7 +218,7 @@ class Date
   #   - Date._rfc2822(string, limit: 128) -> hash
   # -->
   # Returns a hash of values parsed from `string`, which should be a valid [RFC
-  # 2822 date format](rdoc-ref:strftime_formatting.rdoc@RFC+2822+Format):
+  # 2822 date format](rdoc-ref:language/strftime_formatting.rdoc@RFC+2822+Format):
   #
   #     d = Date.new(2001, 2, 3)
   #     s = d.rfc2822 # => "Sat, 3 Feb 2001 00:00:00 +0000"
@@ -237,8 +240,8 @@ class Date
   #     Date._strptime('2001-02-03', '%Y-%m-%d') # => {:year=>2001, :mon=>2, :mday=>3}
   #
   # For other formats, see [Formats for Dates and
-  # Times](rdoc-ref:strftime_formatting.rdoc). (Unlike Date.strftime, does not
-  # support flags and width.)
+  # Times](rdoc-ref:language/strftime_formatting.rdoc). (Unlike Date.strftime,
+  # does not support flags and width.)
   #
   # See also [strptime(3)](https://man7.org/linux/man-pages/man3/strptime.3.html).
   #
@@ -309,7 +312,7 @@ class Date
   #         Date.commercial(2020, 1, 1).to_s # => "2019-12-30"
   #         Date.commercial(2020, 1, 7).to_s # => "2020-01-05"
   #
-  # See argument [start](rdoc-ref:date/calendars.rdoc@Argument+start).
+  # See argument [start](rdoc-ref:language/calendars.rdoc@Argument+start).
   #
   # Related: Date.jd, Date.new, Date.ordinal.
   #
@@ -335,7 +338,8 @@ class Date
   #   - Date.httpdate(string = 'Mon, 01 Jan -4712 00:00:00 GMT', start = Date::ITALY, limit: 128) -> date
   # -->
   # Returns a new Date object with values parsed from `string`, which should be a
-  # valid [HTTP date format](rdoc-ref:strftime_formatting.rdoc@HTTP+Format):
+  # valid [HTTP date
+  # format](rdoc-ref:language/strftime_formatting.rdoc@HTTP+Format):
   #
   #     d = Date.new(2001, 2, 3)
   #     s = d.httpdate   # => "Sat, 03 Feb 2001 00:00:00 GMT"
@@ -343,7 +347,7 @@ class Date
   #
   # See:
   #
-  # *   Argument [start](rdoc-ref:date/calendars.rdoc@Argument+start).
+  # *   Argument [start](rdoc-ref:language/calendars.rdoc@Argument+start).
   # *   Argument [limit](rdoc-ref:Date@Argument+limit).
   #
   # Related: Date._httpdate (returns a hash).
@@ -356,7 +360,8 @@ class Date
   # -->
   # Returns a new Date object with values parsed from `string`, which should
   # contain an [ISO 8601 formatted
-  # date](rdoc-ref:strftime_formatting.rdoc@ISO+8601+Format+Specifications):
+  # date](rdoc-ref:language/strftime_formatting.rdoc@ISO+8601+Format+Specification
+  # s):
   #
   #     d = Date.new(2001, 2, 3)
   #     s = d.iso8601   # => "2001-02-03"
@@ -364,7 +369,7 @@ class Date
   #
   # See:
   #
-  # *   Argument [start](rdoc-ref:date/calendars.rdoc@Argument+start).
+  # *   Argument [start](rdoc-ref:language/calendars.rdoc@Argument+start).
   # *   Argument [limit](rdoc-ref:Date@Argument+limit).
   #
   # Related: Date._iso8601 (returns a hash).
@@ -393,7 +398,7 @@ class Date
   #
   #         Date.jd(Date::ITALY - 1).julian?    # => true
   #
-  # See argument [start](rdoc-ref:date/calendars.rdoc@Argument+start).
+  # See argument [start](rdoc-ref:language/calendars.rdoc@Argument+start).
   #
   # Related: Date.new.
   #
@@ -405,7 +410,7 @@ class Date
   # -->
   # Returns a new Date object with values parsed from `string`, which should be a
   # valid [JIS X 0301
-  # format](rdoc-ref:strftime_formatting.rdoc@JIS+X+0301+Format):
+  # format](rdoc-ref:language/strftime_formatting.rdoc@JIS+X+0301+Format):
   #
   #     d = Date.new(2001, 2, 3)
   #     s = d.jisx0301   # => "H13.02.03"
@@ -417,7 +422,7 @@ class Date
   #
   # See:
   #
-  # *   Argument [start](rdoc-ref:date/calendars.rdoc@Argument+start).
+  # *   Argument [start](rdoc-ref:language/calendars.rdoc@Argument+start).
   # *   Argument [limit](rdoc-ref:Date@Argument+limit).
   #
   # Related: Date._jisx0301 (returns a hash).
@@ -480,7 +485,7 @@ class Date
   #
   # Raises an exception if `yday` is zero or out of range.
   #
-  # See argument [start](rdoc-ref:date/calendars.rdoc@Argument+start).
+  # See argument [start](rdoc-ref:language/calendars.rdoc@Argument+start).
   #
   # Related: Date.jd, Date.new.
   #
@@ -492,9 +497,10 @@ class Date
   # -->
   # **Note**: This method recognizes many forms in `string`, but it is not a
   # validator. For formats, see ["Specialized Format Strings" in Formats for Dates
-  # and Times](rdoc-ref:strftime_formatting.rdoc@Specialized+Format+Strings) If
-  # `string` does not specify a valid date, the result is unpredictable; consider
-  # using Date._strptime instead.
+  # and
+  # Times](rdoc-ref:language/strftime_formatting.rdoc@Specialized+Format+Strings)
+  # If `string` does not specify a valid date, the result is unpredictable;
+  # consider using Date._strptime instead.
   #
   # Returns a new Date object with values parsed from `string`:
   #
@@ -510,7 +516,7 @@ class Date
   #
   # See:
   #
-  # *   Argument [start](rdoc-ref:date/calendars.rdoc@Argument+start).
+  # *   Argument [start](rdoc-ref:language/calendars.rdoc@Argument+start).
   # *   Argument [limit](rdoc-ref:Date@Argument+limit).
   #
   # Related: Date._parse (returns a hash).
@@ -523,7 +529,7 @@ class Date
   # -->
   # Returns a new Date object with values parsed from `string`, which should be a
   # valid [RFC 2822 date
-  # format](rdoc-ref:strftime_formatting.rdoc@RFC+2822+Format):
+  # format](rdoc-ref:language/strftime_formatting.rdoc@RFC+2822+Format):
   #
   #     d = Date.new(2001, 2, 3)
   #     s = d.rfc2822   # => "Sat, 3 Feb 2001 00:00:00 +0000"
@@ -531,7 +537,7 @@ class Date
   #
   # See:
   #
-  # *   Argument [start](rdoc-ref:date/calendars.rdoc@Argument+start).
+  # *   Argument [start](rdoc-ref:language/calendars.rdoc@Argument+start).
   # *   Argument [limit](rdoc-ref:Date@Argument+limit).
   #
   # Related: Date._rfc2822 (returns a hash).
@@ -543,7 +549,8 @@ class Date
   #   - Date.rfc3339(string = '-4712-01-01T00:00:00+00:00', start = Date::ITALY, limit: 128) -> date
   # -->
   # Returns a new Date object with values parsed from `string`, which should be a
-  # valid [RFC 3339 format](rdoc-ref:strftime_formatting.rdoc@RFC+3339+Format):
+  # valid [RFC 3339
+  # format](rdoc-ref:language/strftime_formatting.rdoc@RFC+3339+Format):
   #
   #     d = Date.new(2001, 2, 3)
   #     s = d.rfc3339   # => "2001-02-03T00:00:00+00:00"
@@ -551,7 +558,7 @@ class Date
   #
   # See:
   #
-  # *   Argument [start](rdoc-ref:date/calendars.rdoc@Argument+start).
+  # *   Argument [start](rdoc-ref:language/calendars.rdoc@Argument+start).
   # *   Argument [limit](rdoc-ref:Date@Argument+limit).
   #
   # Related: Date._rfc3339 (returns a hash).
@@ -564,7 +571,7 @@ class Date
   # -->
   # Returns a new Date object with values parsed from `string`, which should be a
   # valid [RFC 2822 date
-  # format](rdoc-ref:strftime_formatting.rdoc@RFC+2822+Format):
+  # format](rdoc-ref:language/strftime_formatting.rdoc@RFC+2822+Format):
   #
   #     d = Date.new(2001, 2, 3)
   #     s = d.rfc2822   # => "Sat, 3 Feb 2001 00:00:00 +0000"
@@ -572,7 +579,7 @@ class Date
   #
   # See:
   #
-  # *   Argument [start](rdoc-ref:date/calendars.rdoc@Argument+start).
+  # *   Argument [start](rdoc-ref:language/calendars.rdoc@Argument+start).
   # *   Argument [limit](rdoc-ref:Date@Argument+limit).
   #
   # Related: Date._rfc2822 (returns a hash).
@@ -595,10 +602,10 @@ class Date
   #     Date.strptime('sat3feb01', '%a%d%b%y')   # => #<Date: 2001-02-03>
   #
   # For other formats, see [Formats for Dates and
-  # Times](rdoc-ref:strftime_formatting.rdoc). (Unlike Date.strftime, does not
-  # support flags and width.)
+  # Times](rdoc-ref:language/strftime_formatting.rdoc). (Unlike Date.strftime,
+  # does not support flags and width.)
   #
-  # See argument [start](rdoc-ref:date/calendars.rdoc@Argument+start).
+  # See argument [start](rdoc-ref:language/calendars.rdoc@Argument+start).
   #
   # See also [strptime(3)](https://man7.org/linux/man-pages/man3/strptime.3.html).
   #
@@ -614,7 +621,7 @@ class Date
   #
   #     Date.today.to_s # => "2022-07-06"
   #
-  # See argument [start](rdoc-ref:date/calendars.rdoc@Argument+start).
+  # See argument [start](rdoc-ref:language/calendars.rdoc@Argument+start).
   #
   def self.today: (?Integer start) -> Date
 
@@ -629,7 +636,7 @@ class Date
   #     Date.valid_date?(2001, 2, 29) # => false
   #     Date.valid_date?(2001, 2, -1) # => true
   #
-  # See argument [start](rdoc-ref:date/calendars.rdoc@Argument+start).
+  # See argument [start](rdoc-ref:language/calendars.rdoc@Argument+start).
   #
   # Related: Date.jd, Date.new.
   #
@@ -647,7 +654,7 @@ class Date
   #
   # See Date.commercial.
   #
-  # See argument [start](rdoc-ref:date/calendars.rdoc@Argument+start).
+  # See argument [start](rdoc-ref:language/calendars.rdoc@Argument+start).
   #
   # Related: Date.jd, Date.commercial.
   #
@@ -664,7 +671,7 @@ class Date
   #     Date.valid_date?(2001, 2, 29) # => false
   #     Date.valid_date?(2001, 2, -1) # => true
   #
-  # See argument [start](rdoc-ref:date/calendars.rdoc@Argument+start).
+  # See argument [start](rdoc-ref:language/calendars.rdoc@Argument+start).
   #
   # Related: Date.jd, Date.new.
   #
@@ -679,7 +686,7 @@ class Date
   #
   #     Date.valid_jd?(2451944) # => true
   #
-  # See argument [start](rdoc-ref:date/calendars.rdoc@Argument+start).
+  # See argument [start](rdoc-ref:language/calendars.rdoc@Argument+start).
   #
   # Related: Date.jd.
   #
@@ -695,7 +702,7 @@ class Date
   #     Date.valid_ordinal?(2001, 34)  # => true
   #     Date.valid_ordinal?(2001, 366) # => false
   #
-  # See argument [start](rdoc-ref:date/calendars.rdoc@Argument+start).
+  # See argument [start](rdoc-ref:language/calendars.rdoc@Argument+start).
   #
   # Related: Date.jd, Date.ordinal.
   #
@@ -714,7 +721,7 @@ class Date
   #
   # See:
   #
-  # *   Argument [start](rdoc-ref:date/calendars.rdoc@Argument+start).
+  # *   Argument [start](rdoc-ref:language/calendars.rdoc@Argument+start).
   # *   Argument [limit](rdoc-ref:Date@Argument+limit).
   #
   # Related: Date._xmlschema (returns a hash).
@@ -922,8 +929,8 @@ class Date
   #   - asctime -> string
   # -->
   # Equivalent to #strftime with argument `'%a %b %e %T %Y'` (or its [shorthand
-  # form](rdoc-ref:strftime_formatting.rdoc@Shorthand+Conversion+Specifiers)
-  # `'%c'`):
+  # form](rdoc-ref:language/strftime_formatting.rdoc@Shorthand+Conversion+Specifie
+  # rs) `'%c'`):
   #
   #     Date.new(2001, 2, 3).asctime # => "Sat Feb  3 00:00:00 2001"
   #
@@ -933,8 +940,8 @@ class Date
 
   # <!-- rdoc-file=ext/date/date_core.c -->
   # Equivalent to #strftime with argument `'%a %b %e %T %Y'` (or its [shorthand
-  # form](rdoc-ref:strftime_formatting.rdoc@Shorthand+Conversion+Specifiers)
-  # `'%c'`):
+  # form](rdoc-ref:language/strftime_formatting.rdoc@Shorthand+Conversion+Specifie
+  # rs) `'%c'`):
   #
   #     Date.new(2001, 2, 3).asctime # => "Sat Feb  3 00:00:00 2001"
   #
@@ -1065,7 +1072,7 @@ class Date
   #   - httpdate -> string
   # -->
   # Equivalent to #strftime with argument `'%a, %d %b %Y %T GMT'`; see [Formats
-  # for Dates and Times](rdoc-ref:strftime_formatting.rdoc):
+  # for Dates and Times](rdoc-ref:language/strftime_formatting.rdoc):
   #
   #     Date.new(2001, 2, 3).httpdate # => "Sat, 03 Feb 2001 00:00:00 GMT"
   #
@@ -1087,8 +1094,8 @@ class Date
   #   - iso8601    ->  string
   # -->
   # Equivalent to #strftime with argument `'%Y-%m-%d'` (or its [shorthand
-  # form](rdoc-ref:strftime_formatting.rdoc@Shorthand+Conversion+Specifiers)
-  # `'%F'`);
+  # form](rdoc-ref:language/strftime_formatting.rdoc@Shorthand+Conversion+Specifie
+  # rs) `'%F'`);
   #
   #     Date.new(2001, 2, 3).iso8601 # => "2001-02-03"
   #
@@ -1225,7 +1232,7 @@ class Date
   #     d1 = d0.new_start(Date::JULIAN)
   #     d1.julian? # => true
   #
-  # See argument [start](rdoc-ref:date/calendars.rdoc@Argument+start).
+  # See argument [start](rdoc-ref:language/calendars.rdoc@Argument+start).
   #
   def new_start: (?Integer start) -> Date
 
@@ -1294,7 +1301,7 @@ class Date
   #   - rfc2822 -> string
   # -->
   # Equivalent to #strftime with argument `'%a, %-d %b %Y %T %z'`; see [Formats
-  # for Dates and Times](rdoc-ref:strftime_formatting.rdoc):
+  # for Dates and Times](rdoc-ref:language/strftime_formatting.rdoc):
   #
   #     Date.new(2001, 2, 3).rfc2822 # => "Sat, 3 Feb 2001 00:00:00 +0000"
   #
@@ -1305,7 +1312,7 @@ class Date
   #   - rfc3339 -> string
   # -->
   # Equivalent to #strftime with argument `'%FT%T%:z'`; see [Formats for Dates and
-  # Times](rdoc-ref:strftime_formatting.rdoc):
+  # Times](rdoc-ref:language/strftime_formatting.rdoc):
   #
   #     Date.new(2001, 2, 3).rfc3339 # => "2001-02-03T00:00:00+00:00"
   #
@@ -1314,7 +1321,7 @@ class Date
   # <!-- rdoc-file=ext/date/date_core.c -->
   # Returns a new Date object with values parsed from `string`, which should be a
   # valid [RFC 2822 date
-  # format](rdoc-ref:strftime_formatting.rdoc@RFC+2822+Format):
+  # format](rdoc-ref:language/strftime_formatting.rdoc@RFC+2822+Format):
   #
   #     d = Date.new(2001, 2, 3)
   #     s = d.rfc2822   # => "Sat, 3 Feb 2001 00:00:00 +0000"
@@ -1322,7 +1329,7 @@ class Date
   #
   # See:
   #
-  # *   Argument [start](rdoc-ref:date/calendars.rdoc@Argument+start).
+  # *   Argument [start](rdoc-ref:language/calendars.rdoc@Argument+start).
   # *   Argument [limit](rdoc-ref:Date@Argument+limit).
   #
   # Related: Date._rfc2822 (returns a hash).
@@ -1355,7 +1362,7 @@ class Date
   #     Date.new(2001, 2, 3, Date::GREGORIAN).start # => -Infinity
   #     Date.new(2001, 2, 3, Date::JULIAN).start    # => Infinity
   #
-  # See argument [start](rdoc-ref:date/calendars.rdoc@Argument+start).
+  # See argument [start](rdoc-ref:language/calendars.rdoc@Argument+start).
   #
   def start: () -> Float
 
@@ -1401,7 +1408,7 @@ class Date
   #     Date.new(2001, 2, 3).strftime # => "2001-02-03"
   #
   # For other formats, see [Formats for Dates and
-  # Times](rdoc-ref:strftime_formatting.rdoc).
+  # Times](rdoc-ref:language/strftime_formatting.rdoc).
   #
   def strftime: (?String format) -> String
 
@@ -1453,8 +1460,9 @@ class Date
   #   - to_s -> string
   # -->
   # Returns a string representation of the date in `self` in [ISO 8601 extended
-  # date format](rdoc-ref:strftime_formatting.rdoc@ISO+8601+Format+Specifications)
-  # (`'%Y-%m-%d'`):
+  # date
+  # format](rdoc-ref:language/strftime_formatting.rdoc@ISO+8601+Format+Specificati
+  # ons) (`'%Y-%m-%d'`):
   #
   #     Date.new(2001, 2, 3).to_s # => "2001-02-03"
   #
@@ -1509,8 +1517,8 @@ class Date
 
   # <!-- rdoc-file=ext/date/date_core.c -->
   # Equivalent to #strftime with argument `'%Y-%m-%d'` (or its [shorthand
-  # form](rdoc-ref:strftime_formatting.rdoc@Shorthand+Conversion+Specifiers)
-  # `'%F'`);
+  # form](rdoc-ref:language/strftime_formatting.rdoc@Shorthand+Conversion+Specifie
+  # rs) `'%F'`);
   #
   #     Date.new(2001, 2, 3).iso8601 # => "2001-02-03"
   #

data/stdlib/date/0/date_time.rbs

@@ -555,7 +555,7 @@ class DateTime < Date
   #     DateTime.now.strftime # => "2022-07-01T11:03:19-05:00"
   #
   # For other formats, see [Formats for Dates and
-  # Times](rdoc-ref:strftime_formatting.rdoc):
+  # Times](rdoc-ref:language/strftime_formatting.rdoc):
   #
   def strftime: (?String format) -> String
 

data/stdlib/delegate/0/delegator.rbs

@@ -44,7 +44,7 @@ class Delegator < BasicObject
   #   rdoc-file=lib/delegate.rb
   #   - !()
   # -->
-  # Delegates ! to the _*getobj*_
+  # Delegates ! to the `__getobj__`
   #
   def !: () -> untyped
 
@@ -94,7 +94,7 @@ class Delegator < BasicObject
   #   rdoc-file=lib/delegate.rb
   #   - freeze()
   # -->
-  # :method: freeze Freeze both the object returned by _*getobj*_ and self.
+  # :method: freeze Freeze both the object returned by `__getobj__` and self.
   #
   def freeze: () -> self
 
@@ -102,7 +102,7 @@ class Delegator < BasicObject
   #   rdoc-file=lib/delegate.rb
   #   - marshal_dump()
   # -->
-  # Serialization support for the object returned by _*getobj*_.
+  # Serialization support for the object returned by `__getobj__`.
   #
   def marshal_dump: () -> untyped
 
@@ -126,7 +126,7 @@ class Delegator < BasicObject
   #   - methods(all=true)
   # -->
   # Returns the methods available to this delegate object as the union of this
-  # object's and _*getobj*_ methods.
+  # object's and `__getobj__` methods.
   #
   def methods: (?boolish all) -> Array[Symbol]
 
@@ -135,7 +135,7 @@ class Delegator < BasicObject
   #   - protected_methods(all=true)
   # -->
   # Returns the methods available to this delegate object as the union of this
-  # object's and _*getobj*_ protected methods.
+  # object's and `__getobj__` protected methods.
   #
   def protected_methods: (?boolish all) -> Array[Symbol]
 
@@ -144,7 +144,7 @@ class Delegator < BasicObject
   #   - public_methods(all=true)
   # -->
   # Returns the methods available to this delegate object as the union of this
-  # object's and _*getobj*_ public methods.
+  # object's and `__getobj__` public methods.
   #
   def public_methods: (?untyped all) -> Array[Symbol]
 
@@ -168,7 +168,7 @@ class Delegator < BasicObject
   #   - respond_to_missing?(m, include_private)
   # -->
   # Checks for a method provided by this the delegate object by forwarding the
-  # call through _*getobj*_.
+  # call through `__getobj__`.
   #
   def respond_to_missing?: (Symbol m, bool include_private) -> bool
 
@@ -180,5 +180,8 @@ class Delegator < BasicObject
   #
   def target_respond_to?: (untyped target, Symbol m, bool include_private) -> bool
 
+  # <!-- rdoc-file=lib/delegate.rb -->
+  # The version string
+  #
   VERSION: String
 end

data/stdlib/digest/0/digest.rbs

@@ -471,6 +471,116 @@ end
 class Digest::SHA1 < Digest::Base
 end
 
+# <!-- rdoc-file=ext/digest/sha2/lib/sha2.rb -->
+# A meta digest provider class for SHA256, SHA384 and SHA512.
+#
+# FIPS 180-2 describes SHA2 family of digest algorithms. It defines three
+# algorithms:
+# *   one which works on chunks of 512 bits and returns a 256-bit digest
+#     (SHA256),
+# *   one which works on chunks of 1024 bits and returns a 384-bit digest
+#     (SHA384),
+# *   and one which works on chunks of 1024 bits and returns a 512-bit digest
+#     (SHA512).
+#
+# ## Examples
+#     require 'digest'
+#
+#     # Compute a complete digest
+#     Digest::SHA2.hexdigest 'abc'          # => "ba7816bf8..."
+#     Digest::SHA2.new(256).hexdigest 'abc' # => "ba7816bf8..."
+#     Digest::SHA256.hexdigest 'abc'        # => "ba7816bf8..."
+#
+#     Digest::SHA2.new(384).hexdigest 'abc' # => "cb00753f4..."
+#     Digest::SHA384.hexdigest 'abc'        # => "cb00753f4..."
+#
+#     Digest::SHA2.new(512).hexdigest 'abc' # => "ddaf35a19..."
+#     Digest::SHA512.hexdigest 'abc'        # => "ddaf35a19..."
+#
+#     # Compute digest by chunks
+#     sha2 = Digest::SHA2.new               # =>#<Digest::SHA2:256>
+#     sha2.update "ab"
+#     sha2 << "c"                           # alias for #update
+#     sha2.hexdigest                        # => "ba7816bf8..."
+#
+#     # Use the same object to compute another digest
+#     sha2.reset
+#     sha2 << "message"
+#     sha2.hexdigest                        # => "ab530a13e..."
+#
+class Digest::SHA2 < Digest::Class
+  # <!--
+  #   rdoc-file=ext/digest/sha2/lib/sha2.rb
+  #   - Digest::SHA2.new(bitlen = 256) -> digest_obj
+  # -->
+  # Create a new SHA2 hash object with a given bit length.
+  #
+  # Valid bit lengths are 256, 384 and 512.
+  #
+  def initialize: (?(256 | 384 | 512) bitlen) -> void
+
+  # <!--
+  #   rdoc-file=ext/digest/sha2/lib/sha2.rb
+  #   - digest_obj.reset -> digest_obj
+  # -->
+  # Reset the digest to the initial state and return self.
+  #
+  def reset: () -> self
+
+  # <!--
+  #   rdoc-file=ext/digest/sha2/lib/sha2.rb
+  #   - digest_obj.update(string) -> digest_obj
+  #   - digest_obj << string -> digest_obj
+  # -->
+  # Update the digest using a given *string* and return self.
+  #
+  def update: (String) -> self
+
+  private def finish: () -> String
+
+  # <!--
+  #   rdoc-file=ext/digest/sha2/lib/sha2.rb
+  #   - <<(str)
+  # -->
+  #
+  alias << update
+
+  # <!--
+  #   rdoc-file=ext/digest/sha2/lib/sha2.rb
+  #   - digest_obj.block_length -> Integer
+  # -->
+  # Return the block length of the digest in bytes.
+  #
+  #     Digest::SHA256.new.block_length * 8
+  #     # => 512
+  #     Digest::SHA384.new.block_length * 8
+  #     # => 1024
+  #     Digest::SHA512.new.block_length * 8
+  #     # => 1024
+  #
+  def block_length: () -> Integer
+
+  # <!--
+  #   rdoc-file=ext/digest/sha2/lib/sha2.rb
+  #   - digest_obj.digest_length -> Integer
+  # -->
+  # Return the length of the hash value (the digest) in bytes.
+  #
+  #     Digest::SHA256.new.digest_length * 8
+  #     # => 256
+  #     Digest::SHA384.new.digest_length * 8
+  #     # => 384
+  #     Digest::SHA512.new.digest_length * 8
+  #     # => 512
+  #
+  # For example, digests produced by Digest::SHA256 will always be 32 bytes (256
+  # bits) in size.
+  #
+  def digest_length: () -> Integer
+
+  def initialize_copy: (untyped) -> untyped
+end
+
 # <!-- rdoc-file=ext/digest/md5/md5init.c -->
 # A class for calculating message digests using the MD5 Message-Digest Algorithm
 # by RSA Data Security, Inc., described in RFC1321.