From b70aefdb855fea214adf337d6aa2b2cce54da148 Mon Sep 17 00:00:00 2001
From: Evan Nemerson <evan@coeus-group.com>
Date: Tue, 19 Jun 2012 17:33:45 -0700
Subject: [PATCH] introspection: add missing return value annotations

---
 gst/gstatomicqueue.c    | 6 ++++--
 gst/gstbuffer.c         | 5 +++--
 gst/gstelementfactory.c | 5 +++--
 gst/gsttaskpool.c       | 6 +++---
 4 files changed, 13 insertions(+), 9 deletions(-)

diff --git a/gst/gstatomicqueue.c b/gst/gstatomicqueue.c
index 8e11a3d..c0d83e8 100644
--- a/gst/gstatomicqueue.c
+++ b/gst/gstatomicqueue.c
@@ -222,7 +222,8 @@ gst_atomic_queue_unref (GstAtomicQueue * queue)
  *
  * Peek the head element of the queue without removing it from the queue.
  *
- * Returns: the head element of @queue or NULL when the queue is empty.
+ * Returns: (transfer none): the head element of @queue or NULL when
+ * the queue is empty.
  *
  * Since: 0.10.33
  */
@@ -273,7 +274,8 @@ gst_atomic_queue_peek (GstAtomicQueue * queue)
  *
  * Get the head element of the queue.
  *
- * Returns: the head element of @queue or NULL when the queue is empty.
+ * Returns: (transfer full): the head element of @queue or NULL when
+ * the queue is empty.
  *
  * Since: 0.10.33
  */
diff --git a/gst/gstbuffer.c b/gst/gstbuffer.c
index eb42c51..c4c2f35 100644
--- a/gst/gstbuffer.c
+++ b/gst/gstbuffer.c
@@ -1664,7 +1664,7 @@ gst_buffer_append (GstBuffer * buf1, GstBuffer * buf2)
  * Get the metadata for @api on buffer. When there is no such
  * metadata, NULL is returned.
  *
- * Returns: the metadata for @api on @buffer.
+ * Returns: (transfer none): the metadata for @api on @buffer.
  */
 GstMeta *
 gst_buffer_get_meta (GstBuffer * buffer, GType api)
@@ -1793,7 +1793,8 @@ gst_buffer_remove_meta (GstBuffer * buffer, GstMeta * meta)
  *
  * @state will be updated with an opage state pointer 
  *
- * Returns: The next #GstMeta or %NULL when there are no more items.
+ * Returns: (transfer none): The next #GstMeta or %NULL when there are
+ * no more items.
  */
 GstMeta *
 gst_buffer_iterate_meta (GstBuffer * buffer, gpointer * state)
diff --git a/gst/gstelementfactory.c b/gst/gstelementfactory.c
index 3a7bd40..cce6c8d 100644
--- a/gst/gstelementfactory.c
+++ b/gst/gstelementfactory.c
@@ -515,8 +515,9 @@ gst_element_factory_get_metadata (GstElementFactory * factory,
  *
  * Get the available keys for the metadata on @factory.
  *
- * Returns: a %NULL-terminated array of key strings, or %NULL when
- * there is no metadata. Free with g_strfreev() when no longer needd.
+ * Returns: (transfer full) (element-type utf8) (array zero-terminated=1):
+ * a %NULL-terminated array of key strings, or %NULL when there is no
+ * metadata. Free with g_strfreev() when no longer needed.
  */
 gchar **
 gst_element_factory_get_metadata_keys (GstElementFactory * factory)
diff --git a/gst/gsttaskpool.c b/gst/gsttaskpool.c
index d5981e6..6b2f5ad 100644
--- a/gst/gsttaskpool.c
+++ b/gst/gsttaskpool.c
@@ -229,9 +229,9 @@ gst_task_pool_cleanup (GstTaskPool * pool)
  *
  * Start the execution of a new thread from @pool.
  *
- * Returns: a pointer that should be used for the gst_task_pool_join
- * function. This pointer can be NULL, you must check @error to detect
- * errors.
+ * Returns: (transfer none): a pointer that should be used for the
+ * gst_task_pool_join function. This pointer can be NULL, you must
+ * check @error to detect errors.
  *
  * Since: 0.10.24
  */
-- 
2.7.4