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

[Jonathan Gibbons]

On Mon, 17 May 2021 17:39:19 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 refreshed the contents of this pull request, and previous commits have been removed. The incremental views will show differences compared to the previous content of the PR.

As a matter of style, these days we avoid small files like `First.java` and `Second.java` and put the source instead in a text block in the main test file and write the file(s) on the fly, typically using `ToolBox.writeJavaFiles`.  This makes it easier to read the test all at once, instead of switching between small files that are dominated by a legal header.

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

Changes requested by jjg (Reviewer).

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