RFR: 8284299: Handle inheritDoc misuse more gracefully [v2]

[Jonathan Gibbons]

On Wed, 6 Apr 2022 16:52:37 GMT, Pavel Rappo <prappo at openjdk.org> wrote:

>> This is a straightforward change that fixes a certain type of crashes and improves diagnosability. For details, see the individual commit messages.
>> 
>> One non-intuitive thing is that I had to specify `-Xdoclint:none` in the test to capture the respective warnings in the output. When I omitted `-Xdoclint` option or specified it in any other way, the warnings would disappear from the console. I know the mechanics of why that happens, but am unsure if it makes sense or is a bug.
>
> Pavel Rappo has updated the pull request incrementally with one additional commit since the last revision:
> 
>   Address feedback

Marked as reviewed by jjg (Reviewer).

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

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