[Bug #827209] Add footnote from Alex M. about listcomps leaking their index variables

diff --git a/Doc/ref/ref5.tex b/Doc/ref/ref5.tex
index 27127adc867cf5c63f4ece9437a3a26542303c3a..093192026cdd12e0c5bba1542edce52b3a0a91b7 100644 (file)
--- a/Doc/ref/ref5.tex
+++ b/Doc/ref/ref5.tex
@@ -184,7 +184,11 @@ case, the elements of the new list are those that would be produced
 by considering each of the \keyword{for} or \keyword{if} clauses a block,
 nesting from
 left to right, and evaluating the expression to produce a list element
-each time the innermost block is reached.
+each time the innermost block is reached\footnote{In Python 2.3, a
+list comprehension "leaks" the control variables of each
+\samp{for} it contains into the containing scope.  However, this
+behavior is deprecated, and relying on it will not work once this
+bug is fixed in a future release}.
 \obindex{list}
 \indexii{empty}{list}