rbs 4.0.0.dev.4 → 4.0.0.dev.5

data/core/file.rbs

@@ -847,7 +847,7 @@ class File < IO
   # *   [Open Options](rdoc-ref:IO@Open+Options).
   # *   [Encoding options](rdoc-ref:encodings.rdoc@Encoding+Options).
   #
-  def initialize: (string | _ToPath | int file_name, ?string | int mode, ?int perm) -> void
+  def initialize: (path | int file_name, ?string | int mode, ?int perm) -> void
 
   # <!--
   #   rdoc-file=file.c
@@ -861,7 +861,7 @@ class File < IO
   #
   #     File.absolute_path("~oracle/bin")       #=> "<relative_path>/~oracle/bin"
   #
-  def self.absolute_path: (string | _ToPath file_name, ?string | _ToPath dir_string) -> String
+  def self.absolute_path: (path file_name, ?path dir_string) -> String
 
   # <!--
   #   rdoc-file=file.c
@@ -871,7 +871,7 @@ class File < IO
   #
   #     File.absolute_path?("c:/foo")     #=> false (on Linux), true (on Windows)
   #
-  def self.absolute_path?: (string | _ToPath file_name) -> bool
+  def self.absolute_path?: (path file_name) -> bool
 
   # <!--
   #   rdoc-file=file.c
@@ -883,7 +883,7 @@ class File < IO
   #
   #     File.atime("testfile")   #=> Wed Apr 09 08:51:48 CDT 2003
   #
-  def self.atime: (string | _ToPath | IO file_name) -> Time
+  def self.atime: (path | IO file_name) -> Time
 
   # <!--
   #   rdoc-file=file.c
@@ -899,7 +899,7 @@ class File < IO
   #     File.basename("/home/gumby/work/ruby.rb", ".rb")   #=> "ruby"
   #     File.basename("/home/gumby/work/ruby.rb", ".*")    #=> "ruby"
   #
-  def self.basename: (string | _ToPath file_name, ?string suffix) -> String
+  def self.basename: (path file_name, ?string suffix) -> String
 
   # <!--
   #   rdoc-file=file.c
@@ -913,7 +913,7 @@ class File < IO
   #
   # If the platform doesn't have birthtime, raises NotImplementedError.
   #
-  def self.birthtime: (string | _ToPath | IO file_name) -> Time
+  def self.birthtime: (path | IO file_name) -> Time
 
   # <!--
   #   rdoc-file=file.c
@@ -924,7 +924,7 @@ class File < IO
   #     File.blockdev?('/dev/sda1')       # => true
   #     File.blockdev?(File.new('t.tmp')) # => false
   #
-  def self.blockdev?: (string | _ToPath | IO file_name) -> bool
+  def self.blockdev?: (path | IO file_name) -> bool
 
   # <!--
   #   rdoc-file=file.c
@@ -935,7 +935,7 @@ class File < IO
   #     File.chardev?($stdin)     # => true
   #     File.chardev?('t.txt')     # => false
   #
-  def self.chardev?: (string | _ToPath | IO file_name) -> bool
+  def self.chardev?: (path | IO file_name) -> bool
 
   # <!--
   #   rdoc-file=file.c
@@ -948,7 +948,7 @@ class File < IO
   #
   #     File.chmod(0644, "testfile", "out")   #=> 2
   #
-  def self.chmod: (int mode, *string | _ToPath file_name) -> Integer
+  def self.chmod: (int mode, *path file_name) -> Integer
 
   # <!--
   #   rdoc-file=file.c
@@ -962,7 +962,7 @@ class File < IO
   #
   #     File.chown(nil, 100, "testfile")
   #
-  def self.chown: (int? owner, int? group, *string | _ToPath file_name) -> Integer
+  def self.chown: (int? owner, int? group, *path file_name) -> Integer
 
   # <!--
   #   rdoc-file=file.c
@@ -977,7 +977,7 @@ class File < IO
   #
   #     File.ctime("testfile")   #=> Wed Apr 09 08:53:13 CDT 2003
   #
-  def self.ctime: (string | _ToPath | IO file_name) -> Time
+  def self.ctime: (path | IO file_name) -> Time
 
   # <!--
   #   rdoc-file=file.c
@@ -1010,7 +1010,7 @@ class File < IO
   #
   # Argument `path` can be an IO object.
   #
