-
Bug
-
Resolution: Won't Fix
-
P4
-
21, 22, 23
-
None
I haven't been able to narrow this down to a simple test program.
To reproduce this, build the JavaFX docs from the jfx22 branch of the GitHub jfx repo using JDK 21 (or later) as follows:
git clone https://github.com/openjdk/jfx.git
cd jfx
git checkout jfx22
bash gradlew javadoc
It will produce 186 warnings, 2 of which are incorrect.
jfx/modules/javafx.controls/src/main/java/javafx/scene/control/Skinnable.java:55: warning: no comment
public void setSkin(Skin<?> value);
^
jfx/modules/javafx.controls/src/main/java/javafx/scene/control/Skinnable.java:57: warning: no comment
public Skin<?> getSkin();
^
There is a corresponding skinProperty() method in the same interface, and the javadoc tool correctly produces the docs for these two methods from the property.
WORKAROUND: Annotate the two methods with `@SuppressWarnings("doclint:missing")`
To reproduce this, build the JavaFX docs from the jfx22 branch of the GitHub jfx repo using JDK 21 (or later) as follows:
git clone https://github.com/openjdk/jfx.git
cd jfx
git checkout jfx22
bash gradlew javadoc
It will produce 186 warnings, 2 of which are incorrect.
jfx/modules/javafx.controls/src/main/java/javafx/scene/control/Skinnable.java:55: warning: no comment
public void setSkin(Skin<?> value);
^
jfx/modules/javafx.controls/src/main/java/javafx/scene/control/Skinnable.java:57: warning: no comment
public Skin<?> getSkin();
^
There is a corresponding skinProperty() method in the same interface, and the javadoc tool correctly produces the docs for these two methods from the property.
WORKAROUND: Annotate the two methods with `@SuppressWarnings("doclint:missing")`
- relates to
-
JDK-8345583 Block tag lookup triggers doclint warning for missing doc comment
- Open
-
JDK-8314590 ☂ Eliminate all javadoc warnings in JavaFX
- Resolved