rbs 4.0.0.dev.5 → 4.0.1.dev.1

data/stdlib/optparse/0/optparse.rbs

@@ -107,15 +107,16 @@
 #
 # OptionParser comes with a few ready-to-use kinds of type coercion. They are:
 #
-# *   Date  -- Anything accepted by `Date.parse` (need to require
-#     `optparse/date`)
-# *   DateTime -- Anything accepted by `DateTime.parse` (need to require
-#     `optparse/date`)
-# *   Time -- Anything accepted by `Time.httpdate` or `Time.parse` (need to
-#     require `optparse/time`)
-# *   URI  -- Anything accepted by `URI.parse` (need to require `optparse/uri`)
-# *   Shellwords -- Anything accepted by `Shellwords.shellwords` (need to
-#     require `optparse/shellwords`)
+# *   Date  -- Anything accepted by <code>Date.parse</code> (need to require
+#     <code>optparse/date</code>)
+# *   DateTime -- Anything accepted by <code>DateTime.parse</code> (need to
+#     require <code>optparse/date</code>)
+# *   Time -- Anything accepted by <code>Time.httpdate</code> or
+#     <code>Time.parse</code> (need to require <code>optparse/time</code>)
+# *   URI  -- Anything accepted by <code>URI.parse</code> (need to require
+#     <code>optparse/uri</code>)
+# *   Shellwords -- Anything accepted by <code>Shellwords.shellwords</code>
+#     (need to require <code>optparse/shellwords</code>)
 # *   String -- Any non-empty string
 # *   Integer -- Any integer. Will convert octal. (e.g. 124, -3, 040)
 # *   Float -- Any float. (e.g. 10, 3.14, -100E+13)
@@ -760,8 +761,8 @@ class OptionParser
   # -->
   # Parses command line arguments `argv` in order. When a block is given, each
   # non-option argument is yielded. When optional `into` keyword argument is
-  # provided, the parsed option values are stored there via `[]=` method (so it
-  # can be Hash, or OpenStruct, or other similar object).
+  # provided, the parsed option values are stored there via <code>[]=</code>
+  # method (so it can be Hash, or OpenStruct, or other similar object).
   #
   # Returns the rest of `argv` left unparsed.
   #
@@ -784,7 +785,8 @@ class OptionParser
   # Parses command line arguments `argv` in order when environment variable
   # POSIXLY_CORRECT is set, and in permutation mode otherwise. When optional
   # `into` keyword argument is provided, the parsed option values are stored there
-  # via `[]=` method (so it can be Hash, or OpenStruct, or other similar object).
+  # via <code>[]=</code> method (so it can be Hash, or OpenStruct, or other
+  # similar object).
   #
   def parse: (*String argv, ?into: _Intoable) -> Array[String]
            | (Array[String] argv, ?into: _Intoable) -> Array[String]
@@ -804,8 +806,8 @@ class OptionParser
   # -->
   # Parses command line arguments `argv` in permutation mode and returns list of
   # non-option arguments. When optional `into` keyword argument is provided, the
-  # parsed option values are stored there via `[]=` method (so it can be Hash, or
-  # OpenStruct, or other similar object).
+  # parsed option values are stored there via <code>[]=</code> method (so it can
+  # be Hash, or OpenStruct, or other similar object).
   #
   def permute: (*String argv, ?into: _Intoable) -> Array[String]
              | (Array[String] argv, ?into: _Intoable) -> Array[String]
@@ -876,10 +878,12 @@ class OptionParser
   #
   def separator: (String string) -> void
 
+  # <!-- rdoc-file=lib/optparse.rb -->
   # Heading banner preceding summary.
   #
   alias set_banner banner=
 
+  # <!-- rdoc-file=lib/optparse.rb -->
   # Program name to be emitted in error message and default banner, defaults to
   # $0.
   #

data/stdlib/pathname/0/pathname.rbs

@@ -14,8 +14,8 @@ class Pathname
   # Since it is implemented by the standard library module Find, Find.prune can be
   # used to control the traversal.
   #
