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

fix(#16610): warn ignored Scaladoc on multiple enum cases #19555

Conversation

i10416
Copy link
Contributor

@i10416 i10416 commented Jan 28, 2024

close #16610

Before this commit, the compiler ignored Scaladoc comment on multiple enum cases without warning.

This is partly expected because the case to which the doc is attached is ambiguous, but we should at least warn users that the comment is ignored by compiler due to ambiguity and they should take an action if they want the doc to be displayed.

Before this commit, the compiler ignored Scaladoc comment on multiple
enum cases without warning.

This is partly expected because the case to which the doc is attached is ambiguous,
but we should at least warn users that the comment is ignored by compiler due to
ambiguity and they should take an action if they want the doc to be displayed.
@i10416 i10416 force-pushed the fix/16610-compiler-ignored-ambiguous-docs-on-enum-cases-without-warn branch from 5c252cb to 76ee412 Compare January 28, 2024 13:17
@i10416 i10416 changed the title fix(#16610): warn Scaladoc on multiple cases fix(#16610): warn ignored Scaladoc on multiple cases Jan 28, 2024
@i10416 i10416 changed the title fix(#16610): warn ignored Scaladoc on multiple cases fix(#16610): warn ignored Scaladoc on multiple enum cases Jan 28, 2024
@i10416
Copy link
Contributor Author

i10416 commented Feb 24, 2024

@Florian3k would you be kind enough to review the changes?

@Florian3k
Copy link
Contributor

Hi, sorry for the delay, I've somehow missed the notification. I'll get to this ASAP.

@Florian3k
Copy link
Contributor

This looks good, but to add new warning without flag we need to wait for 3.5.0.
For now, we can hide this behind a flag, eg. -Wcheck-comments.
Would you be able to do that? If no, let me know and we will take care of it.

@i10416
Copy link
Contributor Author

i10416 commented Feb 28, 2024

Would you be able to do that?

I haven't tried yet, so I'm not sure, but may I try it?

@i10416
Copy link
Contributor Author

i10416 commented Mar 9, 2024

Copy link
Contributor

@Florian3k Florian3k left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM

@Florian3k Florian3k merged commit 11a6f0a into scala:main Mar 11, 2024
19 checks passed
@Kordyjan Kordyjan added this to the 3.4.2 milestone Mar 28, 2024
WojciechMazur added a commit that referenced this pull request Jul 2, 2024
close #16610 

Before this commit, the compiler ignored Scaladoc comment on multiple
enum cases without warning.

This is partly expected because the case to which the doc is attached is
ambiguous, but we should at least warn users that the comment is ignored
by compiler due to ambiguity and they should take an action if they want
the doc to be displayed.
[Cherry-picked 11a6f0a][modified]
WojciechMazur added a commit that referenced this pull request Jul 3, 2024
…to LTS (#20983)

Backports #19555 to the LTS branch.

PR submitted by the release tooling.
[skip ci]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

scaladoc comment for multiple enum cases is silently ignored without any warning
3 participants