dnd: Add some warnings to the docs

Add some warnings about pitfalls of the async dnd api.
This commit is contained in:
Matthias Clasen 2021-03-16 14:24:04 -04:00
parent cc6bb13242
commit 74e2bb4cf1

View File

@ -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