-  # If `self` is `.`, yielded pathnames begin with a filename in the current
-  # directory, not `./`.
+  # If `self` is <code>.</code>, yielded pathnames begin with a filename in the
+  # current directory, not <code>./</code>.
   #
   # See Find.find
   #

data/stdlib/pp/0/pp.rbs

@@ -31,18 +31,19 @@
 #     pp(obj1, obj2, ...) #=> [obj1, obj2, ...]
 #     pp()                #=> nil
 #
-# Output `obj(s)` to `$>` in pretty printed format.
+# Output <code>obj(s)</code> to <code>$></code> in pretty printed format.
 #
-# It returns `obj(s)`.
+# It returns <code>obj(s)</code>.
 #
 # ## Output Customization
 #
 # To define a customized pretty printing function for your classes, redefine
-# method `#pretty_print(pp)` in the class. Note that `require 'pp'` is needed
-# before redefining `#pretty_print(pp)`.
+# method <code>#pretty_print(pp)</code> in the class. Note that <code>require
+# 'pp'</code> is needed before redefining <code>#pretty_print(pp)</code>.
 #
-# `#pretty_print` takes the `pp` argument, which is an instance of the PP class.
-# The method uses #text, #breakable, #nest, #group and #pp to print the object.
+# <code>#pretty_print</code> takes the `pp` argument, which is an instance of
+# the PP class. The method uses #text, #breakable, #nest, #group and #pp to
+# print the object.
 #
 # ## Pretty-Print JSON
 #
@@ -237,8 +238,8 @@ class PP < PrettyPrint
   # -->
   # Outputs `obj` to `out` in pretty printed format of `width` columns in width.
   #
-  # If `out` is omitted, `$>` is assumed. If `width` is omitted, the width of
-  # `out` is assumed (see width_for).
+  # If `out` is omitted, <code>$></code> is assumed. If `width` is omitted, the
+  # width of `out` is assumed (see width_for).
   #
   # PP.pp returns `out`.
   #

data/stdlib/prettyprint/0/prettyprint.rbs

@@ -196,8 +196,8 @@ class PrettyPrint
   #
   # If `sep` is not specified, " " is used.
   #
-  # If `width` is not specified, `sep.length` is used. You will have to specify
-  # this when `sep` is a multibyte character, for example.
+  # If `width` is not specified, <code>sep.length</code> is used. You will have to
+  # specify this when `sep` is a multibyte character, for example.
   #
   def fill_breakable: (?String sep, ?Integer width) -> void
 
@@ -210,8 +210,8 @@ class PrettyPrint
   #
   # If `sep` is not specified, " " is used.
   #
-  # If `width` is not specified, `sep.length` is used. You will have to specify
-  # this when `sep` is a multibyte character, for example.
+  # If `width` is not specified, <code>sep.length</code> is used. You will have to
+  # specify this when `sep` is a multibyte character, for example.
   #
   def breakable: (?String sep, ?Integer width) -> void
 
@@ -225,9 +225,9 @@ class PrettyPrint
   # If `indent` is specified, the method call is regarded as nested by
   # nest(indent) { ... }.
   #
-  # If `open_obj` is specified, `text open_obj, open_width` is called before
-  # grouping. If `close_obj` is specified, `text close_obj, close_width` is called
-  # after grouping.
+  # If `open_obj` is specified, <code>text open_obj, open_width</code> is called
+  # before grouping. If `close_obj` is specified, <code>text close_obj,
+  # close_width</code> is called after grouping.
   #
   def group: (?::Integer indent, ?::String open_obj, ?::String close_obj, ?Integer open_width, ?Integer close_width) { () -> untyped } -> Integer
 

data/stdlib/pstore/0/pstore.rbs

@@ -299,7 +299,7 @@
 #       end
 #     end
 #
-class PStore
+class PStore[unchecked out K = untyped, unchecked out V = untyped]
   # <!--
   #   rdoc-file=lib/pstore.rb
   #   - [](key)
@@ -320,7 +320,7 @@ class PStore
   #
   # Raises an exception if called outside a transaction block.
   #
