introspection: add missing return value annotations

This commit is contained in:
Evan Nemerson 2012-06-19 17:33:45 -07:00
parent 8620b30df9
commit b70aefdb85
4 changed files with 13 additions and 9 deletions

View file

@ -222,7 +222,8 @@ gst_atomic_queue_unref (GstAtomicQueue * queue)
* *
* Peek the head element of the queue without removing it from the 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 * Since: 0.10.33
*/ */
@ -273,7 +274,8 @@ gst_atomic_queue_peek (GstAtomicQueue * queue)
* *
* Get the head element of the 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 * Since: 0.10.33
*/ */

View file

@ -1664,7 +1664,7 @@ gst_buffer_append (GstBuffer * buf1, GstBuffer * buf2)
* Get the metadata for @api on buffer. When there is no such * Get the metadata for @api on buffer. When there is no such
* metadata, NULL is returned. * metadata, NULL is returned.
* *
* Returns: the metadata for @api on @buffer. * Returns: (transfer none): the metadata for @api on @buffer.
*/ */
GstMeta * GstMeta *
gst_buffer_get_meta (GstBuffer * buffer, GType api) 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 * @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 * GstMeta *
gst_buffer_iterate_meta (GstBuffer * buffer, gpointer * state) gst_buffer_iterate_meta (GstBuffer * buffer, gpointer * state)

View file

@ -515,8 +515,9 @@ gst_element_factory_get_metadata (GstElementFactory * factory,
* *
* Get the available keys for the metadata on @factory. * Get the available keys for the metadata on @factory.
* *
* Returns: a %NULL-terminated array of key strings, or %NULL when * Returns: (transfer full) (element-type utf8) (array zero-terminated=1):
* there is no metadata. Free with g_strfreev() when no longer needd. * a %NULL-terminated array of key strings, or %NULL when there is no
* metadata. Free with g_strfreev() when no longer needed.
*/ */
gchar ** gchar **
gst_element_factory_get_metadata_keys (GstElementFactory * factory) gst_element_factory_get_metadata_keys (GstElementFactory * factory)

View file

@ -229,9 +229,9 @@ gst_task_pool_cleanup (GstTaskPool * pool)
* *
* Start the execution of a new thread from @pool. * Start the execution of a new thread from @pool.
* *
* Returns: a pointer that should be used for the gst_task_pool_join * Returns: (transfer none): a pointer that should be used for the
* function. This pointer can be NULL, you must check @error to detect * gst_task_pool_join function. This pointer can be NULL, you must
* errors. * check @error to detect errors.
* *
* Since: 0.10.24 * Since: 0.10.24
*/ */