RFR: 8241619: (fs) Files.newByteChannel(path, Set.of(CREATE_NEW, READ)) does not throw a FileAlreadyExistsException when the file exists [v2]

[Brian Burkhalter]

On Tue, 16 Mar 2021 13:51:24 GMT, Alan Bateman <alanb at openjdk.org> wrote:

>> Brian Burkhalter has updated the pull request incrementally with one additional commit since the last revision:
>> 
>>   8241619: change "if" to "IF"; link optional specific exception doc
>
> src/java.base/share/classes/java/nio/file/spi/package-info.java line 36:
> 
>> 34:  * java.lang.NullPointerException NullPointerException} to be thrown.  In some
>> 35:  * cases methods which are specified to throw an {@code IOException} may throw
>> 36:  * a more precise <a href="../file/package-summary.html#optspecex">optional
> 
> The terminology in the reference section is "optional specific exception" so it would be more consistent to continue with "specific" rather than switching to "precise" here. I'm in two minds about adding this to the java.nio.channels package description as it's only applicable to the static open methods defined by FileChannel and AsynchronousFileChannel.

Changed "precise" to "specific" and removed update to `java.nio.channels` package doc.

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

PR: https://git.openjdk.java.net/jdk/pull/2980