The PEG rule "case_block" of match statement seems not rendered correctly

[hikorp]

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

[terryjreedy]

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

[StanFromIreland]

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.

[StanFromIreland]

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

[gvanrossum]

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.

[ByteFlowing1337]

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