-  def []: (untyped name) -> untyped
+  def []: (K name) -> V?
 
   # <!--
   #   rdoc-file=lib/pstore.rb
@@ -338,7 +338,7 @@ class PStore
   #
   # Raises an exception if called outside a transaction block.
   #
-  def []=: (untyped name, untyped value) -> untyped
+  def []=: (K name, V value) -> V
 
   # <!--
   #   rdoc-file=lib/pstore.rb
@@ -349,7 +349,7 @@ class PStore
   #
   # Raises an exception if called outside a transaction block.
   #
-  def abort: () -> untyped
+  def abort: () -> void
 
   # <!--
   #   rdoc-file=lib/pstore.rb
@@ -360,7 +360,7 @@ class PStore
   #
   # Raises an exception if called outside a transaction block.
   #
-  def commit: () -> nil
+  def commit: () -> void
 
   # <!--
   #   rdoc-file=lib/pstore.rb
@@ -379,7 +379,7 @@ class PStore
   #
   # Raises an exception if called outside a transaction block.
   #
-  def delete: (untyped name) -> untyped
+  def delete: (K name) -> V?
 
   # <!--
   #   rdoc-file=lib/pstore.rb
@@ -400,7 +400,7 @@ class PStore
   #
   # Raises an exception if called outside a transaction block.
   #
-  def fetch: (untyped name, ?untyped default) -> untyped
+  def fetch: (K name, ?V default) -> V
 
   # <!--
   #   rdoc-file=lib/pstore.rb
@@ -410,21 +410,25 @@ class PStore
   #
   #     store.path # => "flat.store"
   #
-  def path: () -> untyped
+  def path: () -> String
 
   # <!--
   #   rdoc-file=lib/pstore.rb
   #   - root?(key)
   # -->
   #
-  def root?: (untyped name) -> bool
+  def key?: (K name) -> bool
+
+  alias root? key?
 
   # <!--
   #   rdoc-file=lib/pstore.rb
   #   - roots()
   # -->
   #
-  def roots: () -> Array[untyped]
+  def keys: () -> Array[K]
+
+  alias roots keys
 
   # <!--
   #   rdoc-file=lib/pstore.rb
@@ -441,7 +445,7 @@ class PStore
   #
   # Raises an exception if called within a transaction block.
   #
-  def transaction: (?untyped read_only) -> untyped
+  def transaction: [U] (?bool read_only) { (self) -> U } -> U
 
   # <!-- rdoc-file=lib/pstore.rb -->
   # Whether PStore should do its best to prevent file corruptions, even when an
@@ -458,7 +462,7 @@ class PStore
   #     raises no unexpected I/O error; if such an error occurs during a write to
   #     the store, the file may become corrupted.
   #
-  def ultra_safe: () -> untyped
+  def ultra_safe: () -> bool
 
   # <!-- rdoc-file=lib/pstore.rb -->
   # Whether PStore should do its best to prevent file corruptions, even when an
@@ -475,7 +479,7 @@ class PStore
   #     raises no unexpected I/O error; if such an error occurs during a write to
   #     the store, the file may become corrupted.
   #
-  def ultra_safe=: (untyped) -> untyped
+  def ultra_safe=: (bool) -> bool
 
   private
 
@@ -486,14 +490,14 @@ class PStore
   #   - empty_marshal_checksum()
   # -->
   #
-  def empty_marshal_checksum: () -> untyped
+  def empty_marshal_checksum: () -> String
 
   # <!--
   #   rdoc-file=lib/pstore.rb
   #   - empty_marshal_data()
   # -->
   #
-  def empty_marshal_data: () -> untyped
+  def empty_marshal_data: () -> String
 
   # <!--
   #   rdoc-file=lib/pstore.rb
@@ -501,7 +505,7 @@ class PStore
   # -->
   # Raises PStore::Error if the calling code is not in a PStore#transaction.
   #
-  def in_transaction: () -> untyped
+  def in_transaction: () -> void
 
   # <!--
   #   rdoc-file=lib/pstore.rb
