Skip to content
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

Decide on KDoc tags case-sensitivity #2929

Open
qwwdfsad opened this issue Mar 17, 2023 · 0 comments
Open

Decide on KDoc tags case-sensitivity #2929

qwwdfsad opened this issue Mar 17, 2023 · 0 comments
Labels
enhancement An issue for a feature or an overall improvement kdoc-spec An issue that requires clarification from the KDoc spec's perspective

Comments

@qwwdfsad
Copy link
Member

#2907 uncovered that our Javadoc's tag parser is case-insensitive even though it shouldn't be according to specification.

Further investigation has shown that KDoc tags are, as opposed to Javadoc's tags, case-insensitive: https://github.com/JetBrains/kotlin/blob/92d200e093c693b3c06e53a39e0b0973b84c7ec5/compiler/psi/src/org/jetbrains/kotlin/kdoc/parser/KDocKnownTag.kt#L42

We should decide whether this behaviour is deliberate or was driven by the implementation convenience, and react accordingly: change the behaviour or change the specification.

@qwwdfsad qwwdfsad added enhancement An issue for a feature or an overall improvement kdoc-spec An issue that requires clarification from the KDoc spec's perspective labels Mar 17, 2023
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
enhancement An issue for a feature or an overall improvement kdoc-spec An issue that requires clarification from the KDoc spec's perspective
Projects
None yet
Development

No branches or pull requests

1 participant