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.

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

Commit messages:
 - Remove "String buffers support mutable strings"

Changes: https://git.openjdk.org/jdk/pull/30608/files
  Webrev: https://webrevs.openjdk.org/?repo=jdk&pr=30608&range=00
  Issue: https://bugs.openjdk.org/browse/JDK-8381772
  Stats: 1 line in 1 file changed: 0 ins; 0 del; 1 mod
  Patch: https://git.openjdk.org/jdk/pull/30608.diff
  Fetch: git fetch https://git.openjdk.org/jdk.git pull/30608/head:pull/30608

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

Reply via email to