[Doxygen] fix multi-function definition in doxygen.

This will solve the problem, but I don't think I have time to update every doc. Future work here.
I'm not showing api doc in the website anyway.
This is just a test.

Author: cindytsai

include/libyt.h

@@ -38,7 +38,7 @@ int yt_set_UserParameterUlong(const char* key, const int n, const unsigned long*
 int yt_set_UserParameterFloat(const char* key, const int n, const float* input);
 int yt_set_UserParameterDouble(const char* key, const int n, const double* input);
 int yt_set_UserParameterString(const char* key, const char* input);
-int yt_commit();
+int yt_commit(); /*!< \ingroup api_yt_commit */
 int yt_free();
 int yt_run_FunctionArguments(const char* function_name, int argc, ...);
 int yt_run_Function(const char* function_name);

src/py_add_dict.cpp

@@ -161,7 +161,7 @@ int AddStringToDict(PyObject* dict, const char* key, const char* string) {
 }
 
 // explicit template instantiation
-/*!< \cond */
+/** @cond */
 template int AddScalarToDict<float>(PyObject* dict, const char* key, const float value);
 template int AddScalarToDict<double>(PyObject* dict, const char* key, const double value);
 template int AddScalarToDict<int>(PyObject* dict, const char* key, const int value);
@@ -186,6 +186,6 @@ template int AddVectorNToDict<unsigned int>(PyObject* dict, const char* key,
                                             const int len, const unsigned int* vector);
 template int AddVectorNToDict<unsigned long>(PyObject* dict, const char* key,
                                              const int len, const unsigned long* vector);
-/*!< \endcond */
+/** @endcond */
 }  // namespace python_controller
 #endif  // #ifndef USE_PYBIND11

src/yt_commit.cpp

@@ -4,30 +4,20 @@
 #include "logging.h"
 #include "timer.h"
 
-//-------------------------------------------------------------------------------------------------------
-// Function    :  yt_commit
-// Description :  Add local grids, append field list and particle list info to the libyt
-// Python module.
-//
-// Note        :  1. Must call yt_get_FieldsPtr (if num_fields>0), yt_get_ParticlesPtr (if
-// num_par_types>0),
-//                   yt_get_GridsPtr, which gets data info from user.
-//                2. Check the local grids, field list, and particle list.
-//                3. Append field_list info and particle_list info to
-//                libyt.param_yt['field_list'] and
-//                   libyt.param_yt['particle_list'].
-//                4. Gather hierarchy in different rank, and check hierarchy in
-//                check_hierarchy(), excluding
-//                   particles.
-//                5. If there is particle, we gather different particle type separately.
-//                6. Pass the grids and hierarchy to YT in function append_grid().
-//                7. We assume that one grid contains all the fields belong to that grid.
-//                8. Free LibytProcessControl::Get().param_yt_.grids_local, after we have
-//                passed all grid info and data in.
-//                9. TODO: this can be more memory efficient when gathering hierarchy.
-//
-// Return      :  YT_SUCCESS or YT_FAIL
-//-------------------------------------------------------------------------------------------------------
+/**
+ * \defgroup api_yt_commit libyt API: yt_commit
+ * \fn int yt_commit()
+ * \brief
+ * Add local grids, append field list and particle list info to the libyt Python module.
+ * \details
+ * 1. Must call \ref yt_get_FieldsPtr (if num_fields>0),
+ *    \ref yt_get_ParticlesPtr (if num_par_types>0), and \ref yt_get_GridsPtr.
+ * 2. Call DataStructureAmr to bind info, bind hierarchy, and bind local data to Python.
+ *
+ * \version 0.1.0
+ *
+ * @return \ref YT_SUCCESS or \ref YT_FAIL
+ */
 int yt_commit() {
   SET_TIMER(__PRETTY_FUNCTION__);