[gtk+/wip/garnacho/dnd-grab: 4/4] gdk: Document the functions that don't need calling on managed DnD

[Carlos Garnacho <carlosg src gnome org>]

commit 20d50674c8eb9d8ba77b03a677356981645ff0cf
Author: Carlos Garnacho <carlosg gnome org>
Date:   Mon Jan 18 22:22:24 2016 +0100

    gdk: Document the functions that don't need calling on managed DnD
    
    These functions will be automatically called by the windowing backend.
    The usual hooks to run this from in gtk/ shouldn't even happen, but
    it is worth to document which calls are expected and which aren't.

 gdk/gdkdnd.c |    9 +++++++++
 1 files changed, 9 insertions(+), 0 deletions(-)
---
diff --git a/gdk/gdkdnd.c b/gdk/gdkdnd.c
index 5803e9f..0a3afea 100644
--- a/gdk/gdkdnd.c
+++ b/gdk/gdkdnd.c
@@ -428,6 +428,9 @@ gdk_drag_status (GdkDragContext *context,
  *
  * This function is called by the drag source.
  *
+ * This function does not need to be called in managed drag and drop
+ * operations. See gdk_drag_context_manage_dnd() for more information.
+ *
  * Returns:
  */
 gboolean
@@ -461,6 +464,9 @@ gdk_drag_motion (GdkDragContext *context,
  * Aborts a drag without dropping.
  *
  * This function is called by the drag source.
+ *
+ * This function does not need to be called in managed drag and drop
+ * operations. See gdk_drag_context_manage_dnd() for more information.
  */
 void
 gdk_drag_abort (GdkDragContext *context,
@@ -479,6 +485,9 @@ gdk_drag_abort (GdkDragContext *context,
  * Drops on the current destination.
  *
  * This function is called by the drag source.
+ *
+ * This function does not need to be called in managed drag and drop
+ * operations. See gdk_drag_context_manage_dnd() for more information.
  */
 void
 gdk_drag_drop (GdkDragContext *context,