rbs 2.0.0 → 2.1.0

data/stdlib/uri/0/ldaps.rbs

@@ -1,108 +1,14 @@
-# URI is a module providing classes to handle Uniform Resource Identifiers
-# ([RFC2396](http://tools.ietf.org/html/rfc2396)).
-#
-# ## Features
-#
-# *   Uniform way of handling URIs.
-# *   Flexibility to introduce custom URI schemes.
-# *   Flexibility to have an alternate URI::Parser (or just different patterns
-#     and regexp's).
-#
-#
-# ## Basic example
-#
-#     require 'uri'
-#
-#     uri = URI("http://foo.com/posts?id=30&limit=5#time=1305298413")
-#     #=> #<URI::HTTP http://foo.com/posts?id=30&limit=5#time=1305298413>
-#
-#     uri.scheme    #=> "http"
-#     uri.host      #=> "foo.com"
-#     uri.path      #=> "/posts"
-#     uri.query     #=> "id=30&limit=5"
-#     uri.fragment  #=> "time=1305298413"
-#
-#     uri.to_s      #=> "http://foo.com/posts?id=30&limit=5#time=1305298413"
-#
-# ## Adding custom URIs
-#
-#     module URI
-#       class RSYNC < Generic
-#         DEFAULT_PORT = 873
-#       end
-#       @@schemes['RSYNC'] = RSYNC
-#     end
-#     #=> URI::RSYNC
-#
-#     URI.scheme_list
-#     #=> {"FILE"=>URI::File, "FTP"=>URI::FTP, "HTTP"=>URI::HTTP,
-#     #    "HTTPS"=>URI::HTTPS, "LDAP"=>URI::LDAP, "LDAPS"=>URI::LDAPS,
-#     #    "MAILTO"=>URI::MailTo, "RSYNC"=>URI::RSYNC}
-#
-#     uri = URI("rsync://rsync.foo.com")
-#     #=> #<URI::RSYNC rsync://rsync.foo.com>
-#
-# ## RFC References
-#
-# A good place to view an RFC spec is http://www.ietf.org/rfc.html.
-#
-# Here is a list of all related RFC's:
-# *   [RFC822](http://tools.ietf.org/html/rfc822)
-# *   [RFC1738](http://tools.ietf.org/html/rfc1738)
-# *   [RFC2255](http://tools.ietf.org/html/rfc2255)
-# *   [RFC2368](http://tools.ietf.org/html/rfc2368)
-# *   [RFC2373](http://tools.ietf.org/html/rfc2373)
-# *   [RFC2396](http://tools.ietf.org/html/rfc2396)
-# *   [RFC2732](http://tools.ietf.org/html/rfc2732)
-# *   [RFC3986](http://tools.ietf.org/html/rfc3986)
-#
-#
-# ## Class tree
-#
-# *   URI::Generic (in uri/generic.rb)
-#     *   URI::File - (in uri/file.rb)
-#     *   URI::FTP - (in uri/ftp.rb)
-#     *   URI::HTTP - (in uri/http.rb)
-#         *   URI::HTTPS - (in uri/https.rb)
-#
-#     *   URI::LDAP - (in uri/ldap.rb)
-#         *   URI::LDAPS - (in uri/ldaps.rb)
-#
-#     *   URI::MailTo - (in uri/mailto.rb)
-#
-# *   URI::Parser - (in uri/common.rb)
-# *   URI::REGEXP - (in uri/common.rb)
-#     *   URI::REGEXP::PATTERN - (in uri/common.rb)
-#
-# *   URI::Util - (in uri/common.rb)
-# *   URI::Escape - (in uri/common.rb)
-# *   URI::Error - (in uri/common.rb)
-#     *   URI::InvalidURIError - (in uri/common.rb)
-#     *   URI::InvalidComponentError - (in uri/common.rb)
-#     *   URI::BadURIError - (in uri/common.rb)
-#
-#
-#
-# ## Copyright Info
-#
-# Author
-# :   Akira Yamada <akira@ruby-lang.org>
-# Documentation
-# :   Akira Yamada <akira@ruby-lang.org> Dmitry V. Sabanin <sdmitry@lrn.ru>
-#     Vincent Batts <vbatts@hashbangbash.com>
-# License
-# :   Copyright (c) 2001 akira yamada <akira@ruby-lang.org> You can redistribute
-#     it and/or modify it under the same term as Ruby.
-# Revision
-# :   $Id$
-#
-#
+%a{annotate:rdoc:skip}
 module URI
