[glib] Improve g_cond_wait docs

[Matthias Clasen <matthiasc src gnome org>]

commit e478b65ea5fe20ea714a4e78be051a8aa7583ece
Author: Matthias Clasen <mclasen redhat com>
Date:   Fri Jan 4 08:27:00 2013 -0500

    Improve g_cond_wait docs
    
    Document that the mutex is locked upon return.
    https://bugzilla.gnome.org/show_bug.cgi?id=691110

 glib/gthread-posix.c |    2 ++
 1 files changed, 2 insertions(+), 0 deletions(-)
---
diff --git a/glib/gthread-posix.c b/glib/gthread-posix.c
index 68c633c..e65e437 100644
--- a/glib/gthread-posix.c
+++ b/glib/gthread-posix.c
@@ -727,6 +727,8 @@ g_cond_clear (GCond *cond)
  * @mutex: a #GMutex that is currently locked
  *
  * Atomically releases @mutex and waits until @cond is signalled.
+ * When this function returns, @mutex is locked again and owned by the
+ * calling thread.
  *
  * When using condition variables, it is possible that a spurious wakeup
  * may occur (ie: g_cond_wait() returns even though g_cond_signal() was