rbs 3.10.4 → 4.0.0

data/stdlib/stringio/0/stringio.rbs

@@ -6,8 +6,8 @@
 # *   StringIO.new: returns a new StringIO object containing the given string.
 # *   StringIO.open: passes a new StringIO object to the given block.
 # Like an IO stream, a StringIO stream has certain properties:
-# *   **Read/write mode**: whether the stream may be read, written, appended to,
-#     etc.;
+# *   <strong>Read/write mode</strong>: whether the stream may be read, written,
+#     appended to, etc.;
 #      see [Read/Write Mode](rdoc-ref:StringIO@Read-2FWrite+Mode).
 # *   **Data mode**: text-only or binary;
 #      see [Data Mode](rdoc-ref:StringIO@Data+Mode).
@@ -18,8 +18,8 @@
 # *   **Line number**: a special, line-oriented, "position" (different from the
 #     position mentioned above);
 #      see [Line Number](rdoc-ref:StringIO@Line+Number).
-# *   **Open/closed**: whether the stream is open or closed, for reading or
-#     writing.
+# *   <strong>Open/closed</strong>: whether the stream is open or closed, for
+#     reading or writing.
 #      see [Open/Closed Streams](rdoc-ref:StringIO@Open-2FClosed+Streams).
 # *   **BOM**: byte mark order;
 #      see [Byte Order Mark](rdoc-ref:StringIO@BOM+-28Byte+Order+Mark-29).
@@ -39,24 +39,24 @@
 # ## Stream Properties
 # ### Read/Write Mode
 # #### Summary
-#        Mode        |Initial Clear?|  Read  | Write
-# -------------------|--------------|--------|--------
-#  `'r'`: read-only  |      No      |Anywhere| Error
-#  `'w'`: write-only |     Yes      | Error  |Anywhere
-# `'a'`: append-only |      No      | Error  |End only
-# `'r+'`: read/write |      No      |Anywhere|Anywhere
-# `'w+'`: read-write |     Yes      |Anywhere|Anywhere
-# `'a+'`: read/append|      No      |Anywhere|End only
+#              Mode             |Initial Clear?|  Read  | Write
+# ------------------------------|--------------|--------|--------
+#  <code>'r'</code>: read-only  |      No      |Anywhere| Error
+#  <code>'w'</code>: write-only |     Yes      | Error  |Anywhere
+# <code>'a'</code>: append-only |      No      | Error  |End only
+# <code>'r+'</code>: read/write |      No      |Anywhere|Anywhere
+# <code>'w+'</code>: read-write |     Yes      |Anywhere|Anywhere
+# <code>'a+'</code>: read/append|      No      |Anywhere|End only
 # Each section below describes a read/write mode.
 # Any of the modes may be given as a string or as file constants;
 # example:
 #     strio = StringIO.new('foo', 'a')
 # strio = StringIO.new('foo', File::WRONLY | File::APPEND)
 #
-# #### `'r'`: Read-Only
+# #### <code>'r'</code>: Read-Only
 # Mode specified as one of:
-# *   String: `'r'`.
-# *   Constant: `File::RDONLY`.
+# *   String: <code>'r'</code>.
+# *   Constant: <code>File::RDONLY</code>.
 # Initial state:
 #     strio = StringIO.new('foobarbaz', 'r')
 # strio.pos    # => 0            # Beginning-of-stream.
@@ -71,10 +71,10 @@
 # May not be written:
 #     strio.write('foo')  # Raises IOError: not opened for writing
 #
-# #### `'w'`: Write-Only
+# #### <code>'w'</code>: Write-Only
 # Mode specified as one of:
-# *   String: `'w'`.
-# *   Constant: `File::WRONLY`.
+# *   String: <code>'w'</code>.
+# *   Constant: <code>File::WRONLY</code>.
 # Initial state:
 #     strio = StringIO.new('foo', 'w')
 # strio.pos    # => 0   # Beginning of stream.
