doc/go1.1.html: state that the heap is bigger on 64-bit machines

Be deliberately vague, since the precise details should not be depended upon.
Fixes #5155.

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

diff --git a/doc/go1.1.html b/doc/go1.1.html
index dfd9e65340e65c126e7791dd48c6f7bfaac9fee1..578d6e901c9c74a99d1ca2f6980df10d4af74119 100644 (file)
--- a/doc/go1.1.html
+++ b/doc/go1.1.html
@@ -201,6 +201,24 @@ would instead say:
 i := int(int32(x))
 </pre>
 
+<h3 id="heap">Heap size on 64-bit architectures</h3>
+
+<p>
+On 64-bit architectures only, the maximum heap size has been enlarged substantially,
+from a few gigabytes to several tens of gigabytes.
+(The exact details depend on the system and may change.)
+</p>
+
+<p>
+On 32-bit architectures, the heap size has not changed.
+</p>
+
+<p>
+<em>Updating</em>:
+This change should have no effect on existing programs beyond allowing them
+to run with larger heaps.
+</p>
+
 <h3 id="unicode">Unicode</h3>
 
 <p>