docs: Explain how GAsyncReadyCallbacks are, and should be, invoked

https://bugzilla.gnome.org/show_bug.cgi?id=783825
This commit is contained in:
Debarshi Ray 2017-06-16 14:15:03 +02:00
parent a71251dc40
commit 09d936c528

View File

@ -264,7 +264,13 @@ typedef struct _GVolumeMonitor GVolumeMonitor;
* @user_data: user data passed to the callback.
*
* Type definition for a function that will be called back when an asynchronous
* operation within GIO has been completed.
* operation within GIO has been completed. #GAsyncReadyCallback
* callbacks from #GTask are guaranteed to be invoked in a later
* iteration of the
* [thread-default main context][g-main-context-push-thread-default]
* where the #GTask was created. All other users of
* #GAsyncReadyCallback must likewise call it asynchronously in a
* later iteration of the main context.
**/
typedef void (*GAsyncReadyCallback) (GObject *source_object,
GAsyncResult *res,