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

[Brian Burkhalter]

On Sat, 14 Sep 2024 06:47:40 GMT, Alan Bateman <alanb at openjdk.org> wrote:

>> 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/FileInputStream.java line 90:
> 
>> 88:      * in the file system.  {@linkplain java.nio.file##links Symbolic links}
>> 89:      * are automatically redirected to the <i>target</i> of the link.
>> 90:      * A new {@code FileDescriptor}
> 
> In passing (and not for this PR) is that we should probably change the first sentence to say that it opens an existing file and drop the use of "connection".

Tracked by [JDK-8340229](https://bugs.openjdk.org/browse/JDK-8340229).

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

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