Skip to content

Ref target labels for except/except*/finally not located precisely #95975

Closed
@CAM-Gerlach

Description

@CAM-Gerlach

As originally noticed by @ezio-melotti on #95937 , the ref target labels for the except, except* and finally keywords are located at the top of the [try statement section in the Compound Statements][(https://docs.python.org/3.11/reference/compound_stmts.html#the-try-statement) reference; however, they are actually discussed at specific points sometimes several pages down in the lengthy section. Therefore, the targets should be moved to more precise locations immediately prior to the introduction of the relevant keyword.

It would also be nice to make the section either to navigate with sub sections rather than one big long section, but that is considered outside the immediate scope of this proximate issue. It turns out this is required to get :keyword: to work, and the section is already organized by clause, so it makes sense just to add them.

Metadata

Metadata

Assignees

Labels

docsDocumentation in the Doc dir

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions