rust-lang / rust-lang/reference
Improve grammar of block expressions
Nobody has claimed this yet.
- Dominant language
- Rust
- Stars
- 1.6k
- Forks
- 607
- PR merge metrics
- PR metrics pending
Description
At some point, we may want to improve the grammar for blocks.
The way that rustc works is that a block is a sequence of statements. It's probably clearer to do something like that here. Then we can just say that "all expressions are statements" and that "a block is a sequence of statements that are delimited by semicolons with an optional trailing semicolon" or something to that effect.
But, of course, we should beware of:
cc @ehuss
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Start by reading the current block-expression grammar in the Rust Reference, then review rust-lang/rust#61733 and reference#625 before proposing wording. Done would require an agreed grammar model and an updated explanation that addresses the compatibility concerns raised by those issues.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- rust
- Domain
- compilers, documentation
- Issue type
- Documentation
- Difficulty
- 5/5
- Estimated time
- Over a week
- Activity status
- Stale
- Clarity
- Needs clarification
- Newbie friendliness
- 20/100