rbs 3.6.1 → 3.9.5

data/core/dir.rbs

@@ -10,7 +10,6 @@
 #     retrieved in an [array-like fashion](rdoc-ref:Dir@Dir+As+Array-Like) or in
 #     a [stream-like fashion](rdoc-ref:Dir@Dir+As+Stream-Like).
 #
-#
 # ## About the Examples
 #
 # Some examples on this page use this simple file tree:
@@ -33,7 +32,6 @@
 # *   It has instance methods #children, #each, and #each_child.
 # *   It includes [module Enumerable](rdoc-ref:Enumerable@What-27s+Here).
 #
-#
 # ## Dir As Stream-Like
 #
 # A Dir object is in some ways stream-like.
@@ -54,7 +52,6 @@
 #     the position; if at end-of-stream, does not increment the position.
 # *   Method #rewind sets the position to zero.
 #
-#
 # Examples (using the [simple file tree](rdoc-ref:Dir@About+the+Examples)):
 #
 #     dir = Dir.new('example') # => #<Dir:example>
@@ -89,7 +86,6 @@
 # *   Includes [module Enumerable](rdoc-ref:Enumerable@What-27s+Here), which
 #     provides dozens of additional methods.
 #
-#
 # Here, class Dir provides methods that are useful for:
 #
 # *   [Reading](rdoc-ref:Dir@Reading)
@@ -98,7 +94,6 @@
 # *   [Iterating](rdoc-ref:Dir@Iterating)
 # *   [Other](rdoc-ref:Dir@Other)
 #
-#
 # ### Reading
 #
 # *   #close: Closes the directory stream for `self`.
@@ -110,7 +105,6 @@
 # *   #seek: Sets the position in the directory stream for `self` the entry at
 #     the given offset.
 #
-#
 # ### Setting
 #
 # *   ::chdir: Changes the working directory of the current process to the given
@@ -118,7 +112,6 @@
 # *   ::chroot: Changes the file-system root for the current process to the
 #     given directory.
 #
-#
 # ### Querying
 #
 # *   ::[]: Same as ::glob without the ability to pass flags.
@@ -141,7 +134,6 @@
 # *   #tell (aliased as #pos): Returns the integer position in the directory
 #     stream for `self`.
 #
-#
 # ### Iterating
 #
 # *   ::each_child: Calls the given block with each entry in the given
@@ -153,7 +145,6 @@
 # *   #each_child: Calls the given block with each entry in `self`, but not
 #     including `.` or `..`.
 #
-#
 # ### Other
 #
 # *   ::mkdir: Creates a directory at the given path, with optional permissions.
@@ -215,7 +206,6 @@ class Dir
   #     defined.
   # *   Otherwise makes no change.
   #
-  #
   # With argument `new_dirpath` and a block, temporarily changes the working
   # directory:
   #
@@ -225,7 +215,6 @@ class Dir
   # *   Restores the previous working directory.
   # *   Returns the block's return value.
   #
-  #
   # Example:
   #
   #     Dir.chdir('/var/spool/mail')
@@ -395,7 +384,6 @@ class Dir
   # *   Restores the previous working directory.
   # *   Returns the block's return value.
   #
-  #
   # Example:
   #
   #     Dir.chdir('/var/spool/mail')
@@ -504,7 +492,6 @@ class Dir
   # *   We use method Array#take to shorten returned arrays that otherwise would
   #     be very large.
   #
-  #
   # With no block, returns array *entry_names*; example (using the [simple file
   # tree](rdoc-ref:Dir@About+the+Examples)):
   #
@@ -564,7 +551,6 @@ class Dir
   #
   #             Dir.glob('*c*').take(3) # => ["CONTRIBUTING.md", "COPYING", "COPYING.ja"]
   #
-  #
   #     Does not match Unix-like hidden entry names ("dot files"). To include
   #     those in the matched entry names, use flag IO::FNM_DOTMATCH or something
   #     like `'{*,.*}'`.
