RFR: 8366102: Clarification Needed: Symbolic Link Handling in File API Specifications

[Francesco Andreuzzi]

On Fri, 29 Aug 2025 15:01:51 GMT, Brian Burkhalter <bpb at openjdk.org> wrote:

> Attempt to improve the verbiage of the `java.io.File` specification to make it clearer whether a given method operates only on an abstract pathname or on the actual file system entry it denotes.

src/java.base/share/classes/java/io/File.java line 85:

> 83:  * <p> Unless otherwise noted, {@linkplain java.nio.file##links symbolic links}
> 84:  * are automatically redirected to the <i>target</i> of the link, whether they
> 85:  * are provided by a pathname string or via a {@code File} object.  Methods

Suggestion:

 * are provided by a pathname string or via a {@code File} object. Methods

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

PR Review Comment: https://git.openjdk.org/jdk/pull/27006#discussion_r2310430983