RubyGems - rbs - Versions diffs - 3.2.2 → 3.3.0.pre.1 - Mend

rbs 3.2.2 → 3.3.0.pre.1

Files changed (125) hide show

checksums.yaml +4 -4
data/.github/workflows/comments.yml +1 -1
data/.github/workflows/ruby.yml +7 -2
data/CHANGELOG.md +85 -0
data/Gemfile.lock +14 -14
data/README.md +11 -2
data/Rakefile +10 -7
data/Steepfile +7 -7
data/core/basic_object.rbs +7 -7
data/core/binding.rbs +3 -3
data/core/builtin.rbs +171 -5
data/core/constants.rbs +17 -17
data/core/dir.rbs +3 -3
data/core/encoding.rbs +434 -628
data/core/enumerator.rbs +37 -0
data/core/exception.rbs +11 -11
data/core/false_class.rbs +5 -11
data/core/fiber.rbs +3 -3
data/core/file_test.rbs +28 -26
data/core/kernel.rbs +900 -21
data/core/marshal.rbs +24 -14
data/core/match_data.rbs +8 -8
data/core/math.rbs +57 -53
data/core/method.rbs +3 -1
data/core/module.rbs +38 -36
data/core/nil_class.rbs +7 -13
data/core/object.rbs +3 -966
data/core/process.rbs +3 -3
data/core/ractor.rbs +2 -2
data/core/rb_config.rbs +64 -43
data/core/regexp.rbs +3 -3
data/core/signal.rbs +10 -4
data/core/struct.rbs +1 -1
data/core/thread.rbs +7 -7
data/core/thread_group.rbs +9 -9
data/core/true_class.rbs +5 -11
data/core/unbound_method.rbs +56 -7
data/core/warning.rbs +33 -0
data/docs/collection.md +56 -6
data/docs/data_and_struct.md +57 -0
data/docs/stdlib.md +61 -2
data/docs/syntax.md +123 -2
data/ext/rbs_extension/lexer.c +624 -569
data/ext/rbs_extension/lexer.h +1 -0
data/ext/rbs_extension/lexer.re +1 -0
data/ext/rbs_extension/lexstate.c +1 -0
data/ext/rbs_extension/parser.c +6 -0
data/goodcheck.yml +2 -2
data/lib/rbs/annotate/formatter.rb +13 -3
data/lib/rbs/annotate/rdoc_source.rb +10 -1
data/lib/rbs/cli/colored_io.rb +48 -0
data/lib/rbs/cli/diff.rb +80 -0
data/lib/rbs/cli.rb +151 -16
data/lib/rbs/collection/config/lockfile.rb +0 -25
data/lib/rbs/collection/config/lockfile_generator.rb +0 -6
data/lib/rbs/collection/installer.rb +1 -1
data/lib/rbs/collection/sources/git.rb +6 -4
data/lib/rbs/collection/sources/local.rb +7 -5
data/lib/rbs/diff.rb +104 -0
data/lib/rbs/environment.rb +1 -1
data/lib/rbs/method_type.rb +23 -0
data/lib/rbs/prototype/rb.rb +2 -9
data/lib/rbs/prototype/runtime/helpers.rb +59 -0
data/lib/rbs/prototype/runtime/value_object_generator.rb +236 -0
data/lib/rbs/prototype/runtime.rb +234 -150
data/lib/rbs/sorter.rb +144 -117
data/lib/rbs/test/guaranteed.rb +31 -0
data/lib/rbs/test/type_check.rb +4 -4
data/lib/rbs/test.rb +3 -0
data/lib/rbs/types.rb +184 -3
data/lib/rbs/version.rb +1 -1
data/lib/rbs/writer.rb +4 -4
data/lib/rbs.rb +1 -0
data/rbs.gemspec +1 -0
data/sig/annotate/formatter.rbs +2 -2
data/sig/annotate/rdoc_annotater.rbs +1 -1
data/sig/cli/colored_io.rbs +15 -0
data/sig/cli/diff.rbs +21 -0
data/sig/cli.rbs +2 -0
data/sig/collection/config/lockfile.rbs +0 -6
data/sig/diff.rbs +23 -0
data/sig/errors.rbs +1 -5
data/sig/method_types.rbs +6 -0
data/sig/prototype/runtime.rbs +108 -0
data/sig/rdoc/rbs.rbs +4 -0
data/sig/shims/bundler.rbs +5 -0
data/sig/sorter.rbs +23 -5
data/sig/types.rbs +29 -0
data/stdlib/benchmark/0/benchmark.rbs +1 -1
data/stdlib/cgi/0/core.rbs +2 -2
data/stdlib/did_you_mean/0/did_you_mean.rbs +2 -2
data/stdlib/digest/0/digest.rbs +1 -1
data/stdlib/fileutils/0/fileutils.rbs +1 -1
data/stdlib/forwardable/0/forwardable.rbs +4 -4
data/stdlib/io-console/0/io-console.rbs +1 -1
data/stdlib/json/0/json.rbs +37 -0
data/stdlib/logger/0/logger.rbs +2 -2
data/stdlib/net-http/0/manifest.yaml +1 -1
data/stdlib/net-http/0/net-http.rbs +16 -63
data/stdlib/net-protocol/0/manifest.yaml +2 -0
data/stdlib/net-protocol/0/net-protocol.rbs +56 -0
data/stdlib/openssl/0/openssl.rbs +1 -1
data/stdlib/pp/0/manifest.yaml +2 -0
data/stdlib/pp/0/pp.rbs +301 -0
data/stdlib/{yaml → psych}/0/dbm.rbs +3 -3
data/stdlib/psych/0/manifest.yaml +3 -0
data/stdlib/psych/0/psych.rbs +391 -0
data/stdlib/{yaml → psych}/0/store.rbs +2 -2
data/stdlib/rdoc/0/code_object.rbs +55 -0
data/stdlib/rdoc/0/comment.rbs +60 -0
data/stdlib/rdoc/0/context.rbs +153 -0
data/stdlib/rdoc/0/markup.rbs +119 -0
data/stdlib/rdoc/0/parser.rbs +56 -0
data/stdlib/rdoc/0/rdoc.rbs +0 -372
data/stdlib/rdoc/0/ri.rbs +17 -0
data/stdlib/rdoc/0/store.rbs +48 -0
data/stdlib/rdoc/0/top_level.rbs +97 -0
data/stdlib/socket/0/basic_socket.rbs +1 -1
data/stdlib/socket/0/socket.rbs +1 -1
data/stdlib/uri/0/common.rbs +1 -1
data/stdlib/yaml/0/manifest.yaml +1 -2
data/stdlib/yaml/0/yaml.rbs +1 -199
metadata +46 -9
data/sig/shims/pp.rbs +0 -3
data/sig/shims.rbs +0 -47

