RFR: 8344706: Compiler Implementation of Compact Source Files and Instance Main Methods [v3]

[Stuart Marks]

On Mon, 7 Apr 2025 19:44:40 GMT, Stuart Marks <smarks at 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