Merge branch 'master' of github.com:perl6/specs

S32-setting-library/IO.pod

@@ -63,6 +63,16 @@ than C<Str> types.
 
 TODO: document read/write/append modes (:r, :w, :a)
 
+=item dir
+X<dir>
+
+    multi dir($directory = '.', Mu :$test = none('.', '..')) { ... }
+
+Returns a lazy list of file names in the C<$directory>. By default the current
+and the parent directory are excluded, which can be controlled with the
+C<$test> named paramater. Only items that smart-match against this test are
+returned.
+
 =item getc
 X<getc>