Doc: fix doxygen comments.

Some existing doxygen comments resulted in bad or bad looking
documentation. These were fixed.

Change-Id: I20ab5a81c54d3bdc0e056965ad7de293d472cdf9
Signed-off-by: Gyorgy Szing <Gyorgy.Szing@arm.com>
diff --git a/interface/include/psa_initial_attestation_api.h b/interface/include/psa_initial_attestation_api.h
index 2a674bd..1a7636f 100644
--- a/interface/include/psa_initial_attestation_api.h
+++ b/interface/include/psa_initial_attestation_api.h
@@ -188,12 +188,12 @@
  * \param[in]     challenge_obj   Pointer to buffer where challenge input is
  *                                stored. Nonce and / or hash of attested data.
  *                                Must be always
- *                                \ref PSA_INITIAL_ATTEST_CHALLENGE_SIZE bytes
+ *                                \ref PSA_INITIAL_ATTEST_TOKEN_SIZE bytes
  *                                long.
  * \param[in]     challenge_size  Size of challenge object in bytes.
  * \param[out]    token           Pointer to the buffer where attestation token
  *                                must be stored.
- * \param[in/out] token_size      Size of allocated buffer for token, which
+ * \param[in,out] token_size      Size of allocated buffer for token, which
  *                                updated by initial attestation service with
  *                                final token size.
  *