data/stdlib/rdoc/0/markup.rbs ADDED Viewed

@@ -0,0 +1,119 @@
+%a{annotate:rdoc:skip}
+module RDoc
+  # <!-- rdoc-file=lib/rdoc/markup.rb -->
+  # RDoc::Markup parses plain text documents and attempts to decompose them into
+  # their constituent parts.  Some of these parts are high-level: paragraphs,
+  # chunks of verbatim text, list entries and the like.  Other parts happen at the
+  # character level: a piece of bold text, a word in code font.  This markup is
+  # similar in spirit to that used on WikiWiki webs, where folks create web pages
+  # using a simple set of formatting rules.
+  #
+  # RDoc::Markup and other markup formats do no output formatting, this is handled
+  # by the RDoc::Markup::Formatter subclasses.
+  #
+  # # Supported Formats
+  #
+  # Besides the RDoc::Markup format, the following formats are built in to RDoc:
+  #
+  # markdown
+  # :   The markdown format as described by
+  #     http://daringfireball.net/projects/markdown/.  See RDoc::Markdown for
+  #     details on the parser and supported extensions.
+  # rd
+  # :   The rdtool format.  See RDoc::RD for details on the parser and format.
+  # tomdoc
+  # :   The TomDoc format as described by http://tomdoc.org/.  See RDoc::TomDoc
+  #     for details on the parser and supported extensions.
+  #
+  #
+  # You can choose a markup format using the following methods:
+  #
+  # per project
+  # :   If you build your documentation with rake use RDoc::Task#markup.
+  #
+  #     If you build your documentation by hand run:
+  #
+  #         rdoc --markup your_favorite_format --write-options
+  #
+  #     and commit `.rdoc_options` and ship it with your packaged gem.
+  # per file
+  # :   At the top of the file use the `:markup:` directive to set the default
+  #     format for the rest of the file.
+  # per comment
+  # :   Use the `:markup:` directive at the top of a comment you want to write in
+  #     a different format.
+  #
+  #
+  # # RDoc::Markup
+  #
+  # RDoc::Markup is extensible at runtime: you can add new markup elements to be
+  # recognized in the documents that RDoc::Markup parses.
+  #
+  # RDoc::Markup is intended to be the basis for a family of tools which share the
+  # common requirement that simple, plain-text should be rendered in a variety of
+  # different output formats and media.  It is envisaged that RDoc::Markup could
+  # be the basis for formatting RDoc style comment blocks, Wiki entries, and
+  # online FAQs.
+  #
+  # ## Synopsis
+  #
+  # This code converts `input_string` to HTML.  The conversion takes place in the
+  # `convert` method, so you can use the same RDoc::Markup converter to convert
+  # multiple input strings.
+  #
+  #     require 'rdoc'
+  #
+  #     h = RDoc::Markup::ToHtml.new(RDoc::Options.new)
+  #
+  #     puts h.convert(input_string)
+  #
+  # You can extend the RDoc::Markup parser to recognize new markup sequences, and
+  # to add regexp handling. Here we make WikiWords significant to the parser, and
+  # also make the sequences {word} and <no>text...</no> signify strike-through
+  # text.  We then subclass the HTML output class to deal with these:
+  #
+  #     require 'rdoc'
+  #
+  #     class WikiHtml < RDoc::Markup::ToHtml
+  #       def handle_regexp_WIKIWORD(target)
+  #         "<font color=red>" + target.text + "</font>"
+  #       end
+  #     end
+  #
+  #     markup = RDoc::Markup.new
+  #     markup.add_word_pair("{", "}", :STRIKE)
+  #     markup.add_html("no", :STRIKE)
+  #
+  #     markup.add_regexp_handling(/\b([A-Z][a-z]+[A-Z]\w+)/, :WIKIWORD)
+  #
+  #     wh = WikiHtml.new RDoc::Options.new, markup
+  #     wh.add_tag(:STRIKE, "<strike>", "</strike>")
+  #
+  #     puts "<body>#{wh.convert ARGF.read}</body>"
+  #
+  # ## Encoding
+  #
+  # Where Encoding support is available, RDoc will automatically convert all
+  # documents to the same output encoding.  The output encoding can be set via
+  # RDoc::Options#encoding and defaults to Encoding.default_external.
+  #
+  # # RDoc Markup Reference
+  #
+  # See RDoc::MarkupReference.
+  #
+  class Markup
+    class Document
+      include Enumerable[Document]
+      def each: () { (Document) -> void } -> void
+              | () -> Enumerator[Document, void]
+      def file: () -> String?
+      def accept: (untyped) -> String
+    end
+    class ToMarkdown
+    end
+  end
+end

