diff --git a/library/psa_crypto_core.h b/library/psa_crypto_core.h
index 694f682f3..610c69be6 100644
--- a/library/psa_crypto_core.h
+++ b/library/psa_crypto_core.h
@@ -366,6 +366,9 @@ psa_status_t psa_generate_key_internal( const psa_key_attributes_t *attributes,
  *       entry point as defined in the PSA driver interface specification for
  *       transparent drivers.
  *
+ * \note This function will call the driver for psa_sign_hash
+ *       and go through driver dispatch again.
+ *
  * \param[in]  attributes       The attributes of the key to use for the
  *                              operation.
  * \param[in]  key_buffer       The buffer containing the key context.
@@ -406,6 +409,9 @@ psa_status_t psa_sign_message_builtin(
  *       entry point as defined in the PSA driver interface specification for
  *       transparent drivers.
  *
+ * \note This function will call the driver for psa_verify_hash
+ *       and go through driver dispatch again.
+ *
  * \param[in]  attributes       The attributes of the key to use for the
  *                              operation.
  * \param[in]  key_buffer       The buffer containing the key context.