sync latest api changes

Original commit message from CVS:
sync latest api changes

ChangeLog

@@ -1,3 +1,14 @@
+2004-01-20  Thomas Vander Stichele  <thomas at apestaart dot org>
+
+	* docs/gst/gstreamer-sections.txt:
+	* docs/gst/tmpl/gst.sgml:
+	* docs/gst/tmpl/gstbuffer.sgml:
+	* docs/gst/tmpl/gstclock.sgml:
+	* docs/gst/tmpl/gstelement.sgml:
+	* docs/gst/tmpl/gstreamer-unused.sgml:
+	* docs/gst/tmpl/gstxml.sgml:
+          sync latest API changes to docs
+
 2004-01-20  Thomas Vander Stichele  <thomas at apestaart dot org>
 
 	* gst/gstpluginfeature.c:

docs/gst/gstreamer-sections.txt

@@ -361,8 +361,6 @@ GST_BUFFER_SIZE
 GST_BUFFER_MAXSIZE
 GST_BUFFER_TIMESTAMP
 GST_BUFFER_OFFSET
-GST_BUFFER_BUFFERPOOL
-GST_BUFFER_POOL_PRIVATE
 GstBufferFlag
 GstBuffer
 gst_buffer_new

docs/gst/tmpl/gst.sgml

@@ -90,14 +90,6 @@ pipeline</ulink> and Microsoft's DirectShow for some background.
 @argv: 
 
 
-<!-- ##### FUNCTION gst_init_get_popt_table ##### -->
-<para>
-
-</para>
-
-@Returns: 
-
-
 <!-- ##### FUNCTION gst_init_with_popt_table ##### -->
 <para>
 

docs/gst/tmpl/gstbuffer.sgml

@@ -214,23 +214,6 @@ Gets the offset in the source file of this buffer.
 @buf: a #GstBuffer to get offset of.
 
 
-<!-- ##### MACRO GST_BUFFER_BUFFERPOOL ##### -->
-<para>
-Gets the bufferpool for this buffer.
-</para>
-
-@buf: a #GstBuffer to get the bufferpool of.
-@Returns: the #GstBufferPool of this buffer.
-
-
-<!-- ##### MACRO GST_BUFFER_POOL_PRIVATE ##### -->
-<para>
-Gets the bufferpool private data.
-</para>
-
-@buf: a #GstBuffer to get bufferpool's private data of.
-
-
 <!-- ##### ENUM GstBufferFlag ##### -->
 <para>
 A set of buffer flags used to describe properties of a #GstBuffer.
@@ -242,12 +225,9 @@ A set of buffer flags used to describe properties of a #GstBuffer.
 @GST_BUFFER_ORIGINAL: buffer is not a copy of another buffer.
 @GST_BUFFER_DONTFREE: do not try to free the data when this buffer is 
                       unreferenced.
-@GST_BUFFER_DISCONTINUOUS: the buffer is the first one after a discontinuity 
-                          in the stream.
 @GST_BUFFER_KEY_UNIT: the buffer holds a key unit, a unit that can be 
                       decoded independently of other buffers.
-@GST_BUFFER_PREROLL: the buffer should be decoded but not rendered, it is 
+@GST_BUFFER_DONTKEEP: 
-                     mainly used to resynchronise the stream.
 @GST_BUFFER_FLAG_LAST: additional flags can be added starting from this flag.
 
 <!-- ##### STRUCT GstBuffer ##### -->
@@ -263,8 +243,8 @@ The basic structure of a buffer.
 @duration: 
 @offset: 
 @offset_end: 
-@pool: 
+@free_data: 
-@pool_private: 
+@buffer_private: 
 @_gst_reserved: 
 
 <!-- ##### FUNCTION gst_buffer_new ##### -->

docs/gst/tmpl/gstclock.sgml

@@ -402,6 +402,11 @@ The GstClock object
 @id: 
 
 
+<!-- ##### ARG GstClock:event-diff ##### -->
+<para>
+
+</para>
+
 <!-- ##### ARG GstClock:max-diff ##### -->
 <para>
 Maximum allowed diff for clock sync requests against the real time.

docs/gst/tmpl/gstelement.sgml

@@ -379,11 +379,17 @@ Sets the name of the element, getting rid of the old name if there was one.
 @element: 
 
 
-<!-- ##### FUNCTION gst_element_error ##### -->
+<!-- ##### MACRO gst_element_error ##### -->
 <para>
 
 </para>
 
+@el: 
+@domain: 
+@code: 
+@message: 
+@debug: 
+<!-- # Unused Parameters # -->
 @element: 
 @error: 
 @Varargs: 
@@ -746,6 +752,7 @@ notifications to stdout.
 @object: 
 @orig: 
 @error: 
+@debug: 
 
 
 <!-- ##### ENUM GstElementState ##### -->
@@ -980,6 +987,7 @@ Is triggered whenever an error occured.
 @gstelement: the object which received the signal.
 @arg1: the error message
 @arg2: 
+@: 
 
 <!-- ##### SIGNAL GstElement::found-tag ##### -->
 <para>

docs/gst/tmpl/gstreamer-unused.sgml

@@ -1757,6 +1757,14 @@ Get the value of a #GstAtomicSwap
 
 @klass: 
 
+<!-- ##### MACRO GST_BUFFER_BUFFERPOOL ##### -->
+<para>
+Gets the bufferpool for this buffer.
+</para>
+
+@buf: a #GstBuffer to get the bufferpool of.
+@Returns: the #GstBufferPool of this buffer.
+
 <!-- ##### MACRO GST_BUFFER_LOCK ##### -->
 <para>
 Obtains a lock on the object, making serialization possible.
@@ -1785,6 +1793,13 @@ Unlock the given bufferpool.
 
 @pool: the bufferpool to unlock.
 
+<!-- ##### MACRO GST_BUFFER_POOL_PRIVATE ##### -->
+<para>
+Gets the bufferpool private data.
+</para>
+
+@buf: a #GstBuffer to get bufferpool's private data of.
+
 <!-- ##### MACRO GST_BUFFER_POOL_UNLOCK ##### -->
 <para>
 Lock the given bufferpool.
@@ -8918,6 +8933,13 @@ of an element he doesn't need anymore.
 @format: 
 @args...: 
 
+<!-- ##### FUNCTION gst_init_get_popt_table ##### -->
+<para>
+
+</para>
+
+@Returns: 
+
 <!-- ##### FUNCTION gst_link_get_type ##### -->
 <para>
 

docs/gst/tmpl/gstxml.sgml

@@ -110,10 +110,6 @@ All GstElements can be serialized to an XML presentation and subsequently loaded
 
 </para>
 
-@: 
-@: 
-@:
-
 @gstxml: the object which received the signal.
 @arg1: 
 @arg2: 
@@ -123,7 +119,7 @@ All GstElements can be serialized to an XML presentation and subsequently loaded
 
 </para>
 
-@gstxml: the object which received the signal.
+@: 
-@arg1: 
+@: 
-@arg2: 
+@: