Add more docs

svn path=/trunk/; revision=7545

ChangeLog

@@ -1,5 +1,7 @@
 @008-09-26  Matthias Clasen  <mclasen@redhat.com>
 
+	* glib/gmain.c: Add some more docs.
+
 	* glib/giochannel.c: Move more docs inline, and improve them
 	on the way.
 

glib/gmain.c

@@ -3347,6 +3347,10 @@ g_timeout_source_new_seconds (guint interval)
  * 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.
  **/
 guint
@@ -3397,6 +3401,10 @@ g_timeout_add_full (gint           priority,
  * 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
@@ -3443,6 +3451,11 @@ g_timeout_add (guint32        interval,
  * 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
@@ -3482,8 +3495,10 @@ g_timeout_add_seconds_full (gint           priority,
  * 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
+ * This internally creates a main loop source using 
- * g_timeout_add() and g_timeout_add_seconds().
+ * 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.
  *
@@ -3805,6 +3820,11 @@ g_child_watch_source_new (GPid pid)
  * 
  * 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
@@ -3854,6 +3874,11 @@ g_child_watch_add_full (gint            priority,
  *
  * 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
@@ -3935,6 +3960,10 @@ g_idle_source_new (void)
  * 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 
@@ -3971,6 +4000,10 @@ g_idle_add_full (gint           priority,
  * 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