JDK-8325071 : javadoc generates incorrect missing comment warning in one case for JavaFX property
  • Type: Bug
  • Component: tools
  • Sub-Component: javadoc(tool)
  • Affected Version: 21,22,23
  • Priority: P4
  • Status: Open
  • Resolution: Unresolved
  • Submitted: 2024-01-31
  • Updated: 2024-05-28
The Version table provides details related to the release that this issue/RFE will be addressed.

Unresolved : Release in which this issue/RFE will be addressed.
Resolved: Release in which this issue/RFE has been resolved.
Fixed : Release in which this issue/RFE has been fixed. The release containing this fix may be available for download as an Early Access Release or a General Availability Release.

To download the current JDK release, click here.
JDK 24
24Unresolved
Related Reports
Relates :  
JDK-8314590 - ☂ Eliminate all javadoc warnings in JavaFX
Description
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")`