8347065: Add missing @spec tags for Java Security Standard Algorithm Names

Reviewed-by: weijun

src/java.base/share/classes/java/security/AlgorithmParameterGenerator.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 1997, 2022, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 1997, 2025, Oracle and/or its affiliates. All rights reserved.
  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
  *
  * This code is free software; you can redistribute it and/or modify it
@@ -88,6 +88,7 @@ import sun.security.jca.JCAUtil;
  * Consult the release documentation for your implementation to see if any
  * other algorithms are supported.
  *
+ * @spec security/standard-names.html Java Security Standard Algorithm Names
  * @author Jan Luehe
  *
  *
@@ -161,6 +162,7 @@ public class AlgorithmParameterGenerator {
      * Java Security Standard Algorithm Names Specification</a>
      * for information about standard algorithm names.
      *
+     * @spec security/standard-names.html Java Security Standard Algorithm Names
      * @return the new {@code AlgorithmParameterGenerator} object
      *
      * @throws NoSuchAlgorithmException if no {@code Provider} supports an
@@ -208,6 +210,7 @@ public class AlgorithmParameterGenerator {
      *
      * @param provider the string name of the {@code Provider}.
      *
+     * @spec security/standard-names.html Java Security Standard Algorithm Names
      * @return the new {@code AlgorithmParameterGenerator} object
      *
      * @throws IllegalArgumentException if the provider name is {@code null}
@@ -258,6 +261,7 @@ public class AlgorithmParameterGenerator {
      *
      * @param provider the {@code Provider} object.
      *
+     * @spec security/standard-names.html Java Security Standard Algorithm Names
      * @return the new {@code AlgorithmParameterGenerator} object
      *
      * @throws IllegalArgumentException if the specified provider is

src/java.base/share/classes/java/security/AlgorithmParameters.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 1997, 2024, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 1997, 2025, Oracle and/or its affiliates. All rights reserved.
  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
  *
  * This code is free software; you can redistribute it and/or modify it
@@ -69,6 +69,7 @@ import java.util.Objects;
  * Consult the release documentation for your implementation to see if any
  * other algorithms are supported.
  *
+ * @spec security/standard-names.html Java Security Standard Algorithm Names
  * @author Jan Luehe
  *
  *
@@ -147,6 +148,7 @@ public class AlgorithmParameters {
      * Java Security Standard Algorithm Names Specification</a>
      * for information about standard algorithm names.
      *
+     * @spec security/standard-names.html Java Security Standard Algorithm Names
      * @return the new parameter object
      *
      * @throws NoSuchAlgorithmException if no {@code Provider} supports an
@@ -194,6 +196,7 @@ public class AlgorithmParameters {
      *
      * @param provider the name of the provider.
      *
+     * @spec security/standard-names.html Java Security Standard Algorithm Names
      * @return the new parameter object
      *
      * @throws IllegalArgumentException if the provider name is {@code null}
@@ -244,6 +247,7 @@ public class AlgorithmParameters {
      *
      * @param provider the name of the provider.
      *
+     * @spec security/standard-names.html Java Security Standard Algorithm Names
      * @return the new parameter object
      *
      * @throws IllegalArgumentException if the provider is {@code null}

src/java.base/share/classes/java/security/DrbgParameters.java

@@ -229,6 +229,7 @@ import java.util.Objects;
  *
  * @spec https://nvlpubs.nist.gov/nistpubs/SpecialPublications/NIST.SP.800-90Ar1.pdf
  *      Recommendation for Random Number Generation Using Deterministic Random Bit Generators
+ * @spec security/standard-names.html Java Security Standard Algorithm Names
  *
  * @since 9
  */

src/java.base/share/classes/java/security/KeyFactory.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 1997, 2024, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 1997, 2025, Oracle and/or its affiliates. All rights reserved.
  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
  *
  * This code is free software; you can redistribute it and/or modify it
@@ -84,6 +84,7 @@ import sun.security.jca.GetInstance.Instance;
  * Consult the release documentation for your implementation to see if any
  * other algorithms are supported.
  *
+ * @spec security/standard-names.html Java Security Standard Algorithm Names
  * @author Jan Luehe
  *
  * @see Key
@@ -169,6 +170,7 @@ public class KeyFactory {
      * Java Security Standard Algorithm Names Specification</a>
      * for information about standard algorithm names.
      *
+     * @spec security/standard-names.html Java Security Standard Algorithm Names
      * @return the new {@code KeyFactory} object
      *
      * @throws NoSuchAlgorithmException if no {@code Provider} supports a
@@ -205,6 +207,7 @@ public class KeyFactory {
      *
      * @param provider the name of the provider.
      *
+     * @spec security/standard-names.html Java Security Standard Algorithm Names
      * @return the new {@code KeyFactory} object
      *
      * @throws IllegalArgumentException if the provider name is {@code null}
@@ -247,6 +250,7 @@ public class KeyFactory {
      *
      * @param provider the provider.
      *
+     * @spec security/standard-names.html Java Security Standard Algorithm Names
      * @return the new {@code KeyFactory} object
      *
      * @throws IllegalArgumentException if the specified provider is

src/java.base/share/classes/java/security/KeyPairGenerator.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 1997, 2024, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 1997, 2025, Oracle and/or its affiliates. All rights reserved.
  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
  *
  * This code is free software; you can redistribute it and/or modify it
@@ -131,6 +131,7 @@ import sun.security.util.Debug;
  * Consult the release documentation for your implementation to see if any
  * other algorithms are supported.
  *
+ * @spec security/standard-names.html Java Security Standard Algorithm Names
  * @author Benjamin Renaud
  * @since 1.1
  *
@@ -157,6 +158,7 @@ public abstract class KeyPairGenerator extends KeyPairGeneratorSpi {
      * "{@docRoot}/../specs/security/standard-names.html#keypairgenerator-algorithms">
      * Java Security Standard Algorithm Names Specification</a>
      * for information about standard algorithm names.
+     * @spec security/standard-names.html Java Security Standard Algorithm Names
      */
     protected KeyPairGenerator(String algorithm) {
         this.algorithm = algorithm;
@@ -169,6 +171,7 @@ public abstract class KeyPairGenerator extends KeyPairGeneratorSpi {
      * Java Security Standard Algorithm Names Specification</a>
      * for information about standard algorithm names.
      *
+     * @spec security/standard-names.html Java Security Standard Algorithm Names
      * @return the standard string name of the algorithm.
      */
     public String getAlgorithm() {
@@ -221,6 +224,7 @@ public abstract class KeyPairGenerator extends KeyPairGeneratorSpi {
      * Java Security Standard Algorithm Names Specification</a>
      * for information about standard algorithm names.
      *
+     * @spec security/standard-names.html Java Security Standard Algorithm Names
      * @return the new {@code KeyPairGenerator} object
      *
      * @throws NoSuchAlgorithmException if no {@code Provider} supports a
@@ -280,6 +284,7 @@ public abstract class KeyPairGenerator extends KeyPairGeneratorSpi {
      *
      * @param provider the string name of the provider.
      *
+     * @spec security/standard-names.html Java Security Standard Algorithm Names
      * @return the new {@code KeyPairGenerator} object
      *
      * @throws IllegalArgumentException if the provider name is {@code null}
@@ -320,6 +325,7 @@ public abstract class KeyPairGenerator extends KeyPairGeneratorSpi {
      * Java Security Standard Algorithm Names Specification</a>
      * for information about standard algorithm names.
      *
+     * @spec security/standard-names.html Java Security Standard Algorithm Names
      * @param provider the provider.
      *
      * @return the new {@code KeyPairGenerator} object

src/java.base/share/classes/java/security/KeyStore.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 1997, 2024, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 1997, 2025, Oracle and/or its affiliates. All rights reserved.
  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
  *
  * This code is free software; you can redistribute it and/or modify it
@@ -183,6 +183,7 @@ import sun.security.util.Debug;
  * Consult the release documentation for your implementation to see if any
  * other types are supported.
  *
+ * @spec security/standard-names.html Java Security Standard Algorithm Names
  * @author Jan Luehe
  *
  * @see java.security.PrivateKey
@@ -300,6 +301,7 @@ public class KeyStore {
          * @throws    NullPointerException if {@code protectionAlgorithm} is
          *     {@code null}
          *
+         * @spec security/standard-names.html Java Security Standard Algorithm Names
          * @since 1.8
          */
         public PasswordProtection(char[] password, String protectionAlgorithm,
@@ -852,6 +854,7 @@ public class KeyStore {
      * Java Security Standard Algorithm Names Specification</a>
      * for information about standard keystore types.
      *
+     * @spec security/standard-names.html Java Security Standard Algorithm Names
      * @return a keystore object of the specified type
      *
      * @throws KeyStoreException if no provider supports a
@@ -893,6 +896,7 @@ public class KeyStore {
      *
      * @param provider the name of the provider.
      *
+     * @spec security/standard-names.html Java Security Standard Algorithm Names
      * @return a keystore object of the specified type
      *
      * @throws IllegalArgumentException if the provider name is {@code null}
@@ -939,6 +943,7 @@ public class KeyStore {
      *
      * @param provider the provider.
      *
+     * @spec security/standard-names.html Java Security Standard Algorithm Names
      * @return a keystore object of the specified type
      *
      * @throws IllegalArgumentException if the specified provider is

src/java.base/share/classes/java/security/MessageDigest.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 1996, 2024, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 1996, 2025, Oracle and/or its affiliates. All rights reserved.
  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
  *
  * This code is free software; you can redistribute it and/or modify it
@@ -96,6 +96,7 @@ import javax.crypto.SecretKey;
  * Consult the release documentation for your implementation to see if any
  * other algorithms are supported.
  *
+ * @spec security/standard-names.html Java Security Standard Algorithm Names
  * @author Benjamin Renaud
  * @since 1.1
  *
@@ -128,6 +129,7 @@ public abstract class MessageDigest extends MessageDigestSpi {
      * "{@docRoot}/../specs/security/standard-names.html#messagedigest-algorithms">
      * Java Security Standard Algorithm Names Specification</a>
      * for information about standard algorithm names.
+     * @spec security/standard-names.html Java Security Standard Algorithm Names
      */
     protected MessageDigest(String algorithm) {
         this.algorithm = algorithm;
@@ -166,6 +168,7 @@ public abstract class MessageDigest extends MessageDigestSpi {
      * Java Security Standard Algorithm Names Specification</a>
      * for information about standard algorithm names.
      *
+     * @spec security/standard-names.html Java Security Standard Algorithm Names
      * @return a {@code MessageDigest} object that implements the
      *         specified algorithm
      *
@@ -221,6 +224,7 @@ public abstract class MessageDigest extends MessageDigestSpi {
      *
      * @param provider the name of the provider.
      *
+     * @spec security/standard-names.html Java Security Standard Algorithm Names
      * @return a {@code MessageDigest} object that implements the
      *         specified algorithm
      *
@@ -275,6 +279,7 @@ public abstract class MessageDigest extends MessageDigestSpi {
      *
      * @param provider the provider.
      *
+     * @spec security/standard-names.html Java Security Standard Algorithm Names
      * @return a {@code MessageDigest} object that implements the
      *         specified algorithm
      *
@@ -513,6 +518,7 @@ public abstract class MessageDigest extends MessageDigestSpi {
      * Java Security Standard Algorithm Names Specification</a>
      * for information about standard algorithm names.
      *
+     * @spec security/standard-names.html Java Security Standard Algorithm Names
      * @return the name of the algorithm
      */
     public final String getAlgorithm() {

src/java.base/share/classes/java/security/SecureRandom.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 1996, 2024, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 1996, 2025, Oracle and/or its affiliates. All rights reserved.
  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
  *
  * This code is free software; you can redistribute it and/or modify it
@@ -144,7 +144,7 @@ import java.util.regex.Pattern;
  *      RFC 4086: Randomness Requirements for Security
  * @spec https://nvlpubs.nist.gov/nistpubs/FIPS/NIST.FIPS.140-2.pdf
  *      Security Requirements for Cryptographic Modules
- *
+ * @spec security/standard-names.html Java Security Standard Algorithm Names
  * @see java.security.SecureRandomSpi
  * @see java.util.Random
  *
@@ -214,6 +214,7 @@ public class SecureRandom extends java.util.Random {
      * "{@docRoot}/../specs/security/standard-names.html#securerandom-number-generation-algorithms">
      * Java Security Standard Algorithm Names Specification</a>
      * for information about standard RNG algorithm names.
+     * @spec security/standard-names.html Java Security Standard Algorithm Names
      */
     public SecureRandom() {
         /*
@@ -257,6 +258,7 @@ public class SecureRandom extends java.util.Random {
      * for information about standard RNG algorithm names.
      *
      * @param seed the seed.
+     * @spec security/standard-names.html Java Security Standard Algorithm Names
      * @throws NullPointerException if {@code seed} is {@code null}
      */
     public SecureRandom(byte[] seed) {
@@ -371,6 +373,7 @@ public class SecureRandom extends java.util.Random {
      * Java Security Standard Algorithm Names Specification</a>
      * for information about standard RNG algorithm names.
      *
+     * @spec security/standard-names.html Java Security Standard Algorithm Names
      * @return the new {@code SecureRandom} object
      *
      * @throws NoSuchAlgorithmException if no {@code Provider} supports a
@@ -412,6 +415,7 @@ public class SecureRandom extends java.util.Random {
      *
      * @param provider the name of the provider.
      *
+     * @spec security/standard-names.html Java Security Standard Algorithm Names
      * @return the new {@code SecureRandom} object
      *
      * @throws IllegalArgumentException if the provider name is {@code null}
@@ -456,6 +460,7 @@ public class SecureRandom extends java.util.Random {
      *
      * @param provider the provider.
      *
+     * @spec security/standard-names.html Java Security Standard Algorithm Names
      * @return the new {@code SecureRandom} object
      *
      * @throws IllegalArgumentException if the specified provider is
@@ -511,6 +516,7 @@ public class SecureRandom extends java.util.Random {
      * @param params the {@code SecureRandomParameters}
      *               the newly created {@code SecureRandom} object must support.
      *
+     * @spec security/standard-names.html Java Security Standard Algorithm Names
      * @return the new {@code SecureRandom} object
      *
      * @throws IllegalArgumentException if the specified params is
@@ -563,6 +569,7 @@ public class SecureRandom extends java.util.Random {
      *
      * @param provider the name of the provider.
      *
+     * @spec security/standard-names.html Java Security Standard Algorithm Names
      * @return the new {@code SecureRandom} object
      *
      * @throws IllegalArgumentException if the provider name is {@code null}
@@ -615,6 +622,7 @@ public class SecureRandom extends java.util.Random {
      *
      * @param provider the provider.
      *
+     * @spec security/standard-names.html Java Security Standard Algorithm Names
      * @return the new {@code SecureRandom} object
      *
      * @throws IllegalArgumentException if the specified provider or params

src/java.base/share/classes/java/security/SecureRandomSpi.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 1998, 2022, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 1998, 2025, Oracle and/or its affiliates. All rights reserved.
  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
  *
  * This code is free software; you can redistribute it and/or modify it
@@ -79,6 +79,7 @@ package java.security;
  * {@code SecureRandom} will call the applicable engine methods
  * without any synchronization.
  *
+ * @spec security/standard-names.html Java Security Standard Algorithm Names
  * @since 1.2
  */
 

src/java.base/share/classes/java/security/Signature.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 1996, 2024, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 1996, 2025, Oracle and/or its affiliates. All rights reserved.
  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
  *
  * This code is free software; you can redistribute it and/or modify it
@@ -122,6 +122,7 @@ import sun.security.util.KnownOIDs;
  * Consult the release documentation for your implementation to see if any
  * other algorithms are supported.
  *
+ * @spec security/standard-names.html Java Security Standard Algorithm Names
  * @author Benjamin Renaud
  * @since 1.1
  *
@@ -206,6 +207,7 @@ public abstract class Signature extends SignatureSpi {
      * "{@docRoot}/../specs/security/standard-names.html#signature-algorithms">
      * Java Security Standard Algorithm Names Specification</a>
      * for information about standard algorithm names.
+     * @spec security/standard-names.html Java Security Standard Algorithm Names
      */
     protected Signature(String algorithm) {
         this.algorithm = algorithm;
@@ -252,6 +254,7 @@ public abstract class Signature extends SignatureSpi {
      * Java Security Standard Algorithm Names Specification</a>
      * for information about standard algorithm names.
      *
+     * @spec security/standard-names.html Java Security Standard Algorithm Names
      * @return the new {@code Signature} object
      *
      * @throws NoSuchAlgorithmException if no {@code Provider} supports a
@@ -375,6 +378,7 @@ public abstract class Signature extends SignatureSpi {
      *
      * @param provider the name of the provider.
      *
+     * @spec security/standard-names.html Java Security Standard Algorithm Names
      * @return the new {@code Signature} object
      *
      * @throws IllegalArgumentException if the provider name is {@code null}
@@ -428,6 +432,7 @@ public abstract class Signature extends SignatureSpi {
      *
      * @param provider the provider.
      *
+     * @spec security/standard-names.html Java Security Standard Algorithm Names
      * @return the new {@code Signature} object
      *
      * @throws IllegalArgumentException if the provider is {@code null}

src/java.base/share/classes/java/security/cert/CertPath.java

@@ -111,6 +111,7 @@ import java.util.List;
  * generally not difficult, since the {@code CertPath} and
  * {@code List} objects in question are immutable.
  *
+ * @spec security/standard-names.html Java Security Standard Algorithm Names
  * @see CertificateFactory
  * @see CertPathBuilder
  *

src/java.base/share/classes/java/security/cert/CertPathBuilder.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2000, 2024, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2000, 2025, Oracle and/or its affiliates. All rights reserved.
  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
  *
  * This code is free software; you can redistribute it and/or modify it
@@ -90,6 +90,7 @@ import sun.security.jca.GetInstance.Instance;
  * threads each manipulating a different {@code CertPathBuilder} instance
  * need not synchronize.
  *
+ * @spec security/standard-names.html Java Security Standard Algorithm Names
  * @see CertPath
  *
  * @since       1.4
@@ -154,6 +155,7 @@ public class CertPathBuilder {
      * Java Security Standard Algorithm Names Specification</a>
      * for information about standard algorithm names.
      *
+     * @spec security/standard-names.html Java Security Standard Algorithm Names
      * @return a {@code CertPathBuilder} object that implements the
      *         specified algorithm
      *
@@ -194,6 +196,7 @@ public class CertPathBuilder {
      *
      * @param provider the name of the provider.
      *
+     * @spec security/standard-names.html Java Security Standard Algorithm Names
      * @return a {@code CertPathBuilder} object that implements the
      *         specified algorithm
      *
@@ -237,6 +240,7 @@ public class CertPathBuilder {
      *
      * @param provider the provider.
      *
+     * @spec security/standard-names.html Java Security Standard Algorithm Names
      * @return a {@code CertPathBuilder} object that implements the
      *         specified algorithm
      *

src/java.base/share/classes/java/security/cert/CertPathValidator.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2000, 2024, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2000, 2025, Oracle and/or its affiliates. All rights reserved.
  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
  *
  * This code is free software; you can redistribute it and/or modify it
@@ -92,6 +92,7 @@ import sun.security.jca.GetInstance.Instance;
  * threads each manipulating a different {@code CertPathValidator}
  * instance need not synchronize.
  *
+ * @spec security/standard-names.html Java Security Standard Algorithm Names
  * @see CertPath
  *
  * @since       1.4
@@ -155,6 +156,7 @@ public class CertPathValidator {
      * Java Security Standard Algorithm Names Specification</a>
      * for information about standard algorithm names.
      *
+     * @spec security/standard-names.html Java Security Standard Algorithm Names
      * @return a {@code CertPathValidator} object that implements the
      *         specified algorithm
      *
@@ -195,6 +197,7 @@ public class CertPathValidator {
      *
      * @param provider the name of the provider.
      *
+     * @spec security/standard-names.html Java Security Standard Algorithm Names
      * @return a {@code CertPathValidator} object that implements the
      *         specified algorithm
      *
@@ -239,6 +242,7 @@ public class CertPathValidator {
      *
      * @param provider the provider.
      *
+     * @spec security/standard-names.html Java Security Standard Algorithm Names
      * @return a {@code CertPathValidator} object that implements the
      *          specified algorithm
      *

src/java.base/share/classes/java/security/cert/CertStore.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2000, 2024, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2000, 2025, Oracle and/or its affiliates. All rights reserved.
  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
  *
  * This code is free software; you can redistribute it and/or modify it
@@ -84,6 +84,7 @@ import sun.security.jca.GetInstance.Instance;
  * Multiple threads may concurrently invoke the static methods defined in
  * this class with no ill effects.
  *
+ * @spec security/standard-names.html Java Security Standard Algorithm Names
  * @since       1.4
  * @author      Sean Mullan, Steve Hanna
  */
@@ -216,6 +217,7 @@ public class CertStore {
      *
      * @param params the initialization parameters (may be {@code null}).
      *
+     * @spec security/standard-names.html Java Security Standard Algorithm Names
      * @return a {@code CertStore} object that implements the specified
      *          {@code CertStore} type
      *
@@ -282,6 +284,7 @@ public class CertStore {
      *
      * @param provider the name of the provider.
      *
+     * @spec security/standard-names.html Java Security Standard Algorithm Names
      * @return a {@code CertStore} object that implements the
      *          specified type
      *
@@ -343,6 +346,7 @@ public class CertStore {
      *
      * @param provider the provider.
      *
+     * @spec security/standard-names.html Java Security Standard Algorithm Names
      * @return a {@code CertStore} object that implements the
      *          specified type
      *

src/java.base/share/classes/java/security/cert/Certificate.java

@@ -79,6 +79,7 @@ public abstract class Certificate implements java.io.Serializable {
      * "{@docRoot}/../specs/security/standard-names.html#certificatefactory-types">
      * Java Security Standard Algorithm Names Specification</a>
      * for information about standard certificate types.
+     * @spec security/standard-names.html Java Security Standard Algorithm Names
      */
     protected Certificate(String type) {
         this.type = type;

src/java.base/share/classes/java/security/cert/CertificateFactory.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 1998, 2022, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 1998, 2025, Oracle and/or its affiliates. All rights reserved.
  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
  *
  * This code is free software; you can redistribute it and/or modify it
@@ -109,6 +109,7 @@ import sun.security.jca.GetInstance.Instance;
  * Consult the release documentation for your implementation to see if any
  * other types or encodings are supported.
  *
+ * @spec security/standard-names.html Java Security Standard Algorithm Names
  * @author Hemma Prafullchandra
  * @author Jan Luehe
  * @author Sean Mullan
@@ -176,6 +177,7 @@ public class CertificateFactory {
      * Java Security Standard Algorithm Names Specification</a>
      * for information about standard certificate types.
      *
+     * @spec security/standard-names.html Java Security Standard Algorithm Names
      * @return a certificate factory object for the specified type
      *
      * @throws CertificateException if no {@code Provider} supports a
@@ -219,6 +221,7 @@ public class CertificateFactory {
      *
      * @param provider the name of the provider.
      *
+     * @spec security/standard-names.html Java Security Standard Algorithm Names
      * @return a certificate factory object for the specified type
      *
      * @throws CertificateException if a {@code CertificateFactorySpi}
@@ -265,6 +268,7 @@ public class CertificateFactory {
      * for information about standard certificate types.
      * @param provider the provider.
      *
+     * @spec security/standard-names.html Java Security Standard Algorithm Names
      * @return a certificate factory object for the specified type
      *
      * @throws CertificateException if a {@code CertificateFactorySpi}
@@ -369,6 +373,7 @@ public class CertificateFactory {
      * {@code remove} method result in an
      * {@code UnsupportedOperationException}.
      *
+     * @spec security/standard-names.html Java Security Standard Algorithm Names
      * @return an {@code Iterator} over the names of the supported
      *         {@code CertPath} encodings (as {@code String}s)
      * @since 1.4
@@ -407,6 +412,7 @@ public class CertificateFactory {
      *
      * @param inStream an {@code InputStream} containing the data
      * @param encoding the encoding used for the data
+     * @spec security/standard-names.html Java Security Standard Algorithm Names
      * @return a {@code CertPath} initialized with the data from the
      *   {@code InputStream}
      * @throws    CertificateException if an exception occurs while decoding or

src/java.base/share/classes/java/security/cert/CertificateFactorySpi.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 1998, 2022, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 1998, 2025, Oracle and/or its affiliates. All rights reserved.
  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
  *
  * This code is free software; you can redistribute it and/or modify it
@@ -198,6 +198,7 @@ public abstract class CertificateFactorySpi {
      * existing service providers, this method cannot be {@code abstract}
      * and by default throws an {@code UnsupportedOperationException}.
      *
+     * @spec security/standard-names.html Java Security Standard Algorithm Names
      * @return an {@code Iterator} over the names of the supported
      *         {@code CertPath} encodings (as {@code String}s)
      * @throws    UnsupportedOperationException if the method is not supported

src/java.base/share/classes/java/security/spec/ECGenParameterSpec.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2003, 2024, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2003, 2025, Oracle and/or its affiliates. All rights reserved.
  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
  *
  * This code is free software; you can redistribute it and/or modify it
@@ -50,6 +50,7 @@ public class ECGenParameterSpec extends NamedParameterSpec {
      *        "{@docRoot}/../specs/security/standard-names.html#ecgenparameterspec">
      *        Java Security Standard Algorithm Names Specification</a> for
      *        information about standard names.
+     * @spec security/standard-names.html Java Security Standard Algorithm Names
      * @throws NullPointerException if {@code stdName} is null.
      */
     public ECGenParameterSpec(String stdName) {

src/java.base/share/classes/java/security/spec/EncodedKeySpec.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 1997, 2022, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 1997, 2025, Oracle and/or its affiliates. All rights reserved.
  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
  *
  * This code is free software; you can redistribute it and/or modify it
@@ -79,6 +79,7 @@ public abstract class EncodedKeySpec implements KeySpec {
      * "{@docRoot}/../specs/security/standard-names.html#keyfactory-algorithms">
      * Java Security Standard Algorithm Names Specification</a>
      * for information about standard algorithm names.
+     * @spec security/standard-names.html Java Security Standard Algorithm Names
      * @throws NullPointerException if {@code encodedKey}
      * or {@code algorithm} is null.
      * @throws IllegalArgumentException if {@code algorithm} is

src/java.base/share/classes/java/security/spec/NamedParameterSpec.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2018, 2024, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2018, 2025, Oracle and/or its affiliates. All rights reserved.
  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
  *
  * This code is free software; you can redistribute it and/or modify it
@@ -36,6 +36,7 @@ import java.util.Objects;
  * "{@docRoot}/../specs/security/standard-names.html#namedparameterspec">
  *          Java Security Standard Algorithm Names Specification</a>.
  *
+ * @spec security/standard-names.html Java Security Standard Algorithm Names
  * @since 11
  *
  */
@@ -131,6 +132,7 @@ public class NamedParameterSpec implements AlgorithmParameterSpec {
      *        Java Security Standard Algorithm Names Specification</a> for
      *        information about standard names.
      *
+     * @spec security/standard-names.html Java Security Standard Algorithm Names
      * @throws NullPointerException if {@code stdName} is null.
      */
     public NamedParameterSpec(String stdName) {

src/java.base/share/classes/java/security/spec/PKCS8EncodedKeySpec.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 1997, 2017, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 1997, 2025, Oracle and/or its affiliates. All rights reserved.
  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
  *
  * This code is free software; you can redistribute it and/or modify it
@@ -88,6 +88,7 @@ public class PKCS8EncodedKeySpec extends EncodedKeySpec {
      * "{@docRoot}/../specs/security/standard-names.html#keyfactory-algorithms">
      * Java Security Standard Algorithm Names Specification</a>
      * for information about standard algorithm names.
+     * @spec security/standard-names.html Java Security Standard Algorithm Names
      * @throws NullPointerException if {@code encodedKey}
      * or {@code algorithm} is null.
      * @throws IllegalArgumentException if {@code algorithm} is

src/java.base/share/classes/java/security/spec/PSSParameterSpec.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2001, 2024, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2001, 2025, Oracle and/or its affiliates. All rights reserved.
  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
  *
  * This code is free software; you can redistribute it and/or modify it
@@ -140,6 +140,7 @@ public class PSSParameterSpec implements AlgorithmParameterSpec {
      *         getMGFParameters().
      * @param saltLen      the length of salt in bytes
      * @param trailerField the value of the trailer field
+     * @spec security/standard-names.html Java Security Standard Algorithm Names
      * @throws    NullPointerException if {@code mdName}, or {@code mgfName}
      *         is null
      * @throws    IllegalArgumentException if {@code saltLen} or

src/java.base/share/classes/java/security/spec/X509EncodedKeySpec.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 1997, 2017, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 1997, 2025, Oracle and/or its affiliates. All rights reserved.
  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
  *
  * This code is free software; you can redistribute it and/or modify it
@@ -78,6 +78,7 @@ public class X509EncodedKeySpec extends EncodedKeySpec {
      * "{@docRoot}/../specs/security/standard-names.html#keyfactory-algorithms">
      * Java Security Standard Algorithm Names Specification</a>
      * for information about standard algorithm names.
+     * @spec security/standard-names.html Java Security Standard Algorithm Names
      * @throws NullPointerException if {@code encodedKey}
      * or {@code algorithm} is null.
      * @throws IllegalArgumentException if {@code algorithm} is

src/java.base/share/classes/javax/crypto/Cipher.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 1997, 2024, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 1997, 2025, Oracle and/or its affiliates. All rights reserved.
  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
  *
  * This code is free software; you can redistribute it and/or modify it
@@ -169,6 +169,7 @@ import sun.security.util.KnownOIDs;
  *      RFC 5116: An Interface and Algorithms for Authenticated Encryption
  * @spec https://www.rfc-editor.org/info/rfc7539
  *      RFC 7539: ChaCha20 and Poly1305 for IETF Protocols
+ * @spec security/standard-names.html Java Security Standard Algorithm Names
  * @author Jan Luehe
  * @see KeyGenerator
  * @see SecretKey
@@ -520,6 +521,7 @@ public class Cipher {
      * Java Security Standard Algorithm Names Specification</a>
      * for information about standard transformation names.
      *
+     * @spec security/standard-names.html Java Security Standard Algorithm Names
      * @return a {@code Cipher} object that implements the requested
      * transformation
      *
@@ -611,6 +613,7 @@ public class Cipher {
      *
      * @param provider the name of the provider
      *
+     * @spec security/standard-names.html Java Security Standard Algorithm Names
      * @return a {@code Cipher} object that implements the requested
      * transformation
      *
@@ -683,6 +686,7 @@ public class Cipher {
      *
      * @param provider the provider
      *
+     * @spec security/standard-names.html Java Security Standard Algorithm Names
      * @return a {@code Cipher} object that implements the requested
      * transformation
      *

src/java.base/share/classes/javax/crypto/ExemptionMechanism.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 1999, 2024, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 1999, 2025, Oracle and/or its affiliates. All rights reserved.
  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
  *
  * This code is free software; you can redistribute it and/or modify it
@@ -129,6 +129,7 @@ public class ExemptionMechanism {
      * Java Security Standard Algorithm Names Specification</a>
      * for information about standard exemption mechanism names.
      *
+     * @spec security/standard-names.html Java Security Standard Algorithm Names
      * @return the new {@code ExemptionMechanism} object
      *
      * @throws NoSuchAlgorithmException if no {@code Provider} supports an
@@ -170,6 +171,7 @@ public class ExemptionMechanism {
      *
      * @param provider the name of the provider.
      *
+     * @spec security/standard-names.html Java Security Standard Algorithm Names
      * @return the new {@code ExemptionMechanism} object
      *
      * @throws IllegalArgumentException if the {@code provider}
@@ -214,6 +216,7 @@ public class ExemptionMechanism {
      *
      * @param provider the provider.
      *
+     * @spec security/standard-names.html Java Security Standard Algorithm Names
      * @return the new {@code ExemptionMechanism} object
      *
      * @throws IllegalArgumentException if the {@code provider}

src/java.base/share/classes/javax/crypto/KDF.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2024, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2024, 2025, Oracle and/or its affiliates. All rights reserved.
  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
  *
  * This code is free software; you can redistribute it and/or modify it
@@ -222,6 +222,7 @@ public final class KDF {
      *         Java Security Standard Algorithm Names Specification</a> for
      *         information about standard KDF algorithm names.
      *
+     * @spec security/standard-names.html Java Security Standard Algorithm Names
      * @return a {@code KDF} object
      *
      * @throws NoSuchAlgorithmException
@@ -256,6 +257,7 @@ public final class KDF {
      * @param provider
      *         the provider to use for this key derivation
      *
+     * @spec security/standard-names.html Java Security Standard Algorithm Names
      * @return a {@code KDF} object
      *
      * @throws NoSuchAlgorithmException
@@ -291,6 +293,7 @@ public final class KDF {
      * @param provider
      *         the provider to use for this key derivation
      *
+     * @spec security/standard-names.html Java Security Standard Algorithm Names
      * @return a {@code KDF} object
      *
      * @throws NoSuchAlgorithmException
@@ -332,6 +335,7 @@ public final class KDF {
      *         the {@code KDFParameters} used to configure the derivation
      *         algorithm or {@code null} if no parameters are provided
      *
+     * @spec security/standard-names.html Java Security Standard Algorithm Names
      * @return a {@code KDF} object
      *
      * @throws NoSuchAlgorithmException
@@ -375,6 +379,7 @@ public final class KDF {
      * @param provider
      *         the provider to use for this key derivation
      *
+     * @spec security/standard-names.html Java Security Standard Algorithm Names
      * @return a {@code KDF} object
      *
      * @throws NoSuchAlgorithmException
@@ -428,6 +433,7 @@ public final class KDF {
      * @param provider
      *         the provider to use for this key derivation
      *
+     * @spec security/standard-names.html Java Security Standard Algorithm Names
      * @return a {@code KDF} object
      *
      * @throws NoSuchAlgorithmException

src/java.base/share/classes/javax/crypto/KEM.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2023, 2024, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2023, 2025, Oracle and/or its affiliates. All rights reserved.
  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
  *
  * This code is free software; you can redistribute it and/or modify it
@@ -531,6 +531,7 @@ public final class KEM {
      *          "{@docRoot}/../specs/security/standard-names.html#kem-algorithms">
      *          Java Security Standard Algorithm Names Specification</a>
      *          for information about standard KEM algorithm names.
+     * @spec security/standard-names.html Java Security Standard Algorithm Names
      * @return the new {@code KEM} object
      * @throws NoSuchAlgorithmException if no {@code Provider} supports a
      *         {@code KEM} implementation for the specified algorithm
@@ -568,6 +569,7 @@ public final class KEM {
      *          for information about standard KEM algorithm names.
      * @param provider the provider. If {@code null}, this method is equivalent
      *                 to {@link #getInstance(String)}.
+     * @spec security/standard-names.html Java Security Standard Algorithm Names
      * @return the new {@code KEM} object
      * @throws NoSuchAlgorithmException if a {@code provider} is specified and
      *          it does not support the specified KEM algorithm,
@@ -599,6 +601,7 @@ public final class KEM {
      *          for information about standard KEM algorithm names.
      * @param provider the provider. If {@code null}, this method is equivalent
      *                 to {@link #getInstance(String)}.
+     * @spec security/standard-names.html Java Security Standard Algorithm Names
      * @return the new {@code KEM} object
      * @throws NoSuchAlgorithmException if a {@code provider} is specified and
      *          it does not support the specified KEM algorithm,

src/java.base/share/classes/javax/crypto/KeyAgreement.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 1997, 2024, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 1997, 2025, Oracle and/or its affiliates. All rights reserved.
  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
  *
  * This code is free software; you can redistribute it and/or modify it
@@ -71,6 +71,7 @@ import sun.security.jca.GetInstance.Instance;
  * Consult the release documentation for your implementation to see if any
  * other algorithms are supported.
  *
+ * @spec security/standard-names.html Java Security Standard Algorithm Names
  * @author Jan Luehe
  *
  * @see KeyGenerator
@@ -170,6 +171,7 @@ public class KeyAgreement {
      * Java Security Standard Algorithm Names Specification</a>
      * for information about standard algorithm names.
      *
+     * @spec security/standard-names.html Java Security Standard Algorithm Names
      * @return the new {@code KeyAgreement} object
      *
      * @throws NoSuchAlgorithmException if no {@code Provider} supports a
@@ -217,6 +219,7 @@ public class KeyAgreement {
      *
      * @param provider the name of the provider.
      *
+     * @spec security/standard-names.html Java Security Standard Algorithm Names
      * @return the new {@code KeyAgreement} object
      *
      * @throws IllegalArgumentException if the {@code provider}
@@ -261,6 +264,7 @@ public class KeyAgreement {
      *
      * @param provider the provider.
      *
+     * @spec security/standard-names.html Java Security Standard Algorithm Names
      * @return the new {@code KeyAgreement} object
      *
      * @throws IllegalArgumentException if the {@code provider}

src/java.base/share/classes/javax/crypto/KeyGenerator.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 1997, 2024, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 1997, 2025, Oracle and/or its affiliates. All rights reserved.
  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
  *
  * This code is free software; you can redistribute it and/or modify it
@@ -109,6 +109,7 @@ import sun.security.util.Debug;
  * Consult the release documentation for your implementation to see if any
  * other algorithms are supported.
  *
+ * @spec security/standard-names.html Java Security Standard Algorithm Names
  * @author Jan Luehe
  *
  * @see SecretKey
@@ -226,6 +227,7 @@ public class KeyGenerator {
      * Java Security Standard Algorithm Names Specification</a>
      * for information about standard algorithm names.
      *
+     * @spec security/standard-names.html Java Security Standard Algorithm Names
      * @return the new {@code KeyGenerator} object
      *
      * @throws NoSuchAlgorithmException if no {@code Provider} supports a
@@ -262,6 +264,7 @@ public class KeyGenerator {
      *
      * @param provider the name of the provider.
      *
+     * @spec security/standard-names.html Java Security Standard Algorithm Names
      * @return the new {@code KeyGenerator} object
      *
      * @throws IllegalArgumentException if the {@code provider}
@@ -305,6 +308,7 @@ public class KeyGenerator {
      *
      * @param provider the provider.
      *
+     * @spec security/standard-names.html Java Security Standard Algorithm Names
      * @return the new {@code KeyGenerator} object
      *
      * @throws IllegalArgumentException if the {@code provider}

src/java.base/share/classes/javax/crypto/Mac.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 1998, 2024, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 1998, 2025, Oracle and/or its affiliates. All rights reserved.
  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
  *
  * This code is free software; you can redistribute it and/or modify it
@@ -66,6 +66,7 @@ import sun.security.jca.GetInstance.Instance;
  * Consult the release documentation for your implementation to see if any
  * other algorithms are supported.
  *
+ * @spec security/standard-names.html Java Security Standard Algorithm Names
  * @author Jan Luehe
  *
  * @since 1.4
@@ -165,6 +166,7 @@ public class Mac implements Cloneable {
      * Java Security Standard Algorithm Names Specification</a>
      * for information about standard algorithm names.
      *
+     * @spec security/standard-names.html Java Security Standard Algorithm Names
      * @return the new {@code Mac} object
      *
      * @throws NoSuchAlgorithmException if no {@code Provider} supports a
@@ -210,6 +212,7 @@ public class Mac implements Cloneable {
      *
      * @param provider the name of the provider.
      *
+     * @spec security/standard-names.html Java Security Standard Algorithm Names
      * @return the new {@code Mac} object
      *
      * @throws IllegalArgumentException if the {@code provider}
@@ -251,6 +254,7 @@ public class Mac implements Cloneable {
      *
      * @param provider the provider.
      *
+     * @spec security/standard-names.html Java Security Standard Algorithm Names
      * @return the new {@code Mac} object
      *
      * @throws IllegalArgumentException if the {@code provider} is

src/java.base/share/classes/javax/crypto/SecretKeyFactory.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 1997, 2024, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 1997, 2025, Oracle and/or its affiliates. All rights reserved.
  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
  *
  * This code is free software; you can redistribute it and/or modify it
@@ -68,6 +68,7 @@ import sun.security.jca.GetInstance.Instance;
  * Consult the release documentation for your implementation to see if any
  * other algorithms are supported.
  *
+ * @spec security/standard-names.html Java Security Standard Algorithm Names
  * @author Jan Luehe
  *
  * @see SecretKey
@@ -146,6 +147,7 @@ public class SecretKeyFactory {
      * Java Security Standard Algorithm Names Specification</a>
      * for information about standard algorithm names.
      *
+     * @spec security/standard-names.html Java Security Standard Algorithm Names
      * @return the new {@code SecretKeyFactory} object
      *
      * @throws NoSuchAlgorithmException if no {@code Provider} supports a
@@ -183,6 +185,7 @@ public class SecretKeyFactory {
      *
      * @param provider the name of the provider.
      *
+     * @spec security/standard-names.html Java Security Standard Algorithm Names
      * @return the new {@code SecretKeyFactory} object
      *
      * @throws IllegalArgumentException if the {@code provider}
@@ -227,6 +230,7 @@ public class SecretKeyFactory {
      *
      * @param provider the provider.
      *
+     * @spec security/standard-names.html Java Security Standard Algorithm Names
      * @return the new {@code SecretKeyFactory} object
      *
      * @throws IllegalArgumentException if the {@code provider}

src/java.base/share/classes/javax/net/ssl/KeyManagerFactory.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 1999, 2024, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 1999, 2025, Oracle and/or its affiliates. All rights reserved.
  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
  *
  * This code is free software; you can redistribute it and/or modify it
@@ -124,6 +124,7 @@ public class KeyManagerFactory {
      *          Algorithm Names Specification for information about standard
      *          algorithm names.
      *
+     * @spec security/standard-names.html Java Security Standard Algorithm Names
      * @return the new {@code KeyManagerFactory} object
      *
      * @throws NoSuchAlgorithmException if no {@code Provider} supports a
@@ -165,6 +166,7 @@ public class KeyManagerFactory {
      *
      * @param provider the name of the provider.
      *
+     * @spec security/standard-names.html Java Security Standard Algorithm Names
      * @return the new {@code KeyManagerFactory} object
      *
      * @throws IllegalArgumentException if the provider name is {@code null}
@@ -210,6 +212,7 @@ public class KeyManagerFactory {
      *
      * @param provider an instance of the provider.
      *
+     * @spec security/standard-names.html Java Security Standard Algorithm Names
      * @return the new {@code KeyManagerFactory} object
      *
      * @throws IllegalArgumentException if provider is {@code null}

src/java.base/share/classes/javax/net/ssl/SSLContext.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 1999, 2024, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 1999, 2025, Oracle and/or its affiliates. All rights reserved.
  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
  *
  * This code is free software; you can redistribute it and/or modify it
@@ -51,6 +51,7 @@ import sun.security.jca.GetInstance;
  * Consult the release documentation for your implementation to see if any
  * other protocols are supported.
  *
+ * @spec security/standard-names.html Java Security Standard Algorithm Names
  * @since 1.4
  */
 public class SSLContext {
@@ -161,6 +162,7 @@ public class SSLContext {
      *          Java Security Standard Algorithm Names Specification</a>
      *          for information about standard protocol names.
      *
+     * @spec security/standard-names.html Java Security Standard Algorithm Names
      * @return the new {@code SSLContext} object
      *
      * @throws NoSuchAlgorithmException if no {@code Provider} supports a
@@ -200,6 +202,7 @@ public class SSLContext {
      *
      * @param provider the name of the provider.
      *
+     * @spec security/standard-names.html Java Security Standard Algorithm Names
      * @return the new {@code SSLContext} object
      *
      * @throws IllegalArgumentException if the provider name is
@@ -242,6 +245,7 @@ public class SSLContext {
      *
      * @param provider an instance of the provider.
      *
+     * @spec security/standard-names.html Java Security Standard Algorithm Names
      * @return the new {@code SSLContext} object
      *
      * @throws IllegalArgumentException if the provider is {@code null}

src/java.base/share/classes/javax/net/ssl/SSLEngine.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2003, 2024, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2003, 2025, Oracle and/or its affiliates. All rights reserved.
  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
  *
  * This code is free software; you can redistribute it and/or modify it
@@ -917,6 +917,7 @@ public abstract class SSLEngine {
      * Algorithm Names Specification, and may also include other cipher
      * suites that the provider supports.
      *
+     * @spec security/standard-names.html Java Security Standard Algorithm Names
      * @return  an array of cipher suite names
      * @see     #getEnabledCipherSuites()
      * @see     #setEnabledCipherSuites(String[])
@@ -943,6 +944,7 @@ public abstract class SSLEngine {
      * Algorithm Names Specification, and may also include other cipher
      * suites that the provider supports.
      *
+     * @spec security/standard-names.html Java Security Standard Algorithm Names
      * @return  an array of cipher suite names
      * @see     #getSupportedCipherSuites()
      * @see     #setEnabledCipherSuites(String[])
@@ -970,6 +972,7 @@ public abstract class SSLEngine {
      * on why a specific cipher suite may never be used on an engine.
      *
      * @param   suites Names of all the cipher suites to enable
+     * @spec security/standard-names.html Java Security Standard Algorithm Names
      * @throws  IllegalArgumentException when one or more of the ciphers
      *          named by the parameter is not supported, or when the
      *          parameter is null.

src/java.base/share/classes/javax/net/ssl/SSLParameters.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2005, 2024, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2005, 2025, Oracle and/or its affiliates. All rights reserved.
  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
  *
  * This code is free software; you can redistribute it and/or modify it
@@ -113,6 +113,7 @@ public class SSLParameters {
      * Algorithm Names Specification.  Providers may support cipher suite
      * names not found in this list.
      *
+     * @spec security/standard-names.html Java Security Standard Algorithm Names
      * @param cipherSuites the array of ciphersuites (or null)
      */
     @SuppressWarnings("this-escape")
@@ -134,6 +135,7 @@ public class SSLParameters {
      * Algorithm Names Specification.  Providers may support cipher suite
      * names not found in this list.
      *
+     * @spec security/standard-names.html Java Security Standard Algorithm Names
      * @param cipherSuites the array of ciphersuites (or null)
      * @param protocols the array of protocols (or null)
      */
@@ -158,6 +160,7 @@ public class SSLParameters {
      * Algorithm Names Specification, and may also include other cipher suites
      * that the provider supports.
      *
+     * @spec security/standard-names.html Java Security Standard Algorithm Names
      * @return a copy of the array of ciphersuites or null if none
      * have been set.
      */
@@ -175,6 +178,7 @@ public class SSLParameters {
      * Algorithm Names Specification.  Providers may support cipher suite
      * names not found in this list or might not use the recommended name
      * for a certain cipher suite.
+     * @spec security/standard-names.html Java Security Standard Algorithm Names
      */
     public void setCipherSuites(String[] cipherSuites) {
         this.cipherSuites = clone(cipherSuites);
@@ -749,6 +753,7 @@ public class SSLParameters {
      * with the SunJSSE provider to override the provider-specific default
      * signature schemes.
      *
+     * @spec security/standard-names.html Java Security Standard Algorithm Names
      * @return an array of signature scheme {@code Strings} or {@code null} if
      *         none have been set.  For non-null returns, this method will
      *         return a new array each time it is invoked.  The array is
@@ -794,6 +799,7 @@ public class SSLParameters {
      *        method will make a copy of this array.  Providers should ignore
      *        unknown signature scheme names while establishing the
      *        SSL/TLS/DTLS connections.
+     * @spec security/standard-names.html Java Security Standard Algorithm Names
      * @throws IllegalArgumentException if any element in the
      *        {@code signatureSchemes} array is {@code null} or
      *        {@linkplain String#isBlank() blank}.
@@ -868,6 +874,7 @@ public class SSLParameters {
      * {@systemProperty jdk.tls.namedGroups} system property with the SunJSSE
      * provider to override the provider-specific default named groups.
      *
+     * @spec security/standard-names.html Java Security Standard Algorithm Names
      * @return an array of key exchange named group names {@code Strings} or
      *         {@code null} if none have been set.  For non-null returns, this
      *         method will return a new array each time it is invoked.  The
@@ -913,6 +920,7 @@ public class SSLParameters {
      *        This method will make a copy of this array. Providers should
      *        ignore unknown named group scheme names while establishing the
      *        SSL/TLS/DTLS connections.
+     * @spec security/standard-names.html Java Security Standard Algorithm Names
      * @throws IllegalArgumentException if any element in the
      *        {@code namedGroups} array is a duplicate, {@code null} or
      *        {@linkplain String#isBlank() blank}.

src/java.base/share/classes/javax/net/ssl/SSLServerSocket.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 1997, 2024, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 1997, 2025, Oracle and/or its affiliates. All rights reserved.
  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
  *
  * This code is free software; you can redistribute it and/or modify it
@@ -177,6 +177,7 @@ public abstract class SSLServerSocket extends ServerSocket {
      * Algorithm Names Specification, and may also include other cipher
      * suites that the provider supports.
      *
+     * @spec security/standard-names.html Java Security Standard Algorithm Names
      * @return an array of cipher suites enabled
      * @see #getSupportedCipherSuites()
      * @see #setEnabledCipherSuites(String[])
@@ -211,6 +212,7 @@ public abstract class SSLServerSocket extends ServerSocket {
      * @exception IllegalArgumentException when one or more of ciphers
      *          named by the parameter is not supported, or when
      *          the parameter is null.
+     * @spec security/standard-names.html Java Security Standard Algorithm Names
      * @see #getSupportedCipherSuites()
      * @see #getEnabledCipherSuites()
      */
@@ -233,6 +235,7 @@ public abstract class SSLServerSocket extends ServerSocket {
      * Algorithm Names Specification, and may also include other cipher
      * suites that the provider supports.
      *
+     * @spec security/standard-names.html Java Security Standard Algorithm Names
      * @return an array of cipher suite names
      * @see #getEnabledCipherSuites()
      * @see #setEnabledCipherSuites(String[])

src/java.base/share/classes/javax/net/ssl/SSLServerSocketFactory.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 1997, 2022, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 1997, 2025, Oracle and/or its affiliates. All rights reserved.
  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
  *
  * This code is free software; you can redistribute it and/or modify it
@@ -91,6 +91,7 @@ public abstract class SSLServerSocketFactory extends ServerSocketFactory {
      * Algorithm Names Specification, and may also include other cipher
      * suites that the provider supports.
      *
+     * @spec security/standard-names.html Java Security Standard Algorithm Names
      * @see #getSupportedCipherSuites()
      * @return array of the cipher suites enabled by default
      */
@@ -112,6 +113,7 @@ public abstract class SSLServerSocketFactory extends ServerSocketFactory {
      * Algorithm Names Specification, and may also include other cipher
      * suites that the provider supports.
      *
+     * @spec security/standard-names.html Java Security Standard Algorithm Names
      * @return an array of cipher suite names
      * @see #getDefaultCipherSuites()
      */

src/java.base/share/classes/javax/net/ssl/SSLSocket.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 1997, 2024, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 1997, 2025, Oracle and/or its affiliates. All rights reserved.
  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
  *
  * This code is free software; you can redistribute it and/or modify it
@@ -305,6 +305,7 @@ public abstract class SSLSocket extends Socket
      * Algorithm Names Specification, and may also include other cipher
      * suites that the provider supports.
      *
+     * @spec security/standard-names.html Java Security Standard Algorithm Names
      * @return an array of cipher suite names
      * @see #getEnabledCipherSuites()
      * @see #setEnabledCipherSuites(String [])
@@ -331,6 +332,7 @@ public abstract class SSLSocket extends Socket
      * Algorithm Names Specification, and may also include other cipher
      * suites that the provider supports.
      *
+     * @spec security/standard-names.html Java Security Standard Algorithm Names
      * @return an array of cipher suite names
      * @see #getSupportedCipherSuites()
      * @see #setEnabledCipherSuites(String [])
@@ -358,6 +360,7 @@ public abstract class SSLSocket extends Socket
      * on why a specific ciphersuite may never be used on a connection.
      *
      * @param suites Names of all the cipher suites to enable
+     * @spec security/standard-names.html Java Security Standard Algorithm Names
      * @throws IllegalArgumentException when one or more of the ciphers
      *          named by the parameter is not supported, or when the
      *          parameter is null.

src/java.base/share/classes/javax/net/ssl/SSLSocketFactory.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 1997, 2024, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 1997, 2025, Oracle and/or its affiliates. All rights reserved.
  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
  *
  * This code is free software; you can redistribute it and/or modify it
@@ -109,6 +109,7 @@ public abstract class SSLSocketFactory extends SocketFactory {
      * Algorithm Names Specification, and may also include other cipher suites
      * that the provider supports.
      *
+     * @spec security/standard-names.html Java Security Standard Algorithm Names
      * @see #getSupportedCipherSuites()
      * @return array of the cipher suites enabled by default
      */
@@ -128,6 +129,7 @@ public abstract class SSLSocketFactory extends SocketFactory {
      * Algorithm Names Specification, and may also include other cipher suites
      * that the provider supports.
      *
+     * @spec security/standard-names.html Java Security Standard Algorithm Names
      * @see #getDefaultCipherSuites()
      * @return an array of cipher suite names
      */

src/java.base/share/classes/javax/net/ssl/TrustManagerFactory.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 1999, 2024, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 1999, 2025, Oracle and/or its affiliates. All rights reserved.
  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
  *
  * This code is free software; you can redistribute it and/or modify it
@@ -48,6 +48,7 @@ import sun.security.jca.GetInstance;
  * Consult the release documentation for your implementation to see if any
  * other algorithms are supported.
  *
+ * @spec security/standard-names.html Java Security Standard Algorithm Names
  * @since 1.4
  * @see TrustManager
  */
@@ -138,6 +139,7 @@ public class TrustManagerFactory {
      *          Algorithm Names Specification for information about standard
      *          algorithm names.
      *
+     * @spec security/standard-names.html Java Security Standard Algorithm Names
      * @return the new {@code TrustManagerFactory} object
      *
      * @throws NoSuchAlgorithmException if no {@code Provider} supports a
@@ -177,6 +179,7 @@ public class TrustManagerFactory {
      *          Algorithm Names Specification for information about standard
      *          algorithm names.
      *
+     * @spec security/standard-names.html Java Security Standard Algorithm Names
      * @param provider the name of the provider.
      *
      * @return the new {@code TrustManagerFactory} object
@@ -224,6 +227,7 @@ public class TrustManagerFactory {
      *
      * @param provider an instance of the provider.
      *
+     * @spec security/standard-names.html Java Security Standard Algorithm Names
      * @return the new {@code TrustManagerFactory} object
      *
      * @throws IllegalArgumentException if the provider is {@code null}

src/java.base/share/classes/javax/security/auth/login/Configuration.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 1998, 2024, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 1998, 2025, Oracle and/or its affiliates. All rights reserved.
  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
  *
  * This code is free software; you can redistribute it and/or modify it
@@ -176,6 +176,7 @@ import sun.security.jca.GetInstance;
  * Java Security Standard Algorithm Names Specification</a>
  * for a list of standard Configuration types.
  *
+ * @spec security/standard-names.html Java Security Standard Algorithm Names
  * @since 1.4
  * @see javax.security.auth.login.LoginContext
  * @see java.security.Security security properties
@@ -268,6 +269,7 @@ public abstract class Configuration {
      *
      * @param params parameters for the Configuration, which may be null.
      *
+     * @spec security/standard-names.html Java Security Standard Algorithm Names
      * @return the new {@code Configuration} object
      *
      * @throws IllegalArgumentException if the specified parameters
@@ -324,6 +326,7 @@ public abstract class Configuration {
      *
      * @param provider the provider.
      *
+     * @spec security/standard-names.html Java Security Standard Algorithm Names
      * @return the new {@code Configuration} object
      *
      * @throws IllegalArgumentException if the specified provider
@@ -387,6 +390,7 @@ public abstract class Configuration {
      *
      * @param provider the Provider.
      *
+     * @spec security/standard-names.html Java Security Standard Algorithm Names
      * @return the new {@code Configuration} object
      *
      * @throws IllegalArgumentException if the specified {@code Provider}

src/java.management/share/classes/com/sun/jmx/remote/security/HashedPasswordManager.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2017, 2024, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2017, 2025, Oracle and/or its affiliates. All rights reserved.
  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
  *
  * This code is free software; you can redistribute it and/or modify it
@@ -84,6 +84,7 @@ import static java.nio.charset.StandardCharsets.UTF_8;
  * A user generated hashed password file can also be used instead of a
  * clear-text password file. If generated by the user, hashed passwords must
  * follow the format specified above.
+ * @spec security/standard-names.html Java Security Standard Algorithm Names
  */
 public final class HashedPasswordManager {
 

src/java.xml.crypto/share/classes/javax/xml/crypto/dsig/TransformService.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2005, 2019, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2005, 2025, Oracle and/or its affiliates. All rights reserved.
  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
  *
  * This code is free software; you can redistribute it and/or modify it
@@ -101,6 +101,7 @@ import javax.xml.crypto.dsig.spec.TransformParameterSpec;
  * necessary locking. Multiple threads each manipulating a different
  * <code>TransformService</code> instance need not synchronize.
  *
+ * @spec security/standard-names.html Java Security Standard Algorithm Names
  * @author Sean Mullan
  * @author JSR 105 Expert Group
  * @since 1.6
@@ -153,6 +154,7 @@ public abstract class TransformService implements Transform {
      *    "{@docRoot}/../specs/security/standard-names.html#xml-signature-xmlsignaturefactorykeyinfofactorytransformservice-mechanisms">
      *    Java Security Standard Algorithm Names Specification</a> for a list of
      *    standard mechanism types.
+     * @spec security/standard-names.html Java Security Standard Algorithm Names
      * @return a new <code>TransformService</code>
      * @throws NullPointerException if <code>algorithm</code> or
      *   <code>mechanismType</code> is  <code>null</code>
@@ -215,6 +217,7 @@ public abstract class TransformService implements Transform {
      *    Java Security Standard Algorithm Names Specification</a> for a list of
      *    standard mechanism types.
      * @param provider the <code>Provider</code> object
+     * @spec security/standard-names.html Java Security Standard Algorithm Names
      * @return a new <code>TransformService</code>
      * @throws NullPointerException if <code>provider</code>,
      *   <code>algorithm</code>, or <code>mechanismType</code> is
@@ -277,6 +280,7 @@ public abstract class TransformService implements Transform {
      *    Java Security Standard Algorithm Names Specification</a> for a list of
      *    standard mechanism types.
      * @param provider the string name of the provider
+     * @spec security/standard-names.html Java Security Standard Algorithm Names
      * @return a new <code>TransformService</code>
      * @throws NoSuchProviderException if the specified provider is not
      *   registered in the security provider list

src/java.xml.crypto/share/classes/javax/xml/crypto/dsig/XMLSignatureFactory.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2005, 2018, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2005, 2025, Oracle and/or its affiliates. All rights reserved.
  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
  *
  * This code is free software; you can redistribute it and/or modify it
@@ -143,6 +143,7 @@ import java.util.List;
  * necessary locking. Multiple threads each manipulating a different
  * <code>XMLSignatureFactory</code> instance need not synchronize.
  *
+ * @spec security/standard-names.html Java Security Standard Algorithm Names
  * @author Sean Mullan
  * @author JSR 105 Expert Group
  * @since 1.6
@@ -186,6 +187,7 @@ public abstract class XMLSignatureFactory {
      *    "{@docRoot}/../specs/security/standard-names.html#xml-signature-xmlsignaturefactorykeyinfofactorytransformservice-mechanisms">
      *    Java Security Standard Algorithm Names Specification</a> for a list of
      *    standard mechanism types.
+     * @spec security/standard-names.html Java Security Standard Algorithm Names
      * @return a new <code>XMLSignatureFactory</code>
      * @throws NullPointerException if <code>mechanismType</code> is
      *    <code>null</code>
@@ -234,6 +236,7 @@ public abstract class XMLSignatureFactory {
      *    Java Security Standard Algorithm Names Specification</a> for a list of
      *    standard mechanism types.
      * @param provider the <code>Provider</code> object
+     * @spec security/standard-names.html Java Security Standard Algorithm Names
      * @return a new <code>XMLSignatureFactory</code>
      * @throws NullPointerException if <code>provider</code> or
      *    <code>mechanismType</code> is <code>null</code>
@@ -287,6 +290,7 @@ public abstract class XMLSignatureFactory {
      *    Java Security Standard Algorithm Names Specification</a> for a list of
      *    standard mechanism types.
      * @param provider the string name of the provider
+     * @spec security/standard-names.html Java Security Standard Algorithm Names
      * @return a new <code>XMLSignatureFactory</code>
      * @throws NoSuchProviderException if the specified provider is not
      *    registered in the security provider list

src/java.xml.crypto/share/classes/javax/xml/crypto/dsig/keyinfo/KeyInfoFactory.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2005, 2018, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2005, 2025, Oracle and/or its affiliates. All rights reserved.
  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
  *
  * This code is free software; you can redistribute it and/or modify it
@@ -99,6 +99,7 @@ import javax.xml.crypto.dsig.*;
  * Multiple threads each manipulating a different <code>KeyInfoFactory</code>
  * instance need not synchronize.
  *
+ * @spec security/standard-names.html Java Security Standard Algorithm Names
  * @author Sean Mullan
  * @author JSR 105 Expert Group
  * @since 1.6
@@ -142,6 +143,7 @@ public abstract class KeyInfoFactory {
      *    "{@docRoot}/../specs/security/standard-names.html#xml-signature-xmlsignaturefactorykeyinfofactorytransformservice-mechanisms">
      *    Java Security Standard Algorithm Names Specification</a> for a list
      *    of standard mechanism types.
+     * @spec security/standard-names.html Java Security Standard Algorithm Names
      * @return a new <code>KeyInfoFactory</code>
      * @throws NullPointerException if <code>mechanismType</code> is
      *    <code>null</code>
@@ -189,6 +191,7 @@ public abstract class KeyInfoFactory {
      *    Java Security Standard Algorithm Names Specification</a> for a list
      *    of standard mechanism types.
      * @param provider the <code>Provider</code> object
+     * @spec security/standard-names.html Java Security Standard Algorithm Names
      * @return a new <code>KeyInfoFactory</code>
      * @throws NullPointerException if <code>mechanismType</code> or
      *    <code>provider</code> are <code>null</code>
@@ -241,6 +244,7 @@ public abstract class KeyInfoFactory {
      *    Java Security Standard Algorithm Names Specification</a> for a list
      *    of standard mechanism types.
      * @param provider the string name of the provider
+     * @spec security/standard-names.html Java Security Standard Algorithm Names
      * @return a new <code>KeyInfoFactory</code>
      * @throws NoSuchProviderException if the specified provider is not
      *    registered in the security provider list

src/jdk.jartool/share/classes/jdk/security/jarsigner/JarSigner.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2015, 2024, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2015, 2025, Oracle and/or its affiliates. All rights reserved.
  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
  *
  * This code is free software; you can redistribute it and/or modify it
@@ -181,6 +181,7 @@ public final class JarSigner {
          *      "{@docRoot}/../specs/security/standard-names.html#messagedigest-algorithms">
          *      Java Cryptography Architecture Standard Algorithm Name
          *      Documentation</a> for information about standard algorithm names.
+         * @spec security/standard-names.html Java Security Standard Algorithm Names
          * @return the {@code JarSigner.Builder} itself.
          * @throws NoSuchAlgorithmException if {@code algorithm} is not available.
          */
@@ -202,6 +203,7 @@ public final class JarSigner {
          *      Java Cryptography Architecture Standard Algorithm Name
          *      Documentation</a> for information about standard algorithm names.
          * @param provider the provider.
+         * @spec security/standard-names.html Java Security Standard Algorithm Names
          * @return the {@code JarSigner.Builder} itself.
          * @throws NoSuchAlgorithmException if {@code algorithm} is not
          *      available in the specified provider.
@@ -227,6 +229,7 @@ public final class JarSigner {
          *      "{@docRoot}/../specs/security/standard-names.html#signature-algorithms">
          *      Java Cryptography Architecture Standard Algorithm Name
          *      Documentation</a> for information about standard algorithm names.
+         * @spec security/standard-names.html Java Security Standard Algorithm Names
          * @return the {@code JarSigner.Builder} itself.
          * @throws NoSuchAlgorithmException if {@code algorithm} is not available.
          * @throws IllegalArgumentException if {@code algorithm} is not
@@ -254,6 +257,7 @@ public final class JarSigner {
          *      Java Cryptography Architecture Standard Algorithm Name
          *      Documentation</a> for information about standard algorithm names.
          * @param provider  the provider.
+         * @spec security/standard-names.html Java Security Standard Algorithm Names
          * @return the {@code JarSigner.Builder} itself.
          * @throws NoSuchAlgorithmException if {@code algorithm} is not
          *      available in the specified provider.