@@ -600,7 +586,6 @@ class Dir
   #     Note that on Windows, the backslash character may not be used in a string
   #     pattern: `Dir['c:\\foo*']` will not work, use `Dir['c:/foo*']` instead.
   #
-  #
   # More examples (using the [simple file tree](rdoc-ref:Dir@About+the+Examples)):
   #
   #     # We're in the example directory.
@@ -669,7 +654,7 @@ class Dir
   #   rdoc-file=dir.c
   #   - Dir.home(user_name = nil) -> dirpath
   # -->
-  # Retruns the home directory path of the user specified with `user_name` if it
+  # Returns the home directory path of the user specified with `user_name` if it
   # is not `nil`, or the current login user:
   #
   #     Dir.home         # => "/home/me"
@@ -779,12 +764,11 @@ class Dir
   # *   Restores the previous working directory.
   # *   Returns the block's return value.
   #
-  #
   # Uses Dir.fchdir if available, and Dir.chdir if not, see those methods for
   # caveats.
   #
   def chdir: () -> Integer
-           | [T] { () -> T } -> T
+           | [T] () { () -> T } -> T
 
   # <!--
   #   rdoc-file=dir.c

data/core/encoding.rbs

@@ -12,7 +12,6 @@
 # *   The name of an encoding.
 # *   An alias for an encoding name.
 #
-#
 # These are equivalent:
 #
 #     'foo'.encode(Encoding::US_ASCII) # Encoding object.
@@ -109,7 +108,6 @@ class Encoding
   # *   String#inspect
   # *   Regexp#inspect
   #
-  #
   # While strings created from these locations will have this encoding, the
   # encoding may not be valid.  Be sure to check String#valid_encoding?.
   #
@@ -157,7 +155,6 @@ class Encoding
   # *   Values from ENV
   # *   Values in ARGV including $PROGRAM_NAME
   #
-  #
   # Additionally String#encode and String#encode! use the default internal
   # encoding if no encoding is given.
   #
@@ -198,10 +195,13 @@ class Encoding
   #
   # "external"
   # :   default external encoding
+  #
   # "internal"
   # :   default internal encoding
+  #
   # "locale"
   # :   locale encoding
+  #
   # "filesystem"
   # :   filesystem encoding
   #
@@ -999,7 +999,6 @@ class Encoding::Converter < Object
   #     :partial_input is specified.
   # *   conversion is finished (:finished)
   #
-  #
   # example:
   #     ec = Encoding::Converter.new("UTF-8", "UTF-16BE")
   #     ret = ec.primitive_convert(src="pi", dst="", nil, 100)
@@ -1212,7 +1211,6 @@ class Encoding::Converter < Object
   # *   two-element arrays which contain encodings or encoding names, or
   # *   strings representing decorator names.
   #
-  #
   # Encoding::Converter.new optionally takes an option. The option should be a
   # hash or an integer. The option hash can contain :invalid => nil, etc. The
   # option integer should be logical-or of constants such as
@@ -1220,25 +1218,34 @@ class Encoding::Converter < Object
   #
   # :invalid => nil
   # :   Raise error on invalid byte sequence.  This is a default behavior.
+  #
   # :invalid => :replace
   # :   Replace invalid byte sequence by replacement string.
+  #
   # :undef => nil
   # :   Raise an error if a character in source_encoding is not defined in
   #     destination_encoding. This is a default behavior.
+  #
   # :undef => :replace
   # :   Replace undefined character in destination_encoding with replacement
   #     string.
+  #
   # :replace => string
   # :   Specify the replacement string. If not specified, "uFFFD" is used for
   #     Unicode encodings and "?" for others.
+  #
   # :universal_newline => true
   # :   Convert CRLF and CR to LF.
+  #
   # :crlf_newline => true
   # :   Convert LF to CRLF.
+  #
   # :cr_newline => true
   # :   Convert LF to CR.
