RFR: 8262742: (fs) Add Path::resolve with varargs string [v5]

[Alan Bateman]

On Fri, 14 Jul 2023 16:49:05 GMT, Brian Burkhalter <bpb at openjdk.org> wrote:

>> Add to `java.nio.file.Path` methods which allow resolution of multiple descendants.
>
> Brian Burkhalter has updated the pull request incrementally with one additional commit since the last revision:
> 
>   8262742: Improve verbiage per reviewer PR comments

src/java.base/share/classes/java/nio/file/Path.java line 527:

> 525:      * {@code more} specifies one or more {@code Path}s, then each non-empty
> 526:      * {@code Path}, including {@code first}, is resolved iteratively against
> 527:      * this {@code Path}.

The second paragraph has the same issue as before, it says "resolved iteratively against this Path" but that isn't correct. Same issue in the description of the "more" method.  The first paragraph is correct, and I think we'll need to re-phrase the second paragraph to accurate specify how the iterative resolution works.

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

PR Review Comment: https://git.openjdk.org/jdk/pull/14805#discussion_r1264348985