[unique] Fix introspection annotations



commit 995f91b3c05eef835393205edad11c3d5df56e64
Author: Emmanuele Bassi <ebassi linux intel com>
Date:   Wed Feb 16 19:19:54 2011 +0000

    Fix introspection annotations

 unique/uniqueapp.c     |    2 ++
 unique/uniquebackend.c |    4 ++--
 unique/uniquemessage.c |   16 +++++++++-------
 3 files changed, 13 insertions(+), 9 deletions(-)
---
diff --git a/unique/uniqueapp.c b/unique/uniqueapp.c
index b40a86c..2c89334 100644
--- a/unique/uniqueapp.c
+++ b/unique/uniqueapp.c
@@ -457,6 +457,8 @@ unique_app_class_init (UniqueAppClass *klass)
    * %UNIQUE_RESPONSE_PASSTHROUGH return value is used, the signal
    * emission chain will continue until another handler will return another
    * response code.
+   *
+   * Return value: a #UniqueRespose
    */
   unique_app_signals[MESSAGE_RECEIVED] =
     g_signal_new (I_("message-received"),
diff --git a/unique/uniquebackend.c b/unique/uniquebackend.c
index a76e42e..10714e6 100644
--- a/unique/uniquebackend.c
+++ b/unique/uniquebackend.c
@@ -188,7 +188,7 @@ unique_backend_set_screen (UniqueBackend *backend,
  *
  * FIXME
  *
- * Return value: FIXME
+ * Return value: (transfer none): FIXME
  */
 GdkScreen *
 unique_backend_get_screen (UniqueBackend *backend)
@@ -310,7 +310,7 @@ unique_backend_send_message (UniqueBackend     *backend,
  * <literal>UNIQUE_BACKEND</literal> environment variable with the
  * name of the desired backend.
  *
- * Return value: the newly created #UniqueBackend instance
+ * Return value: (transfer full): the newly created #UniqueBackend instance
  */
 UniqueBackend *
 unique_backend_create (void)
diff --git a/unique/uniquemessage.c b/unique/uniquemessage.c
index c74392d..262d9fb 100644
--- a/unique/uniquemessage.c
+++ b/unique/uniquemessage.c
@@ -90,7 +90,7 @@ unique_message_data_new (void)
  *
  * Copies @message_data.
  *
- * Return value: a copy of the passed #UniqueMessageData
+ * Return value: (transfer full): a copy of the passed #UniqueMessageData
  */
 UniqueMessageData *
 unique_message_data_copy (UniqueMessageData *message_data)
@@ -174,7 +174,7 @@ unique_message_data_set (UniqueMessageData *message_data,
 /**
  * unique_message_data_get:
  * @message_data: a #UniqueMessageData
- * @length: return location for the length of the contents
+ * @length: (out): return location for the length of the contents
  *
  * Retrieves the raw contents of @message_data set using
  * unique_messaget_data_set().
@@ -375,7 +375,7 @@ unique_message_data_set_text (UniqueMessageData *message_data,
  *
  * Retrieves the text set using unique_message_data_set_text().
  *
- * Return value: an allocated string.
+ * Return value: (transfer full): a newly-allocated string.
  */
 gchar *
 unique_message_data_get_text (UniqueMessageData *message_data)
@@ -434,7 +434,8 @@ unique_message_data_set_uris (UniqueMessageData  *message_data,
  * Retrieves a %NULL-terminated string vector containing the URIs set with
  * unique_message_data_set_uris().
  *
- * Return value: (array zero-terminated=1) (element-type utf8) (transfer full): an allocated list of URIs. Use g_strfreev() to free it.
+ * Return value: (array zero-terminated=1) (element-type utf8) (transfer full): a newly-allocated,
+ *   %NULL-terminated list of URIs. Use g_strfreev() to free it.
  */
 gchar **
 unique_message_data_get_uris (UniqueMessageData *message_data)
@@ -483,8 +484,9 @@ unique_message_data_set_filename (UniqueMessageData *message_data,
  *
  * Retrieves the filename set with unique_message_data_set_filename().
  *
- * Return value: a newly allocated string containing the filename.
- *   Use g_free() to free the resources used by the returned value.
+ * Return value: (transfer full): a newly allocated string containing the
+ *   filename. Use g_free() to free the resources used by the returned
+ *   value.
  *
  * Since: 1.0.2
  */
@@ -504,7 +506,7 @@ unique_message_data_get_filename (UniqueMessageData *message_data)
  * can use gtk_window_set_screen() to move windows or dialogs to the
  * right screen. This field is always set by the Unique library.
  *
- * Return value: a #GdkScreen
+ * Return value: (transfer none): a #GdkScreen
  */
 GdkScreen *
 unique_message_data_get_screen (UniqueMessageData *message_data)



[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]