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

[Brian Burkhalter]

On Fri, 29 Aug 2025 15:09:37 GMT, Francesco Andreuzzi <duke 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

You will notice that in this source file the convention is to separate with two spaces the period ending a sentence with the first letter of the subsequent sentence. In any case, it makes no difference in the rendered HTML.

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

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