On Thu, 29 Jul 2021 08:43:59 GMT, Ajit Ghaisas <aghai...@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
