[io grant] Document &*chdir

Hoping there won't any be 'splosions due to the `&*` in
the routine's name.

Author: zoffixznet

doc/Type/IO.pod6

@@ -39,6 +39,29 @@ By default, only C<:d> test is performed.
     chdir :r, :w '/tmp'; # … check its .r and .w are True
     chdir '/not-there';  # returns Failure
 
+=head2 sub &*chdir
+
+Defined as:
+
+    sub &*chdir(IO() $path --> IO::Path:D)
+
+Changes value of C<$*CWD> variable to the provided C<$path> and sets
+the process's current directory to the value of
+L«C<$path.absolute>|/routine/absolute». B<NOTE:> that in most cases,
+you want to use L«C<chdir>|/routine/chdir» routine instead.
+
+Returns L«C<IO::Path>|/type/IO::Path»
+representing new C<$*CWD> on success. On failure, returns
+L«C<Failure>|/type/Failure» and leaves C<$*CWD> untouched.
+The C<$path> can be any any object with an IO method that returns an
+L«C<IO::Path>|/type/IO::Path» object.
+
+Note that unlike regular L«C<chdir>|/routine/chdir», there are no arguments
+to specify which file tests to perform.
+
+    &*chdir('/tmp');  # change $*CWD and process's current directory to '/tmp'
+    &*chdir('/not-there'); # returns Failure
+
 =head2 sub print
 
 Print the given text on C<$*OUT> (standard output), e.g.: