Visitar URL original
gh-95975: Move except/*/finally ref labels to more precise locations by CAM-Gerlach · Pull Request #95976 · python/cpython · GitHub
Skip to content

gh-95975: Move except/*/finally ref labels to more precise locations #95976

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
ezio-melotti merged 7 commits into from
Oct 2, 2022
Merged

gh-95975: Move except/*/finally ref labels to more precise locations #95976

Changes from 1 commit
Commits
Show all changes
7 commits
Select commit Hold shift + click to select a range
f741f38
gh-95975: Move except/*/finally ref labels to more precise locations
CAM-Gerlach Aug 14, 2022
6a0721d
Add section headers to fix :keyword: role and aid navigation
CAM-Gerlach Aug 14, 2022
b4eca9e
Move see also to the introduction rather than a particular subsection
CAM-Gerlach Aug 14, 2022
5db46b9
Fix other minor Sphinx syntax issues with except
CAM-Gerlach Aug 14, 2022
89c69bb
Suppress redundant link to same section for except too
CAM-Gerlach Sep 19, 2022
84a0209
Don't link try/except/else/finally keywords if in the same section
CAM-Gerlach Sep 22, 2022
cbe74ab
Format try/except/finally as keywords in modified sections
CAM-Gerlach Sep 22, 2022
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
Prev Previous commit
Next Next commit
Don't link try/except/else/finally keywords if in the same section
  • Loading branch information
@CAM-Gerlach
CAM-Gerlach committed Sep 22, 2022
commit 84a020974271ccb0037372dac68c454638939a2a
16 changes: 8 additions & 8 deletions Doc/reference/compound_stmts.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -213,7 +213,7 @@ The :keyword:`!try` statement
keyword: as
single: : (colon); compound statement

The :keyword:`try` statement specifies exception handlers and/or cleanup code
The :keyword:`!try` statement specifies exception handlers and/or cleanup code
for a group of statements:

.. productionlist:: python-grammar
Expand Down Expand Up @@ -328,7 +328,7 @@ when leaving an exception handler::
:keyword:`!except*` clause
--------------------------

The :keyword:`except* <except_star>` clause(s) are used for handling
The :keyword:`!except* <except_star>` clause(s) are used for handling
:exc:`ExceptionGroup`\s. The exception type for matching is interpreted as in
the case of :keyword:`except`, but in the case of exception groups we can have
partial matches when the type matches some of the exceptions in the group.
Expand Down Expand Up @@ -391,9 +391,9 @@ clauses.
:keyword:`!finally` clause
--------------------------

If :keyword:`finally` is present, it specifies a 'cleanup' handler. The
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
: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
Expand All @@ -411,7 +411,7 @@ or :keyword:`continue` statement, the saved exception is discarded::
42

The exception information is not available to the program during execution of
the :keyword:`finally` clause.
the :keyword:`!finally` clause.

.. index::
statement: return
Expand All @@ -420,10 +420,10 @@ the :keyword:`finally` clause.

When a :keyword:`return`, :keyword:`break` or :keyword:`continue` statement is
executed in the :keyword:`try` suite of a :keyword:`!try`...\ :keyword:`!finally`
statement, the :keyword:`finally` clause is also executed 'on the way out.'
statement, the :keyword:`!finally` clause is also executed 'on the way out.'

The return value of a function is determined by the last :keyword:`return`
statement executed. Since the :keyword:`finally` clause always executes, a
statement executed. Since the :keyword:`!finally` clause always executes, a
:keyword:`!return` statement executed in the :keyword:`!finally` clause will
always be the last one executed::

Expand All @@ -438,7 +438,7 @@ always be the last one executed::

.. versionchanged:: 3.8
Prior to Python 3.8, a :keyword:`continue` statement was illegal in the
:keyword:`finally` clause due to a problem with the implementation.
:keyword:`!finally` clause due to a problem with the implementation.


.. _with:
Expand Down