hg: jdk9/sandbox/jdk: 8180635: (doc) Clarify the compatibility and interoperability issue when using provider default values

[chris.hegarty at oracle.com]

Changeset: 6435d673ea25
Author:    valeriep
Date:      2017-06-01 03:26 +0000
URL:       http://hg.openjdk.java.net/jdk9/sandbox/jdk/rev/6435d673ea25

8180635: (doc) Clarify the compatibility and interoperability issue when using provider default values
Summary: updated the javadoc of KeyPairGenerator, KeyGenerator, AlgorithmParameterGenerator and their Spi classes
Reviewed-by: mullan

! src/java.base/share/classes/java/security/AlgorithmParameterGenerator.java
! src/java.base/share/classes/java/security/AlgorithmParameterGeneratorSpi.java
! src/java.base/share/classes/java/security/KeyPairGenerator.java
! src/java.base/share/classes/java/security/KeyPairGeneratorSpi.java
! src/java.base/share/classes/javax/crypto/KeyGenerator.java
! src/java.base/share/classes/javax/crypto/KeyGeneratorSpi.java