diff --git a/library/psa_crypto_core.h b/library/psa_crypto_core.h
index 356d548..4420ec2 100644
--- a/library/psa_crypto_core.h
+++ b/library/psa_crypto_core.h
@@ -386,6 +386,9 @@
  *       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.
@@ -426,6 +429,9 @@
  *       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.