[gtkmm] Deprecate Gtk::StatusIcon which is deprecated in gtk+

[Kjell Ahlstedt <kjellahl src gnome org>]

commit 243bdf759ae140b2f716775dd276bd1973249d1c
Author: Kjell Ahlstedt <kjell ahlstedt bredband net>
Date:   Thu Aug 28 09:25:08 2014 +0200

    Deprecate Gtk::StatusIcon which is deprecated in gtk+
    
    * gtk/src/filelist.am: Move statusicon.hg to gtkmm_files_deprecated_hg.
    * gtk/src/statusicon.hg: Add _IS_DEPRECATED.

 gtk/src/filelist.am   |    2 +-
 gtk/src/statusicon.hg |    8 ++++++++
 2 files changed, 9 insertions(+), 1 deletions(-)
---
diff --git a/gtk/src/filelist.am b/gtk/src/filelist.am
index ad15dc0..00fe08e 100644
--- a/gtk/src/filelist.am
+++ b/gtk/src/filelist.am
@@ -167,7 +167,6 @@ gtkmm_files_any_hg =                \
        stack.hg                \
        stackswitcher.hg        \
        statusbar.hg            \
-       statusicon.hg           \
        stylecontext.hg         \
        styleprovider.hg        \
        switch.hg               \
@@ -236,6 +235,7 @@ gtkmm_files_deprecated_hg = \
        iconsource.hg           \
        imagemenuitem.hg        \
        numerableicon.hg        \
+       statusicon.hg           \
        stockitem.hg            \
        table.hg                \
        tearoffmenuitem.hg
diff --git a/gtk/src/statusicon.hg b/gtk/src/statusicon.hg
index 9ecf84a..cf4fa51 100644
--- a/gtk/src/statusicon.hg
+++ b/gtk/src/statusicon.hg
@@ -32,6 +32,8 @@ _PINCLUDE(glibmm/private/object_p.h)
 #include <gdkmm/types.h>
 #include <gtkmm/tooltip.h>
 
+_IS_DEPRECATED // This whole file is deprecated.
+
 namespace Gtk
 {
 
@@ -50,7 +52,13 @@ namespace Gtk
  * Implementations of the "tray" side of this specification can be found e.g. in the GNOME and KDE
  * panel applications.
  *
+ * Note that a StatusIcon is not a widget, but just a Glib::Object.
+ * Making it a widget would be impractical, since the system tray
+ * on Win32 doesn’t allow to embed arbitrary widgets.
+ *
  * @newin{2,10}
+ *
+ * @deprecated You should consider using notifications or more modern platform-specific APIs instead.
  */
 class StatusIcon : public Glib::Object
 {