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

[Brian Burkhalter]

> Clarify that `Files::mismatch` does not access the file system if both paths locate the same file. Add package documentation about file operations on directories being implementation specific.

Brian Burkhalter has updated the pull request incrementally with one additional commit since the last revision:

  8214248: Revise verbiage; revert package file

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

Changes:
  - all: https://git.openjdk.org/jdk/pull/15350/files
  - new: https://git.openjdk.org/jdk/pull/15350/files/a845d194..1bd9436a

Webrevs:
 - full: https://webrevs.openjdk.org/?repo=jdk&pr=15350&range=01
 - incr: https://webrevs.openjdk.org/?repo=jdk&pr=15350&range=00-01

  Stats: 13 lines in 2 files changed: 1 ins; 6 del; 6 mod
  Patch: https://git.openjdk.org/jdk/pull/15350.diff
  Fetch: git fetch https://git.openjdk.org/jdk.git pull/15350/head:pull/15350

PR: https://git.openjdk.org/jdk/pull/15350