luc14n0/glib
1
0
Fork 0
mirror of https://gitlab.gnome.org/GNOME/glib.git synced 2025-08-20 23:58:54 +02:00
Code Issues Packages Projects Releases Wiki Activity

gmain: Clarify documentation for g_source_get_id()

Browse Source 
It’s good to know *which* GMainContext is used to determine the ID, and
the preconditions for calling this method.

Using wording suggested by Emmanuele Bassi <ebassi@gmail.com>.

Signed-off-by: Philip Withnall <withnall@endlessm.com>
This commit is contained in:
Philip Withnall
2018-06-21 17:09:57 +01:00
parent 03c324c64a
commit 515dac258c
1 changed files with 5 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

5
glib/gmain.c
View File

@@ -1296,6 +1296,11 @@ g_source_destroy (GSource *source)
* context. The reverse * context. The reverse
* mapping from ID to source is done by g_main_context_find_source_by_id(). * mapping from ID to source is done by g_main_context_find_source_by_id().
* *
* You can only call this function while the source is associated to a
* #GMainContext instance; calling this function before g_source_attach()
* or after g_source_destroy() yields undefined behavior. The ID returned
* is unique within the #GMainContext instance passed to g_source_attach().
*
* Returns: the ID (greater than 0) for the source * Returns: the ID (greater than 0) for the source
**/ **/
guint guint