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

[liach]

On Wed, 19 May 2021 10:43:29 GMT, liach <github.com+7806504+liach at openjdk.org> wrote:

>> This change fixes when a method body has only inline tags that produce no output, the method summary will get eaten.
>> 
>> This change allows `{@inheritDoc}` from empty parents to go through the code path used by `-nocomment` and properly generate tables.
>> 
>> All `jtreg:test/langtools/jdk/javadoc/doclet` tests pass.
>
> liach has updated the pull request incrementally with one additional commit since the last revision:
> 
>   Specify further what isValid expects and how it is used

Since the problems around `isValid` is somehow deeper and beyond the scope of 8267219, I will mark this ready for integrate. The discussion on `isValid` deserves its dedicated issue.

Feel free to point out other problems before anyone sponsors.

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

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