[glib/wip/mutexes] And move the g_thread_yield() docs too

[Matthias Clasen <matthiasc src gnome org>]

commit b96f88959ac320098544262ada63a59eda266ce4
Author: Matthias Clasen <mclasen redhat com>
Date:   Sun Sep 18 22:11:12 2011 -0400

    And move the g_thread_yield() docs too

 glib/gthread-posix.c |    9 +++++++++
 1 files changed, 9 insertions(+), 0 deletions(-)
---
diff --git a/glib/gthread-posix.c b/glib/gthread-posix.c
index 5e51634..52b8d3f 100644
--- a/glib/gthread-posix.c
+++ b/glib/gthread-posix.c
@@ -629,6 +629,15 @@ g_thread_create_posix_impl (GThreadFunc thread_func,
   posix_check_err (ret, "pthread_create");
 }
 
+/**
+ * g_thread_yield:
+ *
+ * Gives way to other threads waiting to be scheduled.
+ *
+ * This function is often used as a method to make busy wait less evil.
+ * But in most cases you will encounter, there are better methods to do
+ * that. So in general you shouldn't use this function.
+ */
 void
 g_thread_yield (void)
 {