eclipse-jdt / eclipse-jdt/eclipse.jdt.core

@link for varargs method needs "[]" rather than "..." for array method parameter

Open
#457 0 comments 0 reactions 0 assignees View on GitHub
Dominant language
Java
Stars
237
Forks
195
Avg merge
1d 10h
Merged PRs (30d)
49

Description

Currently, using array varargs produces the following warning
![image](https://user-images.githubusercontent.com/4885222/194704652-b938f06d-9c5a-45b3-9f8e-7a149ff5aba5.png)
There used to be a similar bug in javadoc back in Java 8 ([JDK Bug](https://bugs.java.com/bugdatabase/view_bug.do?bug_id=5006659)), maybe this is some remnant from a fix from back then? It works with non-array parameters, and javadoc from Java 19 runs without warnings on the array vararg,

Contributor guide

Open the contributing guide

Research direction

Reproduce the warning for an @link to an array-varargs method, then compare it with non-array parameters and Java 19 javadoc. Read the linked JDK Bug 5006659 for historical context. Done means the array-varargs link is accepted without a warning and uses the expected parameter syntax.

Written by the indexing model from the issue text.

Assessment

Tech stack
java
Domain
documentation
Issue type
Bug
Difficulty
4/5
Estimated time
3-5 days
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
38/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.