update markdown

imports.md

@@ -331,14 +331,21 @@ let _ = this.check-write();         // eliding error handling
 </ul>
 <h4><a name="method_output_stream.splice"><code>[method]output-stream.splice: func</code></a></h4>
 <p>Read from one stream and write to another.</p>
+<p>The behavior of splice is equivelant to:</p>
+<ol>
+<li>calling <code>check-write</code> on the <a href="#output_stream"><code>output-stream</code></a></li>
+<li>calling <code>read</code> on the <a href="#input_stream"><code>input-stream</code></a> with the smaller of the
+<code>check-write</code> permitted length and the <code>len</code> provided to <code>splice</code></li>
+<li>calling <code>write</code> on the <a href="#output_stream"><code>output-stream</code></a> with that read data.</li>
+</ol>
+<p>Any error reported by the call to <code>check-write</code>, <code>read</code>, or
+<code>write</code> ends the splice and reports that error.</p>
 <p>This function returns the number of bytes transferred; it may be less
 than <code>len</code>.</p>
-<p>Unlike other I/O functions, this function blocks until all the data
-read from the input stream has been written to the output stream.</p>
 <h5>Params</h5>
 <ul>
 <li><a name="method_output_stream.splice.self"><code>self</code></a>: borrow&lt;<a href="#output_stream"><a href="#output_stream"><code>output-stream</code></a></a>&gt;</li>
-<li><a name="method_output_stream.splice.src"><code>src</code></a>: own&lt;<a href="#input_stream"><a href="#input_stream"><code>input-stream</code></a></a>&gt;</li>
+<li><a name="method_output_stream.splice.src"><code>src</code></a>: borrow&lt;<a href="#input_stream"><a href="#input_stream"><code>input-stream</code></a></a>&gt;</li>
 <li><a name="method_output_stream.splice.len"><code>len</code></a>: <code>u64</code></li>
 </ul>
 <h5>Return values</h5>
@@ -347,34 +354,16 @@ read from the input stream has been written to the output stream.</p>
 </ul>
 <h4><a name="method_output_stream.blocking_splice"><code>[method]output-stream.blocking-splice: func</code></a></h4>
 <p>Read from one stream and write to another, with blocking.</p>
-<p>This is similar to <code>splice</code>, except that it blocks until at least
-one byte can be read.</p>
+<p>This is similar to <code>splice</code>, except that it blocks until the
+<a href="#output_stream"><code>output-stream</code></a> is ready for writing, and the <a href="#input_stream"><code>input-stream</code></a>
+is ready for reading, before performing the <code>splice</code>.</p>
 <h5>Params</h5>
 <ul>
 <li><a name="method_output_stream.blocking_splice.self"><code>self</code></a>: borrow&lt;<a href="#output_stream"><a href="#output_stream"><code>output-stream</code></a></a>&gt;</li>
-<li><a name="method_output_stream.blocking_splice.src"><code>src</code></a>: own&lt;<a href="#input_stream"><a href="#input_stream"><code>input-stream</code></a></a>&gt;</li>
+<li><a name="method_output_stream.blocking_splice.src"><code>src</code></a>: borrow&lt;<a href="#input_stream"><a href="#input_stream"><code>input-stream</code></a></a>&gt;</li>
 <li><a name="method_output_stream.blocking_splice.len"><code>len</code></a>: <code>u64</code></li>
 </ul>
 <h5>Return values</h5>
 <ul>
 <li><a name="method_output_stream.blocking_splice.0"></a> result&lt;<code>u64</code>, <a href="#stream_error"><a href="#stream_error"><code>stream-error</code></a></a>&gt;</li>
 </ul>
-<h4><a name="method_output_stream.forward"><code>[method]output-stream.forward: func</code></a></h4>
-<p>Forward the entire contents of an input stream to an output stream.</p>
-<p>This function repeatedly reads from the input stream and writes
-the data to the output stream, until the end of the input stream
-is reached, or an error is encountered.</p>
-<p>Unlike other I/O functions, this function blocks until the end
-of the input stream is seen and all the data has been written to
-the output stream.</p>
-<p>This function returns the number of bytes transferred, and the status of
-the output stream.</p>
-<h5>Params</h5>
-<ul>
-<li><a name="method_output_stream.forward.self"><code>self</code></a>: borrow&lt;<a href="#output_stream"><a href="#output_stream"><code>output-stream</code></a></a>&gt;</li>
-<li><a name="method_output_stream.forward.src"><code>src</code></a>: own&lt;<a href="#input_stream"><a href="#input_stream"><code>input-stream</code></a></a>&gt;</li>
-</ul>
-<h5>Return values</h5>
-<ul>
-<li><a name="method_output_stream.forward.0"></a> result&lt;<code>u64</code>, <a href="#stream_error"><a href="#stream_error"><code>stream-error</code></a></a>&gt;</li>
-</ul>