[gtk+] Deprecate GTK_WIDGET_*SET_FLAGS() macro

[Javier Jardón <jjardon src gnome org>]

commit d3d4cf0e841df6573a41ef4ebb609ff7b81dbb0f
Author: Javier Jardón <jjardon gnome org>
Date:   Thu Mar 25 19:46:01 2010 +0100

    Deprecate GTK_WIDGET_*SET_FLAGS() macro
    
    The macro GTK_WIDGET_SET_FLAGS(w, GTK_VISIBLE) should
    still be fixed internally.
    
    Fixes https://bugzilla.gnome.org/show_bug.cgi?id=69872

 gtk/gtkwidget.h |   12 ++++++++++++
 1 files changed, 12 insertions(+), 0 deletions(-)
---
diff --git a/gtk/gtkwidget.h b/gtk/gtkwidget.h
index f609873..0b2d84b 100644
--- a/gtk/gtkwidget.h
+++ b/gtk/gtkwidget.h
@@ -445,8 +445,17 @@ typedef enum
  * @flag: the flags to set.
  *
  * Turns on certain widget flags.
+ *
+ * Deprecated: 2.22: Use the proper function instead: gtk_widget_set_app_paintable(),
+ *   gtk_widget_set_can_default(), gtk_widget_set_can_focus(),
+ *   gtk_widget_set_double_buffered(), gtk_widget_set_has_window(),
+ *   gtk_widget_set_mapped(), gtk_widget_set_no_show_all(),
+ *   gtk_widget_set_realized(), gtk_widget_set_receives_default(),
+ *   gtk_widget_set_sensitive() or gtk_widget_set_visible().
+ *
  */
 #define GTK_WIDGET_SET_FLAGS(wid,flag)	  G_STMT_START{ (GTK_WIDGET_FLAGS (wid) |= (flag)); }G_STMT_END
+/* FIXME: Deprecating GTK_WIDGET_SET_FLAGS requires fixing GTK internals. */
 
 /**
  * GTK_WIDGET_UNSET_FLAGS:
@@ -454,8 +463,11 @@ typedef enum
  * @flag: the flags to unset.
  *
  * Turns off certain widget flags.
+ *
+ * Deprecated: 2.22: Use the proper function instead. See GTK_WIDGET_SET_FLAGS().
  */
 #define GTK_WIDGET_UNSET_FLAGS(wid,flag)  G_STMT_START{ (GTK_WIDGET_FLAGS (wid) &= ~(flag)); }G_STMT_END
+/* FIXME: Deprecating GTK_WIDGET_UNSET_FLAGS requires fixing GTK internals. */
 
 #define GTK_TYPE_REQUISITION              (gtk_requisition_get_type ())