@@ -510,7 +514,7 @@ class PStore
   # Raises PStore::Error if the calling code is not in a PStore#transaction or if
   # the code is in a read-only PStore#transaction.
   #
-  def in_transaction_wr: () -> untyped
+  def in_transaction_wr: () -> void
 
   # <!--
   #   rdoc-file=lib/pstore.rb
@@ -531,7 +535,7 @@ class PStore
   #
   #     store = PStore.new(path, true)
   #
-  def initialize: (untyped file, ?boolish thread_safe) -> untyped
+  def initialize: (path file, ?boolish thread_safe) -> void
 
   def load: (untyped content) -> untyped
 
@@ -543,7 +547,8 @@ class PStore
   # be returned. If `read_only` is false, a 3-tuple will be returned: the
   # unmarshalled Hash, a checksum of the data, and the size of the data.
   #
-  def load_data: (untyped file, untyped read_only) -> untyped
+  def load_data: (path file, true read_only) -> Hash[untyped, untyped]
+               | (path file, false read_only) -> [Hash[untyped, untyped], String, Integer]
 
   # <!--
   #   rdoc-file=lib/pstore.rb
@@ -564,7 +569,7 @@ class PStore
   #
   # All exceptions are propagated.
   #
-  def open_and_lock_file: (untyped filename, untyped read_only) -> untyped
+  def open_and_lock_file: (string filename, bool read_only) -> File?
 
   # <!--
   #   rdoc-file=lib/pstore.rb
@@ -578,26 +583,26 @@ class PStore
   #   - save_data_with_atomic_file_rename_strategy(data, file)
   # -->
   #
-  def save_data_with_atomic_file_rename_strategy: (untyped data, untyped file) -> untyped
+  def save_data_with_atomic_file_rename_strategy: (string data, File file) -> void
 
   # <!--
   #   rdoc-file=lib/pstore.rb
   #   - save_data_with_fast_strategy(data, file)
   # -->
   #
-  def save_data_with_fast_strategy: (untyped data, untyped file) -> untyped
-end
+  def save_data_with_fast_strategy: (string data, File file) -> void
 
-PStore::EMPTY_MARSHAL_CHECKSUM: String
+  EMPTY_MARSHAL_CHECKSUM: String
 
-PStore::EMPTY_MARSHAL_DATA: String
+  EMPTY_MARSHAL_DATA: String
 
-PStore::EMPTY_STRING: String
+  EMPTY_STRING: String
 
-PStore::RDWR_ACCESS: Hash[untyped, untyped]
+  RDWR_ACCESS: { mode: Integer, encoding: Encoding }
 
-PStore::RD_ACCESS: Hash[untyped, untyped]
+  RD_ACCESS: { mode: Integer, encoding: Encoding }
 
-PStore::VERSION: String
+  VERSION: String
 
-PStore::WR_ACCESS: Hash[untyped, untyped]
+  WR_ACCESS: { mode: Integer, encoding: Encoding }
+end

data/stdlib/psych/0/psych.rbs

@@ -214,29 +214,30 @@ module Psych
   #
   # Currently supported options are:
   #
-  # `:indentation`
+  # <code>:indentation</code>
   # :   Number of space characters used to indent. Acceptable value should be in
-  #     `0..9` range, otherwise option is ignored.
+  #     <code>0..9</code> range, otherwise option is ignored.
   #
   #     Default: `2`.
   #
-  # `:line_width`
-  # :   Max character to wrap line at. For unlimited line width use `-1`.
+  # <code>:line_width</code>
+  # :   Max character to wrap line at. For unlimited line width use
+  #     <code>-1</code>.
   #
   #     Default: `0` (meaning "wrap at 81").
   #
-  # `:canonical`
+  # <code>:canonical</code>
   # :   Write "canonical" YAML form (very verbose, yet strictly formal).
   #
   #     Default: `false`.
   #
