From 400326e5499fd04ef486cc32d6638ca343dbdd39 Mon Sep 17 00:00:00 2001
From: "Owen W. Taylor" <otaylor@fishsoup.net>
Date: Wed, 7 Oct 2009 14:26:14 -0400
Subject: [PATCH] Add docs and (transfer none) to st_widget_get_theme_node()

st_widget_get_theme_node() was missing the (transfer none)
GObject Introspection causing crashes. Add that and document the
function.
---
 src/st/st-widget.c | 14 ++++++++++++++
 1 file changed, 14 insertions(+)

diff --git a/src/st/st-widget.c b/src/st/st-widget.c
index 02c57cc44..2570ac62c 100644
--- a/src/st/st-widget.c
+++ b/src/st/st-widget.c
@@ -699,6 +699,20 @@ get_root_theme_node (ClutterStage *stage)
   return st_theme_context_get_root_node (context);
 }
 
+/**
+ * st_widget_get_theme_node:
+ * @widget: a #StWidget
+ *
+ * Gets the theme node holding style information for the widget.
+ * The theme node is used to access standard and custom CSS
+ * properties of the widget.
+ *
+ * Return value: (transfer none): the theme node for the widget.
+ *   This is owned by the widget. When attributes of the widget
+ *   or the environment that affect the styling change (for example
+ *   the style_class property of the widget), it will be recreated,
+ *   and the ::style-changed signal will be emitted on the widget.
+ */
 StThemeNode *
 st_widget_get_theme_node (StWidget *widget)
 {