diff --git a/library/psa_crypto_slot_management.c b/library/psa_crypto_slot_management.c
index f623cc9..4e193b5 100644
--- a/library/psa_crypto_slot_management.c
+++ b/library/psa_crypto_slot_management.c
@@ -100,7 +100,8 @@
 
 /** Find a free key slot and mark it as in use.
  *
- * \param[out] handle   On success, a slot number that is not in use.
+ * \param[out] handle   On success, a slot number that is not in use. This
+ *                      value can be used as a handle to the slot.
  *
  * \retval #PSA_SUCCESS
  * \retval #PSA_ERROR_INSUFFICIENT_MEMORY
@@ -123,7 +124,7 @@
  *
  * This does not affect persistent storage.
  *
- * \param handle        The key slot number to release.
+ * \param handle        The handle to the key slot to release.
  *
  * \retval #PSA_SUCCESS
  * \retval #PSA_ERROR_INVALID_ARGUMENT