From ae13f43810e8afe2b1c68a59b10d93e8522b90e3 Mon Sep 17 00:00:00 2001
From: Ian Lance Taylor <iant@golang.org>
Date: Wed, 13 Jan 2010 12:50:45 -0800
Subject: [PATCH] Clarify when expressions are evaluated for a range clause.

R=gri, rsc
CC=golang-dev
https://golang.org/cl/189057
---
 doc/go_spec.html | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/doc/go_spec.html b/doc/go_spec.html
index f4f2f56a0d3..5243db37da5 100644
--- a/doc/go_spec.html
+++ b/doc/go_spec.html
@@ -3783,7 +3783,12 @@ string or array element or map value.
 The types of the array or slice index (always <code>int</code>)
 and element, or of the map key and value respectively,
 must be <a href="#Assignment_compatibility">assignment compatible</a> with
-the type of the iteration variables.
+the type of the iteration variables.  The expression on the right hand
+side is evaluated once before beginning the loop.  At each iteration
+of the loop, the values produced by the range clause are assigned to
+the left hand side as in an <a href="#Assignments">assignment
+statement</a>.  Function calls on the left hand side will be evaluated
+exactly once per iteration.
 </p>
 <p>
 For strings, the "range" clause iterates over the Unicode code points