[io grant] Finish off IO::Path.parent

- Add more examples
- Add note about symlinked dirs

Author: zoffixznet

doc/Type/IO/Path.pod6

@@ -414,12 +414,19 @@ attribute the object was created with, and then is made relative to C<$base>.
 
 Defined as:
 
-    method parent(IO::Path:D: --> IO::Path)
-
-Removes the last portion of the path and returns the result as a new C<IO::Path>.
-
-    my $io = IO::Path.new( "/etc/passwd" );
-    say $io.parent;                          # OUTPUT: «"/etc".IO␤»
+    method parent(IO::Path:D: --> IO::Path:D)
+
+Returns the parent path of the invocant. Note that no file system access
+is made, so the returned parent parent is physical and not the logical parent of
+symlinked directories.
+
+    '/etc/foo'.IO.parent.say; # OUTPUT: «"/etc".IO␤»
+    '/etc/..' .IO.parent.say; # OUTPUT: «"/etc".IO␤»
+    '/etc/../'.IO.parent.say; # OUTPUT: «"/etc".IO␤»
+    './'      .IO.parent.say; # OUTPUT: «"..".IO␤»
+    'foo'     .IO.parent.say; # OUTPUT: «".".IO␤»
+    '/'       .IO.parent.say; # OUTPUT: «"/".IO␤»
+    IO::Path::Win32.new('C:/').parent.say; # OUTPUT: «"C:/".IO␤»
 
 =head2 method resolve