-  def self.directory?: (string | _ToPath | IO path) -> bool
+  def self.directory?: (path | IO path) -> bool
 
   # <!--
   #   rdoc-file=file.c
@@ -1028,7 +1028,7 @@ class File < IO
   #     File.dirname("/home/gumby/work/ruby.rb", 2) #=> "/home/gumby"
   #     File.dirname("/home/gumby/work/ruby.rb", 4) #=> "/"
   #
-  def self.dirname: (string | _ToPath file_name, ?Integer level) -> String
+  def self.dirname: (path file_name, ?Integer level) -> String
 
   # <!--
   #   rdoc-file=file.c
@@ -1054,7 +1054,7 @@ class File < IO
   # Note that some OS-level security features may cause this to return true even
   # though the file is not executable by the effective user/group.
   #
-  def self.executable?: (string | _ToPath file_name) -> bool
+  def self.executable?: (path file_name) -> bool
 
   # <!--
   #   rdoc-file=file.c
@@ -1070,7 +1070,7 @@ class File < IO
   # Note that some OS-level security features may cause this to return true even
   # though the file is not executable by the real user/group.
   #
-  def self.executable_real?: (string | _ToPath file_name) -> bool
+  def self.executable_real?: (path file_name) -> bool
 
   # <!--
   #   rdoc-file=file.c
@@ -1082,7 +1082,7 @@ class File < IO
   #
   # "file exists" means that stat() or fstat() system call is successful.
   #
-  def self.exist?: (string | _ToPath | IO file_name) -> bool
+  def self.exist?: (path | IO file_name) -> bool
 
   # <!--
   #   rdoc-file=file.c
@@ -1109,7 +1109,7 @@ class File < IO
   # So first it resolves the parent of __FILE__, that is bin/, then go to the
   # parent, the root of the project and appends `lib/mygem.rb`.
   #
-  def self.expand_path: (string | _ToPath file_name, ?string | _ToPath dir_string) -> String
+  def self.expand_path: (path file_name, ?path dir_string) -> String
 
   # <!--
   #   rdoc-file=file.c
@@ -1135,7 +1135,7 @@ class File < IO
   #     File.extname(".profile")        #=> ""
   #     File.extname(".profile.sh")     #=> ".sh"
   #
-  def self.extname: (string | _ToPath path) -> String
+  def self.extname: (path path) -> String
 
   # <!--
   #   rdoc-file=file.c
@@ -1148,7 +1148,7 @@ class File < IO
   # If the `file` argument is a symbolic link, it will resolve the symbolic link
   # and use the file referenced by the link.
   #
-  def self.file?: (string | _ToPath | IO file) -> bool
+  def self.file?: (path | IO file) -> bool
 
   # <!--
   #   rdoc-file=dir.rb
@@ -1252,7 +1252,7 @@ class File < IO
   #     File.fnmatch('**/foo', 'a/.b/c/foo', File::FNM_PATHNAME)    #=> false
   #     File.fnmatch('**/foo', 'a/.b/c/foo', File::FNM_PATHNAME | File::FNM_DOTMATCH) #=> true
   #
-  def self.fnmatch: (string pattern, string | _ToPath path, ?int flags) -> bool
+  def self.fnmatch: (string pattern, path path, ?int flags) -> bool
 
   # <!--
   #   rdoc-file=dir.rb
@@ -1273,7 +1273,7 @@ class File < IO
   #     File.ftype("/dev/tty")            #=> "characterSpecial"
   #     File.ftype("/tmp/.X11-unix/X0")   #=> "socket"
   #
-  def self.ftype: (string | _ToPath file_name) -> String
+  def self.ftype: (path file_name) -> String
 
   # <!--
   #   rdoc-file=file.c
@@ -1284,7 +1284,7 @@ class File < IO
   #
   # *file_name* can be an IO object.
   #
-  def self.grpowned?: (string | _ToPath | IO file_name) -> bool
+  def self.grpowned?: (path | IO file_name) -> bool
 
   # <!--
   #   rdoc-file=file.c
@@ -1304,7 +1304,7 @@ class File < IO
   #     open("d", "w") {}
   #     p File.identical?("a", "d")      #=> false
   #
-  def self.identical?: (string | _ToPath | IO file_1, string | _ToPath | IO file_2) -> bool
+  def self.identical?: (path | IO file_1, path | IO file_2) -> bool
 
   # <!--
   #   rdoc-file=file.c
