On Mon, 7 Apr 2025 19:44:40 GMT, Stuart Marks <sma...@openjdk.org> wrote:
>> Can we rephrase the 1st sentence to read: >> "The `readln()` and `readln(String)` methods in this class decode bytes read >> from `System.in` into characters." >> >> And remove the last "these internal objects" sentence. >> >> And for the next paragraph, change the first line to: >> "The `readln` methods may buffer additional bytes..." >> >> So we remove references to "internal objects." > > I'm in the midst of rewriting all of this stuff. The main concern here is > that applications can use System.in more or less as they please (presumably > without buffering) _until_ the first call to a `readln` method, at which time > _something happens_ and effectively the application cannot use System.in > anymore. I'll post the revision when I've finished it. Updated. ------------- PR Review Comment: https://git.openjdk.org/jdk/pull/24438#discussion_r2032003160