X-Git-Url: http://info.iut-bm.univ-fcomte.fr/pub/gitweb/simgrid.git/blobdiff_plain/b5ce62c56116731e8586e42aed37eac39ff387b6..a77f8d403b78888c4adaea9a242ab7ff432a2d16:/include/gras/datadesc.h diff --git a/include/gras/datadesc.h b/include/gras/datadesc.h index 73d697cd9e..7ea963ead9 100644 --- a/include/gras/datadesc.h +++ b/include/gras/datadesc.h @@ -16,7 +16,7 @@ SG_BEGIN_DECL() /** @addtogroup GRAS_dd Data description - * @brief Describing data to be exchanged (Communication facility) + * @brief Describing data to be exchanged * * Since GRAS takes care of potential representation conversion when the platform is heterogeneous, * any data which transits on the network must be described beforehand. @@ -156,9 +156,6 @@ gras_datadesc_parse(const char *name, const char *C_statement); /** @defgroup GRAS_dd_manual Simple manual data description * @ingroup GRAS_dd - *
Top [\ref index]::[\ref GRAS_API]::[\ref GRAS_dd] - *
Prev [\ref GRAS_dd_auto] - *
Next [\ref GRAS_dd_cb_simple]
* * Here are the functions to use if you want to declare your description manually. * The function names should be self-explanatory in most cases. @@ -289,13 +286,11 @@ int gras_datadesc_get_id(gras_datadesc_type_t ddt); /** @defgroup GRAS_dd_cb_simple Data description with Callback Persistant State: Simple push/pop mechanism * @ingroup GRAS_dd - *
Top [\ref index]::[\ref GRAS_API]::[\ref GRAS_dd] - *
Prev [\ref GRAS_dd_manual] - *
Next [\ref GRAS_dd_cb_full]
* * Sometimes, one of the callbacks need to leave information for the next ones. If this is a simple integer (such as * an array size), you can use the functions described here. If not, you'll have to play with the complete cbps interface. * + * \htmlonly \endhtmlonly * * Here is an example:\verbatim struct s_array { @@ -358,12 +353,14 @@ void gras_datadesc_cb_push_ulint_mult(gras_datadesc_type_t typedesc, gras_cbps_t /** @defgroup GRAS_dd_cb_full Data description with Callback Persistant State: Full featured interface * @ingroup GRAS_dd - *
Top [\ref index]::[\ref GRAS_API]::[\ref GRAS_dd] - *
Prev [\ref GRAS_dd_cb_simple] - *
Next
* - * Sometimes, one of the callbacks need to leave information for the next ones. If the simple push/pop mechanism - * introduced in previous section isn't enough, you can always use this full featured one. + * Sometimes, one of the callbacks need to leave information for the next + * ones. If the simple push/pop mechanism introduced in previous section + * isn't enough, you can always use this full featured one. The bad point is + * that it is quite badly documented... + * + * \htmlonly \endhtmlonly + * */ /* @{ */