Small documentation tweak

[~andy/gtk] / gtk / gtkstyleprovider.c

diff --git a/gtk/gtkstyleprovider.c b/gtk/gtkstyleprovider.c
index b1c7d49a590f4975c38233da65ab6bd472025508..c1eb72ec144a99da42b027262e465f257c209a05 100644 (file)
--- a/gtk/gtkstyleprovider.c
+++ b/gtk/gtkstyleprovider.c
@@ -17,9 +17,11 @@
 
 #include "config.h"
 
-#include "gtkprivate.h"
 #include "gtkstyleprovider.h"
+
 #include "gtkintl.h"
+#include "gtkprivate.h"
+#include "gtkwidgetpath.h"
 
 /**
  * SECTION:gtkstyleprovider
@@ -64,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,
@@ -93,6 +98,8 @@ gtk_style_provider_get_style (GtkStyleProvider *provider,
  * the widget represented by @path.
  *
  * Returns: %TRUE if the property was found and has a value, %FALSE otherwise
+ *
+ * Since: 3.0
  **/
 gboolean
 gtk_style_provider_get_style_property (GtkStyleProvider *provider,
@@ -128,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,