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

[Alan Bateman]

On Mon, 22 May 2023 07:00:27 GMT, Nagata-Haruhito <duke at openjdk.org> wrote:

>> src/java.base/share/classes/java/io/File.java line 1828:
>> 
>>> 1826:      * namely {@code "/"}.  The set of filesystem roots is affected
>>> 1827:      * by various system-level operations such as the disconnecting or
>>> 1828:      * unmounting of physical or virtual disk drives.
>> 
>> I think you'll have to move this to the end of the method description, otherwise the paragraphs that follow will show up as "Implementation Note" too.
>
> I think following two paragraphs belongs to `Implementation Note` too, because of UNC pathname and SecurityException. 
> Is it wrong?

The paragraph about that the result is filtered when checkRead is denied by the SecurityException is normative.

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

PR Review Comment: https://git.openjdk.org/jdk/pull/13526#discussion_r1200052457