-  # `:header`
-  # :   Write `%YAML [version]` at the beginning of document.
+  # <code>:header</code>
+  # :   Write <code>%YAML [version]</code> at the beginning of document.
   #
   #     Default: `false`.
   #
   #
-  # `:stringify_names`
+  # <code>:stringify_names</code>
   # :   Dump symbol keys in Hash objects as string.
   #
   #     Default: `false`.
@@ -399,4 +400,56 @@ module Psych
   #
   %a{annotate:rdoc:copy:Psych.unsafe_load}
   def self.unsafe_load: (String yaml, ?filename: String | _ToStr | _ToS?, ?fallback: untyped, ?symbolize_names: bool, ?freeze: bool, ?strict_integer: bool) -> untyped
+
+  # <!--
+  #   rdoc-file=ext/psych/lib/psych.rb
+  #   - safe_load_file(filename, **kwargs)
+  # -->
+  # Safely loads the document contained in `filename`.  Returns the yaml contained
+  # in `filename` as a Ruby object, or if the file is empty, it returns the
+  # specified `fallback` return value, which defaults to `nil`. See safe_load for
+  # options.
+  #
+  %a{annotate:rdoc:copy:Psych.safe_load_file}
+  def self.safe_load_file: (path, ?permitted_classes: Array[Class], ?permitted_symbols: Array[Symbol], ?aliases: bool, ?fallback: untyped, ?symbolize_names: bool, ?freeze: bool) -> untyped
+
+  # <!--
+  #   rdoc-file=ext/psych/lib/psych.rb
+  #   - unsafe_load_file(filename, **kwargs)
+  # -->
+  # Load the document contained in `filename`.  Returns the yaml contained in
+  # `filename` as a Ruby object, or if the file is empty, it returns the specified
+  # `fallback` return value, which defaults to `false`.
+  #
+  # NOTE: This method *should not* be used to parse untrusted documents, such as
+  # YAML documents that are supplied via user input.  Instead, please use the
+  # safe_load_file method.
+  #
+  %a{annotate:rdoc:copy:Psych.unsafe_load_file}
+  def self.unsafe_load_file: (path, ?fallback: untyped, ?symbolize_names: bool, ?freeze: bool) -> untyped
+
+  class Exception < ::RuntimeError
+  end
+
+  class SyntaxError < ::Psych::Exception
+    attr_reader file: String?
+    attr_reader line: Integer?
+    attr_reader column: Integer?
+    attr_reader offset: Integer?
+    attr_reader problem: String?
+    attr_reader context: String?
+
+    # <!--
+    #   rdoc-file=ext/psych/lib/psych/syntax_error.rb
+    #   - new(file, line, col, offset, problem, context)
+    # -->
+    #
+    def initialize: (?String? file, ?Integer? line, ?Integer? column, ?Integer? offset, ?String? problem, ?String? context) -> void
+  end
+
+  class BadAlias < ::Psych::Exception
+  end
+
+  class DisallowedClass < ::Psych::Exception
+  end
 end

data/stdlib/psych/0/store.rbs

@@ -30,7 +30,7 @@
 #     greeting:
 #       hello: world
 #
-class Psych::Store < ::PStore
+class Psych::Store < ::PStore[string, untyped]
   # <!--
   #   rdoc-file=lib/yaml/store.rb
   #   - initialize( file_name, yaml_opts = {} )
@@ -45,8 +45,6 @@ class Psych::Store < ::PStore
   # Options passed in through `yaml_opts` will be used when converting the store
   # to YAML via Hash#to_yaml().
   #
-  def initialize: (*untyped o) -> void
-
   def dump: (untyped table) -> String
 
   def empty_marshal_checksum: () -> String
@@ -55,5 +53,5 @@ class Psych::Store < ::PStore
 
   def load: (String) -> untyped
 
-  def marshal_dump_supports_canonical_option?: () -> ::FalseClass
+  def marshal_dump_supports_canonical_option?: () -> bool
 end

data/stdlib/pty/0/pty.rbs

@@ -103,7 +103,8 @@ module PTY
   #
   # ### Return values
   #
