summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorNick Coghlan <ncoghlan@gmail.com>2012-06-07 12:41:34 (GMT)
committerNick Coghlan <ncoghlan@gmail.com>2012-06-07 12:41:34 (GMT)
commita3a164a03c78d66539f4fe9abf8d1dd5c08babaa (patch)
tree0135fcb3eec947333af8b5587c87756e0e1346ad
parent58f07a9d6d2aa7b5d624ef23cc89c99071fa249f (diff)
downloadcpython-a3a164a03c78d66539f4fe9abf8d1dd5c08babaa.zip
cpython-a3a164a03c78d66539f4fe9abf8d1dd5c08babaa.tar.gz
cpython-a3a164a03c78d66539f4fe9abf8d1dd5c08babaa.tar.bz2
Nudge readers towards a more accurate mental model for loop else clauses
-rw-r--r--Doc/tutorial/controlflow.rst7
1 files changed, 7 insertions, 0 deletions
diff --git a/Doc/tutorial/controlflow.rst b/Doc/tutorial/controlflow.rst
index 5ed5aea..902f2bd 100644
--- a/Doc/tutorial/controlflow.rst
+++ b/Doc/tutorial/controlflow.rst
@@ -187,6 +187,13 @@ following loop, which searches for prime numbers::
(Yes, this is the correct code. Look closely: the ``else`` clause belongs to
the :keyword:`for` loop, **not** the :keyword:`if` statement.)
+When used with a loop, the ``else`` clause has more in common with the
+``else`` clause of a :keyword:`try` statement than it does that of
+:keyword:`if` statements: a :keyword:`try` statement's ``else`` clause runs
+when no exception occurs, and a loop's ``else`` clause runs when no ``break``
+occurs. For more on the :keyword:`try` statement and exceptions, see
+:ref:`tut-handling`.
+
.. _tut-pass: