Move the EC curves and DH groups into a separate API reference section.

Author: athoelke

include/psa/crypto_types.h

@@ -65,6 +65,12 @@ typedef int32_t psa_status_t;
  */
 typedef uint32_t psa_key_type_t;
 
+/**@}*/
+
+/** \defgroup iana_groups TLS Supported Groups
+ * @{
+ */
+
 /** The type of PSA elliptic curve identifiers.
  *
  * The curve identifier is required to create an ECC key using the
@@ -119,6 +125,12 @@ typedef uint16_t psa_ecc_curve_t;
  */
 typedef uint16_t psa_dh_group_t;
 
+/**@}*/
+
+/** \defgroup crypto_types Key and algorithm types
+ * @{
+ */
+
 /** \brief Encoding of a cryptographic algorithm.
  *
  * For algorithms that can be applied to multiple key types, this type

include/psa/crypto_values.h

@@ -455,6 +455,12 @@
                         ((type) & PSA_KEY_TYPE_ECC_CURVE_MASK) : \
                         0))
 
+/**@}*/
+
+/** \defgroup iana_groups TLS Supported Groups
+* @{
+*/
+
 /* The encoding of curve identifiers is currently aligned with the
  * TLS Supported Groups Registry (formerly known as the
  * TLS EC Named Curve Registry)
@@ -516,6 +522,12 @@
  */
 #define PSA_ECC_CURVE_VENDOR_MAX        ((psa_ecc_curve_t) 0xfe7f)
 
+/**@}*/
+
+/** \defgroup crypto_types Key and algorithm types
+ * @{
+ */
+
 #define PSA_KEY_TYPE_DH_PUBLIC_KEY_BASE         ((psa_key_type_t)0x60040000)
 #define PSA_KEY_TYPE_DH_KEY_PAIR_BASE            ((psa_key_type_t)0x70040000)
 #define PSA_KEY_TYPE_DH_GROUP_MASK              ((psa_key_type_t)0x0000ffff)
@@ -553,6 +565,12 @@
                        ((type) & PSA_KEY_TYPE_DH_GROUP_MASK) :  \
                        0))
 
+/**@}*/
+
+/** \defgroup iana_groups TLS Supported Groups
+* @{
+*/
+
 /* The encoding of group identifiers is currently aligned with the
  * TLS Supported Groups Registry (formerly known as the
  * TLS EC Named Curve Registry)
@@ -577,6 +595,12 @@
  */
 #define PSA_DH_GROUP_VENDOR_MAX         ((psa_dh_group_t) 0x01fd)
 
+/**@}*/
+
+/** \defgroup crypto_types Key and algorithm types
+ * @{
+ */
+
 /** The block size of a block cipher.
  *
  * \param type  A cipher key type (value of type #psa_key_type_t).