[gtk+/gtk-2-22] Add deprecation notes for GtkItem

[Matthias Clasen <matthiasc src gnome org>]

commit 15df889204ffd9776b6f25bd096d82793ddb7771
Author: Matthias Clasen <mclasen redhat com>
Date:   Thu Sep 9 00:02:18 2010 -0400

    Add deprecation notes for GtkItem

 docs/reference/gtk/tmpl/gtkitem.sgml |    8 ++++++--
 gtk/gtkitem.h                        |    2 ++
 2 files changed, 8 insertions(+), 2 deletions(-)
---
diff --git a/docs/reference/gtk/tmpl/gtkitem.sgml b/docs/reference/gtk/tmpl/gtkitem.sgml
index 626cf5a..7049e74 100644
--- a/docs/reference/gtk/tmpl/gtkitem.sgml
+++ b/docs/reference/gtk/tmpl/gtkitem.sgml
@@ -9,6 +9,9 @@ Abstract base class for GtkMenuItem, GtkListItem and GtkTreeItem
 The #GtkItem widget is an abstract base class for #GtkMenuItem, #GtkListItem
 and #GtkTreeItem.
 </para>
+<para>
+#GtkItem is deprecated and will be removed in GTK+ 3.
+</para>
 
 <!-- ##### SECTION See_Also ##### -->
 <para>
@@ -55,6 +58,7 @@ Emits the "select" signal on the given item.
 </para>
 
 @item: a #GtkItem.
+ Deprecated: 2.22: Use gtk_menu_item_select() instead
 
 
 <!-- ##### FUNCTION gtk_item_deselect ##### -->
@@ -63,6 +67,7 @@ Emits the "deselect" signal on the given item.
 </para>
 
 @item: a #GtkItem.
+ Deprecated: 2.22: Use gtk_menu_item_deselect() instead
 
 
 <!-- ##### FUNCTION gtk_item_toggle ##### -->
@@ -71,5 +76,4 @@ Emits the "toggle" signal on the given item.
 </para>
 
 @item: a #GtkItem.
-
-
+ Deprecated: 2.22: This function will be removed in GTK+ 3
diff --git a/gtk/gtkitem.h b/gtk/gtkitem.h
index 4c3d3ae..cbc9e80 100644
--- a/gtk/gtkitem.h
+++ b/gtk/gtkitem.h
@@ -70,9 +70,11 @@ struct _GtkItemClass
 
 
 GType gtk_item_get_type (void) G_GNUC_CONST;
+#if !defined(GTK_DISABLE_DEPRECATED) && !defined(GTK_COMPILATION)
 void  gtk_item_select   (GtkItem *item);
 void  gtk_item_deselect (GtkItem *item);
 void  gtk_item_toggle   (GtkItem *item);
+#endif
 
 G_END_DECLS