[jdk19] RFR: 8287379: Using @inheritDoc in an inapplicable context shouldn't crash javadoc

[Pavel Rappo]

On Mon, 27 Jun 2022 17:48:13 GMT, Jonathan Gibbons <jjg at openjdk.org> wrote:

>> This rights the wrongs of JDK-8008768. For more information, see the respective CSR.
>
> test/langtools/jdk/javadoc/doclet/testRelativeLinks/TestRelativeLinks.java line 67:
> 
>> 65:                 <a href="#class-fragment">fragment class link</a>""",
>> 66:             """
>> 67:                 <a id="class-fragment">Class fragment</a>""",
> 
> Why are these lines (and similar, below) being deleted?

Because they come from `{@inheritDoc}` on a class' main description. Such a use case is undocumented, unsupported, and is now being prohibited by this PR.

> test/langtools/jdk/javadoc/doclet/testRelativeLinks/pkg/C.java line 32:
> 
>> 30:  *
>> 31:  * <a id="class-fragment">Class fragment</a>.
>> 32:  */
> 
> Why are these being deleted?

ditto

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

PR: https://git.openjdk.org/jdk19/pull/54