RFR: 8366102: Clarification Needed: Symbolic Link Handling in File API Specifications [v2]

[Brian Burkhalter]

> Attempt to improve the verbiage of the `java.io.File` specification to make it clearer whether a given method operates only on an abstract pathname or on the actual file system entry it denotes.

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

  8366102: Update class-level spec, compareTo, and equals

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

Changes:
  - all: https://git.openjdk.org/jdk/pull/27006/files
  - new: https://git.openjdk.org/jdk/pull/27006/files/c1003dbd..5b970ebc

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

  Stats: 17 lines in 1 file changed: 2 ins; 4 del; 11 mod
  Patch: https://git.openjdk.org/jdk/pull/27006.diff
  Fetch: git fetch https://git.openjdk.org/jdk.git pull/27006/head:pull/27006

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