From: Matthias Clasen Date: Sat, 4 Jan 2020 17:06:36 +0000 (-0500) Subject: docs: Small clarifications to DND docs X-Git-Tag: archive/raspbian/4.4.1+ds1-2+rpi1^2~18^2~20^2~459 X-Git-Url: https://dgit.raspbian.org/?a=commitdiff_plain;h=814d20d61a6881d1ba8632f485892ef74ad1991d;p=gtk4.git docs: Small clarifications to DND docs Clear up the documentation around ASK handling a bit. --- diff --git a/gdk/gdkdrop.c b/gdk/gdkdrop.c index ae606cb73c..eb04ca26ad 100644 --- a/gdk/gdkdrop.c +++ b/gdk/gdkdrop.c @@ -448,7 +448,10 @@ gdk_drop_get_surface (GdkDrop *self) * Returns the possible actions for this #GdkDrop. If this value * contains multiple actions - ie gdk_drag_action_is_unique() * returns %FALSE for the result - gdk_drag_finish() must choose - * the action to use when accepting the drop. + * the action to use when accepting the drop. This will only + * happen if you passed %GDK_ACTION_ASK as one of the possible + * actions in gdk_drag_status(). %GDK_ACTION_ASK itself will not + * be included in the actions returned by this function. * * This value may change over the lifetime of the #GdkDrop both * as a response to source side actions as well as to calls to diff --git a/gdk/gdktypes.h b/gdk/gdktypes.h index faa842ae85..c5e237fffc 100644 --- a/gdk/gdktypes.h +++ b/gdk/gdktypes.h @@ -568,11 +568,12 @@ typedef enum * @GDK_ACTION_MOVE: Move the data, i.e. first copy it, then delete * it from the source using the DELETE target of the X selection protocol. * @GDK_ACTION_LINK: Add a link to the data. Note that this is only - * useful if source and destination agree on what it means. + * useful if source and destination agree on what it means, and is not + * supported on all platforms. * @GDK_ACTION_ASK: Ask the user what to do with the data. * - * Used in #GdkDrag to indicate what the destination - * should do with the dropped data. + * Used in #GdkDrop and #GdkDrag to indicate the actions that the + * destination can and should do with the dropped data. */ typedef enum {