-  # The default port for LDAPS URIs is 636, and the scheme is 'ldaps:' rather
-  # than 'ldap:'. Other than that, LDAPS URIs are identical to LDAP URIs;
-  # see URI::LDAP.
+  # <!-- rdoc-file=lib/uri/ldaps.rb -->
+  # The default port for LDAPS URIs is 636, and the scheme is 'ldaps:' rather than
+  # 'ldap:'. Other than that, LDAPS URIs are identical to LDAP URIs; see
+  # URI::LDAP.
+  #
   class LDAPS < LDAP
+    # <!-- rdoc-file=lib/uri/ldaps.rb -->
     # A Default port of 636 for URI::LDAPS
+    #
     DEFAULT_PORT: Integer
   end
 end

data/stdlib/uri/0/mailto.rbs

@@ -1,5 +1,8 @@
+%a{annotate:rdoc:skip}
 module URI
+  # <!-- rdoc-file=lib/uri/mailto.rb -->
   # RFC6068, the mailto URL scheme.
+  #
   class MailTo < Generic
   end
 end

data/stdlib/uri/0/rfc2396_parser.rbs

@@ -1,9 +1,12 @@
+%a{annotate:rdoc:skip}
 module URI
+  # <!-- rdoc-file=lib/uri/rfc2396_parser.rb -->
   # Includes URI::REGEXP::PATTERN
   #
   module RFC2396_REGEXP
   end
 
+  # <!-- rdoc-file=lib/uri/rfc2396_parser.rb -->
   # Class that parses String's into URI's.
   #
   # It contains a Hash set of patterns and Regexp's that match and validate.
@@ -11,57 +14,67 @@ module URI
   class RFC2396_Parser
     include RFC2396_REGEXP
 
+    # <!-- rdoc-file=lib/uri/rfc2396_parser.rb -->
     # The Hash of patterns.
     #
     # See also URI::Parser.initialize_pattern.
     #
     attr_reader pattern: Hash[Symbol, String]
 
+    # <!-- rdoc-file=lib/uri/rfc2396_parser.rb -->
     # The Hash of Regexp.
     #
     # See also URI::Parser.initialize_regexp.
     #
     attr_reader regexp: Hash[Symbol, Regexp]
 
-    # == Synopsis
+    # <!--
+    #   rdoc-file=lib/uri/rfc2396_parser.rb
+    #   - new(opts = {})
+    # -->
+    # ## Synopsis
     #
-    #   URI::Parser.new([opts])
+    #     URI::Parser.new([opts])
     #
-    # == Args
+    # ## Args
     #
-    # The constructor accepts a hash as options for parser.
-    # Keys of options are pattern names of URI components
-    # and values of options are pattern strings.
-    # The constructor generates set of regexps for parsing URIs.
+    # The constructor accepts a hash as options for parser. Keys of options are
+    # pattern names of URI components and values of options are pattern strings. The
+    # constructor generates set of regexps for parsing URIs.
     #
     # You can use the following keys:
     #
-    #   * :ESCAPED (URI::PATTERN::ESCAPED in default)
-    #   * :UNRESERVED (URI::PATTERN::UNRESERVED in default)
-    #   * :DOMLABEL (URI::PATTERN::DOMLABEL in default)
-    #   * :TOPLABEL (URI::PATTERN::TOPLABEL in default)
-    #   * :HOSTNAME (URI::PATTERN::HOSTNAME in default)
+    #     * :ESCAPED (URI::PATTERN::ESCAPED in default)
+    #     * :UNRESERVED (URI::PATTERN::UNRESERVED in default)
+    #     * :DOMLABEL (URI::PATTERN::DOMLABEL in default)
+    #     * :TOPLABEL (URI::PATTERN::TOPLABEL in default)
+    #     * :HOSTNAME (URI::PATTERN::HOSTNAME in default)
     #
-    # == Examples
+    # ## Examples
     #
-    #   p = URI::Parser.new(:ESCAPED => "(?:%[a-fA-F0-9]{2}|%u[a-fA-F0-9]{4})")
-    #   u = p.parse("http://example.jp/%uABCD") #=> #<URI::HTTP http://example.jp/%uABCD>
-    #   URI.parse(u.to_s) #=> raises URI::InvalidURIError
+    #     p = URI::Parser.new(:ESCAPED => "(?:%[a-fA-F0-9]{2}|%u[a-fA-F0-9]{4})")
+    #     u = p.parse("http://example.jp/%uABCD") #=> #<URI::HTTP http://example.jp/%uABCD>
+    #     URI.parse(u.to_s) #=> raises URI::InvalidURIError
     #