@@ -96,10 +96,10 @@
 # May not be read:
 #     strio.read  # Raises IOError: not opened for reading
 #
-# #### `'a'`: Append-Only
+# #### <code>'a'</code>: Append-Only
 # Mode specified as one of:
-# *   String: `'a'`.
-# *   Constant: `File::WRONLY | File::APPEND`.
+# *   String: <code>'a'</code>.
+# *   Constant: <code>File::WRONLY | File::APPEND</code>.
 # Initial state:
 #     strio = StringIO.new('foo', 'a')
 # strio.pos    # => 0      # Beginning-of-stream.
@@ -117,10 +117,10 @@
 # May not be read:
 #     strio.gets  # Raises IOError: not opened for reading
 #
-# #### `'r+'`: Read/Write
+# #### <code>'r+'</code>: Read/Write
 # Mode specified as one of:
-# *   String: `'r+'`.
-# *   Constant: `File::RDRW`.
+# *   String: <code>'r+'</code>.
+# *   Constant: <code>File::RDRW</code>.
 # Initial state:
 #     strio = StringIO.new('foobar', 'r+')
 # strio.pos    # => 0         # Beginning-of-stream.
@@ -145,10 +145,10 @@
 # strio.pos = 400
 # strio.gets(3) # => nil
 #
-# #### `'w+'`: Read/Write (Initially Clear)
+# #### <code>'w+'</code>: Read/Write (Initially Clear)
 # Mode specified as one of:
-# *   String: `'w+'`.
-# *   Constant: `File::RDWR | File::TRUNC`.
+# *   String: <code>'w+'</code>.
+# *   Constant: <code>File::RDWR | File::TRUNC</code>.
 # Initial state:
 #     strio = StringIO.new('foo', 'w+')
 # strio.pos    # => 0   # Beginning-of-stream.
@@ -177,10 +177,10 @@
 # strio.pos = 400
 # strio.gets(3) # => nil
 #
-# #### `'a+'`: Read/Append
+# #### <code>'a+'</code>: Read/Append
 # Mode specified as one of:
-# *   String: `'a+'`.
-# *   Constant: `File::RDWR | File::APPEND`.
+# *   String: <code>'a+'</code>.
+# *   Constant: <code>File::RDWR | File::APPEND</code>.
 # Initial state:
 #     strio = StringIO.new('foo', 'a+')
 # strio.pos    # => 0      # Beginning-of-stream.
@@ -208,9 +208,9 @@
 # To specify whether the stream is to be treated as text or as binary data,
 # either of the following may be suffixed to any of the string read/write modes
 # above:
-# *   `'t'`: Text;
+# *   <code>'t'</code>: Text;
 #      initializes the encoding as Encoding::UTF_8.
-# *   `'b'`: Binary;
+# *   <code>'b'</code>: Binary;
 #      initializes the encoding as Encoding::ASCII_8BIT.
 # If neither is given, the stream defaults to text data.
 # Examples:
@@ -231,12 +231,12 @@
 # .
 # The initial encoding for a new or re-opened stream depends on its [data
 # mode](rdoc-ref:StringIO@Data+Mode):
-# *   Text: `Encoding::UTF_8`.
-# *   Binary: `Encoding::ASCII_8BIT`.
+# *   Text: <code>Encoding::UTF_8</code>.
+# *   Binary: <code>Encoding::ASCII_8BIT</code>.
 # These instance methods are relevant:
 # *   #external_encoding: returns the current encoding of the stream as an
 #     `Encoding` object.
-# *   #internal_encoding: returns `nil`; a stream does not have an internal
+# *   #internal_encoding: returns +nil+; a stream does not have an internal
 #     encoding.
 # *   #set_encoding: sets the encoding for the stream.
 # *   #set_encoding_by_bom: sets the encoding for the stream to the stream's BOM
@@ -371,7 +371,7 @@
 # *   Method #lineno= sets the line number.
 # The line number can be affected by reading (but never by writing);
 # in general, the line number is incremented each time the record separator
