On Thu, 1 May 2025 16:23:13 GMT, Joe Darcy <da...@openjdk.org> wrote:
>> I can open a bug report, but I think text parity makes no sense: There are >> lots of other places in OpenJDK where the short form is used already, so >> there will not be any benefit of text parity with just one other code >> location, but it will force us to open another JBS / PR once the bug is >> fixed to come back to the short form. So it brings just work but we gain >> nothing IMHO. > > 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. ------------- PR Review Comment: https://git.openjdk.org/jdk/pull/21730#discussion_r2070545048
