On Wed, 30 Apr 2025 15:34:33 GMT, Markus KARG <d...@openjdk.org> wrote:
>> Markus KARG has updated the pull request incrementally with one additional
>> commit since the last revision:
>>
>> Applied changes proposed by Joe and Jaikiran: Using @inheritDoc to get
>> JavaDocs without @since.
>
> src/java.base/share/classes/java/lang/String.java line 1739:
>
>> 1737:
>> 1738: /**
>> 1739: * {@inheritDoc CharSequence}
>
> @jaikiran @jddarcy Sorry for bothering, but I do need your kind help here to
> get the code to exactly that shape that you want to have it. While
> `{@inheritDoc CharSequence}` does work very well for `StringBuilder` and
> `StringBuffer` (via `AbstractStringBuilder` to shorten code size), it simply
> doesn't have *any* effect when applied at `String`: `make docs` successfully
> finishes without warnings or errors, but `String.html` still contains just
> the link to `CharSequence` but *is missing* the copy of the JavaDoc main
> text. I simply do not see why. Any ideas? 🤔
Could this be a Javadoc bug? What does a simple `{@inheritDoc}` do?
-------------
PR Review Comment: https://git.openjdk.org/jdk/pull/21730#discussion_r2068965855
