rbs 4.0.0.dev.4 → 4.1.0.pre.2

data/stdlib/strscan/0/string_scanner.rbs

@@ -1,6 +1,7 @@
 # <!-- rdoc-file=ext/strscan/strscan.c -->
 # Class `StringScanner` supports processing a stored string as a stream;
-# this code creates a new `StringScanner` object with string `'foobarbaz'`:
+# this code creates a new `StringScanner` object with string
+# <code>'foobarbaz'</code>:
 #     require 'strscan'
 # scanner = StringScanner.new('foobarbaz')
 #
@@ -19,16 +20,16 @@
 # ENGLISH_TEXT = 'Hello'
 #
 # Some examples here assume that certain helper methods are defined:
-# *   `put_situation(scanner)`:
+# *   <code>put_situation(scanner)</code>:
 #      Displays the values of the scanner's
 #      methods #pos, #charpos, #rest, and #rest_size.
-# *   `put_match_values(scanner)`:
+# *   <code>put_match_values(scanner)</code>:
 #      Displays the scanner's [match
 #     values](rdoc-ref:StringScanner@Match+Values).
-# *   `match_values_cleared?(scanner)`:
+# *   <code>match_values_cleared?(scanner)</code>:
 #      Returns whether the scanner's [match
 #     values](rdoc-ref:StringScanner@Match+Values) are cleared.
-# See examples [[here]](ext/strscan/helper_methods_md.html).
+# See examples at [helper methods](helper_methods.md).
 # ## The `StringScanner` Object
 # This code creates a `StringScanner` object
 # (we'll call it simply a *scanner*),
@@ -45,7 +46,7 @@
 # The scanner has:
 # *   A *stored string*, which is:
 #     *   Initially set by StringScanner.new(string) to the given `string`
-#          (`'foobarbaz'` in the example above).
+#          (<code>'foobarbaz'</code> in the example above).
 #     *   Modifiable by methods #string=(new_string) and #concat(more_string).
 #     *   Returned by method #string.
 #     More at [Stored String](rdoc-ref:StringScanner@Stored+String) below.
@@ -63,7 +64,7 @@
 #      which is a trailing substring of the stored string;
 #      it extends from the current position to the end of the stored string:
 #     *   Initially set by StringScanner.new(string) to the given `string`
-#          (`'foobarbaz'` in the example above).
+#          (<code>'foobarbaz'</code> in the example above).
 #     *   Returned by method #rest.
 #     *   Modified by any modification to either the stored string or the
 #         position.
@@ -85,10 +86,10 @@
 # and a zero-based *character position*.
 # Each of these methods explicitly sets positions:
 #          Method         |                         Effect
-# ------------------------|--------------------------------------------------------
-#          #reset         |Sets both positions to zero (begining of stored string).
+# ------------------------|---------------------------------------------------------
+#          #reset         |Sets both positions to zero (beginning of stored string).
 #        #terminate       |  Sets both positions to the end of the stored string.
-# #pos=(new_byte_position)|    Sets byte position; adjusts character position.
+# #pos=(new_byte_position)|     Sets byte position; adjusts character position.
 # ### Byte Position (Position)
 # The byte position (or simply *position*)
 # is a zero-based index into the bytes in the scanner's stored string;
@@ -96,7 +97,7 @@
 # When the byte position is:
 # *   Zero (at the beginning), the target substring is the entire stored string.
 # *   Equal to the size of the stored string (at the end),
-#      the target substring is the empty string `''`.
+#      the target substring is the empty string <code>''</code>.
 # To get or set the byte position:
 # *   #pos: returns the byte position.
 # *   #pos=(new_pos): sets the byte position.
@@ -120,7 +121,7 @@
 # *   #charpos: the [character
 #     position](rdoc-ref:StringScanner@Character+Position).
 # *   #rest: the [target substring](rdoc-ref:StringScanner@Target+Substring).
-# *   #rest_size: `rest.size`.
+# *   #rest_size: <code>rest.size</code>.
 # ### Character Position
 # The character position is a zero-based index into the *characters*
 # in the stored string;
