changeset: 78566:bef098bd3fa5 branch: 2.7 parent: 78561:e4fe1daef9f7 user: Andrew Svetlov date: Tue Aug 14 15:44:53 2012 +0300 files: Doc/reference/compound_stmts.rst description: Issue #14167: Document return statement in finally blocks. Patch by Yury Selivanov. diff -r e4fe1daef9f7 -r bef098bd3fa5 Doc/reference/compound_stmts.rst --- a/Doc/reference/compound_stmts.rst Tue Aug 14 11:41:19 2012 +0100 +++ b/Doc/reference/compound_stmts.rst Tue Aug 14 15:44:53 2012 +0300 @@ -290,15 +290,28 @@ .. index:: keyword: finally -If :keyword:`finally` is present, it specifies a 'cleanup' handler. The -:keyword:`try` clause is executed, including any :keyword:`except` and -:keyword:`else` clauses. If an exception occurs in any of the clauses and is -not handled, the exception is temporarily saved. The :keyword:`finally` clause -is executed. If there is a saved exception, it is re-raised at the end of the -:keyword:`finally` clause. If the :keyword:`finally` clause raises another -exception or executes a :keyword:`return` or :keyword:`break` statement, the -saved exception is lost. The exception information is not available to the -program during execution of the :keyword:`finally` clause. +If :keyword:`finally` is present, it specifies a 'cleanup' handler. +The :keyword:`try` clause is executed, including any :keyword:`except` +and :keyword:`else` clauses. If an exception occurs in any of the +clauses and is not handled, the exception is temporarily saved. The +:keyword:`finally` clause is executed. If there is a saved exception +or :keyword:`break` statement, it is re-raised at the end of the +:keyword:`finally` clause. If the :keyword:`finally` clause raises +another exception the saved exception is set as the context of the new +exception; if the :keyword:`finally` clause executes a +:keyword:`return` statement, the saved exception is discarded:: + + def f(): + try: + 1/0 + finally: + return 42 + +>>> f() + 42 + +The exception information is not available to the program during execution of +the :keyword:`finally` clause. .. index:: statement: return