RFR: 8343110: Add getChars(int, int, char[], int) to CharSequence and CharBuffer [v9]

[Chen Liang]

On Wed, 30 Apr 2025 15:34:33 GMT, Markus KARG <duke at 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