Description

hikorp

opened on May 15, 2026

Issue body actions

Documentation

The PEG rule of "case_block" of match statement, in "3.14.5 Documentation » The Python Language Reference » 8. Compound statements" seems not rendered correctly.

Linked PRs

• gh-149861: Fix rendering of case_block in match statement PEG grammar #149908
• [3.13] gh-149861: Fix rule in match statement case_block PEG grammar (GH-149908) #150512
• [3.14] gh-149861: Fix rule in match statement case_block PEG grammar (GH-149908) #150513
• [3.15] gh-149861: Fix rule in match statement case_block PEG grammar (GH-149908) #150514

Activity

1. hikorp

   added

   docsDocumentation in the Doc dirDocumentation in the Doc dir

   on May 15, 2026
2. github-project-automation

   added this to docs issueson May 15, 2026
3. github-project-automation

   moved this to Todo in docs issueson May 15, 2026
4. terryjreedy commented on May 15, 2026

   

   terryjreedy

   on May 15, 2026

   Member

   More actions

   The case_block syntax is here. If the word block is an actual syntax term similar to guard, it should be in blue and underlined and linked to the block syntax line. But the block syntax seems to be missing from both the doc and pep-0634 Is it the same as a normal compound statement suite? (If so, use that.) Or more restricted?

   If the link is meant to be missing, then I believe "`!block`" needs something like ":role:" in front.

   @brandtbucher @gvanrossum
5. StanFromIreland commented on May 15, 2026

   

   StanFromIreland

   on May 15, 2026

   Member

   More actions

   This needs to be fixed like #149811.

   If the link is meant to be missing, then I believe "!block" needs something like ":role:" in front

   That won’t work here I’m afraid. Either we fix the render (I have a PR for this: #148845), or we fix the reference.
6. StanFromIreland commented on May 15, 2026

   

   StanFromIreland

   on May 15, 2026

   Member

   More actions

   CC @encukou you missed the one my fix was originally for ;-)

   Reacted by Petr Viktorin
7. gvanrossum commented on May 15, 2026

   

   gvanrossum

   on May 15, 2026

   Member

   More actions

   This needs to be fixed like #149811.

   To be clear, is the solution to remove the exclamation point and rename to `suite?

   So `!block` -> `suite` ?

   I see no reason to omit the link.

   Reacted by Stan Ulbrych
8. IvyXu420 commented on May 24, 2026

   

   IvyXu420

   on May 24, 2026

   Contributor

   More actions

   I have made a PR to fix this. Could anyone please review it when you’re free? Thanks!
9. encukou

   closed this as completedin #149908on May 27, 2026
10. encukou

    added a commit that references this issue on May 27, 2026

    gh-149861: Fix rule in match statement `case_block` PEG grammar (GH-1…

    99c254e
11. StanFromIreland

    added 3 commits that reference this issue on May 27, 2026

    [3.15] gh-149861: Fix rule in match statement `case_block` PEG grammar (

    e565d12

    [3.14] gh-149861: Fix rule in match statement `case_block` PEG grammar (

    26c5468

    [3.13] gh-149861: Fix rule in match statement `case_block` PEG grammar (

    446c91e
12. encukou commented on May 28, 2026

    

    encukou

    on May 28, 2026

    Member

    More actions

    Thanks @ByteFlowing1337 for the fix, and Stan for merging the backports!

    Reacted by Ivy Xu

Issue actions