diff --git a/include/psa/crypto.h b/include/psa/crypto.h
index a0f5b13..88cc2d1 100644
--- a/include/psa/crypto.h
+++ b/include/psa/crypto.h
@@ -4366,6 +4366,9 @@
  * Depending on the protocol being executed, you might need to call this
  * function several times or you might not need to call this at all.
  *
+ * Calling this function with PSA_PAKE_DATA_KEY_SHARE as \p type is equivalent
+ * to calling psa_pake_get_key_share().
+ *
  * The exact sequence of calls to perform a password-authenticated key
  * exchange depends on the protocol in use.  Refer to the documentation of
  * individual PAKE algorithm types (`PSA_ALG_XXX` values of type
@@ -4443,6 +4446,9 @@
  * Depending on the protocol being executed, you might need to call this
  * function several times or you might not need to call this at all.
  *
+ * Calling this function with PSA_PAKE_DATA_KEY_SHARE as \p type is equivalent
+ * to calling psa_pake_set_key_share().
+ *
  * The exact sequence of calls to perform a password-authenticated key
  * exchange depends on the protocol in use.  Refer to the documentation of
  * individual PAKE algorithm types (`PSA_ALG_XXX` values of type