[gst-cvs] gstreamer: events: fix g-i annotation for gst_event_new_tag() which takes ownership of the tag list

[<tp...@ke...>]

Module: gstreamer
Branch: master
Commit: 2d37f06ce89e3ff4f000e3a17e8cb15bc15c84aa
URL:    http://cgit.freedesktop.org/gstreamer/gstreamer/commit/?id=2d37f06ce89e3ff4f000e3a17e8cb15bc15c84aa

Author: Tim-Philipp Müller <tim...@co...>
Date:   Thu Feb 10 10:19:38 2011 +0000

events: fix g-i annotation for gst_event_new_tag() which takes ownership of the tag list

---

 gst/gstevent.c |    7 ++++++-
 1 files changed, 6 insertions(+), 1 deletions(-)

diff --git a/gst/gstevent.c b/gst/gstevent.c
index 6d2cc8b..c407fed 100644
--- a/gst/gstevent.c
+++ b/gst/gstevent.c
@@ -683,7 +683,8 @@ gst_event_parse_new_segment_full (GstEvent * event, gboolean * update,
 
 /**
  * gst_event_new_tag:
- * @taglist: metadata list. The event will take ownership of @taglist.
+ * @taglist: (transfer full): metadata list. The event will take ownership
+ *     of the taglist.
  *
  * Generates a metadata tag event from the given @taglist.
  *
@@ -703,6 +704,9 @@ gst_event_new_tag (GstTagList * taglist)
  * @taglist: (out) (transfer none): pointer to metadata list
  *
  * Parses a tag @event and stores the results in the given @taglist location.
+ * No reference to the taglist will be returned, it remains valid only until
+ * the @event is freed. Don't modify or free the taglist, make a copy if you
+ * want to modify it or store it for later use.
  */
 void
 gst_event_parse_tag (GstEvent * event, GstTagList ** taglist)
@@ -1194,6 +1198,7 @@ gst_event_parse_step (GstEvent * event, GstFormat * format, guint64 * amount,
  *
  * Since: 0.10.26
  */
+/* FIXME 0.11: take ownership of msg for consistency? */
 GstEvent *
 gst_event_new_sink_message (GstMessage * msg)
 {