@@ -159,7 +160,7 @@
 # #   rest_size: 12
 #
 # ## Target Substring
-# The target substring is the the part of the [stored
+# The target substring is the part of the [stored
 # string](rdoc-ref:StringScanner@Stored+String)
 # that extends from the current [byte
 # position](rdoc-ref:StringScanner@Byte+Position+-28Position-29) to the end of
@@ -290,7 +291,7 @@
 # generally contain the results of the most recent attempted match.
 # Each match value may be thought of as:
 # *   *Clear*: Initially, or after an unsuccessful match attempt:
-#      usually, `false`, `nil`, or `{}`.
+#      usually, `false`, `nil`, or <code>{}</code>.
 # *   *Set*: After a successful match attempt:
 #      `true`, string, array, or hash.
 # Each of these methods clears match values:
@@ -327,10 +328,10 @@
 #     Method     |          Return After Match           |Return After No Match
 # ---------------|---------------------------------------|---------------------
 #      #size     |     Count of captured substrings.     |       +nil+.
-#     #[](n)     |   <tt>n</tt>th captured substring.    |       +nil+.
+#     #[](n)     |       `n`th captured substring.       |       +nil+.
 #    #captures   |   Array of all captured substrings.   |       +nil+.
 # #values_at(*n) |Array of specified captured substrings.|       +nil+.
-# #named_captures|        Hash of named captures.        |    <tt>{}</tt>.
+# #named_captures|        Hash of named captures.        |  <code>{}</code>.
 #
 # See examples below.
 # #### Match Values Examples
@@ -401,7 +402,7 @@
 # ## Fixed-Anchor Property
 # Pattern matching in `StringScanner` is the same as in Ruby's,
 # except for its fixed-anchor property,
-# which determines the meaning of `'\A'`:
+# which determines the meaning of <code>'\A'</code>:
 # *   `false` (the default): matches the current byte position.
 #         scanner = StringScanner.new('foobar')
 # scanner.scan(/\A./) # => "f"
@@ -486,18 +487,18 @@ class StringScanner
   # scanner[:day]   # => "12"
   # scanner[:nope]  # => nil
   #
-  # When there are no captures, only `[0]` returns non-`nil`:
+  # When there are no captures, only <code>[0]</code> returns non-`nil`:
   #     scanner = StringScanner.new('foobarbaz')
   # scanner.exist?(/bar/)
   # scanner[0] # => "bar"
   # scanner[1] # => nil
   #
-  # For a failed match, even `[0]` returns `nil`:
+  # For a failed match, even <code>[0]</code> returns `nil`:
   #     scanner.scan(/nope/) # => nil
   # scanner[0]           # => nil
   # scanner[1]           # => nil
   #
-  def []: (Integer) -> String?
+  def []: (Integer | String | Symbol) -> String?
 
   # <!--
   #   rdoc-file=ext/strscan/strscan.c
@@ -539,7 +540,8 @@ class StringScanner
   #   - captures -> substring_array or nil
   # -->
   # Returns the array of [captured match
-  # values](rdoc-ref:StringScanner@Captured+Match+Values) at indexes `(1..)`
+  # values](rdoc-ref:StringScanner@Captured+Match+Values) at indexes
+  # <code>(1..)</code>
   # if the most recent match attempt succeeded, or `nil` otherwise:
   #     scanner = StringScanner.new('Fri Dec 12 1975 14:39')
   # scanner.captures         # => nil
@@ -623,7 +625,7 @@ class StringScanner
   #     scanner.check(/nope/)          # => nil
   # match_values_cleared?(scanner) # => true
   #
-  def check: (Regexp) -> String?
+  def check: (Regexp | String) -> String?
 
   # <!--
   #   rdoc-file=ext/strscan/strscan.c
@@ -671,15 +673,7 @@ class StringScanner
   #     scanner.check_until(/nope/)    # => nil
   # match_values_cleared?(scanner) # => true
   #
