--- a/jdk/src/java.base/share/classes/java/security/MessageDigest.java Mon Oct 19 17:26:01 2015 -0700
+++ b/jdk/src/java.base/share/classes/java/security/MessageDigest.java Mon Oct 19 17:35:18 2015 -0700
@@ -146,6 +146,13 @@
* <p> Note that the list of registered providers may be retrieved via
* the {@link Security#getProviders() Security.getProviders()} method.
*
+ * @implNote
+ * The JDK Reference Implementation additionally uses the
+ * {@code jdk.security.provider.preferred} property to determine
+ * the preferred provider order for the specified algorithm. This
+ * may be different than the order of providers returned by
+ * {@link Security#getProviders() Security.getProviders()}.
+ *
* @param algorithm the name of the algorithm requested.
* See the MessageDigest section in the <a href=
* "{@docRoot}/../technotes/guides/security/StandardNames.html#MessageDigest">