Make 3.0 parallel-installable to 2.x

[~andy/gtk] / docs / reference / gtk / tmpl / gtktreednd.sgml

diff --git a/docs/reference/gtk/tmpl/gtktreednd.sgml b/docs/reference/gtk/tmpl/gtktreednd.sgml
index 9414655b6bcbb17e4124a0f222c3bfb3655d4963..a45f8219ed6e339acc4b3fddf5344bf2ce5e18e5 100644 (file)
--- a/docs/reference/gtk/tmpl/gtktreednd.sgml
+++ b/docs/reference/gtk/tmpl/gtktreednd.sgml
@@ -2,27 +2,88 @@
 GtkTreeView drag-and-drop
 
 <!-- ##### SECTION Short_Description ##### -->
-
+Interfaces for drag-and-drop support in GtkTreeView
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>
+GTK+ supports Drag-and-Drop in tree views with a high-level and a low-level 
+API.
+</para>
+<para>
+The low-level API consists of the GTK+ DND API, augmented by some treeview 
+utility functions: gtk_tree_view_set_drag_dest_row(),
+gtk_tree_view_get_drag_dest_row(), gtk_tree_view_get_dest_row_at_pos(), 
+gtk_tree_view_create_row_drag_icon(), gtk_tree_set_row_drag_data() and
+gtk_tree_get_row_drag_data(). This API leaves a lot of flexibility, but
+nothing is done automatically, and implementing advanced features like
+hover-to-open-rows or autoscrolling on top of this API is a lot of work.
+</para>
+<para>
+On the other hand, if you write to the high-level API, then all the 
+bookkeeping of rows is done for you, as well as things like hover-to-open 
+and auto-scroll, but your models have to implement the 
+#GtkTreeDragSource and #GtkTreeDragDest interfaces.
+</para>
+
+<!-- ##### SECTION See_Also ##### -->
+<para>
 
 </para>
 
+<!-- ##### SECTION Stability_Level ##### -->
 
-<!-- ##### SECTION See_Also ##### -->
+
+<!-- ##### SECTION Image ##### -->
+
+
+<!-- ##### STRUCT GtkTreeDragSource ##### -->
 <para>
 
 </para>
 
 
-<!-- ##### STRUCT GtkTreeDragDest ##### -->
+<!-- ##### STRUCT GtkTreeDragSourceIface ##### -->
 <para>
 
 </para>
 
+@g_iface: 
+@row_draggable: 
+@drag_data_get: 
+@drag_data_delete: 
 
-<!-- ##### STRUCT GtkTreeDragSource ##### -->
+<!-- ##### FUNCTION gtk_tree_drag_source_drag_data_delete ##### -->
+<para>
+
+</para>
+
+@drag_source: 
+@path: 
+@Returns: 
+
+
+<!-- ##### FUNCTION gtk_tree_drag_source_drag_data_get ##### -->
+<para>
+
+</para>
+
+@drag_source: 
+@path: 
+@selection_data: 
+@Returns: 
+
+
+<!-- ##### FUNCTION gtk_tree_drag_source_row_draggable ##### -->
+<para>
+
+</para>
+
+@drag_source: 
+@path: 
+@Returns: 
+
+
+<!-- ##### STRUCT GtkTreeDragDest ##### -->
 <para>
 
 </para>
@@ -37,13 +98,47 @@ GtkTreeView drag-and-drop
 @drag_data_received: 
 @row_drop_possible: 
 
-<!-- ##### STRUCT GtkTreeDragSourceIface ##### -->
+<!-- ##### FUNCTION gtk_tree_drag_dest_drag_data_received ##### -->
 <para>
 
 </para>
 
-@g_iface: 
-@row_draggable: 
-@drag_data_get: 
-@drag_data_delete: 
+@drag_dest: 
+@dest: 
+@selection_data: 
+@Returns: 
+
+
+<!-- ##### FUNCTION gtk_tree_drag_dest_row_drop_possible ##### -->
+<para>
+
+</para>
+
+@drag_dest: 
+@dest_path: 
+@selection_data: 
+@Returns: 
+
+
+<!-- ##### FUNCTION gtk_tree_set_row_drag_data ##### -->
+<para>
+
+</para>
+
+@selection_data: 
+@tree_model: 
+@path: 
+@Returns: 
+
+
+<!-- ##### FUNCTION gtk_tree_get_row_drag_data ##### -->
+<para>
+
+</para>
+
+@selection_data: 
+@tree_model: 
+@path: 
+@Returns: 
+