dart-lang / dart-lang/language
[spec] Library version comments are not being ignored by the compiler.
- Dominant language
- TeX
- Stars
- 2.9k
- Forks
- 239
- Avg merge
- 2d 18h
- Merged PRs (30d)
- 14
Description
The language specification states that the content of a non-documentation comment must be ignored by the compiler:
https://github.com/dart-lang/language/blob/0e320bd4a7339ce41db042db8e82c8298d4154dd/specification/dartLangSpec.tex#L22433-L22437
It looks to me like this is not consistent with the behavior of the "library version comment construct" e.g. `// @dart = 2.12`.
Contributor guide
Research direction
Read specification/dartLangSpec.tex at the cited lines and compare its treatment of non-documentation comments with the library version comment construct (`// @dart = 2.12`). Reproduce or inspect the differing compiler behavior, then determine what wording or behavior must be aligned for the issue to be resolved.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- dart
- Domain
- compilers
- Issue type
- Bug
- Difficulty
- 4/5
- Estimated time
- 3-5 days
- Activity status
- Stale
- Clarity
- Mostly clear
- Newbie friendliness
- 35/100