@@ -1324,7 +1324,7 @@ class File < IO
   # change the permissions associated with the link, not the file referenced by
   # the link). Often not available.
   #
-  def self.lchmod: (int mode, *string | _ToPath file_name) -> Integer
+  def self.lchmod: (int mode, *path file_name) -> Integer
 
   # <!--
   #   rdoc-file=file.c
@@ -1334,7 +1334,7 @@ class File < IO
   # change the owner associated with the link, not the file referenced by the
   # link). Often not available. Returns number of files in the argument list.
   #
-  def self.lchown: (int? owner, int? group, *string | _ToPath file_name) -> Integer
+  def self.lchown: (int? owner, int? group, *path file_name) -> Integer
 
   # <!--
   #   rdoc-file=file.c
@@ -1347,7 +1347,7 @@ class File < IO
   #     File.link("testfile", ".testfile")   #=> 0
   #     IO.readlines(".testfile")[0]         #=> "This is line one\n"
   #
-  def self.link: (string | _ToPath old_name, string | _ToPath new_name) -> 0
+  def self.link: (path old_name, path new_name) -> 0
 
   # <!--
   #   rdoc-file=file.c
@@ -1360,7 +1360,7 @@ class File < IO
   #     File.stat('symlink').size  # => 47
   #     File.lstat('symlink').size # => 5
   #
-  def self.lstat: (string | _ToPath file_name) -> File::Stat
+  def self.lstat: (path file_name) -> File::Stat
 
   # <!--
   #   rdoc-file=file.c
@@ -1371,7 +1371,7 @@ class File < IO
   # opposed to its referent; for the inverse behavior, see File.utime. Returns the
   # number of file names in the argument list.
   #
-  def self.lutime: (Time | Numeric atime, Time | Numeric mtime, *string | _ToPath file_name) -> Integer
+  def self.lutime: (Time | Numeric atime, Time | Numeric mtime, *path file_name) -> Integer
 
   # <!--
   #   rdoc-file=file.c
@@ -1381,7 +1381,7 @@ class File < IO
   # FIFO's permissions. It is modified by the process's umask in the usual way:
   # the permissions of the created file are (mode & ~umask).
   #
-  def self.mkfifo: (string | _ToPath file_name, ?int mode) -> 0
+  def self.mkfifo: (path file_name, ?int mode) -> 0
 
   # <!--
   #   rdoc-file=file.c
@@ -1393,7 +1393,7 @@ class File < IO
   #
   #     File.mtime("testfile")   #=> Tue Apr 08 12:58:04 CDT 2003
   #
-  def self.mtime: (string | _ToPath | IO file_name) -> Time
+  def self.mtime: (path | IO file_name) -> Time
 
   # <!--
   #   rdoc-file=io.c
@@ -1407,19 +1407,19 @@ class File < IO
   # With a block given, calls the block with the File object and returns the
   # block's value.
   #
-  def self.open: (string | _ToPath | int file_name, ?string | int mode, ?int perm) -> instance
-               | [T] (string | _ToPath | int file_name, ?string | int mode, ?int perm) { (File) -> T } -> T
+  def self.open: (path | int file_name, ?string | int mode, ?int perm) -> instance
+               | [T] (path | int file_name, ?string | int mode, ?int perm) { (File) -> T } -> T
 
   # <!--
   #   rdoc-file=file.c
   #   - File.owned?(file_name)   -> true or false
   # -->
-  # Returns `true` if the named file exists and the effective used id of the
+  # Returns `true` if the named file exists and the effective user id of the
   # calling process is the owner of the file.
   #
   # *file_name* can be an IO object.
   #
-  def self.owned?: (string | _ToPath | IO file_name) -> bool
+  def self.owned?: (path | IO file_name) -> bool
 
   # <!--
   #   rdoc-file=file.c
@@ -1427,10 +1427,27 @@ class File < IO
   # -->
   # Returns the string representation of the path
   #
-  #     File.path(File::NULL)           #=> "/dev/null"
-  #     File.path(Pathname.new("/tmp")) #=> "/tmp"
+  #        File.path(File::NULL)           #=> "/dev/null"
+  #        File.path(Pathname.new("/tmp")) #=> "/tmp"
   #
