From 79b80579282b2749a9eafe8b95845f434db95969 Mon Sep 17 00:00:00 2001
From: Ryan Lortie <desrt@desrt.ca>
Date: Thu, 21 Jul 2011 09:21:18 +0200
Subject: [PATCH] Advise against using GPrivate

GStaticPrivate is really a lot better in almost every way.
---
 glib/gthread.c | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/glib/gthread.c b/glib/gthread.c
index 44075b698..58d76c763 100644
--- a/glib/gthread.c
+++ b/glib/gthread.c
@@ -682,6 +682,10 @@ GThreadFunctions g_thread_functions_for_glib_use = {
 /**
  * GPrivate:
  *
+ * <note><para>
+ * #GStaticPrivate is a better choice for most uses.
+ * </para></note>
+ *
  * The #GPrivate struct is an opaque data structure to represent a
  * thread private data key. Threads can thereby obtain and set a
  * pointer which is private to the current thread. Take our
@@ -741,6 +745,10 @@ GThreadFunctions g_thread_functions_for_glib_use = {
  * non-%NULL, the destructor is called with this pointer as the
  * argument.
  *
+ * <note><para>
+ * #GStaticPrivate is a better choice for most uses.
+ * </para></note>
+ *
  * <note><para>@destructor is used quite differently from @notify in
  * g_static_private_set().</para></note>
  *