-    #   s = "http://example.com/ABCD"
-    #   u1 = p.parse(s) #=> #<URI::HTTP http://example.com/ABCD>
-    #   u2 = URI.parse(s) #=> #<URI::HTTP http://example.com/ABCD>
-    #   u1 == u2 #=> true
-    #   u1.eql?(u2) #=> false
+    #     s = "http://example.com/ABCD"
+    #     u1 = p.parse(s) #=> #<URI::HTTP http://example.com/ABCD>
+    #     u2 = URI.parse(s) #=> #<URI::HTTP http://example.com/ABCD>
+    #     u1 == u2 #=> true
+    #     u1.eql?(u2) #=> false
     #
     def initialize: (?Hash[Symbol, String] opts) -> void
 
+    # <!--
+    #   rdoc-file=lib/uri/rfc2396_parser.rb
+    #   - escape( str )
+    #   - escape( str, unsafe )
+    # -->
     # ## Args
     #
     # `str`
     # :   String to make safe
     # `unsafe`
-    # :   Regexp to apply. Defaults to [self.regexp](:UNSAFE)
+    # :   Regexp to apply. Defaults to `self.regexp[:UNSAFE]`
     #
     #
     # ## Description
@@ -71,6 +84,12 @@ module URI
     #
     def escape: (String str, ?Regexp unsafe) -> String
 
+    # <!--
+    #   rdoc-file=lib/uri/rfc2396_parser.rb
+    #   - extract( str )
+    #   - extract( str, schemes )
+    #   - extract( str, schemes ) {|item| block }
+    # -->
     # ## Args
     #
     # `str`
@@ -89,6 +108,10 @@ module URI
     def extract: (String str, ?Array[String] schemes) -> Array[String]
                | (String str, ?Array[String] schemes) { (String) -> untyped } -> nil
 
+    # <!--
+    #   rdoc-file=lib/uri/rfc2396_parser.rb
+    #   - join(*uris)
+    # -->
     # ## Args
     #
     # `uris`
@@ -101,11 +124,19 @@ module URI
     #
     def join: (*String uris) -> URI::Generic
 
-    # Returns Regexp that is default [self.regexp](:ABS_URI_REF), unless `schemes`
-    # is provided. Then it is a Regexp.union with [self.pattern](:X_ABS_URI).
+    # <!--
+    #   rdoc-file=lib/uri/rfc2396_parser.rb
+    #   - make_regexp(schemes = nil)
+    # -->
+    # Returns Regexp that is default `self.regexp[:ABS_URI_REF]`, unless `schemes`
+    # is provided. Then it is a Regexp.union with `self.pattern[:X_ABS_URI]`.
     #
     def make_regexp: (?Array[String] schemes) -> Regexp
 
+    # <!--
+    #   rdoc-file=lib/uri/rfc2396_parser.rb
+    #   - parse(uri)
+    # -->
     # ## Args
     #
     # `uri`
@@ -125,16 +156,25 @@ module URI
     #
     def parse: (String uri) -> URI::Generic
 
-    # Returns a split URI against [regexp](:ABS_URI).
+    # <!--
+    #   rdoc-file=lib/uri/rfc2396_parser.rb
+    #   - split(uri)
+    # -->
+    # Returns a split URI against `regexp[:ABS_URI]`.
     #
     def split: (String uri) -> [ String?, String?, String?, String?, String?, String?, String?, String?, String? ]
 
+    # <!--
+    #   rdoc-file=lib/uri/rfc2396_parser.rb
+    #   - unescape( str )
+    #   - unescape( str, escaped )
+    # -->
     # ## Args
     #
     # `str`
     # :   String to remove escapes from
     # `escaped`
-    # :   Regexp to apply. Defaults to [self.regexp](:ESCAPED)
+    # :   Regexp to apply. Defaults to `self.regexp[:ESCAPED]`
     #
     #
     # ## Description

data/stdlib/uri/0/ws.rbs

@@ -1,10 +1,13 @@
+%a{annotate:rdoc:skip}
 module URI
