P2029R4 ("character escapes") seemingly attempts to introduce new terms
Nobody has claimed this yet.
- Dominant language
- TeX
- Stars
- 221
- Forks
- 813
- Avg merge
- 16h 4m
- Merged PRs (30d)
- 36
Description
The newly added table lex.ccon.literal from #4371/P2029R4 seems to attempt to define the terms "ordinary characater literal", "wide character literal", "UTF-8 character literal", etc., but the presentation makes this unclear. Usually, definitions appear in plain body text where the context and style makes it clear that a new term is being defined, but the table stands apart from the main text, and so we can no longer rely on this convention.
It seems useful to define the terms in the main text, e.g. by adding a sentence to the new paragraph 2:
"The kind of a character literal [...] as defined by Table Yas described by Table Y. The following kinds are defined: an ordinary character literal is ...".
Contributor guide
No contributing guide indexed for this repository
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 with the newly added table lex.ccon.literal from #4371/P2029R4 and the new paragraph 2. Check how the terms "ordinary character literal," "wide character literal," and related terms are presented. Done means the main text clearly defines the terms and explains the table's role without relying on the table's standalone presentation.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- tex
- Domain
- documentation
- Issue type
- Documentation
- Difficulty
- 2/5
- Estimated time
- 1-3 hours
- Activity status
- Stale
- Clarity
- Mostly clear
- Newbie friendliness
- 45/100