* After each call to the timeout function, the time of the next
* timeout is recalculated based on the current time and the given interval
* (it does not try to 'catch up' time lost in delays).
+ *
+ * This internally creates a main loop source using g_timeout_source_new()
+ * and attaches it to the main loop context using g_source_attach(). You can
+ * do these steps manually if you need greater control.
*
* Return value: the ID (greater than 0) of the event source.
**/
* g_timeout_add_seconds() function; this function allows for more
* optimizations and more efficient system power usage.
*
+ * This internally creates a main loop source using g_timeout_source_new()
+ * and attaches it to the main loop context using g_source_attach(). You can
+ * do these steps manually if you need greater control.
+ *
* Return value: the ID (greater than 0) of the event source.
**/
guint
* and you don't require the first timer exactly one second from now, the
* use of g_timeout_add_seconds() is preferred over g_timeout_add().
*
+ * This internally creates a main loop source using
+ * g_timeout_source_new_seconds() and attaches it to the main loop context
+ * using g_source_attach(). You can do these steps manually if you need
+ * greater control.
+ *
* Return value: the ID (greater than 0) of the event source.
*
* Since: 2.14
* it returns %FALSE, at which point the timeout is automatically destroyed
* and the function will not be called again.
*
- * See g_timeout_add_seconds_full() for the differences between
- * g_timeout_add() and g_timeout_add_seconds().
- *
+ * This internally creates a main loop source using
+ * g_timeout_source_new_seconds() and attaches it to the main loop context
+ * using g_source_attach(). You can do these steps manually if you need
+ * greater control. Also see g_timout_add_seconds_full().
+ *
* Return value: the ID (greater than 0) of the event source.
*
* Since: 2.14
*
* GLib supports only a single callback per process id.
*
+ * This internally creates a main loop source using
+ * g_child_watch_source_new() and attaches it to the main loop context
+ * using g_source_attach(). You can do these steps manually if you
+ * need greater control.
+ *
* Return value: the ID (greater than 0) of the event source.
*
* Since: 2.4
*
* GLib supports only a single callback per process id.
*
+ * This internally creates a main loop source using
+ * g_child_watch_source_new() and attaches it to the main loop context
+ * using g_source_attach(). You can do these steps manually if you
+ * need greater control.
+ *
* 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.
*
+ * This internally creates a main loop source using g_idle_source_new()
+ * and attaches it to the main loop context using g_source_attach().
+ * You can do these steps manually if you need greater control.
+ *
* Return value: the ID (greater than 0) of the event source.
**/
guint
* returns %FALSE it is automatically removed from the list of event
* sources and will not be called again.
*
+ * This internally creates a main loop source using g_idle_source_new()
+ * and attaches it to the main loop context using g_source_attach().
+ * You can do these steps manually if you need greater control.
+ *
* Return value: the ID (greater than 0) of the event source.
**/
guint