-  # In the non-block form this returns an array of size three, `[r, w, pid]`.
+  # In the non-block form this returns an array of size three, <code>[r, w,
+  # pid]</code>.
   #
   # In the block form these same values will be yielded to the block:
   #
@@ -136,8 +137,8 @@ module PTY
   # -->
   # Allocates a pty (pseudo-terminal).
   #
-  # In the block form, yields an array of two elements (`master_io, slave_file`)
-  # and the value of the block is returned from `open`.
+  # In the block form, yields an array of two elements (<code>master_io,
+  # slave_file</code>) and the value of the block is returned from `open`.
   #
   # The IO and File are both closed after the block completes if they haven't been
   # already closed.
@@ -148,7 +149,8 @@ module PTY
   #       p slave.path #=> "/dev/pts/1"
   #     }
   #
-  # In the non-block form, returns a two element array, `[master_io, slave_file]`.
+  # In the non-block form, returns a two element array, <code>[master_io,
+  # slave_file]</code>.
   #
   #     master, slave = PTY.open
   #     # do something with master for IO, or the slave file
@@ -160,7 +162,7 @@ module PTY
   #
   # `slave_file`
   # :   the slave of the pty, as a File.  The path to the terminal device is
-  #     available via `slave_file.path`
+  #     available via <code>slave_file.path</code>
   #
   #
   # IO#raw! is usable to disable newline conversions:
@@ -208,7 +210,8 @@ module PTY
   #
   # ### Return values
   #
-  # In the non-block form this returns an array of size three, `[r, w, pid]`.
+  # In the non-block form this returns an array of size three, <code>[r, w,
+  # pid]</code>.
   #
   # In the block form these same values will be yielded to the block:
   #

data/stdlib/random-formatter/0/random-formatter.rbs

@@ -180,8 +180,8 @@ module RBS
       # create UUIDs that are time-ordered with sub-millisecond precision, up to 12
       # bits of additional timestamp may added with `extra_timestamp_bits`.  The extra
       # timestamp precision comes at the expense of random bits.  Setting
-      # `extra_timestamp_bits: 12` provides ~244ns of precision, but only 62 random
-      # bits (7.75 random bytes).
+      # <code>extra_timestamp_bits: 12</code> provides ~244ns of precision, but only
+      # 62 random bits (7.75 random bytes).
       #
       #     prng = Random.new
       #     Array.new(4) { prng.uuid_v7(extra_timestamp_bits: 12) }

data/stdlib/ripper/0/ripper.rbs

@@ -31,23 +31,26 @@
 #               nil,
 #               nil]]]]
 #
-# You can see in the example above, the expression starts with `:program`.
+# You can see in the example above, the expression starts with
+# <code>:program</code>.
 #
-# From here, a method definition at `:def`, followed by the method's identifier
-# `:@ident`. After the method's identifier comes the parentheses `:paren` and
-# the method parameters under `:params`.
+# From here, a method definition at <code>:def</code>, followed by the method's
+# identifier <code>:@ident</code>. After the method's identifier comes the
+# parentheses <code>:paren</code> and the method parameters under
+# <code>:params</code>.
 #
-# Next is the method body, starting at `:bodystmt` (`stmt` meaning statement),
-# which contains the full definition of the method.
+# Next is the method body, starting at <code>:bodystmt</code> (`stmt` meaning
+# statement), which contains the full definition of the method.
 #
 # In our case, we're simply returning a String, so next we have the
-# `:string_literal` expression.
+# <code>:string_literal</code> expression.
 #
-# Within our `:string_literal` you'll notice two `@tstring_content`, this is the
-# literal part for `Hello, ` and `!`. Between the two `@tstring_content`
-# statements is a `:string_embexpr`, where *embexpr* is an embedded expression.
-# Our expression consists of a local variable, or `var_ref`, with the identifier
-# (`@ident`) of `world`.
+# Within our <code>:string_literal</code> you'll notice two
+# <code>@tstring_content</code>, this is the literal part for <code>Hello,
+# </code> and <code>!</code>. Between the two <code>@tstring_content</code>
+# statements is a <code>:string_embexpr</code>, where *embexpr* is an embedded
+# expression. Our expression consists of a local variable, or `var_ref`, with
+# the identifier (<code>@ident</code>) of `world`.
 #
 # ## Resources
 #
