From: Russ Cox <rsc@golang.org>
Date: Thu, 26 Nov 2015 16:45:50 +0000 (-0500)
Subject: bufio: clarify Read docs
X-Git-Tag: go1.6beta1~254
X-Git-Url: http://www.git.cypherpunks.su/?a=commitdiff_plain;h=829425d3ce34615726de2c91725c891393370879;p=gostls13.git

bufio: clarify Read docs

Or at least make them true.

Fixes #12237.

Change-Id: I3c92a07233b2174c5731d6fa7fbb9ca3a97beb6b
Reviewed-on: https://go-review.googlesource.com/17237
Reviewed-by: Brad Fitzpatrick <bradfitz@golang.org>
---

diff --git a/src/bufio/bufio.go b/src/bufio/bufio.go
index 3bbb933df3..6a70f7034d 100644
--- a/src/bufio/bufio.go
+++ b/src/bufio/bufio.go
@@ -179,7 +179,7 @@ func (b *Reader) Discard(n int) (discarded int, err error) {
 
 // Read reads data into p.
 // It returns the number of bytes read into p.
-// It calls Read at most once on the underlying Reader,
+// The bytes are taken from at most one Read on the underlying Reader,
 // hence n may be less than len(p).
 // At EOF, the count will be zero and err will be io.EOF.
 func (b *Reader) Read(p []byte) (n int, err error) {