[gtk+] Add introspection annotations to gtk_drag_(source|dest)_set

[Matthias Clasen <matthiasc src gnome org>]

commit ac6525b27c3f8a98dfabfec12c98c724dfb7b28a
Author: Matthias Clasen <mclasen redhat com>
Date:   Mon Mar 8 19:21:32 2010 -0500

    Add introspection annotations to gtk_drag_(source|dest)_set
    
    Also move docs inline at the same time. Bug 610905.

 docs/reference/gtk/tmpl/gtkdnd.sgml |   15 ++++++---------
 gtk/gtkdnd.c                        |   31 ++++++++++++++++---------------
 2 files changed, 22 insertions(+), 24 deletions(-)
---
diff --git a/docs/reference/gtk/tmpl/gtkdnd.sgml b/docs/reference/gtk/tmpl/gtkdnd.sgml
index 3f899d3..7d12740 100644
--- a/docs/reference/gtk/tmpl/gtkdnd.sgml
+++ b/docs/reference/gtk/tmpl/gtkdnd.sgml
@@ -348,17 +348,14 @@ a widget.
 
 <!-- ##### FUNCTION gtk_drag_source_set ##### -->
 <para>
-Sets up a widget so that GTK+ will start a drag
-operation when the user clicks and drags on the
-widget. The widget must have a window.
+
 </para>
 
- widget: a #GtkWidget
- start_button_mask: the bitmask of buttons that can start the drag
- targets: the table of targets that the drag will support
- n_targets: the number of items in @targets
- actions: the bitmask of possible actions for a drag from this
- widget.
+ widget:
+ start_button_mask:
+ targets:
+ n_targets:
+ actions:
 
 
 <!-- ##### FUNCTION gtk_drag_source_set_icon ##### -->
diff --git a/gtk/gtkdnd.c b/gtk/gtkdnd.c
index 4e53ffa..c64ec61 100644
--- a/gtk/gtkdnd.c
+++ b/gtk/gtkdnd.c
@@ -1216,9 +1216,10 @@ gtk_drag_dest_set_internal (GtkWidget       *widget,
  * gtk_drag_dest_set:
  * @widget: a #GtkWidget
  * @flags: which types of default drag behavior to use
- * @targets: a pointer to an array of #GtkTargetEntry<!-- -->s indicating
- * the drop types that this @widget will accept. Later you can access the list
- * with gtk_drag_dest_get_target_list() and gtk_drag_dest_find_target().
+ * @targets (allow-none): a pointer to an array of #GtkTargetEntry<!-- -->s
+ *     indicating the drop types that this @widget will accept, or %NULL.
+ *     Later you can access the list with gtk_drag_dest_get_target_list()
+ *     and gtk_drag_dest_find_target().
  * @n_targets: the number of entries in @targets.
  * @actions: a bitmask of possible actions for a drop onto this @widget.
  *
@@ -2578,19 +2579,19 @@ gtk_drag_begin (GtkWidget         *widget,
 				  actions, button, event);
 }
 
-/*************************************************************
+/**
  * gtk_drag_source_set:
- *     Register a drop site, and possibly add default behaviors.
- *   arguments:
- *     widget:
- *     start_button_mask: Mask of allowed buttons to start drag
- *     targets:           Table of targets for this source
- *     n_targets:
- *     actions:           Actions allowed for this source
- *   results:
- *************************************************************/
-
-void 
+ * @widget: a #GtkWidget
+ * @start_button_mask: the bitmask of buttons that can start the drag
+ * @targets (allow-none): the table of targets that the drag will support,
+ *     may be %NULL
+ * @n_targets: the number of items in @targets
+ * @actions: the bitmask of possible actions for a drag from this widget
+ *
+ * Sets up a widget so that GTK+ will start a drag operation when the user
+ * clicks and drags on the widget. The widget must have a window.
+ */
+void
 gtk_drag_source_set (GtkWidget            *widget,
 		     GdkModifierType       start_button_mask,
 		     const GtkTargetEntry *targets,