data/stdlib/rdoc/0/parser.rbs ADDED Viewed

@@ -0,0 +1,56 @@
+%a{annotate:rdoc:skip}
+module RDoc
+  # <!-- rdoc-file=lib/rdoc/parser.rb -->
+  # A parser is simple a class that subclasses RDoc::Parser and implements #scan
+  # to fill in an RDoc::TopLevel with parsed data.
+  #
+  # The initialize method takes an RDoc::TopLevel to fill with parsed content, the
+  # name of the file to be parsed, the content of the file, an RDoc::Options
+  # object and an RDoc::Stats object to inform the user of parsed items.  The scan
+  # method is then called to parse the file and must return the RDoc::TopLevel
+  # object.  By calling super these items will be set for you.
+  #
+  # In order to be used by RDoc the parser needs to register the file extensions
+  # it can parse.  Use ::parse_files_matching to register extensions.
+  #
+  #     require 'rdoc'
+  #
+  #     class RDoc::Parser::Xyz < RDoc::Parser
+  #       parse_files_matching /\.xyz$/
+  #
+  #       def initialize top_level, file_name, content, options, stats
+  #         super
+  #
+  #         # extra initialization if needed
+  #       end
+  #
+  #       def scan
+  #         # parse file and fill in @top_level
+  #       end
+  #     end
+  #
+  class Parser
+    # <!--
+    #   rdoc-file=lib/rdoc/parser.rb
+    #   - parse_files_matching(regexp)
+    # -->
+    # Record which file types this parser can understand.
+    #
+    # It is ok to call this multiple times.
+    #
+    def self?.parse_files_matching: (Regexp path) -> void
+    # <!--
+    #   rdoc-file=lib/rdoc/parser.rb
+    #   - new(top_level, file_name, content, options, stats)
+    # -->
+    # Creates a new Parser storing `top_level`, `file_name`, `content`, `options`
+    # and `stats` in instance variables.  In +@preprocess+ an
+    # RDoc::Markup::PreProcess object is created which allows processing of
+    # directives.
+    #
+    def initialize: (RDoc::TopLevel top_level, String filename, String content, Hash[untyped, untyped] options, RDoc::Stats stats) -> void
+    def scan: () -> RDoc::TopLevel
+  end
+end

