[9] RFR 8180635: (doc) Clarify the compatibility and interoperability issue when using provider default values

[Valerie Peng]

Sean,

Thanks for the wording suggestions.
Webrev updated at: http://cr.openjdk.java.net/~valeriep/8180635/webrev.01/

Have a wonderful long weekend,
Valerie

On 5/26/2017 5:48 AM, Sean Mullan wrote:
> Just a couple of comments:
>
> - the same text is in KeyPairGeneratorSpi and 
> AlgorithmParameterGeneratorSpi so we should add the warning in those 
> classes too
>
> - we should add the same warning to javax.crypto.KeyGenerator and 
> KeyGeneratorSpi
>
> - Please change "Oracle Providers" to "JDK Providers", since all of 
> these providers are included in the JDK implementation, and we don't 
> want to include "Oracle" in the javadocs. (Plus the name of this guide 
> will be changed to "JDK Providers" at some point in the near future).
>
> - Suggest changing the sentence "Even ..." to "Additionally, the 
> default value for a provider may change in a future version."
>
> - s/Thus/Therefore/
>
> --Sean
>
> On 5/23/17 10:13 PM, Valerie Peng wrote:
>> Sean,
>>
>> Can you please review this javadoc-only changes for JDK 9?
>>
>> Bug: https://bugs.openjdk.java.net/browse/JDK-8180635
>> Webrev: http://cr.openjdk.java.net/~valeriep/8180635/webrev.00/
>>
>> Thanks,
>> Valerie
>
>