[jfx17] RFR: 8250590: Classes and methods in the javafx.css package are missing documentation [v4]

[Kevin Rushforth]

On Thu, 29 Jul 2021 08:43:59 GMT, Ajit Ghaisas <aghaisas at openjdk.org> wrote:

>> This PR corrects/adds missing documentation for classes in javafx.css package.
>
> Ajit Ghaisas has updated the pull request incrementally with one additional commit since the last revision:
> 
>   8250590 - fix review comments

> > Wherever only @inheritdoc is used, we are having this corruption in final html documentation
> 
> I saw this problem with `@inheritDoc` yesterday as well, and was getting ready to report it here, but then couldn't reproduce it with a clean build of the docs. I'll try it again with a fully clean build (not just a clean docs build). If reproducible, it seems likely that this is a bug in the `javadoc` tool.

I can confirm that this is a `javadoc` tool bug. It is already fixed in JDK 17, but since we use JDK 16 as the boot JDK, we will see it. Since `{@inheritDoc}` doesn't do anything for standard JDK classes that we override, except to provoke this bug, we should avoid this pattern for now.

-------------

PR: https://git.openjdk.java.net/jfx/pull/589