From: Miss Islington (bot) <31488909+miss-islington@users.noreply.github.com> Date: Tue, 2 Sep 2025 15:10:30 +0000 (+0200) Subject: [3.13] gh-138297 Point link in docs for `finally` to try/else, instead of if/else... X-Git-Tag: v3.13.8~130 X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=f88bf2ce0db49ce8cc3d7355a2ddffd1f10e70eb;p=thirdparty%2FPython%2Fcpython.git [3.13] gh-138297 Point link in docs for `finally` to try/else, instead of if/else (GH-138298) (#138382) Co-authored-by: James Parrott <80779630+JamesParrott@users.noreply.github.com> Co-authored-by: Brian Schubert Co-authored-by: Adam Turner <9087854+aa-turner@users.noreply.github.com> --- diff --git a/Doc/reference/compound_stmts.rst b/Doc/reference/compound_stmts.rst index 5bd7e2a5b2c7..06719ad8d6a4 100644 --- a/Doc/reference/compound_stmts.rst +++ b/Doc/reference/compound_stmts.rst @@ -413,12 +413,14 @@ clauses. -------------------------- 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, the saved exception is set as the context of the new exception. +: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, the saved exception +is set as the context of the new exception. If the :keyword:`!finally` clause executes a :keyword:`return`, :keyword:`break` or :keyword:`continue` statement, the saved exception is discarded::