From: Matthias Clasen <mclasen@redhat.com>
Date: Fri, 15 Dec 2006 03:42:24 +0000 (+0000)
Subject: Improve the docs. (#345569, Tim-Philipp Müller)
X-Git-Tag: GLIB_2_13_0~188
X-Git-Url: http://review.tizen.org/git/?a=commitdiff_plain;h=dc78f9b202ab926e1c77a16fde0f869aba1dfc06;p=platform%2Fupstream%2Fglib.git

Improve the docs. (#345569, Tim-Philipp Müller)

2006-12-14  Matthias Clasen  <mclasen@redhat.com>

	* glib/gmain.c (g_child_watch_add_full): Improve the docs.
	(#345569, Tim-Philipp Müller)
---

diff --git a/ChangeLog b/ChangeLog
index 572ec4f..5525b97 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,5 +1,8 @@
 2006-12-14  Matthias Clasen  <mclasen@redhat.com>
 
+	* glib/gmain.c (g_child_watch_add_full): Improve the docs.
+	(#345569, Tim-Philipp Müller)
+
 	* glib/gkeyfile.c (g_key_file_add_group): If the group
 	is already there, make it current.  (#385910, Joe Halliwell)
 
diff --git a/glib/gmain.c b/glib/gmain.c
index bbbf8aa..432ddff 100644
--- a/glib/gmain.c
+++ b/glib/gmain.c
@@ -3974,8 +3974,12 @@ g_child_watch_source_new (GPid pid)
  * @data:     data to pass to @function
  * @notify:   function to call when the idle is removed, or %NULL
  * 
- * Sets a function to be called when the child indicated by @pid exits, at a
- * default priority, #G_PRIORITY_DEFAULT.
+ * Sets a function to be called when the child indicated by @pid 
+ * exits, at the priority @priority.
+ *
+ * If you obtain @pid from g_spawn_async() or g_spawn_async_with_pipes() 
+ * you will need to pass #G_SPAWN_DO_NOT_REAP_CHILD as flag to 
+ * the spawn function for the child watching to work.
  * 
  * Note that on platforms where #GPid must be explicitly closed
  * (see g_spawn_close_pid()) @pid must not be closed while the
@@ -4018,8 +4022,12 @@ g_child_watch_add_full (gint            priority,
  * @function: function to call
  * @data:     data to pass to @function
  * 
- * Sets a function to be called when the child indicated by @pid exits, at a
- * default priority, #G_PRIORITY_DEFAULT.
+ * Sets a function to be called when the child indicated by @pid 
+ * exits, at a default priority, #G_PRIORITY_DEFAULT.
+ * 
+ * If you obtain @pid from g_spawn_async() or g_spawn_async_with_pipes() 
+ * you will need to pass #G_SPAWN_DO_NOT_REAP_CHILD as flag to 
+ * the spawn function for the child watching to work.
  * 
  * Note that on platforms where #GPid must be explicitly closed
  * (see g_spawn_close_pid()) @pid must not be closed while the