-  def self.path: (string | _ToPath path) -> String
+  # If `path` is not a String:
+  #
+  # 1.  If it has the `to_path` method, that method will be called to coerce to a
+  #     String.
+  #
+  # 2.  Otherwise, or if the coerced result is not a String too, the standard
+  #     coersion using `to_str` method will take place on that object. (See also
+  #     String.try_convert)
+  #
+  # The coerced string must satisfy the following conditions:
+  #
+  # 1.  It must be in an ASCII-compatible encoding; otherwise, an
+  #     Encoding::CompatibilityError is raised.
+  #
+  # 2.  It must not contain the NUL character (`\0`); otherwise, an ArgumentError
+  #     is raised.
+  #
+  def self.path: (path path) -> String
 
   # <!--
   #   rdoc-file=file.c
@@ -1442,7 +1459,7 @@ class File < IO
   #     File.pipe?('tmp/fifo') # => true
   #     File.pipe?('t.txt')    # => false
   #
-  def self.pipe?: (string | _ToPath | IO file_name) -> bool
+  def self.pipe?: (path | IO file_name) -> bool
 
   # <!--
   #   rdoc-file=file.c
@@ -1454,7 +1471,7 @@ class File < IO
   # Note that some OS-level security features may cause this to return true even
   # though the file is not readable by the effective user/group.
   #
-  def self.readable?: (string | _ToPath file_name) -> bool
+  def self.readable?: (path file_name) -> bool
 
   # <!--
   #   rdoc-file=file.c
@@ -1466,7 +1483,7 @@ class File < IO
   # Note that some OS-level security features may cause this to return true even
   # though the file is not readable by the real user/group.
   #
-  def self.readable_real?: (string | _ToPath file_name) -> bool
+  def self.readable_real?: (path file_name) -> bool
 
   # <!--
   #   rdoc-file=file.c
@@ -1478,7 +1495,7 @@ class File < IO
   #     File.symlink("testfile", "link2test")   #=> 0
   #     File.readlink("link2test")              #=> "testfile"
   #
-  def self.readlink: (string | _ToPath link_name) -> String
+  def self.readlink: (path link_name) -> String
 
   # <!--
   #   rdoc-file=file.c
@@ -1492,7 +1509,7 @@ class File < IO
   #
   # The last component of the real pathname can be nonexistent.
   #
-  def self.realdirpath: (string | _ToPath pathname, ?string | _ToPath dir_string) -> String
+  def self.realdirpath: (path pathname, ?path dir_string) -> String
 
   # <!--
   #   rdoc-file=file.c
@@ -1506,7 +1523,7 @@ class File < IO
   #
   # All components of the pathname must exist when this method is called.
   #
-  def self.realpath: (string | _ToPath pathname, ?string | _ToPath dir_string) -> String
+  def self.realpath: (path pathname, ?path dir_string) -> String
 
   # <!--
   #   rdoc-file=file.c
@@ -1517,7 +1534,7 @@ class File < IO
   #
   #     File.rename("afile", "afile.bak")   #=> 0
   #
-  def self.rename: (string | _ToPath old_name, string | _ToPath new_name) -> 0
+  def self.rename: (path old_name, path new_name) -> 0
 
   # <!--
   #   rdoc-file=file.c
@@ -1527,7 +1544,7 @@ class File < IO
   #
   # *file_name* can be an IO object.
   #
-  def self.setgid?: (string | _ToPath | IO file_name) -> bool
+  def self.setgid?: (path | IO file_name) -> bool
 
   # <!--
   #   rdoc-file=file.c
@@ -1537,7 +1554,7 @@ class File < IO
   #
   # *file_name* can be an IO object.
   #
-  def self.setuid?: (string | _ToPath | IO file_name) -> bool
+  def self.setuid?: (path | IO file_name) -> bool
 
   # <!--
   #   rdoc-file=file.c
@@ -1547,7 +1564,7 @@ class File < IO
   #
   # *file_name* can be an IO object.
   #
-  def self.size: (string | _ToPath | IO file_name) -> Integer
+  def self.size: (path | IO file_name) -> Integer
 
   # <!--
   #   rdoc-file=file.c
@@ -1558,7 +1575,7 @@ class File < IO
   #
   # *file_name* can be an IO object.
   #
-  def self.size?: (string | _ToPath | IO file_name) -> Integer?
+  def self.size?: (path | IO file_name) -> Integer?
 
   # <!--
   #   rdoc-file=file.c
@@ -1570,7 +1587,7 @@ class File < IO
   #     File.socket?(Socket.new(:INET, :STREAM)) # => true
   #     File.socket?(File.new('t.txt'))          # => false
   #
