RFR: 8285368: Overhaul doc-comment inheritance [v7]

[Alan Bateman]

On Thu, 8 Jun 2023 11:27:37 GMT, Pavel Rappo <prappo at openjdk.org> wrote:

> If we were to (re-)structure doc comments in the way you propose, I'd suggest we do it in a separate, non-jdk.javadoc PR. I was simply trying to keep JDK API documentation unchanged.

Understood, it was just a passing comment that TreeMap::entrySet overrides the description so it's specifying what it returns and using inherited text for the @return description.

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

PR Review Comment: https://git.openjdk.org/jdk/pull/14357#discussion_r1223053378