GCond: use monotonic time for timed waits
Switch GCond to using monotonic time for timed waits by introducing a
new API based on monotonic time in a gint64: g_cond_wait_until().
Deprecate the old API based on wallclock time in a GTimeVal.
Fix up the gtk-doc for GCond while we're at it: update the examples to
use static-allocated GCond and GMutex and clarify some things a bit.
Also explain the rationale behind using an absolute time instead of a
relative time.
diff --git a/glib/gthread.h b/glib/gthread.h
index 6afffa1..c3b0f0c 100644
--- a/glib/gthread.h
+++ b/glib/gthread.h
@@ -179,10 +179,7 @@
GMutex *mutex);
void g_cond_signal (GCond *cond);
void g_cond_broadcast (GCond *cond);
-gboolean g_cond_timed_wait (GCond *cond,
- GMutex *mutex,
- GTimeVal *timeval);
-gboolean g_cond_timedwait (GCond *cond,
+gboolean g_cond_wait_until (GCond *cond,
GMutex *mutex,
gint64 abs_time);