summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorTim-Philipp Müller <tim.muller@collabora.co.uk>2011-02-10 10:19:38 +0000
committerTim-Philipp Müller <tim.muller@collabora.co.uk>2011-02-10 10:20:10 +0000
commit2d37f06ce89e3ff4f000e3a17e8cb15bc15c84aa (patch)
tree4cf276a99824b7a3eaee17618496e43b9f05b315
parent1a6f61a1c9920f4736627919c625bd024997c74d (diff)
events: fix g-i annotation for gst_event_new_tag() which takes ownership of the tag list
-rw-r--r--gst/gstevent.c7
1 files changed, 6 insertions, 1 deletions
diff --git a/gst/gstevent.c b/gst/gstevent.c
index 6d2cc8bc2f..c407fedb17 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)
{