[gtk+/gtk-2-24] Document ::expose-event as deprecated

[Matthias Clasen <matthiasc src gnome org>]

commit a06089a248c39d2c6f3fc8791991363d1937e5ca
Author: Matthias Clasen <mclasen redhat com>
Date:   Tue Apr 5 14:58:20 2011 -0400

    Document ::expose-event as deprecated
    
    This doesn't really help that much, but better than nothing.

 gtk/gtkwidget.c |   10 +++++++---
 1 files changed, 7 insertions(+), 3 deletions(-)
---
diff --git a/gtk/gtkwidget.c b/gtk/gtkwidget.c
index 730fb17..903b097 100644
--- a/gtk/gtkwidget.c
+++ b/gtk/gtkwidget.c
@@ -1340,13 +1340,17 @@ gtk_widget_class_init (GtkWidgetClass *klass)
    *
    * The ::expose-event signal is emitted when an area of a previously
    * obscured #GdkWindow is made visible and needs to be redrawn.
-   * #GTK_NO_WINDOW widgets will get a synthesized event from their parent 
+   * #GTK_NO_WINDOW widgets will get a synthesized event from their parent
    * widget.
    *
    * To receive this signal, the #GdkWindow associated to the widget needs
    * to enable the #GDK_EXPOSURE_MASK mask.
-   * 
-   * Returns: %TRUE to stop other handlers from being invoked for the event. 
+   *
+   * Note that the ::expose-event signal has been replaced by a ::draw
+   * signal in GTK+ 3. The the <link linkend="http://library.gnome.org/devel/gtk3/3.0/gtk-migrating-2-to-3.html";>GTK+ 3 migration guide</link>
+   * for hints on how to port from ::expose-event to ::draw.
+   *
+   * Returns: %TRUE to stop other handlers from being invoked for the event.
    *   %FALSE to propagate the event further.
    */
   widget_signals[EXPOSE_EVENT] =