[gnome-shell] Add docs and (transfer none) to st_widget_get_theme_node()

[Owen Taylor <otaylor src gnome org>]

commit 400326e5499fd04ef486cc32d6638ca343dbdd39
Author: Owen W. Taylor <otaylor fishsoup net>
Date:   Wed Oct 7 14:26:14 2009 -0400

    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 files changed, 14 insertions(+), 0 deletions(-)
---
diff --git a/src/st/st-widget.c b/src/st/st-widget.c
index 02c57cc..2570ac6 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)
 {