[gtk+/icon-shadow: 11/11] docs: add docs for gtk_render_icon()

[Cosimo Cecchi <cosimoc src gnome org>]

commit 8e6e6a616a707775e2c06e476decda7f51257474
Author: Cosimo Cecchi <cosimoc gnome org>
Date:   Tue May 24 21:50:08 2011 -0400

    docs: add docs for gtk_render_icon()

 docs/reference/gtk/gtk3-sections.txt |    1 +
 gtk/gtk.symbols                      |    1 +
 gtk/gtkstylecontext.c                |   19 +++++++++++++++++++
 3 files changed, 21 insertions(+), 0 deletions(-)
---
diff --git a/docs/reference/gtk/gtk3-sections.txt b/docs/reference/gtk/gtk3-sections.txt
index 291b219..f63e680 100644
--- a/docs/reference/gtk/gtk3-sections.txt
+++ b/docs/reference/gtk/gtk3-sections.txt
@@ -5639,6 +5639,7 @@ gtk_render_option
 gtk_render_slider
 gtk_render_activity
 gtk_render_icon_pixbuf
+gtk_render_icon
 
 <SUBSECTION Standard>
 GTK_TYPE_STYLE_CONTEXT
diff --git a/gtk/gtk.symbols b/gtk/gtk.symbols
index 51e07da..357840b 100644
--- a/gtk/gtk.symbols
+++ b/gtk/gtk.symbols
@@ -2230,6 +2230,7 @@ gtk_render_focus
 gtk_render_frame
 gtk_render_frame_gap
 gtk_render_handle
+gtk_render_icon
 gtk_render_icon_pixbuf
 gtk_render_layout
 gtk_render_line
diff --git a/gtk/gtkstylecontext.c b/gtk/gtkstylecontext.c
index 287ba1a..996d4e9 100644
--- a/gtk/gtkstylecontext.c
+++ b/gtk/gtkstylecontext.c
@@ -4404,6 +4404,25 @@ gtk_render_icon_pixbuf (GtkStyleContext     *context,
   return engine_class->render_icon_pixbuf (priv->theming_engine, source, size);
 }
 
+/**
+ * gtk_render_icon:
+ * @context: a #GtkStyleContext
+ * @cr: a #cairo_t
+ * @x: X origin of the rectangle 
+ * @y: Y origin of the rectangle
+ * @width: rectangle width
+ * @height: rectangle height
+ * @surface: an image #cairo_surface_t holding the icon to render
+ * @symbolic: whether the icon is symbolic
+ *
+ * Renders the icon in @surface aligned and clipped in the specified area.
+ * If @symbolic is %TRUE, the default #GtkThemingEngine will not apply state
+ * transformation effects (such as prelight or insensitive shades) on the icon.
+ *
+ * Returns: (transfer full): a newly-created #GdkPixbuf containing the rendered icon
+ *
+ * Since: 3.2
+ **/
 void
 gtk_render_icon (GtkStyleContext *context,
                  cairo_t         *cr,