+  #
   # :lf_newline => true
   # :   Convert CRLF and CR to LF (when writing).
+  #
   # :xml => :text
   # :   Escape as XML CharData. This form can be used as an HTML 4.0 #PCDATA.
   #     *   '&' -> '&amp;'
@@ -1258,7 +1265,6 @@ class Encoding::Converter < Object
   #         such as &#xHH;
   #
   #
-  #
   # Examples:
   #     # UTF-16BE to UTF-8
   #     ec = Encoding::Converter.new("UTF-16BE", "UTF-8")
@@ -1296,96 +1302,70 @@ class Encoding::Converter < Object
 end
 
 # <!-- rdoc-file=transcode.c -->
-# AFTER_OUTPUT
-#
 # Stop converting after some output is complete but before all of the input was
 # consumed.  See primitive_convert for an example.
 #
 Encoding::Converter::AFTER_OUTPUT: Integer
 
 # <!-- rdoc-file=transcode.c -->
-# CRLF_NEWLINE_DECORATOR
-#
 # Decorator for converting LF to CRLF
 #
 Encoding::Converter::CRLF_NEWLINE_DECORATOR: Integer
 
 # <!-- rdoc-file=transcode.c -->
-# CR_NEWLINE_DECORATOR
-#
 # Decorator for converting LF to CR
 #
 Encoding::Converter::CR_NEWLINE_DECORATOR: Integer
 
 # <!-- rdoc-file=transcode.c -->
-# INVALID_MASK
-#
 # Mask for invalid byte sequences
 #
 Encoding::Converter::INVALID_MASK: Integer
 
 # <!-- rdoc-file=transcode.c -->
-# INVALID_REPLACE
-#
 # Replace invalid byte sequences
 #
 Encoding::Converter::INVALID_REPLACE: Integer
 
 # <!-- rdoc-file=transcode.c -->
-# PARTIAL_INPUT
-#
 # Indicates the source may be part of a larger string.  See primitive_convert
 # for an example.
 #
 Encoding::Converter::PARTIAL_INPUT: Integer
 
 # <!-- rdoc-file=transcode.c -->
-# UNDEF_HEX_CHARREF
-#
 # Replace byte sequences that are undefined in the destination encoding with an
 # XML hexadecimal character reference.  This is valid for XML conversion.
 #
 Encoding::Converter::UNDEF_HEX_CHARREF: Integer
 
 # <!-- rdoc-file=transcode.c -->
-# UNDEF_MASK
-#
 # Mask for a valid character in the source encoding but no related character(s)
 # in destination encoding.
 #
 Encoding::Converter::UNDEF_MASK: Integer
 
 # <!-- rdoc-file=transcode.c -->
-# UNDEF_REPLACE
-#
 # Replace byte sequences that are undefined in the destination encoding.
 #
 Encoding::Converter::UNDEF_REPLACE: Integer
 
 # <!-- rdoc-file=transcode.c -->
-# UNIVERSAL_NEWLINE_DECORATOR
-#
 # Decorator for converting CRLF and CR to LF
 #
 Encoding::Converter::UNIVERSAL_NEWLINE_DECORATOR: Integer
 
 # <!-- rdoc-file=transcode.c -->
-# XML_ATTR_CONTENT_DECORATOR
-#
 # Escape as XML AttValue
 #
 Encoding::Converter::XML_ATTR_CONTENT_DECORATOR: Integer
 
 # <!-- rdoc-file=transcode.c -->
-# XML_ATTR_QUOTE_DECORATOR
-#
 # Escape as XML AttValue
 #
 Encoding::Converter::XML_ATTR_QUOTE_DECORATOR: Integer
 
 # <!-- rdoc-file=transcode.c -->
-# XML_TEXT_DECORATOR
-#
 # Escape as XML CharData
 #
 Encoding::Converter::XML_TEXT_DECORATOR: Integer