From 4abb6c13bed8ad398c124e8880b8743617f8bee1 Mon Sep 17 00:00:00 2001 From: Matthias Clasen Date: Sat, 10 Nov 2007 00:23:16 +0000 Subject: [PATCH] Improve the docs. (#491974, Areg Beketovski) 2007-11-09 Matthias Clasen * glib/gmain.c (g_main_context_iteration): Improve the docs. (#491974, Areg Beketovski) svn path=/trunk/; revision=5850 --- ChangeLog | 5 +++++ glib/gmain.c | 12 ++++++++---- 2 files changed, 13 insertions(+), 4 deletions(-) diff --git a/ChangeLog b/ChangeLog index 24cbcbed..bddfbfa9 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,3 +1,8 @@ +2007-11-09 Matthias Clasen + + * glib/gmain.c (g_main_context_iteration): Improve the + docs. (#491974, Areg Beketovski) + 2007-11-09 Matthias Clasen * glib/gdate.c: Coding style fixes. diff --git a/glib/gmain.c b/glib/gmain.c index 6d077c97..52b1c21e 100644 --- a/glib/gmain.c +++ b/glib/gmain.c @@ -2737,10 +2737,14 @@ g_main_context_pending (GMainContext *context) * checking to see if any event sources are ready to be processed, * then if no events sources are ready and @may_block is %TRUE, waiting * for a source to become ready, then dispatching the highest priority - * events sources that are ready. Note that even when @may_block is %TRUE, - * it is still possible for g_main_context_iteration() to return - * %FALSE, since the the wait may be interrupted for other - * reasons than an event source becoming ready. + * events sources that are ready. Otherwise, if @may_block is %FALSE + * sources are not waited to become ready, only those highest priority + * events sources will be dispatched (if any), that are ready at this + * given moment without further waiting. + * + * Note that even when @may_block is %TRUE, it is still possible for + * g_main_context_iteration() to return %FALSE, since the the wait may + * be interrupted for other reasons than an event source becoming ready. * * Return value: %TRUE if events were dispatched. **/ -- 2.34.1