Improve documentation of psa_internal_allocate_key_slot
diff --git a/library/psa_crypto_slot_management.h b/library/psa_crypto_slot_management.h
index aebe7db..5c1bde1 100644
--- a/library/psa_crypto_slot_management.h
+++ b/library/psa_crypto_slot_management.h
@@ -57,8 +57,11 @@
/** Find a free key slot and mark it as 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.
+ * \param[out] handle On success, a slot number that can be used as a
+ * handle to the slot. The selected slot was not
+ * in use before. This function marks it as in use
+ * and otherwise leaves it in a freshly-initialized
+ * state.
* \param[out] p_slot On success, a pointer to the slot.
*
* \retval #PSA_SUCCESS