On Thu, 1 May 2025 17:18:07 GMT, Markus KARG <d...@openjdk.org> wrote:

>> There are subtleties and perhaps surprises in `@inheritDoc`, but that 
>> doesn't necessarily imply the current behavior is buggy.
>
> So it is actually *wanted* behavior that in one situation the text *is* 
> inherited, but at `String.java` no text is inherited at all? 🤔 Could not find 
> any hint about that in the JavaDoc manual.

> So it is actually _wanted_ behavior that in one situation the text _is_ 
> inherited, but at `String.java` no text is inherited at all? 🤔 Could not find 
> any hint about that in the JavaDoc manual.

The inheritDoc functionality of javadoc was reworked relatively recently so I 
would assume the current behavior is intentional, even if not documented.

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

PR Review Comment: https://git.openjdk.org/jdk/pull/21730#discussion_r2074634715

Reply via email to