On Tue, 7 Apr 2026 15:53:25 GMT, Eirik Bjørsnøs <[email protected]> wrote:

> Please review this small cleanup which removes the fourth sentence of the 
> class-level Javadocs of `java.lang.String`:
> 
> _String buffers support mutable strings_
> 
> Mentioning "mutable strings" while just establishing that strings are 
> immutable in Java is confusing. It is also unclear what "String buffers" 
> should refer to.
> 
> While it could be possible to improve the phrasing of this sentence, the end 
> result would still be out of context here, so this PR suggests that we simply 
> remove this sentence.
> 
> This was initially discussed on core-libs: 
> https://mail.openjdk.org/archives/list/[email protected]/thread/2WP6UB3LMJGTRPOJILFLTNEGVBDUCKAU/
> 
> Javadoc-only cleanup, `noreg-doc`. 
> 
> It is my understanding that this change is not normative and does not warrant 
> a CSR.

This pull request has now been integrated.

Changeset: 67a71249
Author:    Eirik Bjørsnøs <[email protected]>
URL:       
https://git.openjdk.org/jdk/commit/67a71249a17b3fb9f9263df239fc25b0df22757c
Stats:     3 lines in 1 file changed: 0 ins; 0 del; 3 mod

8381772: Remove mention of "mutable strings" in java.lang.String Javadocs

Reviewed-by: alanb, liach

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

PR: https://git.openjdk.org/jdk/pull/30608

Reply via email to