RFR: 8358530: Properties#list should warn against non-String values [v2]

[cagliostro92]

> Trivial PR to enhance Javadoc for the `Properties#list` method, which has cost me some debugging time.

cagliostro92 has updated the pull request incrementally with one additional commit since the last revision:

  8358530: adds warnings against non-String values in Properties class documentation

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

Changes:
  - all: https://git.openjdk.org/jdk/pull/25334/files
  - new: https://git.openjdk.org/jdk/pull/25334/files/7e28926d..8d7e3d2f

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

  Stats: 4 lines in 1 file changed: 0 ins; 0 del; 4 mod
  Patch: https://git.openjdk.org/jdk/pull/25334.diff
  Fetch: git fetch https://git.openjdk.org/jdk.git pull/25334/head:pull/25334

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