gnome-shell r12 - trunk/src

[otaylor svn gnome org]

Author: otaylor
Date: Fri Oct 31 18:24:29 2008
New Revision: 12
URL: http://svn.gnome.org/viewvc/gnome-shell?rev=12&view=rev

Log:
Add annotations to fix return-value transfer for shell_global_get()

Default transfership for a GObject return value is 'full', override
it to 'none' for a singleton getter.


Modified:
   trunk/src/shell-global.c

Modified: trunk/src/shell-global.c
==============================================================================
--- trunk/src/shell-global.c	(original)
+++ trunk/src/shell-global.c	Fri Oct 31 18:24:29 2008
@@ -119,6 +119,13 @@
                                                         G_PARAM_READABLE));
 }
 
+/**
+ * shell_global_get:
+ *
+ * Gets the singleton global object that represents the desktop.
+ *
+ * Return value: (transfer none): the singleton global object
+ */
 ShellGlobal *
 shell_global_get (void)
 {
@@ -130,6 +137,16 @@
   return the_object;
 }
 
+/**
+ * shell_global_set_stage_input_area:
+ * x: X coordinate of rectangle
+ * y: X coordinate of rectangle
+ * width: width of rectangle
+ * height: Height of rectangle
+ *
+ * Sets the area of the stage that is responsive to mouse clicks as
+ * a rectangle.
+ */
 void
 shell_global_set_stage_input_area (ShellGlobal *global,
                                    int          x,