Tweak description of dir in IO::Path doc

Author: raiph

doc/Type/IO/Path.rakudoc

@@ -462,11 +462,12 @@ platforms, e.g. Windows, since C<resolve> assumes POSIX semantics.
     multi sub dir(IO()       $path, |c)
     method dir(IO::Path:D: Mu :$test = $*SPEC.curupdir)
 
-Returns the contents of a directory as a lazy list of C<IO::Path> objects
-representing relative paths, filtered by
-L<smartmatching|/language/operators#infix_~~> their names (as strings) against
-the C<:test> parameter. The path of returned files will be absolute or
-relative depending on what C<$path> is, and are returned in an arbitrary order.
+Returns a lazy list of C<IO::Path> objects corresponding to the entries in a
+directory, optionally filtered by L<smartmatching|/language/operators#infix_~~>
+their names I<as strings> per the C<:test> parameter. The order in which the
+filesystem returns entries determines the order of the entries/objects in the
+list. Objects corresponding to special directory entries C<.> and C<..> are not
+included. C<$path> determines whether the objects' paths are absolute or relative.
 
 Since the tests are performed against C<Str> arguments, not C<IO>, the tests are
 executed in the C<$*CWD>, instead of the target directory. When testing against