diff options
author | Dana Robinson <derobins@hdfgroup.org> | 2021-05-07 17:56:07 (GMT) |
---|---|---|
committer | Dana Robinson <derobins@hdfgroup.org> | 2021-05-07 17:56:07 (GMT) |
commit | 7f58a89578b64df2b040d97294cb1cf2a82bebd3 (patch) | |
tree | de9971f9f1537a23e2ab59fa1ad4c2631164d20e /src/H5Dmodule.h | |
parent | 79b92df2a262c09eb7461c5bbd9500209573653b (diff) | |
download | hdf5-7f58a89578b64df2b040d97294cb1cf2a82bebd3.zip hdf5-7f58a89578b64df2b040d97294cb1cf2a82bebd3.tar.gz hdf5-7f58a89578b64df2b040d97294cb1cf2a82bebd3.tar.bz2 |
Misc normalization from develop
Diffstat (limited to 'src/H5Dmodule.h')
-rw-r--r-- | src/H5Dmodule.h | 38 |
1 files changed, 30 insertions, 8 deletions
diff --git a/src/H5Dmodule.h b/src/H5Dmodule.h index 292b624..595c714 100644 --- a/src/H5Dmodule.h +++ b/src/H5Dmodule.h @@ -29,15 +29,37 @@ #define H5_MY_PKG_ERR H5E_DATASET #define H5_MY_PKG_INIT YES -/** - * \defgroup H5D H5D - * \brief Group Interface - * \details The HDF5 Dataset Interface, H5D, provides a mechanism for managing - * HDF5 datasets, including the transfer of data between memory and - * disk and the description of dataset properties. +/**\defgroup H5D H5D + * + * Use the functions in this module to manage HDF5 datasets, including the + * transfer of data between memory and disk and the description of dataset + * properties. Datasets are used by other HDF5 APIs and referenced either by + * name or by a handle. Such handles can be obtained by either creating or + * opening the dataset. + * + * Typical stages in the HDF5 dataset life cycle are shown below in introductory + * examples. + * + * <table> + * <tr><th>Create</th><th>Read</th></tr> + * <tr valign="top"> + * <td> + * \snippet H5D_examples.c create + * </td> + * <td> + * \snippet H5D_examples.c read + * </td> + * <tr><th>Update</th><th>Delete</th></tr> + * <tr valign="top"> + * <td> + * \snippet H5D_examples.c update + * </td> + * <td> + * \snippet H5D_examples.c delete + * </td> + * </tr> + * </table> * - * A Dataset is used by other HDF5 APIs, either by name or by a handle, - * which is obtained by either creating or opening the dataset. */ #endif /* H5Dmodule_H */ |