[New-bugs-announce] [issue11669] Clarify Lang Ref "Compound statements" footnote

[Graham Wideman]

New submission from Graham Wideman <initcontact at grahamwideman.com>:

In Language Ref section 7 "Compound Statements":
http://docs.python.org/release/3.1.3/reference/compound_stmts.html
there's a footnote regarding what happens to unhandled exceptions in a try-except statement:

[1] The exception is propagated to the invocation stack only if there is no *finally* clause that negates the exception.

This is very unclearly worded, especially since the reader in need of this footnote is probably familiar with the *except* clause being the one to "negate" an exception, and may well think this footnote is in error.  This footnote could provide a more convincing explanation: 

[1] The exception is propagated to the invocation stack unless there is a finally clause which happens to raise another exception. That new exception causes the old exception to be lost.

----------
assignee: docs at python
components: Documentation
messages: 132072
nosy: docs at python, gwideman
priority: normal
severity: normal
status: open
title: Clarify Lang Ref "Compound statements" footnote
type: behavior
versions: Python 2.5, Python 2.6, Python 2.7, Python 3.1, Python 3.2, Python 3.3, Python 3.4

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue11669>
_______________________________________