[IO::Path] Track method/attribute name changes

Author: moritz

lib/Type/IO/Path.pod

@@ -28,10 +28,10 @@ unless when stated otherwise.
 =head2 method new
 
     multi method new(Str:D $path)
-    multi method new(:$basename!, :$directory = '.', :$volume = '')
+    multi method new(:$basename!, :$dirname = '.', :$volume = '')
 
 Creates a new IO::Path object from a path string (which is being parsed for
-volume, directory and basename), or from volumen, directory and basename
+volume, directory name and basename), or from volume, directory name and basename
 passed as named arguments.
 
 =head2 method abspath
@@ -47,14 +47,14 @@ the file relative to to its directory.
 
     say IO::Path.new("/etc/passwd").basename;   # passwd
 
-=head2 method directory
+=head2 method dirname
 
-    method directory(IO::Path:D)
+    method dirname(IO::Path:D)
 
-Returns the directory portion of the path object. That is, it returns the path
+Returns the directory name portion of the path object. That is, it returns the path
 excluding the volume and the base name.
 
-    say IO::Path.new("/etc/passwd").directory;  # /etc
+    say IO::Path.new("/etc/passwd").dirname;    # /etc
 
 =head2 method volume
 
@@ -69,11 +69,11 @@ the empty string.
 
     method parts(IO::Path:D) returns Hash
 
-Returns a hash with the keys C<directory>, C<path> and C<volume>, and as
+Returns a hash with the keys C<dirname>, C<path> and C<volume>, and as
 values the return values of the methods with the same names.
 
     say IO::Path.new("/etc/passwd").parts.perl
-    # ("directory" => "/etc", "volume" => "", "basename" => "passwd").hash
+    # ("dirname" => "/etc", "volume" => "", "basename" => "passwd").hash
 
 =head2 method path
 
@@ -126,9 +126,9 @@ Returns a new C<IO::Path> object that is an absolute path, based on C<$base>.
 
 Returns a new C<IO::Path> object relative to the C<$base> path.
 
-=head2 method contents
+=head2 method dir
 
-    method contents(IO::Path:D: Mu :$test = none('.', '..'))
+    method dir(IO::Path:D: Mu :$test = none('.', '..'))
 
 Tries to interpret the path as a directory, and returns a lazy list of
 C<IO::Path> objects that match the C<$test> smart-matcher.
@@ -143,7 +143,7 @@ An example that lists all files and directories recursively:
     sub MAIN($dir = '.') {
         my @todo = $dir.path;
         while @todo {
-            for @todo.pop.contents -> $path {
+            for @todo.pop.dir -> $path {
                 say $path.Str;
                 @todo.push: $path if $path.d;
             }