[gtk+/gtk-2-24] Document that gtk_container_propagate_expose is going away

[Matthias Clasen <matthiasc src gnome org>]

commit c3a4f0f777ad818e508212b420ba0d525d9fad1e
Author: Matthias Clasen <mclasen redhat com>
Date:   Fri Apr 8 20:31:21 2011 -0400

    Document that gtk_container_propagate_expose is going away
    
    Requested in https://bugzilla.gnome.org/show_bug.cgi?id=646913

 gtk/gtkcontainer.c |   13 ++++++++++---
 gtk/gtkwidget.c    |    2 +-
 2 files changed, 11 insertions(+), 4 deletions(-)
---
diff --git a/gtk/gtkcontainer.c b/gtk/gtkcontainer.c
index 96dabf0..9aaa7d9 100644
--- a/gtk/gtkcontainer.c
+++ b/gtk/gtkcontainer.c
@@ -2711,16 +2711,23 @@ gtk_container_unmap (GtkWidget *widget)
  * When a container receives an expose event, it must send synthetic
  * expose events to all children that don't have their own #GdkWindows.
  * This function provides a convenient way of doing this. A container,
- * when it receives an expose event, calls gtk_container_propagate_expose() 
+ * when it receives an expose event, calls gtk_container_propagate_expose()
  * once for each child, passing in the event the container received.
  *
  * gtk_container_propagate_expose() takes care of deciding whether
  * an expose event needs to be sent to the child, intersecting
  * the event's area with the child area, and sending the event.
- * 
+ *
  * In most cases, a container can simply either simply inherit the
- * #GtkWidget::expose implementation from #GtkContainer, or, do some drawing 
+ * #GtkWidget::expose implementation from #GtkContainer, or, do some drawing
  * and then chain to the ::expose implementation from #GtkContainer.
+ *
+ * Note that the ::expose-event signal has been replaced by a ::draw
+ * signal in GTK+ 3, and consequently, gtk_container_propagate_expose()
+ * has been replaced by gtk_container_propagate_draw().
+ * 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.
+ *
  **/
 void
 gtk_container_propagate_expose (GtkContainer   *container,
diff --git a/gtk/gtkwidget.c b/gtk/gtkwidget.c
index 903b097..00ec96f 100644
--- a/gtk/gtkwidget.c
+++ b/gtk/gtkwidget.c
@@ -1347,7 +1347,7 @@ gtk_widget_class_init (GtkWidgetClass *klass)
    * to enable the #GDK_EXPOSURE_MASK mask.
    *
    * 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>
+   * signal in GTK+ 3. 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.