[Home]

Issue of the Standard # D0014

Brief

The documentation of the interface "g_main_context_iteration" does not completely describe it's functionality for the "may_block" parameter

Detailed Description

Whenever "may_block" parameter value is set to "FALSE", during the upcoming iteration 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.

Problem location(s) in the standard

Linux Standard Base Desktop Specification 3.1, Chapter 12. Libraries, 12.2 Interfaces for libglib-2.0; http://www.gtk.org/api/2.6/glib/glib-The-Main-Event-Loop.html#g-main-context-iteration

Possible solutions

We propose to add to the documentation after the sentence:

"This involves 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."

the following text:

"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.".

Accepted

Gnome Bugzilla 491974

Status

Fixed in gtk-glib - 2.16

[Home]