commit edd768775f8b0d45b24d7693424e4fd9f4880712
author Gilles Peskine <Gilles.Peskine@arm.com> Fri Jul 20 17:42:05 2018 +0200
committer itayzafrir <itay.zafrir@arm.com> Wed Sep 12 16:50:07 2018 +0300
tree 447ebc50b811fda97001a5ed98ed1b482dd7dc19
parent ff01a8d94796a810d3c7b7851b07aa913afad142

Fix doxygen warnings

* Broken link #PSA_ALG_SHA_256
* Duplicate group name "generators"
* Missing documentation in psa_generate_key_extra_rsa due to bad magic
  comment marker

include/psa/crypto.h

diff --git a/include/psa/crypto.h b/include/psa/crypto.h
index f282aa2..4c615f0 100644
--- a/include/psa/crypto.h
+++ b/include/psa/crypto.h
@@ -652,15 +652,25 @@
 #define PSA_ALG_MD5                             ((psa_algorithm_t)0x01000003)
 #define PSA_ALG_RIPEMD160                       ((psa_algorithm_t)0x01000004)
 #define PSA_ALG_SHA_1                           ((psa_algorithm_t)0x01000005)
+/** SHA2-224 */
 #define PSA_ALG_SHA_224                         ((psa_algorithm_t)0x01000008)
+/** SHA2-256 */
 #define PSA_ALG_SHA_256                         ((psa_algorithm_t)0x01000009)
+/** SHA2-384 */
 #define PSA_ALG_SHA_384                         ((psa_algorithm_t)0x0100000a)
+/** SHA2-512 */
 #define PSA_ALG_SHA_512                         ((psa_algorithm_t)0x0100000b)
+/** SHA2-512/224 */
 #define PSA_ALG_SHA_512_224                     ((psa_algorithm_t)0x0100000c)
+/** SHA2-512/256 */
 #define PSA_ALG_SHA_512_256                     ((psa_algorithm_t)0x0100000d)
+/** SHA3-224 */
 #define PSA_ALG_SHA3_224                        ((psa_algorithm_t)0x01000010)
+/** SHA3-256 */
 #define PSA_ALG_SHA3_256                        ((psa_algorithm_t)0x01000011)
+/** SHA3-384 */
 #define PSA_ALG_SHA3_384                        ((psa_algorithm_t)0x01000012)
+/** SHA3-512 */
 #define PSA_ALG_SHA3_512                        ((psa_algorithm_t)0x01000013)
 
 #define PSA_ALG_MAC_SUBCATEGORY_MASK            ((psa_algorithm_t)0x00c00000)
@@ -2486,7 +2496,7 @@
 
 /**@}*/
 
-/** \defgroup generation Generators
+/** \defgroup generators Generators
  * @{
  */
 
@@ -2708,7 +2718,7 @@
 
 /**@}*/
 
-/** \defgroup generation Key generation
+/** \defgroup random Random generation
  * @{
  */
 
@@ -2740,7 +2750,7 @@
  * parameter to psa_generate_key().
  */
 typedef struct {
-    uint32_t e; /**! Public exponent value. Default: 65537. */
+    uint32_t e; /**< Public exponent value. Default: 65537. */
 } psa_generate_key_extra_rsa;
 
 /**