From d02f59a54b1e9c8fa28d1226df404fbcf15d26eb Mon Sep 17 00:00:00 2001 From: Maximiliano Sandoval Date: Sun, 15 Jun 2025 21:37:11 +0200 Subject: [PATCH] gio: enums: Fix GBusNameOwnerFlags's annotation g-ir-scanner won't pick Since or Deprecated annotations if they are inlined, they need a dedicated documentation block for this to work. The since annotation is used, e.g. in gtk-rs, to not expose enum flags if not compiled declaring we have a new enough glib version. --- gio/gioenums.h | 11 +++++++++-- 1 file changed, 9 insertions(+), 2 deletions(-) diff --git a/gio/gioenums.h b/gio/gioenums.h index 51a03a26a..e4b93bfb4 100644 --- a/gio/gioenums.h +++ b/gio/gioenums.h @@ -987,13 +987,20 @@ typedef enum * @G_BUS_NAME_OWNER_FLAGS_ALLOW_REPLACEMENT: Allow another message bus connection to claim the name. * @G_BUS_NAME_OWNER_FLAGS_REPLACE: If another message bus connection owns the name and have * specified %G_BUS_NAME_OWNER_FLAGS_ALLOW_REPLACEMENT, then take the name from the other connection. - * @G_BUS_NAME_OWNER_FLAGS_DO_NOT_QUEUE: If another message bus connection owns the name, immediately - * return an error from g_bus_own_name() rather than entering the waiting queue for that name. (Since 2.54) * * Flags used in g_bus_own_name(). * * Since: 2.26 */ +/** + * G_BUS_NAME_OWNER_FLAGS_DO_NOT_QUEUE: + * + * If another message bus connection owns the name, immediately return an error + * from [func@Gio.bus_own_name] rather than entering the waiting queue for that + * name. + * + * Since: 2.54 + **/ typedef enum { G_BUS_NAME_OWNER_FLAGS_NONE = 0, /*< nick=none >*/