JDK-8250590 : Classes and methods in the javafx.css package are missing documentation
  • Type: Bug
  • Component: javafx
  • Sub-Component: graphics
  • Affected Version: openjfx14
  • Priority: P4
  • Status: Resolved
  • Resolution: Fixed
  • Submitted: 2020-07-25
  • Updated: 2021-08-10
  • Resolved: 2021-08-03
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.
Other
openjfx17Fixed
Related Reports
Blocks :  
JDK-8271083 - ��� Missing documentation in JavaFX API
Relates :  
JDK-8271460 - Missing summary in javadoc comments in JavaFX modules
Relates :  
JDK-8246343 - Fix mistakes in FX API docs
Relates :  
JDK-8271485 - Javadoc "Method Summary" table is misaligned if overridden JDK method has {@inheritDoc} tag
Relates :  
JDK-8271326 - Elaborate where "the styleClasses list" is defined in javafx.css.StyleClass.getIndex() documentation
Description
Go to https://openjfx.io/javadoc/14/javafx.graphics/javafx/css/package-summary.html. Some classes and their methods are missing documentation.
Comments
Changeset: 7575473c Author: Ajit Ghaisas <aghaisas@openjdk.org> Date: 2021-08-03 06:21:15 +0000 URL: https://git.openjdk.java.net/jfx/commit/7575473c657a3fbd13cc5d8cf0d07ad3a543e050
03-08-2021
I filed JDK-8271083 as an umbrella bug to track all errors where there are missing javadoc comments, including this issue and similar mistakes in other parts of the API. See the description of that bug for more information.
21-07-2021
I attached the results of running the following and then grepping for javafx/css: ``` $ gradle sdk javadoc $ rm -rf build/javadoc $ $JDK_HOME/bin/javadoc -Xmaxwarns 1000 @build/modulesourcepath.args @build/tmp/javadoc/javadoc.options >& build-javadoc.log ``` where JDK_HOME pointed to a local build of JDK 18 with the patch from https://github.com/openjdk/jdk/pull/4747 applied to fix JDK-8269774.
20-07-2021
As noted in the following review comment for a different bug: https://github.com/openjdk/jfx/pull/283#discussion_r472359355 PsuedoClass needs some work in this area that can be done as part of this issue.
26-08-2020
[~kcr] This should be assigned to someone who is familiar with this API.
27-07-2020