+  # <!-- rdoc-file=lib/uri/ws.rb -->
   # The syntax of WS URIs is defined in RFC6455 section 3.
   #
   # Note that the Ruby URI library allows WS URLs containing usernames and
-  # passwords. This is not legal as per the RFC, but used to be
-  # supported in Internet Explorer 5 and 6, before the MS04-004 security
-  # update. See <URL:http://support.microsoft.com/kb/834489>.
+  # passwords. This is not legal as per the RFC, but used to be supported in
+  # Internet Explorer 5 and 6, before the MS04-004 security update. See
+  # <URL:http://support.microsoft.com/kb/834489>.
+  #
   class WS < Generic
   end
 end

data/stdlib/uri/0/wss.rbs

@@ -1,7 +1,9 @@
+%a{annotate:rdoc:skip}
 module URI
-  # The default port for WSS URIs is 443, and the scheme is 'wss:' rather
-  # than 'ws:'. Other than that, WSS URIs are identical to WS URIs;
-  # see URI::WS.
+  # <!-- rdoc-file=lib/uri/wss.rb -->
+  # The default port for WSS URIs is 443, and the scheme is 'wss:' rather than
+  # 'ws:'. Other than that, WSS URIs are identical to WS URIs; see URI::WS.
+  #
   class WSS < WS
   end
 end

data/stdlib/yaml/0/dbm.rbs

@@ -1,3 +1,4 @@
+# <!-- rdoc-file=lib/yaml.rb -->
 # YAML Ain't Markup Language
 #
 # This module provides a Ruby interface for data serialization in YAML format.
@@ -27,8 +28,8 @@
 #
 # ## History
 #
-# Syck was the original for YAML implementation in Ruby's standard library
-# developed by why the lucky stiff.
+# Syck was the original YAML implementation in Ruby's standard library developed
+# by why the lucky stiff.
 #
 # You can still use Syck, if you prefer, for parsing and emitting YAML, but you
 # must install the 'syck' gem now in order to use it.
@@ -47,175 +48,238 @@
 # Syck can also be found on github: https://github.com/ruby/syck
 #
 module YAML
+  # <!-- rdoc-file=lib/yaml/dbm.rb -->
   # YAML + DBM = YDBM
   #
   # YAML::DBM provides the same interface as ::DBM.
   #
-  # However, while DBM only allows strings for both keys and values,
-  # this library allows one to use most Ruby objects for values
-  # by first converting them to YAML. Keys must be strings.
+  # However, while DBM only allows strings for both keys and values, this library
+  # allows one to use most Ruby objects for values by first converting them to
+  # YAML. Keys must be strings.
   #
   # Conversion to and from YAML is performed automatically.
   #
   # See the documentation for ::DBM and ::YAML for more information.
+  #
   class DBM < ::DBM
     VERSION: ::String
 
-    # :call-seq:
-    #   ydbm[key] -> value
-    #
-    # Return value associated with +key+ from database.
+    # <!--
+    #   rdoc-file=lib/yaml/dbm.rb
+    #   - ydbm[key] -> value
+    # -->
+    # Return value associated with `key` from database.
     #
-    # Returns +nil+ if there is no such +key+.
+    # Returns `nil` if there is no such `key`.
     #
     # See #fetch for more information.
+    #
     def []: (String key) -> untyped
 
-    # :call-seq:
-    #   ydbm[key] = value
-    #
-    # Set +key+ to +value+ in database.
+    # <!--
+    #   rdoc-file=lib/yaml/dbm.rb
+    #   - ydbm[key] = value
+    # -->
+    # Set `key` to `value` in database.
     #
-    # +value+ will be converted to YAML before storage.
+    # `value` will be converted to YAML before storage.
     #
     # See #store for more information.
+    #
     def []=: (String key, untyped val) -> untyped
 
-    # :call-seq:
-    #   ydbm.fetch( key, ifnone = nil )
-    #   ydbm.fetch( key ) { |key| ... }
-    #
-    # Return value associated with +key+.
+    # <!--
+    #   rdoc-file=lib/yaml/dbm.rb
+    #   - ydbm.fetch( key, ifnone = nil )
+    #   - ydbm.fetch( key ) { |key| ... }
+    # -->
+    # Return value associated with `key`.
     #
-    # If there is no value for +key+ and no block is given, returns +ifnone+.
+    # If there is no value for `key` and no block is given, returns `ifnone`.
     #
