[gstreamer-bugs] [Bug 533856] gst_buffer_join() documentation is unclear

[GStreamer (bugzilla.gnome.org)]

If you have any questions why you received this email, please see the text at
the end of this email. Replies to this email are NOT read, please see the text
at the end of this email. You can add comments to this bug at:
  http://bugzilla.gnome.org/show_bug.cgi?id=533856

  GStreamer | gstreamer (core) | Ver: HEAD CVS

Tim-Philipp Müller changed:

           What    |Removed                     |Added
----------------------------------------------------------------------------
             Status|UNCONFIRMED                 |NEEDINFO




------- Comment #4 from Tim-Philipp Müller  2008-06-20 11:34 UTC -------
> By the way, I notice that some documentation comments in that file use regular
> gtk-doc syntax, but some use doxygen/javadoc syntax. I presume gtk-doc somehow
> handles both, but it might be something you want to know about.

Oh really? Where?


> So, "span" means the same as "join"?

Basically yes, but span allows for offset/length parameters, so join is
span(0,addedlength).


> I'll probably add some more documentation that it's just a way of doing
> gst_buffer_span(), and that it's not to be used by language bindings.

It's just like gst_buffer_merge() only that _join() unrefs the input buffers.


-- 
See http://bugzilla.gnome.org/page.cgi?id=email.html for more info about why you received
this email, why you can't respond via email, how to stop receiving
emails (or reduce the number you receive), and how to contact someone
if you are having problems with the system.

You can add comments to this bug at http://bugzilla.gnome.org/show_bug.cgi?id=533856.