Skip to content

Improve grammar description for the match statement #114172

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.

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

Open
skirpichev opened this issue Jan 17, 2024 · 1 comment
Open

Improve grammar description for the match statement #114172

skirpichev opened this issue Jan 17, 2024 · 1 comment
Labels
docs Documentation in the Doc dir

Comments

@skirpichev
Copy link
Member

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.

@Laleee
Copy link

Laleee commented Jul 13, 2024

Yes, I agree. We can do better!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
docs Documentation in the Doc dir
Projects
None yet
Development

No branches or pull requests

2 participants