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

[Alan Bateman]

On Wed, 17 May 2023 02:32:56 GMT, Nagata-Haruhito <duke at openjdk.org> wrote:

>> I fixed File.listRoots description.
>> * remove "the insertion or ejection of removable media"
>> * change "available" to "existing"
>> 
>> Please review this change.
>
> Nagata-Haruhito has updated the pull request incrementally with three additional commits since the last revision:
> 
>  - Merge branch 'File_javadoc' of https://github.com/Nagata-Haruhito/jdk into File_javadoc
>  - Drop exist to available
>  - Merge branch 'master' into File_javadoc

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.

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

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