address more comments on spec wording

wangweij · Jan 8, 2025 · 0145bd9 · 0145bd9
1 parent 4634ab1
commit 0145bd9
Show file tree

Hide file tree

Showing 3 changed files with 5 additions and 5 deletions.
diff --git a/src/java.base/share/classes/java/security/spec/X509EncodedKeySpec.java b/src/java.base/share/classes/java/security/spec/X509EncodedKeySpec.java
@@ -73,7 +73,7 @@ public X509EncodedKeySpec(byte[] encodedKey) {
      * @param encodedKey the key, which is assumed to be
      * encoded according to the X.509 standard. The contents of the
      * array are copied to protect against subsequent modification.
-     * @param algorithm the algorithm name of the encoded public key
+     * @param algorithm the algorithm name of the encoded public key.
      * See the AsymmetricKey Algorithms section in the
      * <a href="{@docRoot}/../specs/security/standard-names.html#asymmetrickey-algorithms">
      * Java Security Standard Algorithm Names Specification</a>

diff --git a/src/java.base/share/classes/javax/crypto/KEM.java b/src/java.base/share/classes/javax/crypto/KEM.java
@@ -227,7 +227,7 @@ public Encapsulated encapsulate() {
          *          <a href="{@docRoot}/../specs/security/standard-names.html#secretkey-algorithms">
          *          Java Security Standard Algorithm Names Specification</a>
          *          for information about standard secret key algorithm names.
-         *          Use "Generic" if the output will be used as the input keying
+         *          Specify "Generic" if the output will be used as the input keying
          *          material of a key derivation function (KDF).
          * @return a {@link Encapsulated} object containing a portion of
          *          the shared secret, key encapsulation message, and optional
@@ -357,7 +357,7 @@ public SecretKey decapsulate(byte[] encapsulation) throws DecapsulateException {
          *          <a href="{@docRoot}/../specs/security/standard-names.html#secretkey-algorithms">
          *          Java Security Standard Algorithm Names Specification</a>
          *          for information about standard secret key algorithm names.
-         *          Use "Generic" if the output will be used as the input keying
+         *          Specify "Generic" if the output will be used as the input keying
          *          material of a key derivation function (KDF).
          * @return a portion of the shared secret as a {@code SecretKey}
          *          containing the bytes of the secret ranging from {@code from}

diff --git a/src/java.base/share/classes/javax/crypto/KEMSpi.java b/src/java.base/share/classes/javax/crypto/KEMSpi.java
@@ -134,7 +134,7 @@ interface EncapsulatorSpi {
          *          <a href="{@docRoot}/../specs/security/standard-names.html#secretkey-algorithms">
          *          Java Security Standard Algorithm Names Specification</a>
          *          for information about standard secret key algorithm names.
-         *          Use "Generic" if the output will be used as the input keying
+         *          Specify "Generic" if the output will be used as the input keying
          *          material of a key derivation function (KDF).
          * @return an {@link KEM.Encapsulated} object containing a portion of
          *          the shared secret as a key with the specified algorithm,
@@ -200,7 +200,7 @@ interface DecapsulatorSpi {
          *          <a href="{@docRoot}/../specs/security/standard-names.html#secretkey-algorithms">
          *          Java Security Standard Algorithm Names Specification</a>
          *          for information about standard secret key algorithm names.
-         *          Use "Generic" if the output will be used as the input keying
+         *          Specify "Generic" if the output will be used as the input keying
          *          material of a key derivation function (KDF).
          * @return a portion of the shared secret as a {@code SecretKey} with
          *          the specified algorithm