Skip to content

gh-138297 Point link in docs for finally to try/else, instead of if/else #138298

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 4 commits into from
Sep 2, 2025
Merged

gh-138297 Point link in docs for finally to try/else, instead of if/else #138298

Changes from all commits
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
4aba435
Point link in 8.4.4 (docs for finally) to try/else, instead of if/else
JamesParrott Aug 31, 2025
871a471
Update Doc/reference/compound_stmts.rst
JamesParrott Aug 31, 2025
e442e7b
Merge branch 'main' into patch-1
JamesParrott Sep 2, 2025
ef06809
wrap lines
AA-Turner Sep 2, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
14 changes: 8 additions & 6 deletions Doc/reference/compound_stmts.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -416,12 +416,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 <except_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. For example,
this function returns 42.
Expand Down
Loading