eclipse.jdt.ls icon indicating copy to clipboard operation
eclipse.jdt.ls copied to clipboard

Wrong list elements generated in Javadoc, in some cases where a line contains an @

Open fbricon opened this issue 1 month ago • 1 comments

I noticed an issue with the javadoc of java.lang.annotation.ElementType. It can be narrowed down to an @thing behind followed by another @thingy on the same line, this generates wrong list elements.

    /**
     * Some javadoc and then ...
     * @jls 9.6.4.1 @Target
     */
    public void foo(){}
Image

The @Target in ElementType should be rendered as a link to the jls spec, in this case : https://docs.oracle.com/javase/specs/jls/se25/html/jls-9.html#jls-9.6.4.1

Not sure what should happen if @jls 9.6.4.1 @Target is present on a non JDK class.

fbricon avatar Dec 03 '25 18:12 fbricon

In Eclipse, the generated javadoc doesn't contain a link to the remote spec, but at least it doesn't break:

Image

fbricon avatar Dec 03 '25 18:12 fbricon