RFR: 8285827: Describe the keystore.pkcs12.legacy system property in the java.security file [v2]

[Weijun Wang]

> We added a new system property back in https://bugs.openjdk.java.net/browse/JDK-8153005 but it's better to describe it in the `java.security` file as well.
> 
> Please review the text. I especially added the last sentence so that people won't set `-Dkeystore.pkcs12.legacy=false`.

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

  clearer text

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

Changes:
  - all: https://git.openjdk.java.net/jdk/pull/8452/files
  - new: https://git.openjdk.java.net/jdk/pull/8452/files/08700389..8a24c745

Webrevs:
 - full: https://webrevs.openjdk.java.net/?repo=jdk&pr=8452&range=01
 - incr: https://webrevs.openjdk.java.net/?repo=jdk&pr=8452&range=00-01

  Stats: 18 lines in 1 file changed: 7 ins; 0 del; 11 mod
  Patch: https://git.openjdk.java.net/jdk/pull/8452.diff
  Fetch: git fetch https://git.openjdk.java.net/jdk pull/8452/head:pull/8452

PR: https://git.openjdk.java.net/jdk/pull/8452