From 74e2bb4cf1cb78fc321619182ea1806e5b87fedc Mon Sep 17 00:00:00 2001 From: Matthias Clasen Date: Tue, 16 Mar 2021 14:24:04 -0400 Subject: [PATCH] dnd: Add some warnings to the docs Add some warnings about pitfalls of the async dnd api. --- gdk/gdkdrop.c | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/gdk/gdkdrop.c b/gdk/gdkdrop.c index 4d7ab014f3..cb1cdb1bf6 100644 --- a/gdk/gdkdrop.c +++ b/gdk/gdkdrop.c @@ -699,6 +699,11 @@ gdk_drop_read_async (GdkDrop *self, * * Finishes an async drop read operation. * + * Note that you must not use blocking read calls on the returned stream + * in the GTK thread, since some platforms might require communication with + * GTK to complete the data transfer. You can use async APIs such as + * g_input_stream_read_bytes_async(). + * * See [method@Gdk.Drop.read_async]. * * Returns: (nullable) (transfer full): the `GInputStream`, or %NULL