On Wed, 16 Apr 2025 10:35:10 GMT, Markus KARG <d...@openjdk.org> wrote:
>> src/java.base/share/classes/java/lang/CharSequence.java line 338:
>>
>>> 336: * Concurrent truncation of this character sequence can throw
>>> 337: * {@code IndexOutOfBoundsException}. In this case, some
>>> characters, but not
>>> 338: * all, may be already transferred.
>>
>> Though its been absent for decades, it might be worthwhile to include a
>> class level warning that the implementations of the interface are not known
>> or required to be thread safe and if used concurrently by multiple threads
>> the behavior is unpredictable. I'd be more circumspect than trying to
>> specify the only aberrant behavior is IndexOutOfBounds.
>
> Any quick proposals how to rephrase JavaDocs and CSR? As the CSR is already
> reviewed I am a bit reluctant to hold the train for this, as IMHO *masses* of
> classes and interfaces would need such a disclaimer, if we kick-off that ball
> here...
I think Roger's suggestion is for a different JBS issue / PR / CSR.
-------------
PR Review Comment: https://git.openjdk.org/jdk/pull/21730#discussion_r2046653580
