[glib] docs: Don't be vague about where GTask dispatches the result

[Debarshi Ray <debarshir src gnome org>]

commit 61ea1e7ca48fae358c7212b3dfdb41ce37bd0f33
Author: Debarshi Ray <debarshir gnome org>
Date:   Fri Jun 16 14:37:08 2017 +0200

    docs: Don't be vague about where GTask dispatches the result
    
    https://bugzilla.gnome.org/show_bug.cgi?id=783825

 gio/gtask.c |   19 +++++++++++--------
 1 files changed, 11 insertions(+), 8 deletions(-)
---
diff --git a/gio/gtask.c b/gio/gtask.c
index 9a0c353..fd97f87 100644
--- a/gio/gtask.c
+++ b/gio/gtask.c
@@ -47,11 +47,13 @@
  * Eventually, you will call a method such as
  * g_task_return_pointer() or g_task_return_error(), which will
  * save the value you give it and then invoke the task's callback
- * function (waiting until the next iteration of the main
- * loop first, if necessary). The caller will pass the #GTask back
- * to the operation's finish function (as a #GAsyncResult), and
- * you can use g_task_propagate_pointer() or the like to extract
- * the return value.
+ * function in the
+ * [thread-default main context][g-main-context-push-thread-default]
+ * where it was created (waiting until the next iteration of the main
+ * loop first, if necessary). The caller will pass the #GTask back to
+ * the operation's finish function (as a #GAsyncResult), and you can
+ * can use g_task_propagate_pointer() or the like to extract the
+ * return value.
  *
  * Here is an example for using GTask as a GAsyncResult:
  * |[<!-- language="C" -->
@@ -290,9 +292,10 @@
  * ## Asynchronous operations from synchronous ones
  *
  * You can use g_task_run_in_thread() to turn a synchronous
- * operation into an asynchronous one, by running it in a thread
- * which will then dispatch the result back to the caller's
- * #GMainContext when it completes.
+ * operation into an asynchronous one, by running it in a thread.
+ * When it completes, the result will be dispatched to the
+ * [thread-default main context][g-main-context-push-thread-default]
+ * where the #GTask was created.
  *
  * Running a task in a thread:
  *   |[<!-- language="C" -->