-# (default: `"\n"`) is read.
+# (default: <code>"\n"</code>) is read.
 # Examples:
 #     strio = StringIO.new(TEXT)
 # strio.string # => "First line\nSecond line\n\nFourth line\nFifth line\n"
@@ -522,7 +522,7 @@ class StringIO
   #     strio.closed_write? # => false
   #     strio.close
   #
-  # If `string` is frozen, the default `mode` is `'r'`:
+  # If `string` is frozen, the default `mode` is <code>'r'</code>:
   #
   #     strio = StringIO.new('foo'.freeze)
   #     strio.string        # => "foo"
@@ -546,7 +546,8 @@ class StringIO
   #   - StringIO.open(string = '', mode = 'r+') -> new_stringio
   #   - StringIO.open(string = '', mode = 'r+') {|strio| ... } -> object
   # -->
-  # Creates new StringIO instance by calling `StringIO.new(string, mode)`.
+  # Creates new StringIO instance by calling <code>StringIO.new(string,
+  # mode)</code>.
   #
   # With no block given, returns the new instance:
   #
@@ -685,7 +686,7 @@ class StringIO
   # **No Arguments**
   # With no arguments given,
   # reads lines using the default record separator
-  # (global variable `$/`, whose initial value is `"\n"`).
+  # (global variable <code>$/</code>, whose initial value is <code>"\n"</code>).
   #     strio = StringIO.new(TEXT)
   # strio.each_line {|line| p line }
   # strio.eof? # => true
@@ -697,7 +698,7 @@ class StringIO
   # "Fourth line\n"
   # "Fifth line\n"
   #
-  # **Argument `sep`**
+  # <strong>Argument `sep`</strong>
   # With only string argument `sep` given,
   # reads lines using that string as the record separator:
   #     strio = StringIO.new(TEXT)
@@ -710,7 +711,7 @@ class StringIO
   # "line\nFifth "
   # "line\n"
   #
-  # **Argument `limit`**
+  # <strong>Argument `limit`</strong>
   # With only integer argument `limit` given,
   # reads lines using the default record separator;
   # also limits the size (in characters) of each line to the given limit:
@@ -728,7 +729,7 @@ class StringIO
   # "Fifth line"
   # "\n"
   #
-  # **Arguments `sep` and `limit`**
+  # <strong>Arguments `sep` and `limit`</strong>
   # With arguments `sep` and `limit` both given,
   # honors both:
   #     strio = StringIO.new(TEXT)
@@ -793,7 +794,7 @@ class StringIO
   # Output:
   #     "First line\nSecond line\n\nFourth line\nFifth line\n"
   #
-  # **Keyword Argument `chomp`**
+  # <strong>Keyword Argument `chomp`</strong>
   # With keyword argument `chomp` given as `true` (the default is `false`),
   # removes trailing newline (if any) from each line:
   #     strio = StringIO.new(TEXT)
@@ -1085,10 +1086,10 @@ class StringIO
   # Side effects:
   #
   # *   Increments stream position by the number of bytes read.
-  # *   Assigns the return value to global variable `$_`.
+  # *   Assigns the return value to global variable <code>$_</code>.
   #
   # With no arguments given, reads a line using the default record separator
-  # (global variable `$/`,* whose initial value is `"\n"`):
+  # (global variable <code>$/</code>,* whose initial value is <code>"\n"</code>):
   #
   #     strio = StringIO.new(TEXT)
   #     strio.pos  # => 0
@@ -1105,7 +1106,7 @@ class StringIO
   #     strio.gets # => "Привет"
   #     strio.pos  # => 12
   #
-  # **Argument `sep`**
+  # <strong>Argument `sep`</strong>
   #
   # With only string argument `sep` given, reads a line using that string as the
   # record separator:
@@ -1115,7 +1116,7 @@ class StringIO
   #     strio.gets(' ') # => "line\nSecond "
   #     strio.gets(' ') # => "line\n\nFourth "
   #
