JDK-8248121 : documentation errors in java.desktop module
  • Type: Bug
  • Component: client-libs
  • Affected Version: 15
  • Priority: P3
  • Status: Closed
  • Resolution: Duplicate
  • Submitted: 2020-06-23
  • Updated: 2020-10-07
  • Resolved: 2020-10-07
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 16
16Resolved
Related Reports
Duplicate :  
Duplicate :  
Duplicate :  
Duplicate :  
Description
There are a number of errors in the doc comments for the java.desktop module, as reported by doclint, and seen in this recent report:
http://cr.openjdk.java.net/~jjg/doclint/15-internal%2b0-2020-06-22/

It would be nice to fix the errors in the accessibility and reference columns (just a few errors in each) and look at the errors in the HTML column, which seem to be predominantly that the file uses old-style HTML4 constructs which are not valid in HTML 5. It looks like many/most of these could be mechanically changed in to IDE to a CSS equivalent.
Comments
Missing references and accessibility were fixed by https://bugs.openjdk.java.net/browse/JDK-8251125, https://bugs.openjdk.java.net/browse/JDK-8251124 respectively and html5 error in work in progress under https://bugs.openjdk.java.net/browse/JDK-8251122 and for missing javadoc there is open bug : https://bugs.openjdk.java.net/browse/JDK-8251123
27-08-2020

Setting aside all the errors reported for missing comments, the java.desktop module is now the primary source of other kinds of doclint errors in JDK documentation.
23-06-2020