tag: improve gobject-introspection annotations
authorTim-Philipp Müller <tim.muller@collabora.co.uk>
Sun, 29 Apr 2012 16:16:38 +0000 (17:16 +0100)
committerTim-Philipp Müller <tim.muller@collabora.co.uk>
Sun, 29 Apr 2012 16:16:38 +0000 (17:16 +0100)
gst-libs/gst/tag/gstvorbistag.c
gst-libs/gst/tag/gstxmptag.c
gst-libs/gst/tag/lang.c
gst-libs/gst/tag/licenses.c

index caf0c0ea17ec28aac3d44313f3a7f16e6164a992..d37ac83a549889379769ca71d5f6ac900d3f98dd 100644 (file)
@@ -646,8 +646,9 @@ gst_tag_to_metadata_block_picture (const gchar * tag,
  * Creates a new tag list that contains the information parsed out of a
  * vorbiscomment packet.
  *
- * Returns: A #GList of newly-allocated key=value strings. Free with
- *          g_list_foreach (list, (GFunc) g_free, NULL) plus g_list_free (list)
+ * Returns: (element-type utf8) (transfer full): A #GList of newly-allocated
+ *     key=value strings. Free with g_list_foreach (list, (GFunc) g_free, NULL)
+ *     plus g_list_free (list)
  */
 GList *
 gst_tag_to_vorbis_comments (const GstTagList * list, const gchar * tag)
index 3d257aa1d0eaa60d02799db593e0d304fbcd1547..8bbaf3b5ac6c19e71ca5b9dac0d44de33ea57618 100644 (file)
@@ -60,7 +60,8 @@ static const gchar *schema_list[] = {
  *
  * Gets the list of supported schemas in the xmp lib
  *
- * Returns: a %NULL terminated array of strings with the schema names
+ * Returns: (transfer none): a %NULL terminated array of strings with the
+ *     schema names
  *
  * Since: 0.10.33
  */
index c37366e0890d1886c4199a4daa70b9e41ee4c05b..f1ff081a86d8240b674e556f6999e1d24a963969 100644 (file)
@@ -266,8 +266,8 @@ qsort_strcmp_func (const void *p1, const void *p2)
  * tagging purposes (e.g. to tag an audio track appropriately in a video or
  * audio editor).
  *
- * Returns: NULL-terminated string array with two-letter language codes. Free
- *     with g_strfreev() when no longer needed.
+ * Returns: (transfer full): NULL-terminated string array with two-letter
+ *     language codes. Free with g_strfreev() when no longer needed.
  *
  * Since: 0.10.26
  */
index 189134447df7ad8fda22476ffc482a8b691028d1..90b7717b103884185e9bb584404c408b63fad8ce 100644 (file)
@@ -201,8 +201,8 @@ static const gchar jurisdictions[] =
  * (e.g. to tag an audio track appropriately in a video or audio editor, or
  * an image in a camera application).
  *
- * Returns: NULL-terminated array of license strings. Free with g_strfreev()
- *     when no longer needed.
+ * Returns: (transfer full): NULL-terminated array of license strings. Free
+ *     with g_strfreev() when no longer needed.
  *
  * Since: 0.10.36
  */