From 8fde28813ee8a705ecf1f941e8df6dbc9615c1ac Mon Sep 17 00:00:00 2001
From: "Ryan C. Gordon" <[EMAIL REDACTED]>
Date: Thu, 26 Dec 2024 14:09:26 -0500
Subject: [PATCH] SDL_tray.h: Filled in doxygen for a few minor missing things.
---
include/SDL3/SDL_tray.h | 21 ++++++++++++++++++++-
1 file changed, 20 insertions(+), 1 deletion(-)
diff --git a/include/SDL3/SDL_tray.h b/include/SDL3/SDL_tray.h
index a9f482839fe8d..8e81a0c38596f 100644
--- a/include/SDL3/SDL_tray.h
+++ b/include/SDL3/SDL_tray.h
@@ -39,8 +39,25 @@
extern "C" {
#endif
+/**
+ * An opaque handle representing a toplevel system tray object.
+ *
+ * \since This struct is available since SDL 3.2.0.
+ */
typedef struct SDL_Tray SDL_Tray;
+
+/**
+ * An opaque handle representing a menu/submenu on a system tray object.
+ *
+ * \since This struct is available since SDL 3.2.0.
+ */
typedef struct SDL_TrayMenu SDL_TrayMenu;
+
+/**
+ * An opaque handle representing an entry on a system tray object.
+ *
+ * \since This struct is available since SDL 3.2.0.
+ */
typedef struct SDL_TrayEntry SDL_TrayEntry;
/**
@@ -50,7 +67,7 @@ typedef struct SDL_TrayEntry SDL_TrayEntry;
* the time a tray entry is created. Other flags are optional; zero or more of
* those can be OR'ed together with the required flag.
*
- * \since This datatype is available since SDL 3.0.0.
+ * \since This datatype is available since SDL 3.2.0.
*
* \sa SDL_InsertTrayEntryAt
*/
@@ -69,6 +86,8 @@ typedef Uint32 SDL_TrayEntryFlags;
* it will be invoked.
* \param entry the tray entry that was selected.
*
+ * \since This datatype is available since SDL 3.2.0.
+ *
* \sa SDL_SetTrayEntryCallback
*/
typedef void (SDLCALL *SDL_TrayCallback)(void *userdata, SDL_TrayEntry *entry);