From 1bfb169ce6f878cfbff2a649477cd6e1484be234 Mon Sep 17 00:00:00 2001
From: Carlos Garnacho <carlosg@gnome.org>
Date: Fri, 29 Oct 2010 14:17:03 -0400
Subject: [PATCH] GtkThemingEngine: Documents that engines must only use this
 API.

It was a bit unclear in the documentation, even if it was from the
API POV.
---
 gtk/gtkthemingengine.c | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/gtk/gtkthemingengine.c b/gtk/gtkthemingengine.c
index 886fc8f5ca..59cfcd3dd3 100644
--- a/gtk/gtkthemingengine.c
+++ b/gtk/gtkthemingengine.c
@@ -45,6 +45,10 @@
  * must be created, alongside the CSS file that will reference it, the
  * theming engine would be created as an .so library, and installed in
  * $(gtk-modules-dir)/theming-engines/.
+ *
+ * #GtkThemingEngine<!-- -->s have limited access to the object they are
+ * rendering, the #GtkThemingEngine API has read-only accessors to the
+ * style information contained in the rendered object's #GtkStyleContext.
  */
 
 typedef struct GtkThemingEnginePrivate GtkThemingEnginePrivate;