From 71973c722a030d9ee5a09fda5d79e3be07a819c6 Mon Sep 17 00:00:00 2001
From: Philip Withnall <withnall@endlessm.com>
Date: Fri, 7 Jun 2019 11:26:47 +0100
Subject: [PATCH] =?UTF-8?q?gmain:=20Clarify=20that=20g=5Fsource=5Fdestroy(?=
 =?UTF-8?q?)=20doesn=E2=80=99t=20drop=20a=20reference?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

This always confuses people.

Signed-off-by: Philip Withnall <withnall@endlessm.com>
---
 glib/gmain.c | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/glib/gmain.c b/glib/gmain.c
index 2721d0bb2..5e5d7c3e7 100644
--- a/glib/gmain.c
+++ b/glib/gmain.c
@@ -1266,7 +1266,10 @@ g_source_destroy_internal (GSource      *source,
  * destroyed.  The source cannot be subsequently added to another
  * context. It is safe to call this on sources which have already been
  * removed from their context.
- **/
+ *
+ * This does not unref the #GSource: if you still hold a reference, use
+ * g_source_unref() to drop it.
+ */
 void
 g_source_destroy (GSource *source)
 {