From 9b9d7e13552e082e7152dcc6c819c0eee1b0db49 Mon Sep 17 00:00:00 2001 From: Dana Robinson <43805+derobins@users.noreply.github.com> Date: Wed, 28 Dec 2022 08:35:40 -0800 Subject: Adds Doxygen markup to H5FDdriver_query() (#2373) * Adds Doxygen markup to H5FDdriver_query() * Fixes Doxygen warnings * Fixed missing * --- src/H5FDpublic.h | 22 +++++++++++++++++++++- src/H5VLpublic.h | 5 ++--- 2 files changed, 23 insertions(+), 4 deletions(-) diff --git a/src/H5FDpublic.h b/src/H5FDpublic.h index 3b956de..422cd18 100644 --- a/src/H5FDpublic.h +++ b/src/H5FDpublic.h @@ -397,7 +397,27 @@ extern "C" { #endif /* Function prototypes */ -/* Allows querying a VFD ID for features before the file is opened */ + +/** + * \ingroup H5FD + * + * \brief Allows querying a VFD ID for features before the file is opened + * + * \param[in] driver_id Virtual File Driver (VFD) ID + * \param[out] flags VFD flags supported + * + * \return \herr_t + * + * \details Queries a virtual file driver (VFD) for feature flags. Takes a + * VFD hid_t so it can be used before the file is opened. For example, + * this could be used to check if a VFD supports SWMR. + * + * \note The flags obtained here are just those of the base driver and + * do not take any configuration options (e.g., set via a fapl + * call) into consideration. + * + * \since 1.10.2 + */ H5_DLL herr_t H5FDdriver_query(hid_t driver_id, unsigned long *flags /*out*/); #ifdef __cplusplus diff --git a/src/H5VLpublic.h b/src/H5VLpublic.h index f32abda..c0a0e68 100644 --- a/src/H5VLpublic.h +++ b/src/H5VLpublic.h @@ -409,9 +409,8 @@ H5_DLL herr_t H5VLquery_optional(hid_t obj_id, H5VL_subclass_t subcls, int opt_t * \brief Determines whether an object ID represents a native * VOL connector object. * - * \param[in] obj_id Object identifier - * \param[in] is_native Boolean determining whether object is a native - * VOL connector object + * \obj_id + * \param[out] is_native Boolean determining whether object is a native VOL connector object * \return \herr_t * * \since 1.14.0 -- cgit v0.12