Merge pull request #2475 from perl6/frithnanth-patch-1

Add documentation to the test argument of sub/method dir

Author: JJ

doc/Type/IO/Path.pod6

@@ -504,6 +504,16 @@ representing relative paths, filtered by L<smartmatching|
 /language/operators#infix_~~> their names (as strings) against the C<:test>
 parameter.
 
+Since the tests are performed against Str arguments, not IO, the tests are
+executed in the C<$*CWD>, instead of the target directory.
+When testing against file test operators, this won't work:
+
+    dir('mydir', test => { .IO.d })
+
+while this will:
+
+    dir('mydir', test => { "mydir/$_".IO.d })
+
 B<NOTE:> a C<dir> call opens a directory for reading, which counts towards
 maximum per-process open files for your program. Be sure to exhaust returned
 L<Seq> before doing something like recursively performing more C<dir> calls.