Fix these Doxygen warnings #1581 (#1589)

HDFGroup · Apr 13, 2022 · ab69f5d · ab69f5d
1 parent 29de83a
commit ab69f5d
Show file tree

Hide file tree

Showing 3 changed files with 10 additions and 11 deletions.
diff --git a/src/H5Opublic.h b/src/H5Opublic.h
@@ -291,10 +291,6 @@ H5_DLL hid_t H5Oopen_async(const char *app_file, const char *app_func, unsigned
  * \details H5Oopen_by_token() opens an object specified by the object
  *          identifier, \p loc_id and object token, \p token.
  *
- * \par Example
- *      An example snippet from examples/h5_extlink.c:
- *      \snippet h5_extlink.c H5Open_by_token_snip
- *
  * \since 1.12.0
  *
  */

diff --git a/src/H5Tmodule.h b/src/H5Tmodule.h
@@ -65,17 +65,20 @@
  * \ingroup H5T
  * \defgroup ATOM Atomic Datatypes
  * \ingroup H5T
- * \defgroup COMPOUND Compound Datatypes
- * \ingroup H5T
  * \defgroup CONV Conversion Function
  * \ingroup H5T
- * \defgroup ENUM Enumeration Datatypes
- * \ingroup H5T
  * \defgroup OPAQUE Opaque Datatypes
  * \ingroup H5T
  * \defgroup VLEN Variable-length Sequence Datatypes
  * \ingroup H5T
  *
+ * \defgroup COMPENUM Compound and Enumeration Datatypes
+ * \ingroup H5T
+ * \defgroup COMPOUND Compound Datatypes
+ * \ingroup COMPENUM
+ * \defgroup ENUM Enumeration Datatypes
+ * \ingroup COMPENUM
+ *
  * \defgroup PDT Predefined Datatypes
  * \ingroup H5T
  * \details What is a predefined HDF5 datatype?

diff --git a/src/H5Tpublic.h b/src/H5Tpublic.h
@@ -2039,7 +2039,7 @@ H5_DLL H5T_pad_t H5Tget_inpad(hid_t type_id);
  */
 H5_DLL H5T_str_t H5Tget_strpad(hid_t type_id);
 /**
- * \ingroup COMPOUND ENUM
+ * \ingroup COMPENUM
  *
  * \brief Retrieves the number of elements in a compound or enumeration datatype
  *
@@ -2056,7 +2056,7 @@ H5_DLL H5T_str_t H5Tget_strpad(hid_t type_id);
  */
 H5_DLL int H5Tget_nmembers(hid_t type_id);
 /**
- * \ingroup COMPOUND ENUM
+ * \ingroup COMPENUM
  *
  * \brief Retrieves the name of a compound or enumeration datatype member
  *
@@ -2083,7 +2083,7 @@ H5_DLL int H5Tget_nmembers(hid_t type_id);
  */
 H5_DLL char *H5Tget_member_name(hid_t type_id, unsigned membno);
 /**
- * \ingroup COMPOUND ENUM
+ * \ingroup COMPENUM
  *
  * \brief Retrieves the index of a compound or enumeration datatype member
  *