On Thu, 29 Jul 2021 12:30:36 GMT, Kevin Rushforth <k...@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