data/stdlib/rdoc/0/rdoc.rbs CHANGED Viewed

@@ -57,339 +57,6 @@
 #     for irb and the rtags package.
 #
 module RDoc
-  # <!-- rdoc-file=lib/rdoc/parser.rb -->
-  # A parser is simple a class that subclasses RDoc::Parser and implements #scan
-  # to fill in an RDoc::TopLevel with parsed data.
-  #
-  # The initialize method takes an RDoc::TopLevel to fill with parsed content, the
-  # name of the file to be parsed, the content of the file, an RDoc::Options
-  # object and an RDoc::Stats object to inform the user of parsed items.  The scan
-  # method is then called to parse the file and must return the RDoc::TopLevel
-  # object.  By calling super these items will be set for you.
-  #
-  # In order to be used by RDoc the parser needs to register the file extensions
-  # it can parse.  Use ::parse_files_matching to register extensions.
-  #
-  #     require 'rdoc'
-  #
-  #     class RDoc::Parser::Xyz < RDoc::Parser
-  #       parse_files_matching /\.xyz$/
-  #
-  #       def initialize top_level, file_name, content, options, stats
-  #         super
-  #
-  #         # extra initialization if needed
-  #       end
-  #
-  #       def scan
-  #         # parse file and fill in @top_level
-  #       end
-  #     end
-  #
-  class Parser
-    # <!--
-    #   rdoc-file=lib/rdoc/parser.rb
-    #   - parse_files_matching(regexp)
-    # -->
-    # Record which file types this parser can understand.
-    #
-    # It is ok to call this multiple times.
-    #
-    def self?.parse_files_matching: (Regexp path) -> void
-    # <!--
-    #   rdoc-file=lib/rdoc/parser.rb
-    #   - new(top_level, file_name, content, options, stats)
-    # -->
-    # Creates a new Parser storing `top_level`, `file_name`, `content`, `options`
-    # and `stats` in instance variables.  In +@preprocess+ an
-    # RDoc::Markup::PreProcess object is created which allows processing of
-    # directives.
-    #
-    def initialize: (RDoc::TopLevel top_level, String filename, String content, Hash[untyped, untyped] options, RDoc::Stats stats) -> void
-    def scan: () -> RDoc::TopLevel
-  end
-  # <!-- rdoc-file=lib/rdoc/code_object.rb -->
-  # Base class for the RDoc code tree.
-  #
-  # We contain the common stuff for contexts (which are containers) and other
-  # elements (methods, attributes and so on)
-  #
-  # Here's the tree of the CodeObject subclasses:
-  #
-  # *   RDoc::Context
-  #     *   RDoc::TopLevel
-  #     *   RDoc::ClassModule
-  #         *   RDoc::AnonClass (never used so far)
-  #         *   RDoc::NormalClass
-  #         *   RDoc::NormalModule
-  #         *   RDoc::SingleClass
-  #
-  #
-  # *   RDoc::MethodAttr
-  #     *   RDoc::Attr
-  #     *   RDoc::AnyMethod
-  #         *   RDoc::GhostMethod
-  #         *   RDoc::MetaMethod
-  #
-  #
-  # *   RDoc::Alias
-  # *   RDoc::Constant
-  # *   RDoc::Mixin
-  #     *   RDoc::Require
-  #     *   RDoc::Include
-  #
-  class CodeObject
-    # <!-- rdoc-file=lib/rdoc/code_object.rb -->
-    # Our comment
-    #
-    attr_reader comment: RDoc::Comment
-    # <!--
-    #   rdoc-file=lib/rdoc/code_object.rb
-    #   - new()
-    # -->
-    # Creates a new CodeObject that will document itself and its children
-    #
-    def initialize: () -> void
-    # <!--
-    #   rdoc-file=lib/rdoc/code_object.rb
-    #   - comment=(comment)
-    # -->
-    # Replaces our comment with `comment`, unless it is empty.
-    #
-    def comment=: (RDoc::Comment | String) -> RDoc::Comment
-  end
-  # <!-- rdoc-file=lib/rdoc/context.rb -->
-  # A Context is something that can hold modules, classes, methods, attributes,
-  # aliases, requires, and includes. Classes, modules, and files are all Contexts.
-  #
-  class Context < CodeObject
-    include Comparable
-    # <!-- rdoc-file=lib/rdoc/context.rb -->
-    # Types of methods
-    #
-    TYPES: ::Array["class" | "instance"]
-    TOMDOC_TITLES: ::Array[nil | "Public" | "Internal" | "Deprecated"]
-    type class_types = singleton(RDoc::NormalClass) | singleton(RDoc::SingleClass)
-    # <!--
-    #   rdoc-file=lib/rdoc/context.rb
-    #   - new()
-    # -->
-    # Creates an unnamed empty context with public current visibility
-    #
-    def initialize: () -> void
-    # <!--
-    #   rdoc-file=lib/rdoc/context.rb
-    #   - add_alias(an_alias)
-    # -->
-    # Adds `an_alias` that is automatically resolved
-    #
-    def add_alias: (RDoc::Alias an_alias) -> RDoc::Alias
-    # <!--
-    #   rdoc-file=lib/rdoc/context.rb
-    #   - add_attribute(attribute)
-    # -->
-    # Adds `attribute` if not already there. If it is (as method(s) or attribute),
-    # updates the comment if it was empty.
-    #
-    # The attribute is registered only if it defines a new method. For instance,
-    # `attr_reader :foo` will not be registered if method `foo` exists, but
-    # `attr_accessor :foo` will be registered if method `foo` exists, but `foo=`
-    # does not.
-    #
-    def add_attribute: (RDoc::Attr attribute) -> RDoc::Attr
-    # <!--
-    #   rdoc-file=lib/rdoc/context.rb
-    #   - add_class(class_type, given_name, superclass = '::Object')
-    # -->
-    # Adds a class named `given_name` with `superclass`.
-    #
-    # Both `given_name` and `superclass` may contain '::', and are interpreted
-    # relative to the `self` context. This allows handling correctly examples like
-    # these:
-    #     class RDoc::Gauntlet < Gauntlet
-    #     module Mod
-    #       class Object   # implies < ::Object
-    #       class SubObject < Object  # this is _not_ ::Object
-    #
-    # Given `class Container::Item` RDoc assumes `Container` is a module unless it
-    # later sees `class Container`.  `add_class` automatically upgrades `given_name`
-    # to a class in this case.
-    #
-    def add_class: (class_types class_type, ::String given_name, ?::String superclass) -> (RDoc::NormalClass | RDoc::SingleClass)
-    # <!--
-    #   rdoc-file=lib/rdoc/context.rb
-    #   - add_constant(constant)
-    # -->
-    # Adds `constant` if not already there. If it is, updates the comment, value
-    # and/or is_alias_for of the known constant if they were empty/nil.
-    #
-    def add_constant: (RDoc::Constant constant) -> RDoc::Constant
-    # <!--
-    #   rdoc-file=lib/rdoc/context.rb
-    #   - add_include(include)
-    # -->
-    # Adds included module `include` which should be an RDoc::Include
-    #
-    def add_include: (RDoc::Include `include`) -> RDoc::Include
-    # <!--
-    #   rdoc-file=lib/rdoc/context.rb
-    #   - add_extend(ext)
-    # -->
-    # Adds extension module `ext` which should be an RDoc::Extend
-    #
-    def add_extend: (RDoc::Extend ext) -> RDoc::Extend
-    # <!--
-    #   rdoc-file=lib/rdoc/context.rb
-    #   - add_method(method)
-    # -->
-    # Adds `method` if not already there. If it is (as method or attribute), updates
-    # the comment if it was empty.
-    #
-    def add_method: (RDoc::AnyMethod method) -> RDoc::AnyMethod
-    # <!--
-    #   rdoc-file=lib/rdoc/context.rb
-    #   - add_module(class_type, name)
-    # -->
-    # Adds a module named `name`.  If RDoc already knows `name` is a class then that
-    # class is returned instead.  See also #add_class.
-    #
-    def add_module: (singleton(RDoc::NormalModule) class_type, String name) -> RDoc::NormalModule
-    # <!--
-    #   rdoc-file=lib/rdoc/context.rb
-    #   - find_module_named(name)
-    # -->
-    # Find a module with `name` using ruby's scoping rules
-    #
-    def find_module_named: (untyped name) -> (untyped | self)
-    # <!--
-    #   rdoc-file=lib/rdoc/context.rb
-    #   - full_name()
-    # -->
-    # The full name for this context.  This method is overridden by subclasses.
-    #
-    def full_name: () -> "(unknown)"
-    def to_s: () -> ::String
-    # <!--
-    #   rdoc-file=lib/rdoc/context.rb
-    #   - top_level()
-    # -->
-    # Return the TopLevel that owns us
-    #
-    def top_level: () -> RDoc::TopLevel
-  end
-  # <!-- rdoc-file=lib/rdoc/top_level.rb -->
-  # A TopLevel context is a representation of the contents of a single file
-  #
-  class TopLevel < Context
-    MARSHAL_VERSION: 0
-    # <!--
-    #   rdoc-file=lib/rdoc/top_level.rb
-    #   - new(absolute_name, relative_name = absolute_name)
-    # -->
-    # Creates a new TopLevel for the file at `absolute_name`.  If documentation is
-    # being generated outside the source dir `relative_name` is relative to the
-    # source directory.
-    #
-    def initialize: (String absolute_name, ?String relative_name) -> void
-    # <!--
-    #   rdoc-file=lib/rdoc/top_level.rb
-    #   - ==(other)
-    # -->
-    # An RDoc::TopLevel is equal to another with the same relative_name
-    #
-    def ==: (untyped other) -> bool
-    # <!--
-    #   rdoc-file=lib/rdoc/top_level.rb
-    #   - eql?(other)
-    # -->
-    #
-    alias eql? ==
-    # <!--
-    #   rdoc-file=lib/rdoc/top_level.rb
-    #   - add_alias(an_alias)
-    # -->
-    # Adds `an_alias` to `Object` instead of `self`.
-    #
-    def add_alias: (RDoc::Alias an_alias) -> RDoc::Alias
-    # <!--
-    #   rdoc-file=lib/rdoc/top_level.rb
-    #   - add_constant(constant)
-    # -->
-    # Adds `constant` to `Object` instead of `self`.
-    #
-    def add_constant: (RDoc::Constant constant) -> RDoc::Constant
-    # <!--
-    #   rdoc-file=lib/rdoc/top_level.rb
-    #   - add_include(include)
-    # -->
-    # Adds `include` to `Object` instead of `self`.
-    #
-    def add_include: (RDoc::Include `include`) -> RDoc::Include
-    # <!--
-    #   rdoc-file=lib/rdoc/top_level.rb
-    #   - add_method(method)
-    # -->
-    # Adds `method` to `Object` instead of `self`.
-    #
-    def add_method: (RDoc::AnyMethod method) -> RDoc::AnyMethod
-    # <!--
-    #   rdoc-file=lib/rdoc/top_level.rb
-    #   - find_class_or_module(name)
-    # -->
-    # See RDoc::TopLevel::find_class_or_module
-    #
-    def find_class_or_module: (::String name) -> RDoc::Context
-    # <!--
-    #   rdoc-file=lib/rdoc/top_level.rb
-    #   - find_module_named(name)
-    # -->
-    # Finds a module or class with `name`
-    #
-    def find_module_named: (String name) -> RDoc::Context
-    # <!--
-    #   rdoc-file=lib/rdoc/top_level.rb
-    #   - full_name()
-    # -->
-    # Returns the relative name of this file
-    #
-    def full_name: () -> String
-    def to_s: () -> ::String
-  end
   # <!-- rdoc-file=lib/rdoc/token_stream.rb -->
   # A TokenStream is a list of tokens, gathered during the parse of some entity
   # (say a method). Entities populate these streams by being registered with the
