* Buffer lists are an object containing a list of buffers.
*
* Buffer lists are created with gst_buffer_list_new() and filled with data
- * using a gst_buffer_list_insert().
+ * using gst_buffer_list_insert().
*
* Buffer lists can be pushed on a srcpad with gst_pad_push_list(). This is
* interesting when multiple buffers need to be pushed in one go because it
* gst_buffer_list_new_sized:
* @size: an initial reserved size
*
- * Creates a new, empty #GstBufferList. The caller is responsible for unreffing
- * the returned #GstBufferList. The list will have @size space preallocated so
- * that memory reallocations can be avoided.
+ * Creates a new, empty #GstBufferList. The list will have @size space
+ * preallocated so that memory reallocations can be avoided.
*
- * Free-function: gst_buffer_list_unref
- *
- * Returns: (transfer full): the new #GstBufferList. gst_buffer_list_unref()
- * after usage.
+ * Returns: (transfer full): the new #GstBufferList.
*/
GstBufferList *
gst_buffer_list_new_sized (guint size)
/**
* gst_buffer_list_new:
*
- * Creates a new, empty #GstBufferList. The caller is responsible for unreffing
- * the returned #GstBufferList.
- *
- * Free-function: gst_buffer_list_unref
+ * Creates a new, empty #GstBufferList.
*
- * Returns: (transfer full): the new #GstBufferList. gst_buffer_list_unref()
- * after usage.
+ * Returns: (transfer full): the new #GstBufferList.
*/
GstBufferList *
gst_buffer_list_new (void)
* @func: (scope call): a #GstBufferListFunc to call
* @user_data: (closure): user data passed to @func
*
- * Call @func with @data for each buffer in @list.
+ * Calls @func with @data for each buffer in @list.
*
* @func can modify the passed buffer pointer or its contents. The return value
- * of @func define if this function returns or if the remaining buffers in
+ * of @func defines if this function returns or if the remaining buffers in
* the list should be skipped.
*
* Returns: %TRUE when @func returned %TRUE for each buffer in @list or when
* @list: a #GstBufferList
* @idx: the index
*
- * Get the buffer at @idx.
+ * Gets the buffer at @idx.
*
* You must make sure that @idx does not exceed the number of
* buffers available.
* @idx: the index
* @buffer: (transfer full): a #GstBuffer
*
- * Insert @buffer at @idx in @list. Other buffers are moved to make room for
+ * Inserts @buffer at @idx in @list. Other buffers are moved to make room for
* this new buffer.
*
* A -1 value for @idx will append the buffer at the end.
* @idx: the index
* @length: the amount to remove
*
- * Remove @length buffers starting from @idx in @list. The following buffers
+ * Removes @length buffers starting from @idx in @list. The following buffers
* are moved to close the gap.
*/
void
* gst_buffer_list_copy_deep:
* @list: a #GstBufferList
*
- * Create a copy of the given buffer list. This will make a newly allocated
- * copy of the buffer that the source buffer list contains.
+ * Creates a copy of the given buffer list. This will make a newly allocated
+ * copy of the buffers that the source buffer list contains.
*
* Returns: (transfer full): a new copy of @list.
*
* gst_buffer_list_calculate_size:
* @list: a #GstBufferList
*
- * Calculates the size of the data contained in buffer list by adding the
+ * Calculates the size of the data contained in @list by adding the
* size of all buffers.
*
- * Returns: the size of the data contained in buffer list in bytes.
+ * Returns: the size of the data contained in @list in bytes.
*
* Since: 1.14
*/
* gst_buffer_list_copy: (skip)
* @list: a #GstBufferList
*
- * Create a shallow copy of the given buffer list. This will make a newly
+ * Creates a shallow copy of the given buffer list. This will make a newly
* allocated copy of the source list with copies of buffer pointers. The
* refcount of buffers pointed to will be increased by one.
*