-  def check_until: (Regexp) -> String
-
-  # <!--
-  #   rdoc-file=ext/strscan/strscan.c
-  #   - clear()
-  # -->
-  # Equivalent to #terminate. This method is obsolete; use #terminate instead.
-  #
-  def clear: () -> void
+  def check_until: (Regexp | String) -> String?
 
   # <!--
   #   rdoc-file=ext/strscan/strscan.c
@@ -704,14 +698,6 @@ class StringScanner
   #
   alias concat <<
 
-  # <!--
-  #   rdoc-file=ext/strscan/strscan.c
-  #   - empty?()
-  # -->
-  # Equivalent to #eos?. This method is obsolete, use #eos? instead.
-  #
-  def empty?: () -> bool
-
   # <!--
   #   rdoc-file=ext/strscan/strscan.c
   #   - eos? -> true or false
@@ -774,7 +760,7 @@ class StringScanner
   #     scanner.exist?(/nope/)         # => nil
   # match_values_cleared?(scanner) # => true
   #
-  def exist?: (Regexp) -> Integer?
+  def exist?: (Regexp | String) -> Integer?
 
   # <!--
   #   rdoc-file=ext/strscan/strscan.c
@@ -816,14 +802,6 @@ class StringScanner
   #
   def get_byte: () -> String?
 
-  # <!--
-  #   rdoc-file=ext/strscan/strscan.c
-  #   - getbyte()
-  # -->
-  # Equivalent to #get_byte. This method is obsolete; use #get_byte instead.
-  #
-  def getbyte: () -> String?
-
   # <!--
   #   rdoc-file=ext/strscan/strscan.c
   #   - getch()
@@ -935,7 +913,7 @@ class StringScanner
   #     scanner.match?(/nope/)         # => nil
   # match_values_cleared?(scanner) # => true
   #
-  def match?: (Regexp) -> Integer?
+  def match?: (Regexp | String) -> Integer?
 
   # <!--
   #   rdoc-file=ext/strscan/strscan.c
@@ -995,11 +973,34 @@ class StringScanner
   #
   def matched_size: () -> Integer?
 
+  # <!--
+  #   rdoc-file=ext/strscan/strscan.c
+  #   - named_captures -> hash
+  # -->
+  # Returns the array of captured match values at indexes (1..)
+  # if the most recent match attempt succeeded, or nil otherwise;
+  # see [Captured Match Values](rdoc-ref:StringScanner@Captured+Match+Values):
+  #     scanner = StringScanner.new('Fri Dec 12 1975 14:39')
+  # scanner.named_captures # => {}
+  #
+  # pattern = /(?<wday>\w+) (?<month>\w+) (?<day>\d+) /
+  # scanner.match?(pattern)
+  # scanner.named_captures # => {"wday"=>"Fri", "month"=>"Dec", "day"=>"12"}
+  #
+  # scanner.string = 'nope'
+  # scanner.match?(pattern)
+  # scanner.named_captures # => {"wday"=>nil, "month"=>nil, "day"=>nil}
+  #
+  # scanner.match?(/nosuch/)
+  # scanner.named_captures # => {}
+  #
+  def named_captures: () -> Hash[String, String?]
+
   # <!--
   #   rdoc-file=ext/strscan/strscan.c
   #   - peek(length) -> substring
   # -->
-  # Returns the substring `string[pos, length]`;
+  # Returns the substring <code>string[pos, length]</code>;
   # does not update [match values](rdoc-ref:StringScanner@Match+Values) or
   # [positions](rdoc-ref:StringScanner@Positions):
   #     scanner = StringScanner.new('foobarbaz')
@@ -1012,11 +1013,14 @@ class StringScanner
 
   # <!--
   #   rdoc-file=ext/strscan/strscan.c
-  #   - peep(p1)
+  #   - peek_byte()
   # -->
-  # Equivalent to #peek. This method is obsolete; use #peek instead.
+  # Peeks at the current byte and returns it as an integer.
+  #
+  #     s = StringScanner.new('ab')
+  #     s.peek_byte         # => 97
   #
