RFR 8175846: Provide javadoc descriptions for jdk.policytool and jdk.crypto.* modules

[Weijun Wang]

Please review the patch below. I don't know if all those jdk.crypto.* 
modules will be listed in the doc, but it's nice to include a comment.

Thanks
Max

diff --git a/src/jdk.policytool/share/classes/module-info.java 
b/src/jdk.policytool/share/classes/module-info.java
--- a/src/jdk.policytool/share/classes/module-info.java
+++ b/src/jdk.policytool/share/classes/module-info.java
@@ -23,6 +23,14 @@
   * questions.
   */

+/**
+ * GUI tool for managing policy files.
+ *
+ * @since 9
+ * @deprecated The policytool tool has been deprecated and
+ * is planned to be removed in a future release.
+ */
+ at Deprecated
  module jdk.policytool {
      requires java.desktop;
      requires java.logging;

diff --git a/src/jdk.crypto.cryptoki/share/classes/module-info.java 
b/src/jdk.crypto.cryptoki/share/classes/module-info.java
--- a/src/jdk.crypto.cryptoki/share/classes/module-info.java
+++ b/src/jdk.crypto.cryptoki/share/classes/module-info.java
@@ -23,6 +23,11 @@
   * questions.
   */

+/**
+ * The SunPKCS11 security provider.
+ *
+ * @since 9
+ */
  module jdk.crypto.cryptoki {
      // Depends on SunEC provider for EC related functionality
      requires jdk.crypto.ec;
diff --git a/src/jdk.crypto.ec/share/classes/module-info.java 
b/src/jdk.crypto.ec/share/classes/module-info.java
--- a/src/jdk.crypto.ec/share/classes/module-info.java
+++ b/src/jdk.crypto.ec/share/classes/module-info.java
@@ -23,6 +23,11 @@
   * questions.
   */

+/**
+ * The SunEC security provider.
+ *
+ * @since 9
+ */
  module jdk.crypto.ec {
      provides java.security.Provider with sun.security.ec.SunEC;
  }
diff --git a/src/jdk.crypto.mscapi/windows/classes/module-info.java 
b/src/jdk.crypto.mscapi/windows/classes/module-info.java
--- a/src/jdk.crypto.mscapi/windows/classes/module-info.java
+++ b/src/jdk.crypto.mscapi/windows/classes/module-info.java
@@ -23,6 +23,11 @@
   * questions.
   */

+/**
+ * The SunMSCAPI security provider.
+ *
+ * @since 9
+ */
  module jdk.crypto.mscapi {
      provides java.security.Provider with sun.security.mscapi.SunMSCAPI;
  }
diff --git a/src/jdk.crypto.ucrypto/solaris/classes/module-info.java 
b/src/jdk.crypto.ucrypto/solaris/classes/module-info.java
--- a/src/jdk.crypto.ucrypto/solaris/classes/module-info.java
+++ b/src/jdk.crypto.ucrypto/solaris/classes/module-info.java
@@ -23,6 +23,11 @@
   * questions.
   */

+/**
+ * The OracleUCrypto security provider.
+ *
+ * @since 9
+ */
  module jdk.crypto.ucrypto {
      provides java.security.Provider with 
com.oracle.security.ucrypto.UcryptoProvider;
  }

Thanks
Max