[io grant] Write docs for all spurt routines

- Reflect changes in &spurt
- Document all the args in IO::Path.spurt
- Document newly-added IO::Handle.spurt

Impl: rakudo/rakudo@099512b20c
Tests: Raku/roast@79ff022881

Author: zoffixznet

doc/Type/IO.pod6

@@ -353,24 +353,13 @@ exist, or is a directory.
 
 =head2 sub spurt
 
-=for code :skip-test
-sub spurt($where, $what,
-    Str  :$enc        = 'utf8',
-    Bool :$bin        = False,
-    Bool :$append      = False,
-    Bool :$createonly = False
-    --> Bool )
-
-Writes the indicated contents (2nd positional parameter, C<$what>) to the
-location indicated by the first positional parameter, C<$where> (which can
-either be a string or an C<IO::Path> object).  To write to an C<IO::Handle>,
-use the L<print> method.
-
-If a file needs to be opened for writing, it will also be C<close>d.  Returns
-C<True> on success, or the appropriate C<Failure> if something went wrong.
-
-These named parameters are optional and only have meaning if the first
-positional parameter was B<not> an C<IO::Handle>:
+Defined as:
+
+    multi slurp(IO() $path, |c)
+
+The C<$path> can be any object with an IO method that returns an
+L«C<IO::Path>|/type/IO::Path» object. Calls L«C<IO::Path.spurt>|/routine/spurt»
+on the C<$path>, forwarding any of the remaining arguments.
 
 =head3 Options
 

doc/Type/IO/Handle.pod6

@@ -88,6 +88,20 @@ on strings.
 my $fh = open 'path/to/file', :r;
 $fn.split(' ', close => True); # Returns file content split by a space and closes file;
 
+=head2 method spurt
+
+    multi method spurt(IO::Handle:D: Blob $data, :$close = False)
+    multi method spurt(IO::Handle:D: Cool $data, :$close = False)
+
+Writes all of the C<$data> into the filehandle, closing it when finished,
+if C<$close> is C<True>. For L«C<Cool>|/type/Cool» C<$data>, will use the
+encoding the handle is set to use (L«C<IO::Handle.open>|/routine/open»
+or L«C<IO::Handle.encoding>|/routine/encoding»).
+
+Behaviour for spurting a L«C<Cool>|/type/Cool» when the handle is in binary
+mode or spurting a L«C<Blob>|/type/Blob» when the handle is NOT in binary
+mode is undefined.
+
 =head2 method comb
 
     multi method comb(IO::Handle:D: :$close = False)

doc/Type/IO/Path.pod6

@@ -321,12 +321,23 @@ Returns C<Bool::True> if the invocant is a path and the size is 0.
 
 Return the file content for this path, like L<slurp|/routine/slurp>.
 
-=head2 routine spurt
+=head2 method spurt
 
-    multi method spurt(IO::Path:D: Blob $contents, :$bin, |c)
-    multi method spurt(IO::Path:D: Cool $contents, :$bin, |c)
+    method spurt(IO::Path:D: $data, :$enc, :$append, :$createonly)
 
-Write C<$contents> to this path, like L<spurt|/routine/spurt>.
+Opens the file path for writing, and writes all of the C<$data> into it.
+Will L«C<fail>|/routine/fail» if it cannot succeed for any reason.
+The C<$data> can be any L«C<Cool>|/type/Cool» type or any L«C<Blob>|/type/Blob»
+type. Arguments are as follows:
+
+=item C<:$enc> — character encoding of the data. Takes same values as C<:$enc>
+in L«C<IO::Handle.open>|/routine/open». Defaults to C<utf8>. Ignored if C<$data>
+is a L«C<Blob>|/type/Blob».
+
+=item C<:$append> — open the file in C<append> mode, preserving existing
+contents, and appending data to the end of the file.
+
+=item C<:$createonly> — L«C<fail>|/routine/fail» if the file already exists.
 
 =head2 routine chdir