Add docs

svn path=/trunk/; revision=22042

3 files changed, 15 insertions, 0 deletions

diff --git a/ChangeLog b/ChangeLog
index e22ba639fb..5c3124966d 100644
--- 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 b7aa3b3778..20a21c8a3f 100644
--- 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 c451af390e..dddc2a63c0 100644
--- 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"),