RFR: 8338140: (str) Add notes to String.trim and String.isEmpty pointing to newer APIs

[Naoto Sato]

On Wed, 11 Jun 2025 23:43:40 GMT, Brian Burkhalter <bpb at openjdk.org> wrote:

>> Add a note to String.trim pointing to the String.strip family of methods.
>> 
>> Add notes cross-linking String.isBlank and String.isEmpty.
>
> src/java.base/share/classes/java/lang/String.java line 3837:
> 
>> 3835:      *
>> 3836:      * @apiNote
>> 3837:      * This method uses a ASCII-based definition of space characters that are to be
> 
> "a ASCII" or "an ASCII"?

In fact, "ASCII-based definition of space characters" is kind of unclear to me. How about explicitly specify them as C0 controls and the space, or exactly quote the space definition in the first paragraph?

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

PR Review Comment: https://git.openjdk.org/jdk/pull/25762#discussion_r2141282711