[io grant] Document IO::Spec::*.canonpath

Author: zoffixznet

doc/Type/IO/Spec/Cygwin.pod6

@@ -23,6 +23,23 @@ Returns a string that represents C<$path>, but relative to C<$base> path.
 Both C<$path> and C<$base> may be relative paths C<$bar> defaults to C<$*CWD>.
 Uses L«C<IO::Spec::Win32>|/type/IO::Spec::Win32»'s semantics.
 
+=head2 method canonpath
+
+    method canonpath(Str() $path, :$parent --> Str:D)
+
+Returns a string that is a canonical representation of C<$path>. If C<:$parent>
+is set to true, will also clean up references to parent directories. B<NOTE:>
+the routine does not access the filesystem.
+
+    IO::Spec::Cygwin.canonpath(｢C:\foo\\..\bar\..\ber｣).say;
+    # OUTPUT: «C:/foo/../bar/../ber␤»
+
+    IO::Spec::Cygwin.canonpath("foo///./../bar/../ber").say;
+    # OUTPUT: «foo/../bar/../ber␤»
+
+    IO::Spec::Cygwin.canonpath("foo///./../bar/../ber", :parent).say;
+    # OUTPUT: «ber␤»
+
 =head2 method tmpdir
 
 Defined as:

doc/Type/IO/Spec/QNX.pod6

@@ -15,6 +15,23 @@ need to use C<IO::Spec::*>. Use L«C<IO::Path>|/type/IO::Path» instead.
 
 =head1 Methods
 
+=head2 method canonpath
+
+    method canonpath(Str() $path, :$parent --> Str:D)
+
+Returns a string that is a canonical representation of C<$path>. If C<:$parent>
+is set to true, will also clean up references to parent directories. B<NOTE:>
+the routine does not access the filesystem, so no symlinks are followed.
+
+    IO::Spec::QNX.canonpath("foo//../bar/../ber").say;
+    # OUTPUT: «foo/../bar/../ber␤»
+
+    IO::Spec::QNX.canonpath("foo///./../bar/../ber").say;
+    # OUTPUT: «foo/../bar/../ber␤»
+
+    IO::Spec::QNX.canonpath("foo///./../bar/../ber", :parent).say;
+    # OUTPUT: «ber␤»
+
 =end pod
 
 # vim: expandtab shiftwidth=4 ft=perl6

doc/Type/IO/Spec/Unix.pod6

@@ -33,6 +33,23 @@ slash:
     IO::Spec::Unix.basename("foo/bar/.").perl.say; # OUTPUT: «"."␤»
     IO::Spec::Unix.basename("foo/bar")  .perl.say; # OUTPUT: «"bar"␤»
 
+=head2 method canonpath
+
+    method canonpath(Str() $path, :$parent --> Str:D)
+
+Returns a string that is a canonical representation of C<$path>. If C<:$parent>
+is set to true, will also clean up references to parent directories. B<NOTE:>
+the routine does not access the filesystem, so no symlinks are followed.
+
+    IO::Spec::Unix.canonpath("foo//../bar/../ber").say;
+    # OUTPUT: «foo/../bar/../ber␤»
+
+    IO::Spec::Unix.canonpath("foo///./../bar/../ber").say;
+    # OUTPUT: «foo/../bar/../ber␤»
+
+    IO::Spec::Unix.canonpath("foo///./../bar/../ber", :parent).say;
+    # OUTPUT: «ber␤»
+
 =head2 method tmpdir
 
 Defined as:

doc/Type/IO/Spec/Win32.pod6

@@ -28,6 +28,23 @@ slash or backslash:
     IO::Spec::Win32.basename("foo/bar/.").perl.say; # OUTPUT: «"."␤»
     IO::Spec::Win32.basename("foo/bar")  .perl.say; # OUTPUT: «"bar"␤»
 
+=head2 method canonpath
+
+    method canonpath(Str() $path, :$parent --> Str:D)
+
+Returns a string that is a canonical representation of C<$path>. If C<:$parent>
+is set to true, will also clean up references to parent directories. B<NOTE:>
+the routine does not access the filesystem.
+
+    IO::Spec::Win32.canonpath("C:/foo//../bar/../ber").say;
+    # OUTPUT: «C:\foo\..\bar\..\ber␤»
+
+    IO::Spec::Win32.canonpath("C:/foo///./../bar/../ber").say;
+    # OUTPUT: «C:\foo\..\bar\..\ber␤»
+
+    IO::Spec::Win32.canonpath("C:/foo///./../bar/../ber", :parent).say;
+    # OUTPUT: «C:\ber␤»
+
 =head2 method tmpdir
 
 Defined as: