stdlib/pathname/0/pathname.rbs in rbs-3.0.0.dev.2 vs stdlib/pathname/0/pathname.rbs in rbs-3.0.0.dev.3

@@ -133,10 +133,11 @@
 # *   #stat
 # *   #lstat
 # *   #make_symlink(old)
 # *   #truncate(length)
 # *   #utime(atime, mtime)
+# *   #lutime(atime, mtime)
 # *   #basename(*args)
 # *   #dirname
 # *   #extname
 # *   #expand_path(*args)
 # *   #split
@@ -228,11 +229,13 @@
 
   # <!--
   #   rdoc-file=ext/pathname/lib/pathname.rb
   #   - +(other)
   # -->
-  # Appends a pathname fragment to `self` to produce a new Pathname object.
+  # Appends a pathname fragment to `self` to produce a new Pathname object. Since
+  # `other` is considered as a path relative to `self`, if `other` is an absolute
+  # path, the new Pathname object is created from just `other`.
   #
   #     p1 = Pathname.new("/usr")      # Pathname:/usr
   #     p2 = p1 + "bin/ruby"           # Pathname:/usr/bin/ruby
   #     p3 = p1 + "/etc/passwd"        # Pathname:/etc/passwd
   #
@@ -806,11 +809,13 @@
 
   # <!--
   #   rdoc-file=ext/pathname/lib/pathname.rb
   #   - join(*args)
   # -->
-  # Joins the given pathnames onto `self` to create a new Pathname object.
+  # Joins the given pathnames onto `self` to create a new Pathname object. This is
+  # effectively the same as using Pathname#+ to append `self` and all arguments
+  # sequentially.
   #
   #     path0 = Pathname.new("/usr")                # Pathname:/usr
   #     path0 = path0.join("bin/ruby")              # Pathname:/usr/bin/ruby
   #         # is the same as
   #     path1 = Pathname.new("/usr") + "bin/ruby"   # Pathname:/usr/bin/ruby
@@ -847,10 +852,22 @@
   #
   def lstat: () -> ::File::Stat
 
   # <!--
   #   rdoc-file=ext/pathname/pathname.c
+  #   - lutime(p1, p2)
+  # -->
+  # Update the access and modification times of the file.
+  #
+  # Same as Pathname#utime, but does not follow symbolic links.
+  #
+  # See File.lutime.
+  #
+  def lutime: (Time | Numeric atime, Time | Numeric mtime) -> Integer
+
+  # <!--
+  #   rdoc-file=ext/pathname/pathname.c
   #   - pathname.make_link(old)
   # -->
   # Creates a hard link at *pathname*.
   #
   # See File.link.
@@ -1089,14 +1106,14 @@
   #
   def rmdir: () -> 0
 
   # <!--
   #   rdoc-file=ext/pathname/lib/pathname.rb
-  #   - rmtree()
+  #   - rmtree(noop: nil, verbose: nil, secure: nil)
   # -->
   # Recursively deletes a directory, including all directories beneath it.
   #
-  # See FileUtils.rm_r
+  # See FileUtils.rm_rf
   #
   def rmtree: () -> void
 
   # <!--
   #   rdoc-file=ext/pathname/lib/pathname.rb