[gtk/dnd-gestures-2: 121/150] dragsource: Document prepare

[Matthias Clasen <matthiasc src gnome org>]

commit ca8127027bbd8753218b6002fa8ebb327c78f0dd
Author: Matthias Clasen <mclasen redhat com>
Date:   Mon Jan 6 20:20:45 2020 -0500

    dragsource: Document prepare

 gtk/gtkdragsource.c | 12 ++++++++++++
 1 file changed, 12 insertions(+)
---
diff --git a/gtk/gtkdragsource.c b/gtk/gtkdragsource.c
index 022043283f..9975c5bb07 100644
--- a/gtk/gtkdragsource.c
+++ b/gtk/gtkdragsource.c
@@ -306,6 +306,18 @@ gtk_drag_source_class_init (GtkDragSourceClass *class)
 
   g_object_class_install_properties (object_class, NUM_PROPERTIES, properties);
 
+  /**
+   * GtkDragSource::prepare:
+   * @source: the #GtkDragSource
+   * @x: the X coordinate of the drag starting point
+   * @y: the Y coordinate fo the drag starting point
+   *
+   * The ::prepare signal is emitted when a drag is about to be initiated. It can
+   * be used to set up #GtkDragSource:content and #GtkDragSource:actions just in time,
+   * or to start the drag conditionally.
+   *
+   * Returns: %TRUE to start the drag
+   */
   signals[PREPARE] =
       g_signal_new (I_("prepare"),
                     G_TYPE_FROM_CLASS (class),