From 038216e2cf7a8533fa8eba7b024ed09e9a554991 Mon Sep 17 00:00:00 2001
From: Dana Robinson <43805+derobins@users.noreply.github.com>
Date: Sat, 6 May 2023 15:36:14 -0700
Subject: Add Doxygen for H5ES_NONE _WAIT_NONE/FOREVER (#2922)

---
 src/H5ESpublic.h | 23 +++++++++++++----------
 1 file changed, 13 insertions(+), 10 deletions(-)

diff --git a/src/H5ESpublic.h b/src/H5ESpublic.h
index f2c7cb5..b66ef21 100644
--- a/src/H5ESpublic.h
+++ b/src/H5ESpublic.h
@@ -18,23 +18,26 @@
 #define H5ESpublic_H
 
 /* Public headers needed by this file */
-#include "H5public.h" /* Generic Functions                    */
+#include "H5public.h"
 
 /*****************/
 /* Public Macros */
 /*****************/
 
-/* Default value for "no event set" / synchronous execution */
-#define H5ES_NONE 0 /* (hid_t) */
+/**
+ * Default value for "no event set" / synchronous execution. Used in
+ * place of a @ref hid_t identifier.
+ */
+#define H5ES_NONE 0
 
 /* Special "wait" timeout values */
-#define H5ES_WAIT_FOREVER (UINT64_MAX) /* Wait until all operations complete */
-#define H5ES_WAIT_NONE                                                                                       \
-    (0) /* Don't wait for operations to complete,                                                            \
-         *  just check their status.                                                                         \
-         *  (this allows H5ESwait to behave                                                                  \
-         *   like a 'test' operation)                                                                        \
-         */
+#define H5ES_WAIT_FOREVER (UINT64_MAX) /**< Wait until all operations complete */
+
+/**
+ * Don't wait for operations to complete, just check their status.
+ * (This allows @ref H5ESwait to behave like a 'test' operation)
+ */
+#define H5ES_WAIT_NONE (0)
 
 /*******************/
 /* Public Typedefs */
-- 
cgit v0.12