-  def self.socket?: (string | _ToPath | IO file_name) -> bool
+  def self.socket?: (path | IO file_name) -> bool
 
   # <!--
   #   rdoc-file=file.c
@@ -1581,7 +1598,7 @@ class File < IO
   #
   #     File.split("/home/gumby/.profile")   #=> ["/home/gumby", ".profile"]
   #
-  def self.split: (string | _ToPath file_name) -> [ String, String ]
+  def self.split: (path file_name) -> [ String, String ]
 
   # <!--
   #   rdoc-file=file.c
@@ -1591,7 +1608,7 @@ class File < IO
   #
   #     File.stat('t.txt').class # => File::Stat
   #
-  def self.stat: (string | _ToPath file_name) -> File::Stat
+  def self.stat: (path file_name) -> File::Stat
 
   # <!--
   #   rdoc-file=file.c
@@ -1601,7 +1618,7 @@ class File < IO
   #
   # *file_name* can be an IO object.
   #
-  def self.sticky?: (string | _ToPath | IO file_name) -> bool
+  def self.sticky?: (path | IO file_name) -> bool
 
   # <!--
   #   rdoc-file=file.c
@@ -1613,7 +1630,7 @@ class File < IO
   #
   #     File.symlink("testfile", "link2test")   #=> 0
   #
-  def self.symlink: (string | _ToPath old_name, string | _ToPath new_name) -> 0
+  def self.symlink: (path old_name, path new_name) -> 0
 
   # <!--
   #   rdoc-file=file.c
@@ -1625,7 +1642,7 @@ class File < IO
   #     File.symlink?('symlink') # => true
   #     File.symlink?('t.txt')   # => false
   #
-  def self.symlink?: (string | _ToPath file_name) -> bool
+  def self.symlink?: (path file_name) -> bool
 
   # <!--
   #   rdoc-file=file.c
@@ -1640,7 +1657,7 @@ class File < IO
   #     File.truncate("out", 5)   #=> 0
   #     File.size("out")          #=> 5
   #
-  def self.truncate: (string | _ToPath file_name, int length) -> 0
+  def self.truncate: (path file_name, int length) -> 0
 
   # <!--
   #   rdoc-file=file.c
@@ -1670,7 +1687,7 @@ class File < IO
   #
   # See also Dir::rmdir.
   #
-  def self.unlink: (*string | _ToPath file_name) -> Integer
+  def self.unlink: (*path file_name) -> Integer
 
   # <!--
   #   rdoc-file=file.c
@@ -1681,7 +1698,7 @@ class File < IO
   # than the link itself; for the inverse behavior see File.lutime. Returns the
   # number of file names in the argument list.
   #
-  def self.utime: (Time | Numeric atime, Time | Numeric mtime, *string | _ToPath file_name) -> Integer
+  def self.utime: (Time | Numeric atime, Time | Numeric mtime, *path file_name) -> Integer
 
   # <!--
   #   rdoc-file=file.c
@@ -1697,7 +1714,7 @@ class File < IO
   #     m = File.world_readable?("/etc/passwd")
   #     sprintf("%o", m)                              #=> "644"
   #
-  def self.world_readable?: (string | _ToPath | IO file_name) -> Integer?
+  def self.world_readable?: (path | IO file_name) -> Integer?
 
   # <!--
   #   rdoc-file=file.c
@@ -1713,7 +1730,7 @@ class File < IO
   #     m = File.world_writable?("/tmp")
   #     sprintf("%o", m)                              #=> "777"
   #
-  def self.world_writable?: (string | _ToPath | IO file_name) -> Integer?
+  def self.world_writable?: (path | IO file_name) -> Integer?
 
   # <!--
   #   rdoc-file=file.c
@@ -1725,7 +1742,7 @@ class File < IO
   # Note that some OS-level security features may cause this to return true even
   # though the file is not writable by the effective user/group.
   #
-  def self.writable?: (string | _ToPath file_name) -> bool
+  def self.writable?: (path file_name) -> bool
 
   # <!--
   #   rdoc-file=file.c
@@ -1737,7 +1754,7 @@ class File < IO
   # Note that some OS-level security features may cause this to return true even
   # though the file is not writable by the real user/group.
   #
-  def self.writable_real?: (string | _ToPath file_name) -> bool
+  def self.writable_real?: (path file_name) -> bool
 
   # <!--
   #   rdoc-file=file.c