@@ -189,7 +192,7 @@ class Ripper
     #   - state()
     # -->
     # The scanner's state of the current token. This value is the bitwise OR of zero
-    # or more of the `Ripper::EXPR_*` constants.
+    # or more of the <code>Ripper::EXPR_*</code> constants.
     #
     def state: () -> Ripper::Lexer::State
 
@@ -972,10 +975,10 @@ class Ripper
   #   - lex(src, filename = '-', lineno = 1, **kw)
   # -->
   # Tokenizes the Ruby program and returns an array of an array, which is
-  # formatted like `[[lineno, column], type, token, state]`. The `filename`
-  # argument is mostly ignored. By default, this method does not handle syntax
-  # errors in `src`, use the `raise_errors` keyword to raise a SyntaxError for an
-  # error in `src`.
+  # formatted like <code>[[lineno, column], type, token, state]</code>. The
+  # `filename` argument is mostly ignored. By default, this method does not handle
+  # syntax errors in `src`, use the `raise_errors` keyword to raise a SyntaxError
+  # for an error in `src`.
   #
   #     require 'ripper'
   #     require 'pp'

data/stdlib/securerandom/0/securerandom.rbs

@@ -29,7 +29,7 @@
 # *   uuid
 #
 # These methods are usable as class methods of SecureRandom such as
-# `SecureRandom.hex`.
+# <code>SecureRandom.hex</code>.
 #
 # If a secure random number generator is not available, `NotImplementedError` is
 # raised.

data/stdlib/shellwords/0/shellwords.rbs

@@ -4,8 +4,8 @@
 # This module manipulates strings according to the word parsing rules of the
 # UNIX Bourne shell.
 #
-# The `shellwords()` function was originally a port of shellwords.pl, but
-# modified to conform to [the Shell & Utilities volume of the IEEE Std
+# The <code>shellwords()</code> function was originally a port of shellwords.pl,
+# but modified to conform to [the Shell & Utilities volume of the IEEE Std
 # 1003.1-2008, 2016
 # Edition](http://pubs.opengroup.org/onlinepubs/9699919799/utilities/contents.ht
 # ml)

data/stdlib/socket/0/addrinfo.rbs

@@ -634,13 +634,13 @@ class Addrinfo
   # sockaddr as generated by Socket.sockaddr_in or Socket.unpack_sockaddr_un.
   #
   # sockaddr examples:
-  # *   `["AF_INET", 46102, "localhost.localdomain", "127.0.0.1"]`
-  # *   `["AF_INET6", 42304, "ip6-localhost", "::1"]`
-  # *   `["AF_UNIX", "/tmp/sock"]`
-  # *   `Socket.sockaddr_in("smtp", "2001:DB8::1")`
-  # *   `Socket.sockaddr_in(80, "172.18.22.42")`
-  # *   `Socket.sockaddr_in(80, "www.ruby-lang.org")`
-  # *   `Socket.sockaddr_un("/tmp/sock")`
+  # *   <code>["AF_INET", 46102, "localhost.localdomain", "127.0.0.1"]</code>
+  # *   <code>["AF_INET6", 42304, "ip6-localhost", "::1"]</code>
+  # *   <code>["AF_UNIX", "/tmp/sock"]</code>
+  # *   <code>Socket.sockaddr_in("smtp", "2001:DB8::1")</code>
+  # *   <code>Socket.sockaddr_in(80, "172.18.22.42")</code>
+  # *   <code>Socket.sockaddr_in(80, "www.ruby-lang.org")</code>
+  # *   <code>Socket.sockaddr_un("/tmp/sock")</code>
   #
   # In an AF_INET/AF_INET6 sockaddr array, the 4th element, numeric IP address, is
   # used to construct socket address in the Addrinfo instance. If the 3rd element,