diff --git a/include/psa/crypto_accel_driver.h b/include/psa/crypto_accel_driver.h
index 125d4c2462..1e1940c803 100644
--- a/include/psa/crypto_accel_driver.h
+++ b/include/psa/crypto_accel_driver.h
@@ -644,7 +644,7 @@ typedef psa_status_t (*psa_drv_accel_aead_decrypt_t)(const uint8_t *p_key,
  * Where `ALGO` is the name of the signing algorithm
  *
  * This function supports any asymmetric-key output from psa_export_key() as
- * the buffer in \ref p_key. Refer to the documentation of \ref
+ * the buffer in \p p_key. Refer to the documentation of \ref
  * psa_export_key() for the formats.
  *
  * \param[in] p_key                 A buffer containing the private key
@@ -683,7 +683,7 @@ typedef psa_status_t (*psa_drv_accel_asymmetric_sign_t)(const uint8_t *p_key,
  * Where `ALGO` is the name of the signing algorithm
  *
  * This function supports any output from \ref psa_export_public_key() as the
- * buffer in \ref p_key. Refer to the documentation of \ref
+ * buffer in \p p_key. Refer to the documentation of \ref
  * psa_export_public_key() for the format of public keys and to the
  * documentation of \ref psa_export_key() for the format for other key types.
  *
@@ -721,7 +721,7 @@ typedef psa_status_t (*psa_drv_accel_asymmetric_verify_t)(const uint8_t *p_key,
  * Where `ALGO` is the name of the encryption algorithm
  *
  * This function supports any output from \ref psa_export_public_key() as the
- * buffer in \ref p_key. Refer to the documentation of \ref
+ * buffer in \p p_key. Refer to the documentation of \ref
  * psa_export_public_key() for the format of public keys and to the
  * documentation of \ref psa_export_key() for the format for other key types.
  *
@@ -774,7 +774,7 @@ typedef psa_status_t (*psa_drv_accel_asymmetric_encrypt_t)(const uint8_t *p_key,
  * Where `ALGO` is the name of the encryption algorithm
  *
  * This function supports any asymmetric-key output from psa_export_key() as
- * the buffer in \ref p_key. Refer to the documentation of \ref
+ * the buffer in \p p_key. Refer to the documentation of \ref
  * psa_export_key() for the formats.
  *
  * \param[in] p_key             A buffer containing the private key material
diff --git a/include/psa/crypto_se_driver.h b/include/psa/crypto_se_driver.h
index 870f69d06b..4772f306ef 100644
--- a/include/psa/crypto_se_driver.h
+++ b/include/psa/crypto_se_driver.h
@@ -767,10 +767,10 @@ typedef psa_status_t (*psa_drv_se_export_key_t)(psa_key_slot_number_t key,
  * \brief A function that generates a symmetric or asymmetric key on a secure
  * element
  *
- * If `type` is asymmetric (`#define PSA_KEY_TYPE_IS_ASYMMETRIC(type) == 1`),
+ * If \p type is asymmetric (`#PSA_KEY_TYPE_IS_ASYMMETRIC(\p type) == 1`),
  * the public component of the generated key will be placed in `p_pubkey_out`.
  * The format of the public key information will match the format specified for
- * the `psa_export_key()` function for the key type.
+ * the psa_export_key() function for the key type.
  *
  * \param[in] key_slot      Slot where the generated key will be placed
  * \param[in] type          The type of the key to be generated
@@ -784,7 +784,7 @@ typedef psa_status_t (*psa_drv_se_export_key_t)(psa_key_slot_number_t key,
  *                          interpretation of this parameter should match the
  *                          interpretation in the `extra` parameter is the
  *                          `psa_generate_key` function
- * \param[in] extra_size    The size in bytes of the \ref extra buffer
+ * \param[in] extra_size    The size in bytes of the \p extra buffer
  * \param[out] p_pubkey_out The buffer where the public key information will
  *                          be placed
  * \param[in] pubkey_out_size   The size in bytes of the `p_pubkey_out` buffer