RFR: 8307409: Refactor usage examples to use @snippet in the java.nio packages [v2]

[Brian Burkhalter]

On Tue, 9 May 2023 05:51:34 GMT, Alan Bateman <alanb at openjdk.org> wrote:

>> Brian Burkhalter has updated the pull request incrementally with one additional commit since the last revision:
>> 
>>   8307409: Remove incorrect @link in @snippet
>
> src/java.base/share/classes/java/nio/file/Path.java line 849:
> 
>> 847:      * invocation
>> 848:      * {@snippet lang=java :
>> 849:      *     register(watcher, events, new WatchEvent.Modifier[0]);
> 
> It looks like the link has been lost, try changing it to:
> 
> // @link substring="register" target="Watchable#register" :
> register(watcher, events, new WatchEvent.Modifier[0]);

Thanks for the tip. Fixed in https://github.com/openjdk/jdk/pull/13870/commits/acd62d5ccadd0667b2b08aae9de531adbfdcc8b1.

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

PR Review Comment: https://git.openjdk.org/jdk/pull/13870#discussion_r1189162905