RFR: 8343823: (fs) Files.createLink: inconsistent behavior when creating link to symbolic link

[Alan Bateman]

On Tue, 19 Nov 2024 21:33:42 GMT, Brian Burkhalter <bpb at openjdk.org> wrote:

> Add an API note to `java.nio.file.Files.createLink` to make explicit that the behavior when the target is a symbolic link is unspecified.

src/java.base/share/classes/java/nio/file/Files.java line 997:

> 995:      * whether the new link is for the target of the symbolic link or for the
> 996:      * symbolic link itself is platform dependent and therefore not specified.
> 997:      *

I think is has to be part of the method description rather than an apiNote.

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

PR Review Comment: https://git.openjdk.org/jdk/pull/22257#discussion_r1849635549