[gtk+] Deprecate gtk_widget_send_expose()

[Emmanuele Bassi <ebassi src gnome org>]

commit c3f4fe334dbf9aacf2e1404ac1362c180bd7274b
Author: Emmanuele Bassi <ebassi gnome org>
Date:   Fri Jun 10 13:55:30 2016 +0100

    Deprecate gtk_widget_send_expose()
    
    We have various replacements for what this function does, and we are not
    calling it internally any more.

 gtk/gtkwidget.c |    9 +++++++--
 gtk/gtkwidget.h |    2 +-
 2 files changed, 8 insertions(+), 3 deletions(-)
---
diff --git a/gtk/gtkwidget.c b/gtk/gtkwidget.c
index f9a37c6..e6dfac7 100644
--- a/gtk/gtkwidget.c
+++ b/gtk/gtkwidget.c
@@ -7522,8 +7522,13 @@ gtk_cairo_transform_to_window (cairo_t   *cr,
  * with a call to gdk_window_process_updates().
  *
  * Returns: return from the event signal emission (%TRUE if
- *               the event was handled)
- **/
+ *   the event was handled)
+ *
+ * Deprecated: 3.22: Application and widget code should not handle
+ *   expose events directly; invalidation should use the #GtkWidget
+ *   API, and drawing should only happen inside #GtkWidget::draw
+ *   implementations
+ */
 gint
 gtk_widget_send_expose (GtkWidget *widget,
                        GdkEvent  *event)
diff --git a/gtk/gtkwidget.h b/gtk/gtkwidget.h
index 863d70d..c550dda 100644
--- a/gtk/gtkwidget.h
+++ b/gtk/gtkwidget.h
@@ -741,7 +741,7 @@ gboolean   gtk_widget_mnemonic_activate   (GtkWidget           *widget,
 GDK_AVAILABLE_IN_ALL
 gboolean   gtk_widget_event              (GtkWidget           *widget,
                                           GdkEvent            *event);
-GDK_AVAILABLE_IN_ALL
+GDK_DEPRECATED_IN_3_22
 gint       gtk_widget_send_expose         (GtkWidget           *widget,
                                           GdkEvent            *event);
 GDK_AVAILABLE_IN_ALL