Add docs

svn path=/trunk/; revision=22042

diff --git a/ChangeLog b/ChangeLog
index e22ba639fbaad032dccebf1651aa65df4c99186b..5c3124966d721acbe82bad397e43b3889bc3b0a5 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,9 @@
+2009-01-02  Matthias Clasen  <mclasen@redhat.com>
+
+       * gtk/gtkwidget.c:
+       * gtk/gtkentry.c: Add docs about using ::drag-begin for setting
+       a custom drag icon.
+
 2009-01-01  Matthias Clasen  <mclasen@redhat.com>
 
        * configure.in: Bump version

diff --git a/gtk/gtkentry.c b/gtk/gtkentry.c
index b7aa3b3778fbb047fc3052807dcda63797866ae4..20a21c8a3f3ff8e5e6d58e04fc02e77e0e07b15f 100644 (file)
--- a/gtk/gtkentry.c
+++ b/gtk/gtkentry.c
@@ -7613,6 +7613,11 @@ gtk_entry_get_icon_at_pos (GtkEntry *entry,
  * signal, and use gtk_entry_get_current_icon_drag_source() in
  * your signal handler to find out if the drag was started from
  * an icon.
+ *
+ * By default, GTK+ uses the icon as the drag icon. You can use the 
+ * #GtkWidget::drag-begin signal to set a different icon. Note that you 
+ * have to use g_signal_connect_after() to ensure that your signal handler
+ * gets executed after the default handler.
  */
 void
 gtk_entry_set_icon_drag_source (GtkEntry             *entry,

diff --git a/gtk/gtkwidget.c b/gtk/gtkwidget.c
index c451af390eafa5d6c0e4afcdbd318f1170dc00be..dddc2a63c0fd204a8ebfd71e3651f875b25e43fa 100644 (file)
--- a/gtk/gtkwidget.c
+++ b/gtk/gtkwidget.c
@@ -1595,6 +1595,10 @@ gtk_widget_class_init (GtkWidgetClass *klass)
    * The ::drag-begin signal is emitted on the drag source when a drag is 
    * started. A typical reason to connect to this signal is to set up a 
    * custom drag icon with gtk_drag_source_set_icon().
+   *
+   * Note that some widgets set up a drag icon in the default handler of
+   * this signal, so you may have to use g_signal_connect_after() to
+   * override what the default handler did.
    */
   widget_signals[DRAG_BEGIN] =
     g_signal_new (I_("drag-begin"),