RFR: 8290353: Clarify the streams returned by ModuleReader::list

[Chris Hegarty]

On Mon, 18 Jul 2022 14:06:00 GMT, Ryan Ernst <duke at openjdk.org> wrote:

> This commit adds additional clarification to the javadocs of
> ModuleReader::list about needing to close the stream. The new wording is
> similar to that used in Files::find and other similar methods.

Given the recommendation to close streams returned by the `list` method, then this PR could be extended to update any usages in, at least, java.base. If there are many usages beyond java.base, then a separate issue could be filed to update them too.  ( if not already covered by a previous PR in this area )

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

PR: https://git.openjdk.org/jdk/pull/9538