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

Author: zoffixznet

doc/Type/IO/Spec/Cygwin.pod6

@@ -51,6 +51,25 @@ and are allowed to contain path separators.
     IO::Spec::Cygwin.catdir(<foo/bar ber perl>).say;
     # OUTPUT: «foo/bar/ber/perl␤»
 
+=head2 method catpath
+
+    method catpath (Str:D $volume, Str:D $dirs, Str:D $file --> Str:D)
+
+Same as L«C<IO::Spec::Win32.catpath>|/type/IO::Spec::Win32#method_catpath»,
+except will also change all backslashes to slashes at the end:
+
+    IO::Spec::Cygwin.catpath('C:', '/some/dir', 'foo.txt').say;
+    # OUTPUT: «C:/some/dir/foo.txt␤»
+
+    IO::Spec::Cygwin.catpath('C:', '/some/dir', '').say;
+    # OUTPUT: «C:/some/dir␤»
+
+    IO::Spec::Cygwin.catpath('', '/some/dir', 'foo.txt').say;
+    # OUTPUT: «/some/dir/foo.txt␤»
+
+    IO::Spec::Cygwin.catpath('E:', '', 'foo.txt').say;
+    # OUTPUT: «E:foo.txt␤»
+
 =head2 method tmpdir
 
 Defined as:

doc/Type/IO/Spec/Unix.pod6

@@ -64,6 +64,18 @@ and are allowed to contain path separators.
 
 Alias for L«C<catdir>|/routine/catdir».
 
+=head2 method catpath
+
+    method catpath ($, Str:D $part1, Str:D $part2 --> Str:D)
+
+Takes two path fragments and concatenates them, adding or removing a path
+separator, if necessary. The first argument is ignored (it exists to maintain
+consistent interface with other C<IO::Spec> types for systems that have
+volumes).
+
+    IO::Spec::Unix.catpath($, 'some/dir', 'and/more').say;
+    # OUTPUT: «some/dir/and/more␤»
+
 =head2 method tmpdir
 
 Defined as:

doc/Type/IO/Spec/Win32.pod6

@@ -60,6 +60,27 @@ and are allowed to contain path separators.
 
 Alias for L«C<catdir>|/routine/catdir».
 
+=head2 method catpath
+
+    method catpath (Str:D $volume, Str:D $dirs, Str:D $file --> Str:D)
+
+Concatenates a path from given volume, a chain of directories, and file.
+An empty string can be given for any of the three arguments. No attempt to
+make the path cannonical is made. Use L«C<canonpath>|/routine/canonpath» for
+that purpose.
+
+    IO::Spec::Win32.catpath('C:', '/some/dir', 'foo.txt').say;
+    # OUTPUT: «C:/some/dir\and/more␤»
+
+    IO::Spec::Win32.catpath('C:', '/some/dir', '').say;
+    # OUTPUT: «C:/some/dir␤»
+
+    IO::Spec::Win32.catpath('', '/some/dir', 'foo.txt').say;
+    # OUTPUT: «/some/dir\foo.txt␤»
+
+    IO::Spec::Win32.catpath('E:', '', 'foo.txt').say;
+    # OUTPUT: «E:foo.txt␤»
+
 =head2 method tmpdir
 
 Defined as: