gst/gstutils.c: Mention that this is just like gst_buffer_merge() but with extra unreffing for C coders. Advise langu...

Original commit message from CVS:
patch by: Murray Cumming <murrayc@murrayc.com>
* gst/gstutils.c:
Mention that this is just like gst_buffer_merge() but with extra
unreffing for C coders. Advise language bindings not to wrap it.
Fixes Bug #533856.
Also fix file comment.
This commit is contained in:
Murray Cumming 2008-08-20 07:22:11 +00:00 committed by Stefan Kost
parent c55cc1ff39
commit 976b9750ea
2 changed files with 17 additions and 1 deletions

View file

@ -1,3 +1,14 @@
2008-08-20 Stefan Kost <ensonic@users.sf.net>
patch by: Murray Cumming <murrayc@murrayc.com>
* gst/gstutils.c:
Mention that this is just like gst_buffer_merge() but with extra
unreffing for C coders. Advise language bindings not to wrap it.
Fixes Bug #533856.
Also fix file comment.
2008-08-20 Stefan Kost <ensonic@users.sf.net>
reviewed by: Wim Taymans <wim.taymans@collabora.co.uk>

View file

@ -3,7 +3,7 @@
* 2000 Wim Taymans <wtay@chello.be>
* 2002 Thomas Vander Stichele <thomas@apestaart.org>
*
* gstutils.c: Utility functions: gtk_get_property stuff, etc.
* gstutils.c: Utility functions
*
* This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Library General Public
@ -2420,6 +2420,11 @@ gst_buffer_merge (GstBuffer * buf1, GstBuffer * buf2)
* If the buffers point to contiguous areas of memory, the buffer
* is created without copying the data.
*
* This is a convenience function for C programmers. See also
* gst_buffer_merge(), which does the same thing without
* unreffing the input parameters. Language bindings without
* explicit reference counting should not wrap this function.
*
* Returns: the new #GstBuffer which is the concatenation of the source buffers.
*/
GstBuffer *