diff --git a/docs/reference/gtk/tmpl/gtkrc.sgml b/docs/reference/gtk/tmpl/gtkrc.sgml
index e146d3157f..b89710a3f6 100644
--- a/docs/reference/gtk/tmpl/gtkrc.sgml
+++ b/docs/reference/gtk/tmpl/gtkrc.sgml
@@ -10,6 +10,10 @@ GTK+ provides resource file mechanism for configuring
 various aspects of the operation of a GTK+ program
 at runtime.
 </para>
+<para>
+In GTK+ 3.0, resource files have been deprecated and replaced
+by CSS-like style sheets, which are understood by #GtkCssProvider.
+</para>
 
 <refsect2><title>Default files</title>
 <para>
diff --git a/gtk/gtkstyle.c b/gtk/gtkstyle.c
index a363cc75a7..3c8cdc5d9a 100644
--- a/gtk/gtkstyle.c
+++ b/gtk/gtkstyle.c
@@ -59,6 +59,8 @@
  *
  * Usually applications should not need to use or modify the #GtkStyle of their
  * widgets.
+ *
+ * In GTK+ 3.0, GtkStyle has been deprecated and replaced by #GtkStyleContext.
  */