[gtk+] styleprovider: Deprecate two non-working functions

[Benjamin Otte <otte src gnome org>]

commit 45b4fb02b16a9d3c38956bfd238d9d7307f88071
Author: Benjamin Otte <otte redhat com>
Date:   Sat Nov 24 20:57:12 2012 +0100

    styleprovider: Deprecate two non-working functions
    
    Both of them weren't used inside GTK. And apparently they weren't used
    outside of GTK either, as alex recently mentioned them being severly
    broken.

 gtk/gtkstyleprovider.c |    5 +++++
 gtk/gtkstyleprovider.h |    2 ++
 2 files changed, 7 insertions(+), 0 deletions(-)
---
diff --git a/gtk/gtkstyleprovider.c b/gtk/gtkstyleprovider.c
index 2357556..c1eb72e 100644
--- a/gtk/gtkstyleprovider.c
+++ b/gtk/gtkstyleprovider.c
@@ -66,6 +66,9 @@ gtk_style_provider_iface_init (gpointer g_iface)
  * style settings affecting @path
  *
  * Since: 3.0
+ *
+ * Deprecated: 3.8: Will always return %NULL for all GTK-provided style providers
+ *     as the interface cannot correctly work the way CSS is specified.
  **/
 GtkStyleProperties *
 gtk_style_provider_get_style (GtkStyleProvider *provider,
@@ -132,6 +135,8 @@ gtk_style_provider_get_style_property (GtkStyleProvider *provider,
  * Returns: (transfer none): The icon factory to use for @path, or %NULL
  *
  * Since: 3.0
+ *
+ * Deprecated: 3.8: Will always return %NULL for all GTK-provided style providers.
  **/
 GtkIconFactory *
 gtk_style_provider_get_icon_factory (GtkStyleProvider *provider,
diff --git a/gtk/gtkstyleprovider.h b/gtk/gtkstyleprovider.h
index 62b3aeb..56fa141 100644
--- a/gtk/gtkstyleprovider.h
+++ b/gtk/gtkstyleprovider.h
@@ -109,6 +109,7 @@ struct _GtkStyleProviderIface
 
 GType gtk_style_provider_get_type (void) G_GNUC_CONST;
 
+GDK_DEPRECATED_IN_3_8
 GtkStyleProperties *gtk_style_provider_get_style (GtkStyleProvider *provider,
                                                   GtkWidgetPath    *path);
 
@@ -118,6 +119,7 @@ gboolean gtk_style_provider_get_style_property (GtkStyleProvider *provider,
                                                 GParamSpec       *pspec,
                                                 GValue           *value);
 
+GDK_DEPRECATED_IN_3_8_FOR(NULL)
 GtkIconFactory * gtk_style_provider_get_icon_factory (GtkStyleProvider *provider,
 						      GtkWidgetPath    *path);