Re: RFR: 8340229: Improve opening sentence of FileInputStream constructor specification [v3]

2024-10-02 Thread Jaikiran Pai
On Wed, 2 Oct 2024 15:23:52 GMT, Brian Burkhalter wrote: >> Improve the first sentences of the three `FileInputStream` constructors, in >> particular removing the term "connection." > > Brian Burkhalter has updated the pull request incrementally with one > additional commit since the last revis

Re: RFR: 8340229: Improve opening sentence of FileInputStream constructor specification [v3]

2024-10-02 Thread Alan Bateman
On Wed, 2 Oct 2024 15:23:52 GMT, Brian Burkhalter wrote: >> Improve the first sentences of the three `FileInputStream` constructors, in >> particular removing the term "connection." > > Brian Burkhalter has updated the pull request incrementally with one > additional commit since the last revis

Re: RFR: 8340229: Improve opening sentence of FileInputStream constructor specification [v2]

2024-10-02 Thread Brian Burkhalter
On Wed, 2 Oct 2024 06:45:51 GMT, Alan Bateman wrote: >> Brian Burkhalter has updated the pull request incrementally with one >> additional commit since the last revision: >> >> 8340229: Revert FIS(fdObj) change > > src/java.base/share/classes/java/io/FileInputStream.java line 118: > >> 116:

Re: RFR: 8340229: Improve opening sentence of FileInputStream constructor specification [v3]

2024-10-02 Thread Brian Burkhalter
> Improve the first sentences of the three `FileInputStream` constructors, in > particular removing the term "connection." Brian Burkhalter has updated the pull request incrementally with one additional commit since the last revision: 8340229: Correct typo in FIS - Changes: -

Re: RFR: 8340229: Improve opening sentence of FileInputStream constructor specification [v2]

2024-10-01 Thread Alan Bateman
On Tue, 1 Oct 2024 16:08:56 GMT, Brian Burkhalter wrote: >> Improve the first sentences of the three `FileInputStream` constructors, in >> particular removing the term "connection." > > Brian Burkhalter has updated the pull request incrementally with one > additional commit since the last revis

Re: RFR: 8340229: Improve opening sentence of FileInputStream constructor specification [v2]

2024-10-01 Thread Brian Burkhalter
> Improve the first sentences of the three `FileInputStream` constructors, in > particular removing the term "connection." Brian Burkhalter has updated the pull request incrementally with one additional commit since the last revision: 8340229: Revert FIS(fdObj) change - Changes:

Re: RFR: 8340229: Improve opening sentence of FileInputStream constructor specification [v2]

2024-10-01 Thread Brian Burkhalter
On Tue, 1 Oct 2024 15:46:49 GMT, Alan Bateman wrote: >> Updated for the next commit. > > Did you push that commit? I don't see the update, the PR only has 1 commit. I did just now. - PR Review Comment: https://git.openjdk.org/jdk/pull/21223#discussion_r1783138693

Re: RFR: 8340229: Improve opening sentence of FileInputStream constructor specification

2024-10-01 Thread Alan Bateman
On Mon, 30 Sep 2024 23:13:54 GMT, Brian Burkhalter wrote: >> src/java.base/share/classes/java/io/FileInputStream.java line 118: >> >>> 116: /** >>> 117: * Creates a {@code FileInputStream} to read from an existing file >>> 118: * named by the {@code File} object {@code file}. >> >

Re: RFR: 8340229: Improve opening sentence of FileInputStream constructor specification

2024-10-01 Thread Jaikiran Pai
On Mon, 30 Sep 2024 23:16:56 GMT, Brian Burkhalter wrote: > > Do you think, as part of this PR, we should also revisit some of the > > javadoc in the `java.io.FileOutputStream` class which too has several > > mentions of "connection"? > > Are you thinking of this sentence > > `A new FileDescr

Re: RFR: 8340229: Improve opening sentence of FileInputStream constructor specification

2024-09-30 Thread Brian Burkhalter
On Sun, 29 Sep 2024 07:00:49 GMT, Alan Bateman wrote: >> Improve the first sentences of the three `FileInputStream` constructors, in >> particular removing the term "connection." > > src/java.base/share/classes/java/io/FileInputStream.java line 166: > >> 164: /** >> 165: * Creates a {@

Re: RFR: 8340229: Improve opening sentence of FileInputStream constructor specification

2024-09-30 Thread Brian Burkhalter
On Sat, 28 Sep 2024 06:51:19 GMT, Jaikiran Pai wrote: > Do you think, as part of this PR, we should also revisit some of the javadoc > in the `java.io.FileOutputStream` class which too has several mentions of > "connection"? Are you thinking of this sentence ```A new FileDescriptor object is

Re: RFR: 8340229: Improve opening sentence of FileInputStream constructor specification

2024-09-30 Thread Brian Burkhalter
On Sat, 28 Sep 2024 06:49:44 GMT, Jaikiran Pai wrote: >> Improve the first sentences of the three `FileInputStream` constructors, in >> particular removing the term "connection." > > src/java.base/share/classes/java/io/FileInputStream.java line 118: > >> 116: /** >> 117: * Creates a {@

Re: RFR: 8340229: Improve opening sentence of FileInputStream constructor specification

2024-09-29 Thread Alan Bateman
On Fri, 27 Sep 2024 16:06:51 GMT, Brian Burkhalter wrote: > Improve the first sentences of the three `FileInputStream` constructors, in > particular removing the term "connection." src/java.base/share/classes/java/io/FileInputStream.java line 166: > 164: /** > 165: * Creates a {@code

Re: RFR: 8340229: Improve opening sentence of FileInputStream constructor specification

2024-09-27 Thread Jaikiran Pai
On Fri, 27 Sep 2024 16:06:51 GMT, Brian Burkhalter wrote: > Improve the first sentences of the three `FileInputStream` constructors, in > particular removing the term "connection." Do you think, as part of this PR, we should also revisit some of the javadoc in the `java.io.FileOutputStream` cl

RFR: 8340229: Improve opening sentence of FileInputStream constructor specification

2024-09-27 Thread Brian Burkhalter
Improve the first sentences of the three `FileInputStream` constructors, in particular removing the term "connection." - Commit messages: - 8340229: Improve opening sentence of FileInputStream constructor specification Changes: https://git.openjdk.org/jdk/pull/21223/files Webrev