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

[Brian Burkhalter]

On Tue, 10 Sep 2024 18:05:13 GMT, Brian Burkhalter <bpb at openjdk.org> wrote:

>> src/java.base/share/classes/java/io/File.java line 1440:
>> 
>>> 1438:      * Renames the file denoted by this abstract pathname.  If this pathname
>>> 1439:      * denotes a symbolic link, then the link itself, not its target, will be
>>> 1440:      * renamed.
>> 
>> For FIS/FOS/RAF it's just two constructors in each that follow links so I'm wondering if might be better to put the text there. Also in the case of FOS (and RAF when "w" is in the mode) it will follow the linking when creating (or truncating in the case of FOS) the file and part of wonders if we need to say more on this.
>
>> or truncating in the case of FOS
> 
> For that matter, I don't see where truncation is explicitly mentioned in the FOS doc.

These comments are addressed in f492c36.

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

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