From a06089a248c39d2c6f3fc8791991363d1937e5ca Mon Sep 17 00:00:00 2001 From: Matthias Clasen Date: Tue, 5 Apr 2011 14:58:20 -0400 Subject: [PATCH] Document ::expose-event as deprecated This doesn't really help that much, but better than nothing. --- gtk/gtkwidget.c | 10 +++++++--- 1 file changed, 7 insertions(+), 3 deletions(-) diff --git a/gtk/gtkwidget.c b/gtk/gtkwidget.c index 730fb17d1f..903b097987 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 GTK+ 3 migration guide + * 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] =