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

[Ajit Ghaisas]

On Thu, 29 Jul 2021 12:30:36 GMT, Kevin Rushforth <kcr at openjdk.org> wrote:

> > > 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.

I have filed [JDK-8271485](https://bugs.openjdk.java.net/browse/JDK-8271485) to address this.

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

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