@@ -422,45 +89,6 @@ module RDoc
     alias start_collecting_tokens collect_tokens
   end
-  # <!-- rdoc-file=lib/rdoc/comment.rb -->
-  # A comment holds the text comment for a RDoc::CodeObject and provides a unified
-  # way of cleaning it up and parsing it into an RDoc::Markup::Document.
-  #
-  # Each comment may have a different markup format set by #format=.  By default
-  # 'rdoc' is used.  The :markup: directive tells RDoc which format to use.
-  #
-  # See RDoc::Markup@Other+directives for instructions on adding an alternate
-  # format.
-  #
-  class Comment
-    # <!-- rdoc-file=lib/rdoc/comment.rb -->
-    # The format of this comment.  Defaults to RDoc::Markup
-    #
-    attr_reader format: String
-    # <!-- rdoc-file=lib/rdoc/comment.rb -->
-    # The RDoc::TopLevel this comment was found in
-    #
-    attr_accessor location: String
-    # <!--
-    #   rdoc-file=lib/rdoc/comment.rb
-    #   - new(text = nil, location = nil, language = nil)
-    # -->
-    # Creates a new comment with `text` that is found in the RDoc::TopLevel
-    # `location`.
-    #
-    def initialize: (?String? text, ?RDoc::Context? location, ?String? language) -> void
-    # <!--
-    #   rdoc-file=lib/rdoc/comment.rb
-    #   - format=(format)
-    # -->
-    # Sets the format of this comment and resets any parsed document
-    #
-    def format=: (String format) -> void
-  end
   # <!-- rdoc-file=lib/rdoc/class_module.rb -->
   # ClassModule is the base class for objects representing either a class or a
   # module.

