[gtk+/gtk-style-context: 406/540] GtkThemingEngine: Documents that engines must only use this API.

[Carlos Garnacho <carlosg src gnome org>]

commit 24a46552f0fca6ddc56662a58b0f034e5ba96a96
Author: Carlos Garnacho <carlosg gnome org>
Date:   Fri Oct 29 14:17:03 2010 -0400

    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 files changed, 4 insertions(+), 0 deletions(-)
---
diff --git a/gtk/gtkthemingengine.c b/gtk/gtkthemingengine.c
index 886fc8f..59cfcd3 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;