@@ -1747,7 +1764,7 @@ class File < IO
   #
   # *file_name* can be an IO object.
   #
-  def self.zero?: (string | _ToPath | IO file_name) -> bool
+  def self.zero?: (path | IO file_name) -> bool
 
   # <!--
   #   rdoc-file=file.c
@@ -1822,12 +1839,12 @@ class File < IO
   # Returns `false` if `File::LOCK_NB` is specified and the operation would have
   # blocked;
   # otherwise returns `0`.
-  #    Constant    |    Lock    |                                                    Effect
-  # ---------------|------------|--------------------------------------------------------------------------------------------------------------
-  # +File::LOCK_EX+| Exclusive  |                      Only one process may hold an exclusive lock for +self+ at a time.
-  # +File::LOCK_NB+|Non-blocking|No blocking; may be combined with +File::LOCK_SH+ or +File::LOCK_EX+ using the bitwise OR operator <tt>|</tt>.
-  # +File::LOCK_SH+|   Shared   |                 Multiple processes may each hold a shared lock for +self+ at the same time.
-  # +File::LOCK_UN+|   Unlock   |                                Remove an existing lock held by this process.
+  #    Constant    |    Lock    |                                                Effect
+  # ---------------|------------|-------------------------------------------------------------------------------------------------------
+  # `File::LOCK_EX`| Exclusive  |                   Only one process may hold an exclusive lock for `self` at a time.
+  # `File::LOCK_NB`|Non-blocking|No blocking; may be combined with `File::LOCK_SH` or `File::LOCK_EX` using the bitwise OR operator `|`.
+  # `File::LOCK_SH`|   Shared   |              Multiple processes may each hold a shared lock for `self` at the same time.
+  # `File::LOCK_UN`|   Unlock   |                             Remove an existing lock held by this process.
   # Example:
   #     # Update a counter using an exclusive lock.
   # # Don't use File::WRONLY because it truncates the file.
@@ -2429,10 +2446,8 @@ class File::Stat < Object
 
   # <!--
   #   rdoc-file=file.c
-  #   - new(p1)
+  #   - File::Stat.new(file_name)  -> stat
   # -->
-  # File::Stat.new(file_name)  -> stat
-  #
   # Create a File::Stat object for the given file name (raising an exception if
   # the file doesn't exist).
   #
@@ -2440,16 +2455,31 @@ class File::Stat < Object
 
   # <!--
   #   rdoc-file=file.c
-  #   - stat <=> other_stat    -> -1, 0, 1, nil
+  #   - self <=> other -> -1, 0, 1, or nil
   # -->
-  # Compares File::Stat objects by comparing their respective modification times.
+  # Compares `self` and `other`, by comparing their modification times; that is,
+  # by comparing `self.mtime` and `other.mtime`.
+  #
+  # Returns:
   #
-  # `nil` is returned if `other_stat` is not a File::Stat object
+  # *   `-1`, if `self.mtime` is earlier.
+  # *   `0`, if the two values are equal.
+  # *   `1`, if `self.mtime` is later.
+  # *   `nil`, if `other` is not a File::Stat object.
+  #
+  # Examples:
   #
-  #     f1 = File.new("f1", "w")
-  #     sleep 1
-  #     f2 = File.new("f2", "w")
-  #     f1.stat <=> f2.stat   #=> -1
+  #     stat0 = File.stat('README.md')
+  #     stat1 = File.stat('NEWS.md')
+  #     stat0.mtime         # => 2025-12-20 15:33:05.6972341 -0600
+  #     stat1.mtime         # => 2025-12-20 16:02:08.2672945 -0600
+  #     stat0 <=> stat1     # => -1
+  #     stat0 <=> stat0.dup # => 0
+  #     stat1 <=> stat0     # => 1
+  #     stat0 <=> :foo      # => nil
+  #
+  # Class File::Stat includes module Comparable, each of whose methods uses
+  # File::Stat#<=> for comparison.
   #
   def <=>: (File::Stat other) -> Integer
          | (untyped) -> nil

data/core/file_test.rbs

@@ -145,7 +145,7 @@ module FileTest
   #   rdoc-file=file.c
   #   - File.owned?(file_name)   -> true or false
   # -->
-  # Returns `true` if the named file exists and the effective used id of the
+  # Returns `true` if the named file exists and the effective user id of the
   # calling process is the owner of the file.
   #
   # *file_name* can be an IO object.