gst-plugins-base: tag: improve gobject-introspection annotations

[Tim Müller]

Module: gst-plugins-base
Branch: master
Commit: 9c09fbda52bc56e3affe26e835ec257261acb05c
URL:    http://cgit.freedesktop.org/gstreamer/gst-plugins-base/commit/?id=9c09fbda52bc56e3affe26e835ec257261acb05c

Author: Tim-Philipp Müller <tim.muller at collabora.co.uk>
Date:   Sun Apr 29 17:16:38 2012 +0100

tag: improve gobject-introspection annotations

---

 gst-libs/gst/tag/gstvorbistag.c |    5 +++--
 gst-libs/gst/tag/gstxmptag.c    |    3 ++-
 gst-libs/gst/tag/lang.c         |    4 ++--
 gst-libs/gst/tag/licenses.c     |    4 ++--
 4 files changed, 9 insertions(+), 7 deletions(-)

diff --git a/gst-libs/gst/tag/gstvorbistag.c b/gst-libs/gst/tag/gstvorbistag.c
index caf0c0e..d37ac83 100644
--- a/gst-libs/gst/tag/gstvorbistag.c
+++ b/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
- *          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)
diff --git a/gst-libs/gst/tag/gstxmptag.c b/gst-libs/gst/tag/gstxmptag.c
index 3d257aa..8bbaf3b 100644
--- a/gst-libs/gst/tag/gstxmptag.c
+++ b/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
  */
diff --git a/gst-libs/gst/tag/lang.c b/gst-libs/gst/tag/lang.c
index c37366e..f1ff081 100644
--- a/gst-libs/gst/tag/lang.c
+++ b/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
- *     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
  */
diff --git a/gst-libs/gst/tag/licenses.c b/gst-libs/gst/tag/licenses.c
index 1891344..90b7717 100644
--- a/gst-libs/gst/tag/licenses.c
+++ b/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()
- *     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
  */