-  def peep: (Integer) -> String
+  def peek_byte: () -> Integer?
 
   # <!-- rdoc-file=ext/strscan/strscan.c -->
   # call-seq:
@@ -1122,7 +1126,7 @@ class StringScanner
   # scanner.match?(/nope/) # => nil
   # scanner.post_match     # => nil
   #
-  def post_match: () -> String
+  def post_match: () -> String?
 
   # <!--
   #   rdoc-file=ext/strscan/strscan.c
@@ -1142,7 +1146,7 @@ class StringScanner
   # scanner.exist?(/nope/) # => nil
   # scanner.pre_match      # => nil
   #
-  def pre_match: () -> String
+  def pre_match: () -> String?
 
   # <!--
   #   rdoc-file=ext/strscan/strscan.c
@@ -1151,7 +1155,7 @@ class StringScanner
   # Sets both [byte position](rdoc-ref:StringScanner@Byte+Position+-28Position-29)
   # and [character position](rdoc-ref:StringScanner@Character+Position) to zero,
   # and clears [match values](rdoc-ref:StringScanner@Match+Values);
-  # returns `self`:
+  # returns +self+:
   #     scanner = StringScanner.new('foobarbaz')
   # scanner.exist?(/bar/)          # => 6
   # scanner.reset                  # => #<StringScanner 0/9 @ "fooba...">
@@ -1164,7 +1168,7 @@ class StringScanner
   # # => nil
   # match_values_cleared?(scanner) # => true
   #
-  def reset: () -> void
+  def reset: () -> self
 
   # <!--
   #   rdoc-file=ext/strscan/strscan.c
@@ -1215,15 +1219,6 @@ class StringScanner
   #
   def rest_size: () -> Integer
 
-  # <!--
-  #   rdoc-file=ext/strscan/strscan.c
-  #   - restsize()
-  # -->
-  # `s.restsize` is equivalent to `s.rest_size`. This method is obsolete; use
-  # #rest_size instead.
-  #
-  def restsize: () -> Integer
-
   # <!--
   #   rdoc-file=ext/strscan/strscan.c
   #   - scan(p1)
@@ -1237,7 +1232,7 @@ class StringScanner
   # *   Returns the matched substring.
   # *   Increments the [byte
   #     position](rdoc-ref:StringScanner@Byte+Position+-28Position-29) by
-  #     `substring.bytesize`,
+  #     <code>substring.bytesize</code>,
   #      and may increment the [character
   #     position](rdoc-ref:StringScanner@Character+Position).
   # *   Sets [match values](rdoc-ref:StringScanner@Match+Values).
@@ -1274,7 +1269,16 @@ class StringScanner
   #     scanner.scan(/nope/)           # => nil
   # match_values_cleared?(scanner) # => true
   #
-  def scan: (Regexp) -> String?
+  def scan: (Regexp | String) -> String?
+
+  # <!--
+  #   rdoc-file=ext/strscan/strscan.c
+  #   - scan_byte -> integer_byte
+  # -->
+  # Scans one byte and returns it as an integer. This method is not multibyte
+  # character sensitive. See also: #getch.
+  #
+  def scan_byte: () -> Integer?
 
   # <!--
   #   rdoc-file=ext/strscan/strscan.c
@@ -1286,7 +1290,23 @@ class StringScanner
   #
   # "full" means "#scan with full parameters".
   #
-  def scan_full: (Regexp pattern, bool advance_pointer_p, bool return_string_p) -> untyped
+  def scan_full: (Regexp | String pattern, bool advance_pointer_p, true return_string_p) -> String?
+               | (Regexp | String pattern, bool advance_pointer_p, false return_string_p) -> Integer?
+
+  # <!--
+  #   rdoc-file=ext/strscan/lib/strscan/strscan.rb
+  #   - scan_integer(base: 10)
+  # -->
+  # If `base` isn't provided or is `10`, then it is equivalent to calling
+  # <code>#scan</code> with a `[+-]?d+` pattern, and returns an Integer or nil.
+  #
+  # If `base` is `16`, then it is equivalent to calling <code>#scan</code> with a
+  # `[+-]?(0x)?[0-9a-fA-F]+` pattern, and returns an Integer or nil.
+  #
+  # The scanned string must be encoded with an ASCII compatible encoding,
+  # otherwise Encoding::CompatibilityError will be raised.
+  #
+  def scan_integer: (?base: Integer) -> Integer?
 
   # <!--
   #   rdoc-file=ext/strscan/strscan.c
