* Adds a #GSource to a @context so that it will be executed within
* that context.
*
- * Return value: the ID for the source within the #GMainContext
+ * Return value: the ID (greater than 0) for the source within the
+ * #GMainContext.
**/
guint
g_source_attach (GSource *source,
* @source: a #GSource
*
* Returns the numeric ID for a particular source. The ID of a source
- * is unique within a particular main loop context. The reverse
+ * is a positive integer which is unique within a particular main loop
+ * context. The reverse
* mapping from ID to source is done by g_main_context_find_source_by_id().
*
- * Return value: the ID for the source
+ * Return value: the ID (greater than 0) for the source
**/
guint
g_source_get_id (GSource *source)
/**
* g_main_context_find_source_by_id:
* @context: a #GMainContext (if %NULL, the default context will be used)
- * @source_id: the source ID, as returned by g_source_get_id()
+ * @source_id: the source ID, as returned by g_source_get_id().
*
- * Finds a #GSource given a pair of context and ID
+ * Finds a #GSource given a pair of context and ID.
*
* Return value: the #GSource if found, otherwise, %NULL
**/
/**
* g_source_remove:
- * @tag: the id of the source to remove.
+ * @tag: the ID of the source to remove.
*
- * Removes the source with the given id from the default main context. The id of
+ * Removes the source with the given id from the default main context.
+ * The id of
* a #GSource is given by g_source_get_id(), or will be returned by the
* functions g_source_attach(), g_idle_add(), g_idle_add_full(),
* g_timeout_add(), g_timeout_add_full(), g_child_watch_add(),
* timeout is recalculated based on the current time and the given interval
* (it does not try to 'catch up' time lost in delays).
*
- * Return value: the id of event source.
+ * Return value: the ID (greater than 0) of the event source.
**/
guint
g_timeout_add_full (gint priority,
* timeout is recalculated based on the current time and the given interval
* (it does not try to 'catch up' time lost in delays).
*
- * Return value: the id of event source.
+ * Return value: the ID (greater than 0) of the event source.
**/
guint
g_timeout_add (guint32 interval,
*
* GLib supports only a single callback per process id.
*
- * Return value: the id of event source.
+ * Return value: the ID (greater than 0) of the event source.
*
* Since: 2.4
**/
*
* GLib supports only a single callback per process id.
*
- * Return value: the id of event source.
+ * Return value: the ID (greater than 0) of the event source.
*
* Since: 2.4
**/
* events pending. If the function returns %FALSE it is automatically
* removed from the list of event sources and will not be called again.
*
- * Return value: the id of the event source.
+ * Return value: the ID (greater than 0) of the event source.
**/
guint
g_idle_add_full (gint priority,
* returns %FALSE it is automatically removed from the list of event
* sources and will not be called again.
*
- * Return value: the id of the event source.
+ * Return value: the ID (greater than 0) of the event source.
**/
guint
g_idle_add (GSourceFunc function,