pk: fixed documentation of mbedtls_pk_copy_from_psa()
Signed-off-by: Valerio Setti <valerio.setti@nordicsemi.no>
diff --git a/include/mbedtls/pk.h b/include/mbedtls/pk.h
index 20be7e6..90f4ac6 100644
--- a/include/mbedtls/pk.h
+++ b/include/mbedtls/pk.h
@@ -394,35 +394,36 @@
/**
* \brief Create a PK context starting from a key stored in PSA.
* This key:
- * - must have PSA_KEY_USAGE_EXPORT attribute set and
- * - must be a either a RSA or EC (DH is not managed in PK) and
+ * - must be exportabel and
+ * - must be a either an RSA or EC key (DH is not managed in PK) and
* - must be either a key pair or a public key.
*
* The resulting PK object will be a transparent type:
- * - MBEDTLS_PK_RSA for RSA keys or
- * - MBEDTLS_PK_ECKEY for EC keys.
+ * - #MBEDTLS_PK_RSA for RSA keys or
+ * - #MBEDTLS_PK_ECKEY for EC keys.
+ *
* Once this functions returns the PK object will be completely
* independent from the original PSA key that it was generated
* from.
- * Calling `mbedtls_pk_sign`, `mbedtls_pk_verify`,
- * `mbedtls_pk_encrypt`, `mbedtls_pk_decrypt` on the resulting
+ * Calling mbedtls_pk_sign(), mbedtls_pk_verify(),
+ * mbedtls_pk_encrypt(), mbedtls_pk_decrypt() on the resulting
* PK context will perform an algorithm that is compatible with
* the PSA key's primary algorithm policy if that is a matching
* operation type (sign/verify, encrypt/decrypt), but with no
* restriction on the hash (as if the policy had
- * `PSA_ALG_ANY_HASH` instead of a specific hash, and with
- * `PSA_ALG_RSA_PKCS1V15_SIGN_RAW` merged with
- * `PSA_ALG_RSA_PKCS1V15_SIGN(hash_alg)`).
+ * #PSA_ALG_ANY_HASH instead of a specific hash, and with
+ * #PSA_ALG_RSA_PKCS1V15_SIGN_RAW merged with
+ * #PSA_ALG_RSA_PKCS1V15_SIGN(\c hash_alg)).
* * For ECDSA, the choice of deterministic vs randomized will
- * be based on the compile-time setting `MBEDTLS_ECDSA_DETERMINISTIC`.
+ * be based on the compile-time setting #MBEDTLS_ECDSA_DETERMINISTIC.
* * For an RSA key, the output key will allow both encrypt/decrypt
* and sign/verify regardless of the original key's policy.
* The original key's policy determines the output key's padding
* mode.
*
- * \param key_id The ID of the key stored in PSA.
+ * \param key_id The key identifier of the key stored in PSA.
* \param pk The PK context that will be filled. It must be initialized,
- * but not setup.
+ * but not set up.
*
* \return 0 on success.
* \return MBEDTLS_ERR_PK_BAD_INPUT_DATA in case the provided input