RFR: 8306431: File.listRoots method description should be re-examined [v7]

[Alan Bateman]

On Fri, 26 May 2023 15:57:15 GMT, Brian Burkhalter <bpb at openjdk.org> wrote:

> > Would you please review this PR ?
> 
> We are in the last two weeks before JDK 21 rampdown phase 1 and so are rather busy. This PR has not been forgotten. Thanks for your patience.

Yeah, this is docs only so okay to do after the fork for RDP1. I think the current PR is okay but this method, plus FileSystem::getRootDirectories, need a sentence to that something like “There is no guarantee that the root directory can be accessed”. I don't have an opinion on whether it is this PR or another one.

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

PR Comment: https://git.openjdk.org/jdk/pull/13526#issuecomment-1576719785