diff --git a/library/psa_crypto.c b/library/psa_crypto.c
index 17cec9756b..2f01bf25ee 100644
--- a/library/psa_crypto.c
+++ b/library/psa_crypto.c
@@ -1834,7 +1834,9 @@ static psa_status_t psa_validate_key_attributes(
  *
  * \param method            An identification of the calling function.
  * \param[in] attributes    Key attributes for the new key.
- * \param[out] key          On success, identifier of the key.
+ * \param[out] key          On success, identifier of the key. Note that the
+ *                          key identifier is also stored in the prepared
+ *                          slot.
  * \param[out] p_slot       On success, a pointer to the prepared slot.
  * \param[out] p_drv        On any return, the driver for the key, if any.
  *                          NULL for a transparent key.