A few notes

[-]

Hello,
I have a few pieces of notes after looking at javadoc stuff.
1. JDK-8077565 <https://bugs.openjdk.java.net/browse/JDK-8077565> is the
same as JDK-8253700 <https://bugs.openjdk.java.net/browse/JDK-8253700> and
has been addressed in commit 8cf8e46
<https://github.com/openjdk/jdk/commit/8cf8e463c623b3908befb0af289749b47a793267>.
It can be closed now.
2. When a method has type annotations, its html element id may be broken. I
request filing a bug so I can submit a fix. A minimal example:

Cute.java
import java.lang.annotation.Documented;
import java.lang.annotation.ElementType;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.annotation.Target;

@Documented
@Target(ElementType.TYPE_USE)
@Retention(RetentionPolicy.RUNTIME)
public @interface Cute {
     String value() default "";
}

Daug.java:
public class Daug {
     public void bark(@Cute("") int t) {}
}

Build the javadoc for the two classes. Observe that in the method details
section, the id field of it is like
<section class="detail" id="bark(@Cute(" ")int)"="">
which is a map of
class -> detail
id -> "bark(@Cute("
")int)" -> ""

I suggest changing the id to that used in the method summary section
(already correct), like "bark(@Cute(%22%3Cannotationcontent%3E%22)int)".

liangchenblue at gmail.com
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <https://mail.openjdk.java.net/pipermail/javadoc-dev/attachments/20210115/5c368f62/attachment-0001.htm>