[io grant] Straighten up file test docs

Author: zoffixznet

doc/Type/IO/Path.pod6

@@ -380,73 +380,92 @@ my $perl-files = gather while @stack {
 
 =head2 method e
 
-    method e(--> Bool)
+    method e(--> Bool:D)
 
-Returns C<Bool::True> if the invocant is a valid path that exists.
+Returns C<True> if the invocant is a path that exists.
 
 =head2 method d
 
-    method d(--> Bool)
+    method d(--> Bool:D)
 
-Returns C<Bool::True> if the invocant is a path and the directory exists.
+Returns C<True> if the invocant is a path that exists and is a directory.
+The method will L«C<fail>|/routine/fail» with C<X::IO::DoesNotExist> if the
+path points to a non-existent object.
 
 =head2 method f
 
-    method f(--> Bool)
+    method f(--> Bool:D)
 
-Returns C<Bool::True> if the invocant is a path and the file exists.
+Returns C<True> if the invocant is a path that exists and is a file.
+The method will L«C<fail>|/routine/fail» with C<X::IO::DoesNotExist> if the
+path points to a non-existent object.
 
 =head2 method s
 
-    method s(--> Int)
+    method s(--> Int:D)
 
-If the path is valid and points to a regular file the size of that file
-in bytes is returned. If the path is valid but pointing to something which
-is not a file, e.g. a directory, a L<X::IO::NotAFile> exception is thrown.
-An exception is also thrown if the path is invalid, in that case the exception
-type is L<X::IO::DoesNotExist>.
+Returns the filesize in bytes. May be called on paths that are directories, in
+which case the reported size is dependant on the operating system.
+The method will L«C<fail>|/routine/fail» with C<X::IO::DoesNotExist> if the
+path points to a non-existent object.
 
 =head2 method l
 
-    method l(--> Bool)
+    method l(--> Bool:D)
 
-Returns C<Bool::True> if the invocant is a path and a symlink.
+Returns C<True> if the invocant is a path that exists and is a symlink.
+The method will L«C<fail>|/routine/fail» with C<X::IO::DoesNotExist> if the
+path points to a non-existent object.
 
 =head2 method r
 
-    method r(--> Bool)
+    method r(--> Bool:D)
 
-Returns C<Bool::True> if the invocant is a path and accessible.
+Returns C<True> if the invocant is a path that exists and is accessible.
+The method will L«C<fail>|/routine/fail» with C<X::IO::DoesNotExist> if the
+path points to a non-existent object.
 
 =head2 method w
 
-    method w(--> Bool)
+    method w(--> Bool:D)
 
-Returns C<Bool::True> if the invocant is a path and writable.
+Returns C<True> if the invocant is a path that exists and is writable.
+The method will L«C<fail>|/routine/fail» with C<X::IO::DoesNotExist> if the
+path points to a non-existent object.
 
 =head2 method rw
 
-    method rw(--> Bool)
+    method rw(--> Bool:D)
 
-Returns C<Bool::True> if the invocant is a path, readable and writable.
+Returns C<True> if the invocant is a path that exists and is readable and
+writable. The method will L«C<fail>|/routine/fail» with C<X::IO::DoesNotExist>
+if the path points to a non-existent object.
 
 =head2 method x
 
-    method x(--> Bool)
+    method x(--> Bool:D)
 
-Returns C<Bool::True> if the invocant is a path and executable.
+Returns C<True> if the invocant is a path that exists and is executable.
+The method will L«C<fail>|/routine/fail» with C<X::IO::DoesNotExist> if the
+path points to a non-existent object.
 
 =head2 method rwx
 
-    method rwx(--> Bool)
+    method rwx(--> Bool:D)
 
-Returns C<Bool::True> if the invocant is a path, executable, readable and writable.
+Returns C<True> if the invocant is a path that exists and is executable,
+readable, and writable. The method will L«C<fail>|/routine/fail» with
+C<X::IO::DoesNotExist> if the path points to a non-existent object.
 
 =head2 method z
 
-    method z(--> Bool)
+    method z(--> Bool:D)
 
-Returns C<Bool::True> if the invocant is a path and the size is 0.
+Returns C<True> if the invocant is a path that exists and has size of C<0>.
+May be called on paths that are directories, in
+which case the reported filesize (and thus the result of this method)
+is dependant on the operating system. The method will L«C<fail>|/routine/fail»
+with C<X::IO::DoesNotExist> if the path points to a non-existent object.
 
 =head2 routine slurp