RFR: 8339574: Behavior of File.is{Directory,File,Hidden} is not documented with respect to symlinks [v2]

[Brian Burkhalter]

> Make explicit how the `java.io.File` methods `isDirectory`, `isFile`, and `isHidden` behave when the `File` represents a symbolic link.

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

  8339574: Add verbiage to class doc, delete(), and renameTo(); add implNote to isHidden(); revert isDirectory() and isFile() changes

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

Changes:
  - all: https://git.openjdk.org/jdk/pull/20878/files
  - new: https://git.openjdk.org/jdk/pull/20878/files/7fdc2322..3a68877c

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

  Stats: 26 lines in 1 file changed: 15 ins; 3 del; 8 mod
  Patch: https://git.openjdk.org/jdk/pull/20878.diff
  Fetch: git fetch https://git.openjdk.org/jdk.git pull/20878/head:pull/20878

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