JDK 9 RFR of 8148821: (fs) Path.getParent() javadoc error

Roger Riggs Roger.Riggs at Oracle.com
Wed Feb 3 21:05:44 UTC 2016


Hi Brian,

Looks ok to me.

I would say CCC not required because the case of one element (no parent) 
is defined to return null
and calling subpath(0,0) would throw IAE.  Your fix makes the 
description consistent.

Roger


On 2/3/2016 3:47 PM, Brian Burkhalter wrote:
> Please review this simple doc-only change at your convenience.
>
> Issue:https://bugs.openjdk.java.net/browse/JDK-8148821
> Patch:
>
> diff --git a/src/java.base/share/classes/java/nio/file/Path.java 
> b/src/java.base/share/classes/java/nio/file/Path.java
> --- a/src/java.base/share/classes/java/nio/file/Path.java
> +++ b/src/java.base/share/classes/java/nio/file/Path.java
> @@ -150,7 +150,7 @@
>       * #normalize normalize} method, to eliminate redundant names, 
> for cases where
>       * <em>shell-like</em> navigation is required.
>       *
> -     * <p> If this path has *one or more elements*, and no root 
> component, then
> +     * <p> If this path has *more than one element*, and no root 
> component, then
>       * this method is equivalent to evaluating the expression:
>       * <blockquote><pre>
>       * subpath(0, getNameCount()-1);
>
> A CCC request will be filed if needs must. There is no implementation 
> change and no change in behavior.
>
> Thanks,
>
> Brian



More information about the nio-dev mailing list