-  # **Argument `limit`**
+  # <strong>Argument `limit`</strong>
   #
   # With only integer argument `limit` given, reads a line using the default
   # record separator; limits the size (in characters) of each line to the given
@@ -1127,7 +1128,7 @@ class StringIO
   #     strio.gets(10) # => "Second lin"
   #     strio.gets(10) # => "e\n"
   #
-  # **Arguments `sep` and `limit`**
+  # <strong>Arguments `sep` and `limit`</strong>
   #
   # With arguments `sep` and `limit` both given, honors both:
   #
@@ -1170,7 +1171,7 @@ class StringIO
   #     strio.gets(nil) # "Slurp": read all.
   #     # => "First line\nSecond line\n\nFourth line\nFifth line\n"
   #
-  # **Keyword Argument `chomp`**
+  # <strong>Keyword Argument `chomp`</strong>
   #
   # With keyword argument `chomp` given as `true` (the default is `false`),
   # removes the trailing newline (if any) from the returned line:
@@ -1507,7 +1508,7 @@ class StringIO
   # **No Arguments**
   # With no arguments given,
   # reads lines using the default record separator
-  # (global variable `$/`, whose initial value is `"\n"`).
+  # (global variable <code>$/</code>, whose initial value is <code>"\n"</code>).
   #     strio = StringIO.new(TEXT)
   # strio.each_line {|line| p line }
   # strio.eof? # => true
@@ -1519,7 +1520,7 @@ class StringIO
   # "Fourth line\n"
   # "Fifth line\n"
   #
-  # **Argument `sep`**
+  # <strong>Argument `sep`</strong>
   # With only string argument `sep` given,
   # reads lines using that string as the record separator:
   #     strio = StringIO.new(TEXT)
@@ -1532,7 +1533,7 @@ class StringIO
   # "line\nFifth "
   # "line\n"
   #
-  # **Argument `limit`**
+  # <strong>Argument `limit`</strong>
   # With only integer argument `limit` given,
   # reads lines using the default record separator;
   # also limits the size (in characters) of each line to the given limit:
@@ -1550,7 +1551,7 @@ class StringIO
   # "Fifth line"
   # "\n"
   #
-  # **Arguments `sep` and `limit`**
+  # <strong>Arguments `sep` and `limit`</strong>
   # With arguments `sep` and `limit` both given,
   # honors both:
   #     strio = StringIO.new(TEXT)
@@ -1615,7 +1616,7 @@ class StringIO
   # Output:
   #     "First line\nSecond line\n\nFourth line\nFifth line\n"
   #
-  # **Keyword Argument `chomp`**
+  # <strong>Keyword Argument `chomp`</strong>
   # With keyword argument `chomp` given as `true` (the default is `false`),
   # removes trailing newline (if any) from each line:
   #     strio = StringIO.new(TEXT)

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,13 +20,13 @@
 # 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 at [helper methods](helper_methods.md).
@@ -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.
@@ -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;
@@ -211,12 +212,12 @@
 # This table summarizes (details and examples at the links):
 #        Method        |                   Returns                   |Sets Match Values?
 # ---------------------|---------------------------------------------|------------------
-#    #check(pattern)   |     Matched leading substring or `nil`.     |       Yes.
-# #check_until(pattern)|   Matched substring (anywhere) or `nil`.    |       Yes.
+#    #check(pattern)   |     Matched leading substring or +nil+.     |       Yes.
+# #check_until(pattern)|   Matched substring (anywhere) or +nil+.    |       Yes.
 #   #exist?(pattern)   |   Matched substring (anywhere) end index.   |       Yes.
-#   #match?(pattern)   | Size of matched leading substring or `nil`. |       Yes.
+#   #match?(pattern)   | Size of matched leading substring or +nil+. |       Yes.
 #      #peek(size)     | Leading substring of given length (bytes).  |       No.
-#      #peek_byte      |       Integer leading byte or `nil`.        |       No.
+#      #peek_byte      |       Integer leading byte or +nil+.        |       No.
 #         #rest        |Target substring (from byte position to end).|       No.
 # ### Traversing the Target Substring
 # A *traversal* method examines the target substring,
