From: Daniel Martí <mvdan@mvdan.cc>
Date: Thu, 20 Feb 2020 20:44:18 +0000 (+0000)
Subject: doc/go1.14: document the change to json.Number decoding
X-Git-Tag: go1.15beta1~1158
X-Git-Url: http://www.git.cypherpunks.su/?a=commitdiff_plain;h=ae7cd5c029927e41b50170e5059b6b896c3d779a;p=gostls13.git

doc/go1.14: document the change to json.Number decoding

It might break a program if it was depending on undocumented behavior.
Give a proper heads up.

Fixes #37308.

Change-Id: Id65bc70def1138d5506b694329c52250b417ec6f
Reviewed-on: https://go-review.googlesource.com/c/go/+/220418
Reviewed-by: Bryan C. Mills <bcmills@google.com>
---

diff --git a/doc/go1.14.html b/doc/go1.14.html
index f83b365704..6355337a83 100644
--- a/doc/go1.14.html
+++ b/doc/go1.14.html
@@ -582,6 +582,13 @@ appropriately.)
       was never a documented feature. For proper escaping, see <a
       href="/pkg/encoding/json/#HTMLEscape"><code>HTMLEscape</code></a>.
     </p>
+
+    <p><!-- CL 195045 -->
+      <a href="/pkg/encoding/json/#Number"><code>Number</code></a> no longer
+      accepts invalid numbers, to follow the documented behavior more closely.
+      If a program needs to accept invalid numbers like the empty string,
+      consider wrapping the type with <a href="/pkg/encoding/json/#Unmarshaler"><code>Unmarshaler</code></a>.
+    </p>
   </dd>
 </dl><!-- encoding/json -->