RFR: 8340229: Improve opening sentence of FileInputStream constructor specification

[Jaikiran Pai]

On Mon, 30 Sep 2024 23:16:56 GMT, Brian Burkhalter <bpb at openjdk.org> 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 created to represent this file connection.`
> 
> which appears for the four constructors which do not have a `FileDescriptor` parameter? Those four sentences could probably be deleted.

Yes those were the occurences that I was curious about. Having said that, I now see that we use similar sentence even in the 2 constructors of FileInputStream and we aren't proposing to update those in this PR. So I think it should be OK to leave it in its current form in FileOutputStream.

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

PR Comment: https://git.openjdk.org/jdk/pull/21223#issuecomment-2385481581