diff --git a/src/java.base/share/classes/javax/crypto/KDF.java b/src/java.base/share/classes/javax/crypto/KDF.java
index 0ee0904c1c2c4..446d3757e9a8b 100644
--- a/src/java.base/share/classes/javax/crypto/KDF.java
+++ b/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
@@ -477,7 +477,11 @@ private static KDF handleException(NoSuchAlgorithmException e)
* Derives a key, returned as a {@code SecretKey} object.
*
* @param alg
- * the algorithm of the resultant {@code SecretKey} object
+ * the algorithm of the resultant {@code SecretKey} object.
+ * See the SecretKey Algorithms section in the
+ *
+ * Java Security Standard Algorithm Names Specification
+ * for information about standard secret key algorithm names.
* @param derivationSpec
* the object describing the inputs to the derivation function
*
diff --git a/src/java.base/share/classes/javax/crypto/KDFSpi.java b/src/java.base/share/classes/javax/crypto/KDFSpi.java
index dcd2029c0c06f..de021e87b7a25 100644
--- a/src/java.base/share/classes/javax/crypto/KDFSpi.java
+++ b/src/java.base/share/classes/javax/crypto/KDFSpi.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
@@ -115,7 +115,11 @@ protected KDFSpi(KDFParameters kdfParameters)
* result of {@code deriveData}.
*
* @param alg
- * the algorithm of the resultant {@code SecretKey} object
+ * the algorithm of the resultant {@code SecretKey} object.
+ * See the SecretKey Algorithms section in the
+ *
+ * Java Security Standard Algorithm Names Specification
+ * for information about standard secret key algorithm names.
* @param derivationSpec
* derivation parameters
*
@@ -154,4 +158,4 @@ protected abstract byte[] engineDeriveData(
AlgorithmParameterSpec derivationSpec)
throws InvalidAlgorithmParameterException;
-}
\ No newline at end of file
+}