[gtk+] im: Deprecate gtk_im_multicontext_append_menuitems

[Matthias Clasen <matthiasc src gnome org>]

commit 781b85088f305b10a367eadd930f668e2f0682f5
Author: Christian Persch <chpe gnome org>
Date:   Sat Jun 8 13:53:21 2013 +0200

    im: Deprecate gtk_im_multicontext_append_menuitems
    
    Bug #701840.

 gtk/gtkimmulticontext.c |    5 +++++
 gtk/gtkimmulticontext.h |    2 +-
 2 files changed, 6 insertions(+), 1 deletions(-)
---
diff --git a/gtk/gtkimmulticontext.c b/gtk/gtkimmulticontext.c
index 712d5ca..4fc9cf1 100644
--- a/gtk/gtkimmulticontext.c
+++ b/gtk/gtkimmulticontext.c
@@ -592,6 +592,11 @@ pathnamecmp (const char *a,
  * Add menuitems for various available input methods to a menu;
  * the menuitems, when selected, will switch the input method
  * for the context and the global default input method.
+ *
+ * Deprecated: 3.10: It is better to use the system-wide input
+ *     method framework for changing input methods. Modern
+ *     desktop shells offer on-screen displays for this that
+ *     can triggered with a keyboard shortcut, e.g. Super-Space.
  **/
 void
 gtk_im_multicontext_append_menuitems (GtkIMMulticontext *context,
diff --git a/gtk/gtkimmulticontext.h b/gtk/gtkimmulticontext.h
index 6ab022e..77bc70c 100644
--- a/gtk/gtkimmulticontext.h
+++ b/gtk/gtkimmulticontext.h
@@ -63,7 +63,7 @@ GType         gtk_im_multicontext_get_type (void) G_GNUC_CONST;
 GDK_AVAILABLE_IN_ALL
 GtkIMContext *gtk_im_multicontext_new      (void);
 
-GDK_AVAILABLE_IN_ALL
+GDK_DEPRECATED_IN_3_10
 void          gtk_im_multicontext_append_menuitems (GtkIMMulticontext *context,
                                                    GtkMenuShell      *menushell);
 GDK_AVAILABLE_IN_ALL