data/stdlib/rdoc/0/ri.rbs ADDED Viewed

@@ -0,0 +1,17 @@
+%a{annotate:rdoc:skip}
+module RDoc
+  # <!-- rdoc-file=lib/rdoc/ri.rb -->
+  # Namespace for the ri command line tool's implementation.
+  #
+  # See `ri --help` for details.
+  #
+  module RI
+    module Paths
+      type path_type = :system | :site | :home | :gem | :extra
+      type gem_filter = :latest | :all
+      def self.each: (?bool system, ?bool site, ?bool home, ?gem_filter | false gems, *String extra_dirs) { (String, path_type) -> void } -> void
+    end
+  end
+end

data/stdlib/rdoc/0/store.rbs ADDED Viewed

@@ -0,0 +1,48 @@
+%a{annotate:rdoc:skip}
+module RDoc
+  # <!-- rdoc-file=lib/rdoc/store.rb -->
+  # A set of rdoc data for a single project (gem, path, etc.).
+  #
+  # The store manages reading and writing ri data for a project and maintains a
+  # cache of methods, classes and ancestors in the store.
+  #
+  # The store maintains a #cache of its contents for faster lookup.  After adding
+  # items to the store it must be flushed using #save_cache.  The cache contains
+  # the following structures:
+  #
+  #     @cache = {
+  #       :ancestors        => {}, # class name => ancestor names
+  #       :attributes       => {}, # class name => attributes
+  #       :class_methods    => {}, # class name => class methods
+  #       :instance_methods => {}, # class name => instance methods
+  #       :modules          => [], # classes and modules in this store
+  #       :pages            => [], # page names
+  #     }
+  #
+  class Store
+    # <!--
+    #   rdoc-file=lib/rdoc/store.rb
+    #   - new(path = nil, type = nil)
+    # -->
+    # Creates a new Store of `type` that will load or save to `path`
+    #
+    def initialize: (?String? path, ?Symbol? type) -> void
+    # <!--
+    #   rdoc-file=lib/rdoc/store.rb
+    #   - find_class_or_module(name)
+    # -->
+    # Finds the class or module with `name`
+    #
+    def find_class_or_module: (String) -> ClassModule?
+    # <!--
+    #   rdoc-file=lib/rdoc/store.rb
+    #   - load_all()
+    # -->
+    # Loads all items from this store into memory.  This recreates a documentation
+    # tree for use by a generator
+    #
+    def load_all: () -> void
+  end
+end