Repository navigation
Improve grammar description for the match statement #114172
Description
See #114070 (comment) by @hugovk. Right now we have here:
$ make -C Doc html SPHINXERRORHANDLING=-n SOURCES="reference/compound_stmts.rst"
Doc/reference/compound_stmts.rst:601: WARNING: 'token' reference target not found: python-grammar:star_named_expression
Doc/reference/compound_stmts.rst:601: WARNING: 'token' reference target not found: python-grammar:star_named_expressions
Doc/reference/compound_stmts.rst:601: WARNING: 'token' reference target not found: python-grammar:named_expression
Doc/reference/compound_stmts.rst:601: WARNING: 'token' reference target not found: python-grammar:block
Doc/reference/compound_stmts.rst:693: WARNING: 'token' reference target not found: python-grammar:named_expression
Doc/reference/compound_stmts.rst:835: WARNING: 'token' reference target not found: python-grammar:signed_number
Doc/reference/compound_stmts.rst:835: WARNING: 'token' reference target not found: python-grammar:signed_number
Doc/reference/compound_stmts.rst:835: WARNING: 'token' reference target not found: python-grammar:signed_number
Doc/reference/compound_stmts.rst:835: WARNING: 'token' reference target not found: python-grammar:strings
Doc/reference/compound_stmts.rst:835: WARNING: 'token' reference target not found: python-grammar:signed_number
Some rules are not clear without reading the full grammar specification. Perhaps, we can do better.
Activity
Laleee commentedon Jul 13, 2024
Yes, I agree. We can do better!
StanFromIreland commentedon Jun 24, 2026
The current grammar:
seems fine to me, can this be closed?
skirpichev commentedon Jun 25, 2026
Thanks, looks fixed. I assume you verified that there are no sphinx warnings.
I checked other descriptions in that part of the reference. No broken links.