[gtk/dnd-gestures: 27/29] docs: Mention DND in the migration guide

[Matthias Clasen <matthiasc src gnome org>]

commit 63cd0fdc294a12f040a16b2923dcb269c9a913b7
Author: Matthias Clasen <mclasen redhat com>
Date:   Wed Jan 1 12:55:21 2020 -0500

    docs: Mention DND in the migration guide

 docs/reference/gtk/migrating-3to4.xml | 16 ++++++++++++++++
 1 file changed, 16 insertions(+)
---
diff --git a/docs/reference/gtk/migrating-3to4.xml b/docs/reference/gtk/migrating-3to4.xml
index d64261eee7..49a119ec6c 100644
--- a/docs/reference/gtk/migrating-3to4.xml
+++ b/docs/reference/gtk/migrating-3to4.xml
@@ -903,6 +903,22 @@
         gtk_tooltip_set_custom().
       </para>
     </section>
+
+    <section>
+      <title>Switch to the new DND api</title>
+      <para>
+        The source-side DND apis in GTK 4 have been changed to use a separate object, #GtkDragSource.
+      </para>
+      <para>
+        Instead of calling gtk_drag_source_set() and connecting to #GtkWidget signals, you create
+        a #GtkDragSource object, attach it to the widget with gtk_drag_source_attach(), and connect
+        to #GtkDragSource signals. The signals themselves are fairly similar.
+      </para>
+      <para>
+        Instead of calling gtk_drag_begin() on a widget, use a #GtkDragSource object and call
+        gtk_drag_source_drag_begin().
+      </para>
+    </section>
   </section>
 
 </chapter>