@@ -1339,7 +1359,7 @@ class StringScanner
   #     scanner.scan_until(/nope/)     # => nil
   # match_values_cleared?(scanner) # => true
   #
-  def scan_until: (Regexp) -> String?
+  def scan_until: (Regexp | String) -> String?
 
   # <!--
   #   rdoc-file=ext/strscan/strscan.c
@@ -1350,7 +1370,8 @@ class StringScanner
   # `return_string_p` is true, otherwise returns the number of bytes advanced.
   # This method does affect the match register.
   #
-  def search_full: (Regexp pattern, bool advance_pointer_p, bool return_string_p) -> untyped
+  def search_full: (Regexp | String pattern, bool advance_pointer_p, true return_string_p) -> String?
+                 | (Regexp | String pattern, bool advance_pointer_p, false return_string_p) -> Integer?
 
   # <!--
   #   rdoc-file=ext/strscan/strscan.c
@@ -1370,7 +1391,7 @@ class StringScanner
   # scanner.match?(/nope/)              # => nil
   # scanner.size                        # => nil
   #
-  def size: () -> Integer
+  def size: () -> Integer?
 
   # <!--
   #   rdoc-file=ext/strscan/strscan.c
@@ -1418,7 +1439,7 @@ class StringScanner
   # scanner.skip(/nope/)            # => nil
   # match_values_cleared?(scanner)  # => true
   #
-  def skip: (Regexp) -> Integer?
+  def skip: (Regexp | String) -> Integer?
 
   # <!--
   #   rdoc-file=ext/strscan/strscan.c
@@ -1466,7 +1487,7 @@ class StringScanner
   #     scanner.skip_until(/nope/)     # => nil
   # match_values_cleared?(scanner) # => true
   #
-  def skip_until: (Regexp) -> Integer?
+  def skip_until: (Regexp | String) -> Integer?
 
   # <!--
   #   rdoc-file=ext/strscan/strscan.c
@@ -1517,7 +1538,7 @@ class StringScanner
   # call-seq:
   #  terminate -> self
   # Sets the scanner to end-of-string;
-  # returns `self`:
+  # returns +self+:
   # *   Sets both [positions](rdoc-ref:StringScanner@Positions) to end-of-stream.
   # *   Clears [match values](rdoc-ref:StringScanner@Match+Values).
   #     scanner = StringScanner.new(HIRAGANA_TEXT)
@@ -1540,7 +1561,7 @@ class StringScanner
   # #   rest_size: 0
   # match_values_cleared?(scanner) # => true
   #
-  def terminate: () -> void
+  def terminate: () -> self
 
   # <!--
   #   rdoc-file=ext/strscan/strscan.c
@@ -1571,14 +1592,14 @@ class StringScanner
   # match_values_cleared?(scanner) # => true
   # scanner.unscan                 # Raises StringScanner::Error.
   #
-  def unscan: () -> void
+  def unscan: () -> self
 
   # <!--
   #   rdoc-file=ext/strscan/strscan.c
   #   - values_at(*specifiers) -> array_of_captures or nil
   # -->
   # Returns an array of captured substrings, or `nil` of none.
-  # For each `specifier`, the returned substring is `[specifier]`;
+  # For each `specifier`, the returned substring is <code>[specifier]</code>;
   # see #[].
   #     scanner = StringScanner.new('Fri Dec 12 1975 14:39')
   # pattern = /(?<wday>\w+) (?<month>\w+) (?<day>\d+) /
