[glib] doc: improve doc of g_subprocess_wait()

[Sébastien Wilmet <swilmet src gnome org>]

commit b0c7221c559693baf0735d6562940e0eec0a798c
Author: Sébastien Wilmet <swilmet gnome org>
Date:   Thu Jul 3 15:45:11 2014 +0200

    doc: improve doc of g_subprocess_wait()
    
    When using this API, I wasn't sure what the cancellable does. I think
    it's generally desirable to kill the subprocess if the wait operation is
    cancelled, since in this case the application is no longer interested by
    the subprocess.
    
    https://bugzilla.gnome.org/show_bug.cgi?id=732704

 gio/gsubprocess.c |    3 +++
 1 files changed, 3 insertions(+), 0 deletions(-)
---
diff --git a/gio/gsubprocess.c b/gio/gsubprocess.c
index 339b54b..999d777 100644
--- a/gio/gsubprocess.c
+++ b/gio/gsubprocess.c
@@ -941,6 +941,9 @@ g_subprocess_sync_complete (GAsyncResult **result)
  * This function does not fail in the case of the subprocess having
  * abnormal termination.  See g_subprocess_wait_check() for that.
  *
+ * Cancelling @cancellable doesn't kill the subprocess.  Call
+ * g_subprocess_force_exit() if it is desirable.
+ *
  * Returns: %TRUE on success, %FALSE if @cancellable was cancelled
  *
  * Since: 2.40