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
Add section headers to fix :keyword: role and aid navigation
  • Loading branch information
@CAM-Gerlach
CAM-Gerlach committed Aug 14, 2022
commit 6a0721d427c92bfd66f853ca0e6d0a83c050aa10
14 changes: 14 additions & 0 deletions Doc/reference/compound_stmts.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -231,6 +231,9 @@ for a group of statements:

.. _except:

:keyword:`!except` clause
-------------------------

The :keyword:`except` clause(s) specify one or more exception handlers. When no
Comment thread
CAM-Gerlach marked this conversation as resolved.
Outdated
exception occurs in the :keyword:`try` clause, no exception handler is executed.
When an exception occurs in the :keyword:`!try` suite, a search for an exception
Expand Down Expand Up @@ -311,11 +314,15 @@ when leaving an exception handler::
>>> print(sys.exc_info())
(None, None, None)


.. index::
keyword: except_star

.. _except_star:

:keyword:`!except*` clause
--------------------------

The :keyword:`except*<except_star>` clause(s) are used for handling
:exc:`ExceptionGroup`\ s. The exception type for matching is interpreted as in
Comment thread
CAM-Gerlach marked this conversation as resolved.
Outdated
the case of :keyword:`except`, but in the case of exception groups we can have
Expand Down Expand Up @@ -362,16 +369,23 @@ one except* clause, the first that matches it. ::

.. _except_else:

:keyword:`!else` clause
-----------------------

The optional :keyword:`!else` clause is executed if the control flow leaves the
:keyword:`try` suite, no exception was raised, and no :keyword:`return`,
:keyword:`continue`, or :keyword:`break` statement was executed. Exceptions in
the :keyword:`!else` clause are not handled by the preceding :keyword:`except`
clauses.


.. index:: keyword: finally

.. _finally:

: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
Expand Down