@@ -1586,7 +1607,7 @@ class StringScanner
   # scanner.values_at(*0..3)               # => ["Fri Dec 12 ", "Fri", "Dec", "12"]
   # scanner.values_at(*%i[wday month day]) # => ["Fri", "Dec", "12"]
   #
-  def values_at: (*Integer) -> Array[String]?
+  def values_at: (*Integer | String | Symbol) -> Array[String]?
 
   private
 
@@ -1609,7 +1630,7 @@ class StringScanner
   # #   rest:      "foobarbaz"
   # #   rest_size: 9
   #
-  def initialize: (String, ?bool dup, ?fixed_anchor: bool) -> untyped
+  def initialize: (String, ?fixed_anchor: bool) -> void
 
   # <!--
   #   rdoc-file=ext/strscan/strscan.c

data/stdlib/tempfile/0/tempfile.rbs

@@ -19,7 +19,7 @@
 #     require 'tempfile'
 #
 #     # Tempfile.create with a block
-#     # The filename are choosen automatically.
+#     # The filename are chosen automatically.
 #     # (You can specify the prefix and suffix of the filename by an optional argument.)
 #     Tempfile.create {|f|
 #       f.puts "foo"
@@ -159,7 +159,7 @@ class Tempfile < File
   # *   Generated filename is unique in that directory.
   # *   Permissions are `0600`; see [File
   #     Permissions](rdoc-ref:File@File+Permissions).
-  # *   Mode is `'w+'` (read/write mode, positioned at the end).
+  # *   Mode is <code>'w+'</code> (read/write mode, positioned at the end).
   #
   # The temporary file removal depends on the keyword argument `anonymous` and
   # whether a block is given or not. See the description about the `anonymous`
@@ -206,8 +206,8 @@ class Tempfile < File
   #
   #         Tempfile.create('foo') # => #<File:/tmp/foo20220505-9795-1gok8l9>
   #
-  # *   An array of two strings `[prefix, suffix]`: the generated filename begins
-  #     with `prefix` and ends with `suffix`:
+  # *   An array of two strings <code>[prefix, suffix]</code>: the generated
+  #     filename begins with `prefix` and ends with `suffix`:
   #
   #         Tempfile.create(%w/foo .jpg/) # => #<File:/tmp/foo20220505-17839-tnjchh.jpg>
   #
@@ -226,16 +226,19 @@ class Tempfile < File
   #
   # The keyword argument `anonymous` specifies when the file is removed.
   #
-  # *   `anonymous=false` (default) without a block: the file is not removed.
-  # *   `anonymous=false` (default) with a block: the file is removed after the
-  #     block exits.
-  # *   `anonymous=true` without a block: the file is removed before returning.
-  # *   `anonymous=true` with a block: the file is removed before the block is
-  #     called.
+  # *   <code>anonymous=false</code> (default) without a block: the file is not
+  #     removed.
+  # *   <code>anonymous=false</code> (default) with a block: the file is removed
+  #     after the block exits.
+  # *   <code>anonymous=true</code> without a block: the file is removed before
+  #     returning.
+  # *   <code>anonymous=true</code> with a block: the file is removed before the
+  #     block is called.
   #
-  # In the first case (`anonymous=false` without a block), the file is not removed
-  # automatically. It should be explicitly closed. It can be used to rename to the
-  # desired filename. If the file is not needed, it should be explicitly removed.
+  # In the first case (<code>anonymous=false</code> without a block), the file is
+  # not removed automatically. It should be explicitly closed. It can be used to
+  # rename to the desired filename. If the file is not needed, it should be
+  # explicitly removed.
   #
   # The File#path method of the created file object returns the temporary
   # directory with a trailing slash when `anonymous` is true.
@@ -248,8 +251,8 @@ class Tempfile < File
   #
   # Implementation note:
   #
-  # The keyword argument +anonymous=true+ is implemented using FILE_SHARE_DELETE
-  # on Windows. O_TMPFILE is used on Linux.
+  # The keyword argument <code>anonymous=true</code> is implemented using
+  # `FILE_SHARE_DELETE` on Windows. `O_TMPFILE` is used on Linux.
   #
   # Related: Tempfile.new.
   #
