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

Author: zoffixznet

doc/Type/IO/Spec/Cygwin.pod6

@@ -106,6 +106,15 @@ Defined as:
 Same as L«C<IO::Spec::Win32.join>|/type/IO::Spec::Win32#method_join», except
 replaces backslashes with slashes in the final result.
 
+=head2 method rel2abs
+
+Defined as:
+
+    method rel2abs(|c --> List:D)
+
+Same as L«C<IO::Spec::Win32.rel2abs>|/type/IO::Spec::Win32#method_rel2abs»,
+except replaces backslashes with slashes in the final result.
+
 =head2 method split
 
 Defined as:

doc/Type/IO/Spec/Unix.pod6

@@ -208,6 +208,33 @@ an empty L<Seq> if C«%*ENV<PATH>» is not set or is an empty string.
     IO::Spec::Unix.path.perl.say;
     # OUTPUT: «("foo", "bar/ber", ".", "foo", ".").Seq␤»
 
+=head2 method rel2abs
+
+Defined as:
+
+    method rel2abs(Str() $path, $base = $*CWD --> Str:D)
+
+Returns a string representing C<$path> converted to absolute path, based at
+C<$base>, which defaults to C<$*CWD>. If C<$base> is not an absolute path,
+it will be made absolute relative to C<$*CWD>, unless C<$*CWD> and C<$base>
+are the same.
+
+=begin code
+    say $*CWD;                                  # OUTPUT: «"/home/camelia".IO␤»
+
+    say IO::Spec::Unix.rel2abs: 'foo';          # OUTPUT: «/home/camelia/foo␤»
+    say IO::Spec::Unix.rel2abs: './';           # OUTPUT: «/home/camelia␤»
+    say IO::Spec::Unix.rel2abs: 'foo/../../';   # OUTPUT: «/home/camelia/foo/../..␤»
+    say IO::Spec::Unix.rel2abs: '/foo/';        # OUTPUT: «/foo␤»
+
+    say IO::Spec::Unix.rel2abs: 'foo', 'bar';   # OUTPUT: «/home/camelia/bar/foo␤»
+    say IO::Spec::Unix.rel2abs: './', '/bar';   # OUTPUT: «/bar␤»
+    say IO::Spec::Unix.rel2abs: '/foo/', 'bar'; # OUTPUT: «/foo␤»
+
+    say IO::Spec::Unix.rel2abs: 'foo/../../', 'bar';
+    # OUTPUT: «/home/camelia/bar/foo/../..␤»
+=end code
+
 =head2 method split
 
 Defined as:

doc/Type/IO/Spec/Win32.pod6

@@ -180,6 +180,33 @@ quotes (C<">) it finds.
     %*ENV<PATH> = 'foo;"bar"/"ber"';
     IO::Spec::Win32.path.perl.say; # OUTPUT: «(".", "foo", "bar/ber").Seq␤»
 
+=head2 method rel2abs
+
+Defined as:
+
+    method rel2abs(Str() $path, $base = $*CWD --> Str:D)
+
+Returns a string representing C<$path> converted to absolute path, based at
+C<$base>, which defaults to C<$*CWD>. If C<$base> is not an absolute path,
+it will be made absolute relative to C<$*CWD>, unless C<$*CWD> and C<$base>
+are the same.
+
+=begin code
+    say $*CWD;                                   # OUTPUT: «"C:\Users\camelia".IO␤»
+
+    say IO::Spec::Win32.rel2abs: 'foo';          # OUTPUT: «C:\Users\camelia\foo␤»
+    say IO::Spec::Win32.rel2abs: './';           # OUTPUT: «C:\Users\camelia␤»
+    say IO::Spec::Win32.rel2abs: 'foo/../../';   # OUTPUT: «C:\Users\camelia\foo\..\..␤»
+    say IO::Spec::Win32.rel2abs: '/foo/';        # OUTPUT: «C:\foo␤»
+
+    say IO::Spec::Win32.rel2abs: 'foo', 'bar';   # OUTPUT: «C:\Users\camelia\bar\foo␤»
+    say IO::Spec::Win32.rel2abs: './', '/bar';   # OUTPUT: «\bar␤»
+    say IO::Spec::Win32.rel2abs: '/foo/', 'bar'; # OUTPUT: «C:\foo␤»
+
+    say IO::Spec::Win32.rel2abs: 'foo/../../', 'bar';
+    # OUTPUT: «C:\Users\camelia\bar\foo\..\..␤»
+=end code
+
 =head2 method split
 
 Defined as: