Commit 4f5fa959aa

@@ -859,8 +859,10 @@ pub fn streamDelimiter(r: *Reader, w: *Writer, delimiter: u8) StreamError!usize
 /// Appends to `w` contents by reading from the stream until `delimiter` is found.
 /// Does not write the delimiter itself.
 ///
-/// Returns number of bytes streamed, which may be zero. End of stream can be
-/// detected by checking if the next byte in the stream is the delimiter.
+/// Returns number of bytes streamed, which may be zero. If the stream reaches
+/// the end, the reader buffer will be empty when this function returns.
+/// Otherwise, it will have at least one byte buffered, starting with the
+/// delimiter.
 ///
 /// Asserts buffer capacity of at least one. This function performs better with
 /// larger buffers.