tag: improve gobject-introspection annotations

gst-libs/gst/tag/gstvorbistag.c

@@ -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
+ * Returns: (element-type utf8) (transfer full): A #GList of newly-allocated
- *          g_list_foreach (list, (GFunc) g_free, NULL) plus g_list_free (list)
+ *     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)

gst-libs/gst/tag/gstxmptag.c

@@ -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
  */

gst-libs/gst/tag/lang.c

@@ -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
+ * Returns: (transfer full): NULL-terminated string array with two-letter
- *     with g_strfreev() when no longer needed.
+ *     language codes. Free with g_strfreev() when no longer needed.
  *
  * Since: 0.10.26
  */

gst-libs/gst/tag/licenses.c

@@ -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()
+ * Returns: (transfer full): NULL-terminated array of license strings. Free
- *     when no longer needed.
+ *     with g_strfreev() when no longer needed.
  *
  * Since: 0.10.36
  */