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

[Alan Bateman]

On Fri, 13 Sep 2024 22:05:40 GMT, Brian Burkhalter <bpb at openjdk.org> wrote:

>> 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: Move symbolic link verbiage from class to constructor doc in FIS/FOS/RAF

src/java.base/share/classes/java/io/RandomAccessFile.java line 108:

> 106:      * are automatically redirected to the <i>target</i> of the link.
> 107:      * If the access mode specifies writing and the file or link target exists,
> 108:      * then it will be truncated.

I think you've copied the text from FOS but it doesn't work here as RAF doesn't truncate.

For "r" mode, it opens an existing file. For the "rw" and variants, it opens an existing file, or creates a new file if it doesn't exist.

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

PR Review Comment: https://git.openjdk.org/jdk/pull/20878#discussion_r1759684960