RFR: 8214248: (fs) Files:mismatch spec clarifications [v2]

[Brian Burkhalter]

On Mon, 21 Aug 2023 15:59:22 GMT, Brian Burkhalter <bpb at openjdk.org> wrote:

>> src/java.base/share/classes/java/nio/file/Files.java line 1574:
>> 
>>> 1572:      * and {@code g}, {@code mismatch(f,g)} will return the same value as
>>> 1573:      * {@code mismatch(g,f)}). The only case where there is no file system
>>> 1574:      * access is when the paths are equal.
>> 
>> What would you think of putting this in a new paragraph with "If both Path objects are equal then this method returns true without checking if the file exists"? This would be consistent with isSameFlie?
>> 
>> The updated description for the security exceptions looks okay.
>
> Sounds reasonable.

So changed in 46384485ca6ccc0d2aab7d3fc1a20b5976d88425.

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

PR Review Comment: https://git.openjdk.org/jdk/pull/15350#discussion_r1300335149