From c891dc254b5a8a73ad22b0cb94959af38e6fd098 Mon Sep 17 00:00:00 2001
From: Daemonratte <daemonratte@daemonratte.net>
Date: Fri, 8 May 2026 19:27:55 +0200
Subject: [PATCH] docs: annotate gtk_gc_get ownership for introspection

---
 gtk/gtkgc.c | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/gtk/gtkgc.c b/gtk/gtkgc.c
index 2bf7bca77..50c0701c9 100644
--- a/gtk/gtkgc.c
+++ b/gtk/gtkgc.c
@@ -77,6 +77,18 @@ static GHashTable *gc_key_ht = NULL;
 static GHashTable *gc_gc_ht = NULL;
 static GQuark quark_gtk_gc_drawable_ht = 0;
 
+/**
+ * gtk_gc_get:
+ * @depth: the depth of the graphics context
+ * @colormap: a #GdkColormap
+ * @values: a #GdkGCValues structure containing values for the graphics context
+ * @values_mask: a mask indicating which fields of @values are set
+ *
+ * Gets a shared #GdkGC matching the given values.
+ *
+ * Returns: (transfer full): a #GdkGC. Release it with gtk_gc_release()
+ *   when no longer needed.
+ */
 GdkGC*
 gtk_gc_get (gint             depth,
             GdkColormap     *colormap,