From 24f2e76576dfff39238484e7e9c7e9df759d2ca5 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Corentin=20No=C3=ABl?= <corentin.noel@collabora.com>
Date: Thu, 30 May 2024 15:48:23 +0200
Subject: [PATCH] meta/plugin: Annotate dialog creation virtuals as return full

The two dialog creation virtual functions returned by these functions have to
be unreferenced by the caller (and are actually unreferenced in other places in
the code).

Part-of: <https://gitlab.gnome.org/GNOME/mutter/-/merge_requests/3790>
(cherry picked from commit 4134d12789df15094a6674684b21f8916b42546a)
---
 src/meta/meta-plugin.h | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/src/meta/meta-plugin.h b/src/meta/meta-plugin.h
index c6fb0872f..8d71dc84c 100644
--- a/src/meta/meta-plugin.h
+++ b/src/meta/meta-plugin.h
@@ -224,6 +224,8 @@ struct _MetaPluginClass
    *
    * Virtual function called to create a "force quit" dialog
    * on non-responsive clients.
+   *
+   * Returns: (transfer full) (nullable): a #MetaCloseDialog
    */
   MetaCloseDialog * (* create_close_dialog) (MetaPlugin *plugin,
                                              MetaWindow *window);
@@ -235,6 +237,8 @@ struct _MetaPluginClass
    *
    * Virtual function called to create a "inhibit shortcuts" dialog
    * when a client requests compositor shortcuts to be inhibited.
+   *
+   * Returns: (transfer full): a #MetaInhibitShortcutsDialog
    */
   MetaInhibitShortcutsDialog * (* create_inhibit_shortcuts_dialog) (MetaPlugin *plugin,
                                                                     MetaWindow *window);