RFR: JDK-8267219: Javadoc method summary breaks when {@inheritDoc} from an empty parent [v2]

Pavel Rappo prappo at openjdk.java.net
Tue May 18 10:39:40 UTC 2021


On Tue, 18 May 2021 01:42:57 GMT, liach <github.com+7806504+liach at openjdk.org> wrote:

> if an empty content stays empty, it's handled like htmltree.empty in a special case (just like what happens to nocomment) and included in table output. if it's wrapped in a div class=block, the check will not be triggered as it's not empty but yet invalid content, so when the table converts to content that row is lost.

Your analysis together with the fact that this PR changes code that presumably had no such issue in JDK 15 leaves me with more questions. For example, (1) Why does the lower level that prints out HTML leave out pieces of structure? (2) Why does the higher level that creates this structure knows about and works around that behavior of the lower level?

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

PR: https://git.openjdk.java.net/jdk/pull/4066


More information about the javadoc-dev mailing list