From: Matthias Clasen <mclasen@redhat.com>
Date: Tue, 7 Jan 2020 01:20:45 +0000 (-0500)
Subject: dragsource: Document prepare
X-Git-Tag: archive/raspbian/4.4.1+ds1-2+rpi1^2~18^2~20^2~354^2~62
X-Git-Url: https://dgit.raspbian.org/?a=commitdiff_plain;h=bdb4bf00c59330ff66bf7655252fbd1e15fd6619;p=gtk4.git

dragsource: Document prepare
---

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),