[gtk/matthiasc/for-master: 9/9] docs: Small clarifications to DND docs

[Matthias Clasen <matthiasc src gnome org>]

commit b798dbc86eaa31b373ce0e18f5f34ab2b13b07f5
Author: Matthias Clasen <mclasen redhat com>
Date:   Sat Jan 4 12:06:36 2020 -0500

    docs: Small clarifications to DND docs
    
    Clear up the documentation around ASK handling
    a bit.

 gdk/gdkdrop.c  | 5 ++++-
 gdk/gdktypes.h | 7 ++++---
 2 files changed, 8 insertions(+), 4 deletions(-)
---
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
 {