Add link/symlink

Author: jonathanstowe

lib/Type/IO/Path.pod

@@ -252,6 +252,24 @@ device).
 
 B<NOTE>: This function has not yet been implemented in Rakudo.
 
+=head2 routine symlink
+
+    method symlink(IO::Path:D: Str $name --> Bool);
+    sub    symlink(Str $target, Str $name --> Bool);
+
+Create a new symbolic link named as $target (or the name of the invocant in the method form,) to the existing file named C<$name>.  
+
+Both forms will return C<True> on success or L<fail|/routine/fail> with L<X::IO::Symlink> if the symbolic link could not be created.
+
+=head2 routine link
+
+    method link(IO::Path:D: Str $name --> Bool);
+    sub    link(Str $target, Str $name --> Bool);
+
+Create a new link named as $target (or the name of the invocant in the method form,) to the existing file named C<$name>.  
+
+Both forms will return C<True> on success or L<fail|/routine/fail> with L<X::IO::Link> if the link operation could not be performed.
+
 =head2 routine unlink
 
     method unlink(IO::Path:D: --> Bool);