RFR: 8267569: java.io.File.equals contains misleading Javadoc [v3]

[Brian Burkhalter]

> Modify the specification of `java.io.File.equals` to clarify that equality is based only on a comparison of abstract pathnames as opposed to the file system objects that the `File`s represent.

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

  8267569: Change @implNote to @apiNote

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

Changes:
  - all: https://git.openjdk.java.net/jdk/pull/4232/files
  - new: https://git.openjdk.java.net/jdk/pull/4232/files/acd072ab..1e37eacd

Webrevs:
 - full: https://webrevs.openjdk.java.net/?repo=jdk&pr=4232&range=02
 - incr: https://webrevs.openjdk.java.net/?repo=jdk&pr=4232&range=01-02

  Stats: 4 lines in 1 file changed: 0 ins; 1 del; 3 mod
  Patch: https://git.openjdk.java.net/jdk/pull/4232.diff
  Fetch: git fetch https://git.openjdk.java.net/jdk pull/4232/head:pull/4232

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