encoding/json: document buffering

Fixes #1955.

R=golang-dev, gri
CC=golang-dev
https://golang.org/cl/5643058

diff --git a/src/pkg/encoding/json/stream.go b/src/pkg/encoding/json/stream.go
index f2476395023f74f1dfe49583f61c8ec71ba1c555..7d1cc5f119c5d85454123f914996dab59786a546 100644 (file)
--- a/src/pkg/encoding/json/stream.go
+++ b/src/pkg/encoding/json/stream.go
@@ -19,6 +19,9 @@ type Decoder struct {
 }
 
 // NewDecoder returns a new decoder that reads from r.
+//
+// The decoder introduces its own buffering and may
+// read data from r beyond the JSON values requested.
 func NewDecoder(r io.Reader) *Decoder {
        return &Decoder{r: r}
 }