From 49110eaa2203bc59c754bc2534ba11f969e448f6 Mon Sep 17 00:00:00 2001
From: Russ Cox <rsc@golang.org>
Date: Wed, 8 Feb 2012 13:48:03 -0500
Subject: [PATCH] encoding/json: document buffering

Fixes #1955.

R=golang-dev, gri
CC=golang-dev
https://golang.org/cl/5643058
---
 src/pkg/encoding/json/stream.go | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/src/pkg/encoding/json/stream.go b/src/pkg/encoding/json/stream.go
index f247639502..7d1cc5f119 100644
--- 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}
 }
-- 
2.50.0