@@ -283,7 +286,8 @@ class Tempfile < File
   #
   # The call returns the value of the block.
   #
-  # In any case, all arguments (`*args`) will be passed to Tempfile.new.
+  # In any case, all arguments (<code>*args</code>) will be passed to
+  # Tempfile.new.
   #
   #     Tempfile.open('foo', '/home/temp') do |f|
   #        # ... do something with f ...
@@ -318,7 +322,7 @@ class Tempfile < File
   #   - close!()
   # -->
   # Closes and unlinks (deletes) the file. Has the same effect as called
-  # `close(true)`.
+  # <code>close(true)</code>.
   #
   def close!: () -> void
 
@@ -422,7 +426,7 @@ class Tempfile < File
   # If possible, consider instead using Tempfile.create, which:
   #
   # *   Avoids the performance cost of delegation, incurred when Tempfile.new
-  #     calls its superclass `DelegateClass(File)`.
+  #     calls its superclass <code>DelegateClass(File)</code>.
   # *   Does not rely on a finalizer to close and unlink the file, which can be
   #     unreliable.
   #
@@ -433,7 +437,7 @@ class Tempfile < File
   # *   Generated filename is unique in that directory.
   # *   Permissions are `0600`; see [File
   #     Permissions](rdoc-ref:File@File+Permissions).
-  # *   Mode is `'w+'` (read/write mode, positioned at the end).
+  # *   Mode is <code>'w+'</code> (read/write mode, positioned at the end).
   #
   # The underlying file is removed when the Tempfile object dies and is reclaimed
   # by the garbage collector.
@@ -454,8 +458,8 @@ class Tempfile < File
   #
   #         Tempfile.new('foo') # => #<Tempfile:/tmp/foo20220505-17839-1whk2f>
   #
-  # *   An array of two strings `[prefix, suffix]`: the generated filename begins
-  #     with `prefix` and ends with `suffix`:
+  # *   An array of two strings <code>[prefix, suffix]</code>: the generated
+  #     filename begins with `prefix` and ends with `suffix`:
   #
   #         Tempfile.new(%w/foo .jpg/) # => #<Tempfile:/tmp/foo20220505-17839-58xtfi.jpg>
   #

data/stdlib/time/0/time.rbs

@@ -10,12 +10,13 @@ class Time
 
   # <!--
   #   rdoc-file=lib/time.rb
-  #   - zone_offset(zone, year=self.now.year)
+  #   - zone_offset(zone, year=nil)
   # -->
   # Return the number of seconds the specified time zone differs from UTC.
   #
-  # Numeric time zones that include minutes, such as `-10:00` or `+1330` will
-  # work, as will simpler hour-only time zones like `-10` or `+13`.
+  # Numeric time zones that include minutes, such as <code>-10:00</code> or
+  # <code>+1330</code> will work, as will simpler hour-only time zones like
+  # <code>-10</code> or <code>+13</code>.
   #
   # Textual time zones listed in ZoneOffset are also supported.
   #
@@ -120,9 +121,10 @@ class Time
   # Based on this fact, this method only understands the time zone abbreviations
   # described in RFC 822 and the system time zone, in the order named. (i.e. a
   # definition in RFC 822 overrides the system time zone definition.)  The system
-  # time zone is taken from `Time.local(year, 1, 1).zone` and `Time.local(year, 7,
-  # 1).zone`. If the extracted time zone abbreviation does not match any of them,
-  # it is ignored and the given time is regarded as a local time.
+  # time zone is taken from <code>Time.local(year, 1, 1).zone</code> and
+  # <code>Time.local(year, 7, 1).zone</code>. If the extracted time zone
+  # abbreviation does not match any of them, it is ignored and the given time is
+  # regarded as a local time.
   #
   # ArgumentError is raised if Date._parse cannot extract information from `date`
   # or if the Time class cannot represent specified date.