RFR: 8290353: Clarify the streams returned by ModuleReader::list [v2]

[Ryan Ernst]

> 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.

Ryan Ernst has updated the pull request incrementally with two additional commits since the last revision:

 - adjust wording
 - fix uses of list() in java.base

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

Changes:
  - all: https://git.openjdk.org/jdk/pull/9538/files
  - new: https://git.openjdk.org/jdk/pull/9538/files/6c9750f7..0b3ca182

Webrevs:
 - full: https://webrevs.openjdk.org/?repo=jdk&pr=9538&range=01
 - incr: https://webrevs.openjdk.org/?repo=jdk&pr=9538&range=00-01

  Stats: 23 lines in 6 files changed: 10 ins; 0 del; 13 mod
  Patch: https://git.openjdk.org/jdk/pull/9538.diff
  Fetch: git fetch https://git.openjdk.org/jdk pull/9538/head:pull/9538

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