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