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
