[io grant] Finish up IO::Path.dir docs

- Fix up formatting
- Mention `test` tests against Str names, not IO::Paths
- Use proper $*HOME instead of env var and don't stringify IO::Paths

doc/Type/IO/Path.pod6

@@ -401,7 +401,8 @@ Defined as:
 
 Returns the contents of a directory as a lazy list of C<IO::Path> objects
 representing relative paths, filtered by L<smart-matching|
-/language/operators#infix_~~> their names against the C<:test> parameter.
+/language/operators#infix_~~> their names (as strings) against the C<:test>
+parameter.
 
 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
@@ -414,6 +415,7 @@ control over closing dir handles.
 
 Examples:
 
+=begin code :skip-test
     # To iterate over the contents of the current directory:
     for dir() -> $file {
         say $file;
@@ -426,8 +428,8 @@ Examples:
     }
 
     # To get the names of all .jpg and .jpeg files in ~/Downloads:
-=for code :skip-test
-my @jpegs = "%*ENV<HOME>/Downloads".IO.dir(test => /:i '.' jpe?g $/)».Str;
+    my @jpegs = $*HOME.dir: test => /:i '.' jpe?g $/;
+=end
 
 =comment TODO: Turn the following into a FAQ entry, and link to it from here.