@@ -226,24 +227,24 @@
 # This table summarizes (details and examples at links):
 #        Method       |                      Returns                       |Sets Match Values?
 # --------------------|----------------------------------------------------|------------------
-#      #get_byte      |               Leading byte or `nil`.               |       No.
-#        #getch       |            Leading character or `nil`.             |       No.
-#    #scan(pattern)   |        Matched leading substring or `nil`.         |       Yes.
-#      #scan_byte     |           Integer leading byte or `nil`.           |       No.
-# #scan_until(pattern)|       Matched substring (anywhere) or `nil`.       |       Yes.
-#    #skip(pattern)   |      Matched leading substring size or `nil`.      |       Yes.
-# #skip_until(pattern)|Position delta to end-of-matched-substring or `nil`.|       Yes.
-#       #unscan       |                      `self`.                       |       No.
+#      #get_byte      |               Leading byte or +nil+.               |       No.
+#        #getch       |            Leading character or +nil+.             |       No.
+#    #scan(pattern)   |        Matched leading substring or +nil+.         |       Yes.
+#      #scan_byte     |           Integer leading byte or +nil+.           |       No.
+# #scan_until(pattern)|       Matched substring (anywhere) or +nil+.       |       Yes.
+#    #skip(pattern)   |      Matched leading substring size or +nil+.      |       Yes.
+# #skip_until(pattern)|Position delta to end-of-matched-substring or +nil+.|       Yes.
+#       #unscan       |                      +self+.                       |       No.
 # ## Querying the Scanner
 # Each of these methods queries the scanner object
 # without modifying it (details and examples at links)
 #       Method       |            Returns
 # -------------------|--------------------------------
-# #beginning_of_line?|       `true` or `false`.
+# #beginning_of_line?|       +true+ or +false+.
 #      #charpos      |      Character position.
-#        #eos?       |       `true` or `false`.
-#   #fixed_anchor?   |       `true` or `false`.
-#      #inspect      |String representation of `self`.
+#        #eos?       |       +true+ or +false+.
+#   #fixed_anchor?   |       +true+ or +false+.
+#      #inspect      |String representation of +self+.
 #        #pos        |         Byte position.
 #        #rest       |       Target substring.
 #     #rest_size     |   Size of target substring.
@@ -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:
@@ -312,11 +313,11 @@
 # Each of these methods returns a basic match value:
 #    Method    |          Return After Match          |Return After No Match
 # -------------|--------------------------------------|---------------------
-#   #matched?  |               `true`.                |      `false`.
-# #matched_size|      Size of matched substring.      |       `nil`.
-#   #matched   |          Matched substring.          |       `nil`.
-#  #pre_match  |Substring preceding matched substring.|       `nil`.
-#  #post_match |Substring following matched substring.|       `nil`.
+#   #matched?  |               +true+.                |      +false+.
+# #matched_size|      Size of matched substring.      |       +nil+.
+#   #matched   |          Matched substring.          |       +nil+.
+#  #pre_match  |Substring preceding matched substring.|       +nil+.
+#  #post_match |Substring following matched substring.|       +nil+.
 #
 # See examples below.
 # #### Captured Match Values
@@ -326,11 +327,11 @@
 # Each of these methods returns a captured match value:
 #     Method     |          Return After Match           |Return After No Match
 # ---------------|---------------------------------------|---------------------
-#      #size     |     Count of captured substrings.     |       `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.        |        `{}`.
+#      #size     |     Count of captured substrings.     |       +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.        |  <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,13 +487,13 @@ 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
@@ -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
@@ -999,7 +1001,7 @@ class StringScanner
   #   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')
@@ -1151,7 +1153,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...">
@@ -1237,7 +1239,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).
@@ -1517,7 +1519,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)
@@ -1578,7 +1580,7 @@ class StringScanner
   #   - 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+) /

data/stdlib/tempfile/0/tempfile.rbs

@@ -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>
   #