From: Rob Pike <r@golang.org>
Date: Wed, 8 Feb 2012 20:09:52 +0000 (+1100)
Subject: doc/go1: mention that the compiler catches TotalSize and NewReaderSize
X-Git-Tag: weekly.2012-02-14~209
X-Git-Url: http://www.git.cypherpunks.su/?a=commitdiff_plain;h=cf80ccd8f666a839466af874aefa0ee02c58efdc;p=gostls13.git

doc/go1: mention that the compiler catches TotalSize and NewReaderSize
Today is Size day and the compiler will reject old code using these functions.

R=golang-dev, rsc
CC=golang-dev
https://golang.org/cl/5644053
---

diff --git a/doc/go1.html b/doc/go1.html
index 7613c38805..28f17f1b5d 100644
--- a/doc/go1.html
+++ b/doc/go1.html
@@ -875,8 +875,7 @@ If the argument size is too small or invalid, it is adjusted.
 
 <p>
 <em>Updating</em>:
-These functions are rarely used, and code must be updated by hand.
-All that is required is to drop the second return value.
+What little code is affected will be caught by the compiler and must be updated by hand.
 </p>
 
 <h3 id="crypto_elliptic">The crypto/elliptic package</h3>
@@ -937,7 +936,7 @@ In Go 1, the <code>binary.TotalSize</code></a> function is no longer exported.
 
 <p>
 <em>Updating</em>:
-Code that depends on the function will need to be updated.
+What little code is affected will be caught by the compiler and must be updated by hand.
 </p>
 
 <h3 id="encoding_xml">The encoding/xml package</h3>
diff --git a/doc/go1.tmpl b/doc/go1.tmpl
index f6e69e6ca2..6375ebcc00 100644
--- a/doc/go1.tmpl
+++ b/doc/go1.tmpl
@@ -779,8 +779,7 @@ If the argument size is too small or invalid, it is adjusted.
 
 <p>
 <em>Updating</em>:
-These functions are rarely used, and code must be updated by hand.
-All that is required is to drop the second return value.
+What little code is affected will be caught by the compiler and must be updated by hand.
 </p>
 
 <h3 id="crypto_elliptic">The crypto/elliptic package</h3>
@@ -841,7 +840,7 @@ In Go 1, the <code>binary.TotalSize</code></a> function is no longer exported.
 
 <p>
 <em>Updating</em>:
-Code that depends on the function will need to be updated.
+What little code is affected will be caught by the compiler and must be updated by hand.
 </p>
 
 <h3 id="encoding_xml">The encoding/xml package</h3>