-    # Otherwise, calls block passing in the given +key+.
+    # Otherwise, calls block passing in the given `key`.
     #
     # See ::DBM#fetch for more information.
+    #
     def fetch: (String keystr, ?untyped? ifnone) { (untyped) -> untyped } -> untyped
 
+    # <!--
+    #   rdoc-file=lib/yaml/dbm.rb
+    #   - index( keystr )
+    # -->
     # Deprecated, used YAML::DBM#key instead.
-    # ----
-    # Note:
-    # YAML::DBM#index makes warning from internal of ::DBM#index.
-    # It says 'DBM#index is deprecated; use DBM#key', but DBM#key
-    # behaves not same as DBM#index.
+    # ---
+    # Note: YAML::DBM#index makes warning from internal of ::DBM#index. It says
+    # 'DBM#index is deprecated; use DBM#key', but DBM#key behaves not same as
+    # DBM#index.
     #
     def index: (String keystr) -> untyped
 
-    # :call-seq:
-    #   ydbm.key(value) -> string
-    #
+    # <!--
+    #   rdoc-file=lib/yaml/dbm.rb
+    #   - ydbm.key(value) -> string
+    # -->
     # Returns the key for the specified value.
+    #
     def key: (String keystr) -> String
 
-    # :call-seq:
-    #   ydbm.values_at(*keys)
-    #
+    # <!--
+    #   rdoc-file=lib/yaml/dbm.rb
+    #   - ydbm.values_at(*keys)
+    # -->
     # Returns an array containing the values associated with the given keys.
+    #
     def values_at: (*untyped keys) -> Array[untyped]
 
-    # :call-seq:
-    #   ydbm.delete(key)
+    # <!--
+    #   rdoc-file=lib/yaml/dbm.rb
+    #   - ydbm.delete(key)
+    # -->
+    # Deletes value from database associated with `key`.
     #
-    # Deletes value from database associated with +key+.
+    # Returns value or `nil`.
     #
-    # Returns value or +nil+.
     def delete: (String key) -> untyped
 
+    # <!--
+    #   rdoc-file=lib/yaml/dbm.rb
+    #   - ydbm.delete_if { |key, value| ... }
+    # -->
+    # Calls the given block once for each `key`, `value` pair in the database.
+    # Deletes all entries for which the block returns true.
+    #
+    # Returns `self`.
+    #
     def delete_if: () { (untyped, untyped) -> untyped } -> untyped
 
-    # :call-seq:
-    #   ydbm.reject { |key, value| ... }
-    #
+    # <!--
+    #   rdoc-file=lib/yaml/dbm.rb
+    #   - ydbm.reject { |key, value| ... }
+    # -->
     # Converts the contents of the database to an in-memory Hash, then calls
     # Hash#reject with the specified code block, returning a new Hash.
+    #
     def reject: () { (untyped, untyped) -> untyped } -> Hash[untyped, untyped]
 
+    # <!--
+    #   rdoc-file=lib/yaml/dbm.rb
+    #   - ydbm.each_pair { |key, value| ... }
+    # -->
+    # Calls the given block once for each `key`, `value` pair in the database.
+    #
+    # Returns `self`.
+    #
     def each_pair: () { (untyped, untyped) -> untyped } -> untyped
 
+    # <!--
+    #   rdoc-file=lib/yaml/dbm.rb
+    #   - ydbm.each_value { |value| ... }
+    # -->
+    # Calls the given block for each value in database.
+    #
+    # Returns `self`.
+    #
     def each_value: () { (untyped) -> untyped } -> untyped
 
-    # :call-seq:
-    #   ydbm.values
-    #
+    # <!--
+    #   rdoc-file=lib/yaml/dbm.rb
+    #   - ydbm.values
+    # -->
     # Returns an array of values from the database.
+    #
     def values: () -> untyped
 
-    # :call-seq:
-    #   ydbm.has_value?(value)
+    # <!--
+    #   rdoc-file=lib/yaml/dbm.rb
+    #   - ydbm.has_value?(value)
+    # -->
+    # Returns true if specified `value` is found in the database.
     #
-    # Returns true if specified +value+ is found in the database.
     def has_value?: (untyped val) -> (::TrueClass | ::FalseClass)
 
