[glib] gmain: equivocate a bit on _set_ready_time()

[Ryan Lortie <ryanl src gnome org>]

commit 477490786b05c25614620a47a4b7d6632aa6e480
Author: Ryan Lortie <desrt desrt ca>
Date:   Fri Feb 1 04:56:23 2013 +0100

    gmain: equivocate a bit on _set_ready_time()
    
    Since this is a new API this cycle it's a good time to add a doc comment
    explicitly declaring that a confusing issue that could be resolved
    either way has no specific defined behaviour.
    
    This may allow us some additional freedom in future GMainContext work or
    we may decide that one behaviour is more desirable than the other.

 glib/gmain.c |    6 ++++++
 1 files changed, 6 insertions(+), 0 deletions(-)
---
diff --git a/glib/gmain.c b/glib/gmain.c
index 9f9eccc..68a7f8e 100644
--- a/glib/gmain.c
+++ b/glib/gmain.c
@@ -1735,6 +1735,12 @@ g_source_get_priority (GSource *source)
  * Dispatching the source does not reset the ready time.  You should do
  * so yourself, from the source dispatch function.
  *
+ * Note that if you have a pair of sources where the ready time of one
+ * suggests that it will be delivered first but the priority for the
+ * other suggests that it would be delivered first, and the ready time
+ * for both sources is reached during the same main context iteration
+ * then the order of dispatch is undefined.
+ *
  * Since: 2.36
  **/
 void