From: Tuo Shan <shantuo@google.com>
Date: Tue, 7 Feb 2017 02:06:40 +0000 (-0800)
Subject: encoding/json: clarify documention for Unmarshal into a pointer.
X-Git-Tag: go1.9beta1~1631
X-Git-Url: http://www.git.cypherpunks.su/?a=commitdiff_plain;h=4fafc843a27940c76f43d0d897d918dab2efd529;p=gostls13.git

encoding/json: clarify documention for Unmarshal into a pointer.

Fixes #18730.

Change-Id: If3ef28e62f7e449d4c8dc1dfd78f7d6f5a87ed26
Reviewed-on: https://go-review.googlesource.com/36478
Reviewed-by: Russ Cox <rsc@golang.org>
---

diff --git a/src/encoding/json/decode.go b/src/encoding/json/decode.go
index 77fc4607db..c815599cd5 100644
--- a/src/encoding/json/decode.go
+++ b/src/encoding/json/decode.go
@@ -22,7 +22,8 @@ import (
 )
 
 // Unmarshal parses the JSON-encoded data and stores the result
-// in the value pointed to by v.
+// in the value pointed to by v. If v is nil or not a pointer,
+// Unmarshal returns an InvalidUnmarshalError.
 //
 // Unmarshal uses the inverse of the encodings that
 // Marshal uses, allocating maps, slices, and pointers as necessary,