-    # :call-seq:
-    #   ydbm.invert -> hash
-    #
+    # <!--
+    #   rdoc-file=lib/yaml/dbm.rb
+    #   - ydbm.invert -> hash
+    # -->
     # Returns a Hash (not a DBM database) created by using each value in the
     # database as a key, with the corresponding key as its value.
     #
-    # Note that all values in the hash will be Strings, but the keys will be
-    # actual objects.
+    # Note that all values in the hash will be Strings, but the keys will be actual
+    # objects.
+    #
     def invert: () -> Hash[untyped, untyped]
 
-    # :call-seq:
-    #   ydbm.replace(hash) -> ydbm
-    #
+    # <!--
+    #   rdoc-file=lib/yaml/dbm.rb
+    #   - ydbm.replace(hash) -> ydbm
+    # -->
     # Replaces the contents of the database with the contents of the specified
-    # object. Takes any object which implements the each_pair method, including
-    # Hash and DBM objects.
+    # object. Takes any object which implements the each_pair method, including Hash
+    # and DBM objects.
+    #
     def replace: (Hash[untyped, untyped] | DBM hsh) -> YAML::DBM
 
-    # :call-seq:
-    #   ydbm.shift -> [key, value]
-    #
-    # Removes a [key, value] pair from the database, and returns it.
-    # If the database is empty, returns +nil+.
+    # <!--
+    #   rdoc-file=lib/yaml/dbm.rb
+    #   - ydbm.shift -> [key, value]
+    # -->
+    # Removes a [key, value] pair from the database, and returns it. If the database
+    # is empty, returns `nil`.
     #
     # The order in which values are removed/returned is not guaranteed.
+    #
     def shift: () -> (Array[untyped] | untyped)
 
-    # :call-seq:
-    #   ydbm.select { |key, value| ... }
-    #   ydbm.select(*keys)
-    #
-    # If a block is provided, returns a new array containing [key, value] pairs
-    # for which the block returns true.
+    # <!--
+    #   rdoc-file=lib/yaml/dbm.rb
+    #   - ydbm.select { |key, value| ... }
+    #   - ydbm.select(*keys)
+    # -->
+    # If a block is provided, returns a new array containing [key, value] pairs for
+    # which the block returns true.
     #
     # Otherwise, same as #values_at
+    #
     def select: (*untyped keys) { (untyped, untyped) -> untyped } -> Array[untyped]
 
-    # :call-seq:
-    #   ydbm.store(key, value) -> value
+    # <!--
+    #   rdoc-file=lib/yaml/dbm.rb
+    #   - ydbm.store(key, value) -> value
+    # -->
+    # Stores `value` in database with `key` as the index. `value` is converted to
+    # YAML before being stored.
     #
-    # Stores +value+ in database with +key+ as the index. +value+ is converted
-    # to YAML before being stored.
+    # Returns `value`
     #
-    # Returns +value+
     def store: (String key, untyped val) -> untyped
 
-    # :call-seq:
-    #   ydbm.update(hash) -> ydbm
+    # <!--
+    #   rdoc-file=lib/yaml/dbm.rb
+    #   - ydbm.update(hash) -> ydbm
+    # -->
+    # Updates the database with multiple values from the specified object. Takes any
+    # object which implements the each_pair method, including Hash and DBM objects.
     #
-    # Updates the database with multiple values from the specified object.
-    # Takes any object which implements the each_pair method, including
-    # Hash and DBM objects.
+    # Returns `self`.
     #
-    # Returns +self+.
     def update: (Hash[untyped, untyped]) -> YAML::DBM
 
-    # :call-seq:
-    #   ydbm.to_a -> array
+    # <!--
+    #   rdoc-file=lib/yaml/dbm.rb
+    #   - ydbm.to_a -> array
+    # -->
+    # Converts the contents of the database to an array of [key, value] arrays, and
+    # returns it.
     #
-    # Converts the contents of the database to an array of [key, value] arrays,
-    # and returns it.
-    def to_a: () -> Array [untyped]
+    def to_a: () -> Array[untyped]
 
-    # :call-seq:
-    #   ydbm.to_hash -> hash
+    # <!--
+    #   rdoc-file=lib/yaml/dbm.rb
+    #   - ydbm.to_hash -> hash
+    # -->
+    # Converts the contents of the database to an in-memory Hash object, and returns
+    # it.
     #
-    # Converts the contents of the database to an in-memory Hash object, and
-    # returns it.
     def to_hash: () -> Hash[untyped, untyped]
   end
 end