From 27410f3934e2b52de3334eb93b10d729111ba539 Mon Sep 17 00:00:00 2001 From: Edward Hervey Date: Tue, 6 Jul 2010 10:28:14 +0200 Subject: [PATCH] gstvalue: Improve gst_value_{set|get}_caps docs --- gst/gstvalue.c | 8 +++++--- 1 file changed, 5 insertions(+), 3 deletions(-) diff --git a/gst/gstvalue.c b/gst/gstvalue.c index 5d67397..a8d58de 100644 --- a/gst/gstvalue.c +++ b/gst/gstvalue.c @@ -1341,8 +1341,8 @@ gst_value_deserialize_fraction_range (GValue * dest, const gchar * s) * @value: a GValue initialized to GST_TYPE_CAPS * @caps: the caps to set the value to * - * Sets the contents of @value to @caps. The actual - * #GstCaps structure is copied before it is used. + * Sets the contents of @value to @caps. A reference to the + * provided @caps will be taken by the @value. */ void gst_value_set_caps (GValue * value, const GstCaps * caps) @@ -1358,7 +1358,9 @@ gst_value_set_caps (GValue * value, const GstCaps * caps) * gst_value_get_caps: * @value: a GValue initialized to GST_TYPE_CAPS * - * Gets the contents of @value. + * Gets the contents of @value. The reference count of the returned + * #GstCaps will not be modified, therefore the caller must take one + * before getting rid of the @value. * * Returns: the contents of @value */ -- 2.7.4