More docs updates

Original commit message from CVS:
More docs updates

docs/gst/tmpl/audioraw.sgml

@@ -19,4 +19,9 @@ Information about audio buffers.
 
 </para>
 
+@meta: 
+@format: 
+@channels: 
+@frequency: 
+@bps: 
 

docs/gst/tmpl/cothreads.sgml

@@ -47,12 +47,25 @@ cothreads
 
 </para>
 
+@ctx: 
+@threadnum: 
+@func: 
+@argc: 
+@argv: 
+@flags: 
+@sp: 
+@top_sp: 
+@pc: 
+@jmp: 
 
 <!-- ##### STRUCT cothread_context ##### -->
 <para>
 
 </para>
 
+@threads: 
+@nthreads: 
+@current: 
 
 <!-- ##### USER_FUNCTION cothread_func ##### -->
 <para>

docs/gst/tmpl/gstasyncdisksrc.sgml

@@ -29,6 +29,7 @@ the offset.
 
 </para>
 
+@GST_ASYNCDISKSRC_OPEN: 
 
 <!-- ##### ARG GstAsyncDiskSrc:location ##### -->
 <para>
@@ -40,13 +41,13 @@ Specify the location of the file to read.
 Specify how many bytes to read at a time.
 </para>
 
-<!-- ##### ARG GstAsyncDiskSrc:length ##### -->
-<para>
-Get the size of the current file.
-</para>
-
 <!-- ##### ARG GstAsyncDiskSrc:offset ##### -->
 <para>
 Specify the current offset in the file.
 </para>
 
+<!-- ##### ARG GstAsyncDiskSrc:size ##### -->
+<para>
+
+</para>
+

docs/gst/tmpl/gstaudiosink.sgml

@@ -20,6 +20,7 @@ The buffer is sent to the sound card.
 </para>
 
 @gstaudiosink: the object which received the signal.
+<!-- # Unused Parameters # -->
 @arg1: the audiosink.
 
 <!-- ##### ARG GstAudioSink:mute ##### -->

docs/gst/tmpl/gstbuffer.sgml

@@ -167,12 +167,28 @@ used when data in a stream has been skipped</entry>
 
 </para>
 
+@GST_BUFFER_READONLY: 
+@GST_BUFFER_EOS: 
+@GST_BUFFER_ORIGINAL: 
+@GST_BUFFER_DONTFREE: 
+@GST_BUFFER_FLUSH: 
 
 <!-- ##### STRUCT GstBuffer ##### -->
 <para>
 
 </para>
 
+@lock: 
+@flags: 
+@data: 
+@size: 
+@maxsize: 
+@offset: 
+@timestamp: 
+@maxage: 
+@metas: 
+@parent: 
+@pool: 
 
 <!-- ##### FUNCTION gst_buffer_new ##### -->
 <para>

docs/gst/tmpl/gstbufferpool.sgml

@@ -1,12 +1,21 @@
 <!-- ##### SECTION Title ##### -->
-gstbufferpool
+GstBufferPool
 
 <!-- ##### SECTION Short_Description ##### -->
-
+Create buffers from a pool
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>
+A bufferpool is used to create buffers in an efficient way. En element
+can maintain a bufferpool with a fixed number of buffers. This will reduce
+the g_malloc and g_free overhead.
+</para>
 
+<para>
+A bufferpool can also be used to implement direct access. A bufferpool can be
+sent from one element to another so that the latter can directly write into
+the memory of the element that maintains the bufferpool. This can greatly reduce
+the number of memcpy operations.
 </para>
 
 <!-- ##### SECTION See_Also ##### -->
@@ -14,19 +23,15 @@ gstbufferpool
 
 </para>
 
-<!-- ##### MACRO GST_BUFFER_POOL ##### -->
-<para>
-
-</para>
-
-@buf: 
-
-
 <!-- ##### STRUCT GstBufferPool ##### -->
 <para>
 
 </para>
 
+@new_buffer: 
+@new_user_data: 
+@destroy_user_data: 
+@destroy_buffer: 
 
 <!-- ##### USER_FUNCTION GstBufferPoolCreateFunction ##### -->
 <para>

docs/gst/tmpl/gstclock.sgml

@@ -40,6 +40,16 @@ gstclock
 
 </para>
 
+@name: 
+@start_time: 
+@current_time: 
+@adjust: 
+@locking: 
+@sinkobjects: 
+@num: 
+@num_locked: 
+@sinkmutex: 
+@lock: 
 
 <!-- ##### FUNCTION gst_clock_new ##### -->
 <para>

docs/gst/tmpl/gstcpu.sgml

@@ -18,19 +18,13 @@ features of the CPU.
 
 </para>
 
-<!-- ##### MACRO GST_CPU_FLAG_MMX ##### -->
+<!-- ##### ENUM GstCPUFlags ##### -->
 <para>
-A flag indicating that MMX instructions are supported.
+
 </para>
 
-
+@GST_CPU_FLAG_MMX: 
-
+@GST_CPU_FLAG_SSE: 
-<!-- ##### MACRO GST_CPU_FLAG_SSE ##### -->
-<para>
-A flag indicating that SSE instructions are supported.
-</para>
-
-
 
 <!-- ##### FUNCTION gst_cpu_get_flags ##### -->
 <para>

docs/gst/tmpl/gstdisksrc.sgml

@@ -30,6 +30,7 @@ with seeking capabilities use a <classname>GstAsynDiskSrc</classname> instead.
 
 </para>
 
+@GST_DISKSRC_OPEN: 
 
 <!-- ##### ARG GstDiskSrc:location ##### -->
 <para>

docs/gst/tmpl/gstelement.sgml

@@ -69,6 +69,11 @@ temporary stops the data flow.
 </tbody></tgroup></informaltable>
 </para>
 
+@GST_STATE_NONE_PENDING: 
+@GST_STATE_NULL: 
+@GST_STATE_READY: 
+@GST_STATE_PLAYING: 
+@GST_STATE_PAUSED: 
 
 <!-- ##### ENUM GstElementStateReturn ##### -->
 <para>
@@ -98,6 +103,9 @@ can return after a state change.
 
 </para>
 
+@GST_STATE_FAILURE: 
+@GST_STATE_SUCCESS: 
+@GST_STATE_ASYNC: 
 
 <!-- ##### MACRO GST_STATE ##### -->
 <para>
@@ -132,6 +140,8 @@ may have.
 
 </para>
 
+@GST_ELEMENT_MULTI_IN: 
+@GST_ELEMENT_THREAD_SUGGESTED: 
 
 <!-- ##### MACRO GST_ELEMENT_IS_MULTI_IN ##### -->
 <para>
@@ -142,6 +152,14 @@ Query whether this object has multiple input pads.
 @obj: Element to query for multiple input pads.
 
 
+<!-- ##### MACRO GST_ELEMENT_IS_THREAD_SUGGESTED ##### -->
+<para>
+
+</para>
+
+@obj: 
+
+
 <!-- ##### STRUCT GstElement ##### -->
 <para>
 
@@ -154,6 +172,12 @@ This struct is used to define public information about the element.  It
 describes the element, mostly for the benefit of editors.
 </para>
 
+@longname: 
+@class: 
+@description: 
+@version: 
+@author: 
+@copyright: 
 
 <!-- ##### STRUCT GstElementFactory ##### -->
 <para>
@@ -162,6 +186,11 @@ of the element, the GtkType value for it, as well as a pointer to the
 GstElementDetails struct for the element.
 </para>
 
+@name: 
+@type: 
+@details: 
+@src_types: 
+@sink_types: 
 
 <!-- ##### USER_FUNCTION GstElementLoopFunction ##### -->
 <para>
@@ -320,6 +349,16 @@ circumstances.
 @Returns: 
 
 
+<!-- ##### FUNCTION gst_element_load_thyself ##### -->
+<para>
+
+</para>
+
+@parent: 
+@elements: 
+@Returns: 
+
+
 <!-- ##### FUNCTION gst_elementfactory_new ##### -->
 <para>
 

docs/gst/tmpl/gstextratypes.sgml

@@ -0,0 +1,31 @@
+<!-- ##### SECTION Title ##### -->
+GstExtraTypes
+
+<!-- ##### SECTION Short_Description ##### -->
+
+
+<!-- ##### SECTION Long_Description ##### -->
+<para>
+
+</para>
+
+<!-- ##### SECTION See_Also ##### -->
+<para>
+
+</para>
+
+<!-- ##### MACRO GST_TYPE_FILENAME ##### -->
+<para>
+
+</para>
+
+
+
+<!-- ##### FUNCTION gst_extra_get_filename_type ##### -->
+<para>
+
+</para>
+
+@Returns: 
+
+

docs/gst/tmpl/gstmeta.sgml

@@ -112,6 +112,8 @@ it, is there?
 
 </para>
 
+@meta: 
+<!-- # Unused Parameters # -->
 @buf: 
 
 
@@ -147,12 +149,17 @@ it, is there?
 
 </para>
 
+@GST_META_FREEABLE: 
 
 <!-- ##### STRUCT GstMeta ##### -->
 <para>
 
 </para>
 
+@lock: 
+@flags: 
+@data: 
+@size: 
 
 <!-- ##### FUNCTION gst_meta_new_size ##### -->
 <para>

docs/gst/tmpl/gstpad.sgml

@@ -78,6 +78,9 @@ the function that will be called when a QoS message is sent.
 
 </para>
 
+@GST_PAD_UNKNOWN: 
+@GST_PAD_SRC: 
+@GST_PAD_SINK: 
 
 <!-- ##### FUNCTION gst_pad_new ##### -->
 <para>
@@ -278,3 +281,13 @@ the function that will be called when a QoS message is sent.
 @Returns: 
 
 
+<!-- ##### FUNCTION gst_pad_load_and_connect ##### -->
+<para>
+
+</para>
+
+@parent: 
+@element: 
+@elements: 
+
+

docs/gst/tmpl/gstplugin.sgml

@@ -20,6 +20,12 @@ GStreamer is extensible so <classname>GstElements</classname> can be loaded at r
 
 </para>
 
+@name: 
+@longname: 
+@filename: 
+@types: 
+@elements: 
+@loaded: 
 
 <!-- ##### STRUCT GstPluginElement ##### -->
 <para>

docs/gst/tmpl/gstreamer-unused.sgml

@@ -17,13 +17,6 @@
 </para>
 
 
-<!-- ##### FUNCTION gst_fakesrc_push ##### -->
-<para>
-
-</para>
-
-@src: 
-
 <!-- ##### FUNCTION gst_tee_get_type ##### -->
 <para>
 
@@ -31,6 +24,13 @@
 
 @Returns: 
 
+<!-- ##### FUNCTION gst_fakesrc_push ##### -->
+<para>
+
+</para>
+
+@src: 
+
 <!-- ##### MACRO GST_FAKESRC ##### -->
 <para>
 
@@ -45,6 +45,12 @@
 
 @obj: 
 
+<!-- ##### STRUCT GstAsyncDiskSrcClass ##### -->
+<para>
+
+</para>
+
+
 <!-- ##### FUNCTION gst_fdsink_new ##### -->
 <para>
 
@@ -53,12 +59,6 @@
 @name: 
 @Returns: 
 
-<!-- ##### STRUCT GstAsyncDiskSrcClass ##### -->
-<para>
-
-</para>
-
-
 <!-- ##### MACRO GST_IS_FILTER_CLASS ##### -->
 <para>
 
@@ -133,6 +133,10 @@
 </para>
 
 
+<!-- ##### SECTION ./tmpl/gstgetbits.sgml:Short_Description ##### -->
+
+
+
 <!-- ##### MACRO GST_PAD_CLASS ##### -->
 <para>
 
@@ -167,13 +171,6 @@
 
 @Returns: 
 
-<!-- ##### FUNCTION gst_object_get_type ##### -->
-<para>
-
-</para>
-
-@Returns: 
-
 <!-- ##### MACRO GST_SINESRC ##### -->
 <para>
 
@@ -181,19 +178,19 @@
 
 @obj: 
 
-<!-- ##### SECTION ./tmpl/plugin.sgml:Long_Description ##### -->
+<!-- ##### FUNCTION gst_object_get_type ##### -->
-<para>
-
-</para>
-
-
-<!-- ##### FUNCTION gst_audiosrc_get_type ##### -->
 <para>
 
 </para>
 
 @Returns: 
 
+<!-- ##### SECTION ./tmpl/plugin.sgml:Long_Description ##### -->
+<para>
+
+</para>
+
+
 <!-- ##### MACRO GST_QUEUE_CLASS ##### -->
 <para>
 
@@ -201,6 +198,13 @@
 
 @klass: 
 
+<!-- ##### FUNCTION gst_audiosrc_get_type ##### -->
+<para>
+
+</para>
+
+@Returns: 
+
 <!-- ##### MACRO GST_IS_QUEUE ##### -->
 <para>
 
@@ -237,6 +241,12 @@
 @name: 
 @Returns: 
 
+<!-- ##### SECTION ./tmpl/gstgetbits.sgml:See_Also ##### -->
+<para>
+
+</para>
+
+
 <!-- ##### MACRO GST_IS_SRC ##### -->
 <para>
 
@@ -264,6 +274,13 @@
 
 @klass: 
 
+<!-- ##### FUNCTION gst_thread_main_loop ##### -->
+<para>
+
+</para>
+
+@arg: 
+
 <!-- ##### MACRO GST_TYPE_BIN ##### -->
 <para>
 
@@ -339,12 +356,6 @@
 </para>
 
 
-<!-- ##### STRUCT GstFakeSink ##### -->
-<para>
-
-</para>
-
-
 <!-- ##### MACRO GST_THREAD_CLASS ##### -->
 <para>
 
@@ -352,6 +363,12 @@
 
 @klass: 
 
+<!-- ##### STRUCT GstFakeSink ##### -->
+<para>
+
+</para>
+
+
 <!-- ##### MACRO GST_BIN_CLASS ##### -->
 <para>
 
@@ -392,6 +409,10 @@
 </para>
 
 
+<!-- ##### SECTION ./tmpl/gstcolorspace.sgml:Title ##### -->
+GstColorSpace
+
+
 <!-- ##### MACRO GST_PAD ##### -->
 <para>
 
@@ -422,6 +443,12 @@
 @name: 
 @Returns: 
 
+<!-- ##### SECTION ./tmpl/gstcolorspace.sgml:Long_Description ##### -->
+<para>
+
+</para>
+
+
 <!-- ##### FUNCTION gst_audiosrc_new ##### -->
 <para>
 
@@ -457,6 +484,10 @@
 
 @obj: 
 
+<!-- ##### SECTION ./tmpl/gstgetbits.sgml:Title ##### -->
+GstGetbits
+
+
 <!-- ##### MACRO GST_FILTER_CLASS ##### -->
 <para>
 
@@ -668,14 +699,18 @@ This macro unsets the given state on the element.
 </para>
 
 
-<!-- ##### MACRO GST_ASYNCDISKSRC_CLASS ##### -->
+<!-- ##### SECTION ./tmpl/gstcolorspace.sgml:Short_Description ##### -->
+
+
+
+<!-- ##### MACRO GST_ESDSINK_CLASS ##### -->
 <para>
 
 </para>
 
 @klass: 
 
-<!-- ##### MACRO GST_ESDSINK_CLASS ##### -->
+<!-- ##### MACRO GST_ASYNCDISKSRC_CLASS ##### -->
 <para>
 
 </para>
@@ -715,6 +750,12 @@ This macro unsets the given state on the element.
 </para>
 
 
+<!-- ##### SECTION ./tmpl/gstcolorspace.sgml:See_Also ##### -->
+<para>
+
+</para>
+
+
 <!-- ##### STRUCT GstHttpSrc ##### -->
 <para>
 
@@ -891,6 +932,12 @@ plugin
 
 @obj: 
 
+<!-- ##### MACRO GST_CPU_FLAG_SSE ##### -->
+<para>
+A flag indicating that SSE instructions are supported.
+</para>
+
+
 <!-- ##### STRUCT GstAudioSrcClass ##### -->
 <para>
 
@@ -1087,6 +1134,12 @@ This macro checks to see if the given state is set.
 
 
 
+<!-- ##### SECTION ./tmpl/gstgetbits.sgml:Long_Description ##### -->
+<para>
+
+</para>
+
+
 <!-- ##### FUNCTION gst_fakesink_get_type ##### -->
 <para>
 
@@ -1143,6 +1196,12 @@ This macro checks to see if the given state is set.
 @esdsink: 
 @frequency: 
 
+<!-- ##### ARG GstAsyncDiskSrc:length ##### -->
+<para>
+Get the size of the current file.
+</para>
+
+
 <!-- ##### MACRO GST_TYPE_PIPELINE ##### -->
 <para>
 
@@ -1177,6 +1236,13 @@ This macro checks to see if the given state is set.
 </para>
 
 
+<!-- ##### FUNCTION gst_thread_iterate ##### -->
+<para>
+
+</para>
+
+@thread: 
+
 <!-- ##### MACRO GST_AUDIOSINK ##### -->
 <para>
 
@@ -1300,13 +1366,6 @@ This macro checks to see if the given state is set.
 </para>
 
 
-<!-- ##### MACRO GST_META ##### -->
-<para>
-
-</para>
-
-@meta: 
-
 <!-- ##### FUNCTION gst_audiosink_get_type ##### -->
 <para>
 
@@ -1314,6 +1373,13 @@ This macro checks to see if the given state is set.
 
 @Returns: 
 
+<!-- ##### MACRO GST_META ##### -->
+<para>
+
+</para>
+
+@meta: 
+
 <!-- ##### FUNCTION gst_httpsrc_get_type ##### -->
 <para>
 
@@ -1355,6 +1421,12 @@ This macro checks to see if the given state is set.
 </para>
 
 
+<!-- ##### MACRO GST_TYPE_FILTER ##### -->
+<para>
+
+</para>
+
+
 <!-- ##### MACRO GST_IS_SINESRC_CLASS ##### -->
 <para>
 
@@ -1362,12 +1434,6 @@ This macro checks to see if the given state is set.
 
 @obj: 
 
-<!-- ##### MACRO GST_TYPE_FILTER ##### -->
-<para>
-
-</para>
-
-
 <!-- ##### MACRO GST_IS_AUDIOSRC_CLASS ##### -->
 <para>
 
@@ -1445,6 +1511,10 @@ GstElement
 
 @obj: 
 
+<!-- ##### SECTION ./tmpl/plugin.sgml:Short_Description ##### -->
+
+
+
 <!-- ##### FUNCTION gst_audiosrc_push ##### -->
 <para>
 
@@ -1452,10 +1522,6 @@ GstElement
 
 @src: 
 
-<!-- ##### SECTION ./tmpl/plugin.sgml:Short_Description ##### -->
-
-
-
 <!-- ##### MACRO GST_HTTPSRC_CLASS ##### -->
 <para>
 
@@ -1506,6 +1572,13 @@ GstElement
 @fd: 
 @Returns: 
 
+<!-- ##### MACRO GST_BUFFER_POOL ##### -->
+<para>
+
+</para>
+
+@buf: 
+
 <!-- ##### FUNCTION gst_audiosink_set_format ##### -->
 <para>
 
@@ -1570,3 +1643,9 @@ GstElement
 </para>
 
 
+<!-- ##### MACRO GST_CPU_FLAG_MMX ##### -->
+<para>
+A flag indicating that MMX instructions are supported.
+</para>
+
+

docs/gst/tmpl/gstsrc.sgml

@@ -30,6 +30,7 @@ audio source. It provides data for the next element in the graph.
 </tbody></tgroup></informaltable>
 </para>
 
+@GST_SRC_ASYNC: 
 
 <!-- ##### MACRO GST_SRC_FLAGS ##### -->
 <para>

docs/gst/tmpl/gstthread.sgml

@@ -43,6 +43,9 @@ to be dealt with in the separate thread.
 
 </para>
 
+@GST_THREAD_CREATE: 
+@GST_THREAD_STATE_SPINNING: 
+@GST_THREAD_STATE_REAPING: 
 
 <!-- ##### STRUCT GstThread ##### -->
 <para>
@@ -59,22 +62,6 @@ to be dealt with in the separate thread.
 @Returns: 
 
 
-<!-- ##### FUNCTION gst_thread_main_loop ##### -->
-<para>
-
-</para>
-
-@arg: 
-
-
-<!-- ##### FUNCTION gst_thread_iterate ##### -->
-<para>
-
-</para>
-
-@thread: 
-
-
 <!-- ##### ARG GstThread:create_thread ##### -->
 <para>
 TRUE if the thread should be created.

docs/gst/tmpl/gsttrace.sgml

@@ -27,12 +27,21 @@ Tracing functionality
 
 </para>
 
+@filename: 
+@fd: 
+@buf: 
+@bufsize: 
+@bufoffset: 
 
 <!-- ##### STRUCT GstTraceEntry ##### -->
 <para>
 
 </para>
 
+@timestamp: 
+@sequence: 
+@data: 
+@message: 
 
 <!-- ##### FUNCTION gst_trace_new ##### -->
 <para>

docs/gst/tmpl/gsttype.sgml

@@ -69,12 +69,22 @@ valid mp3 decoder, and thus the whole point of the type system.
 
 </para>
 
+@id: 
+@mime: 
+@exts: 
+@typefindfunc: 
+@srcs: 
+@sinks: 
+@converters: 
 
 <!-- ##### STRUCT GstTypeFactory ##### -->
 <para>
 
 </para>
 
+@mime: 
+@exts: 
+@typefindfunc: 
 
 <!-- ##### FUNCTION gst_type_register ##### -->
 <para>

docs/gst/tmpl/gsttypefind.sgml

@@ -0,0 +1,30 @@
+<!-- ##### SECTION Title ##### -->
+GstTypeFind
+
+<!-- ##### SECTION Short_Description ##### -->
+Detect the mime type of a media stream
+
+<!-- ##### SECTION Long_Description ##### -->
+<para>
+This element can be added to the pipeline and will notify the listener of
+the detected mime type of the stream. It is used in autoplugging.
+</para>
+
+<!-- ##### SECTION See_Also ##### -->
+<para>
+
+</para>
+
+<!-- ##### SIGNAL GstTypeFind::have-type ##### -->
+<para>
+The signal to indicate the mime type was detected.
+</para>
+
+@gsttypefind: the object which received the signal.
+@arg1: The mime type that was detected
+
+<!-- ##### ARG GstTypeFind:type ##### -->
+<para>
+Query the element for the current mime type
+</para>
+

docs/gst/tmpl/gstxml.sgml

@@ -15,6 +15,24 @@ All GstElements can be serialized to an XML presentation
 
 </para>
 
+<!-- ##### STRUCT GstXML ##### -->
+<para>
+
+</para>
+
+@object: 
+@elements: 
+
+<!-- ##### FUNCTION gst_xml_new ##### -->
+<para>
+
+</para>
+
+@fname: 
+@root: 
+@Returns: 
+
+
 <!-- ##### FUNCTION gst_xml_write ##### -->
 <para>
 
@@ -24,3 +42,13 @@ All GstElements can be serialized to an XML presentation
 @Returns: 
 
 
+<!-- ##### FUNCTION gst_xml_get_element ##### -->
+<para>
+
+</para>
+
+@xml: 
+@name: 
+@Returns: 
+
+

docs/gst/tmpl/spectrum.sgml

@@ -20,4 +20,11 @@ Frequencies of a spectrum analysis.
 
 </para>
 
+@meta: 
+@bands: 
+@channels: 
+@interleaved: 
+@lowfreq: 
+@highfreq: 
+@steps: 
 

docs/gst/tmpl/videoraw.sgml

@@ -19,6 +19,10 @@ Information about video buffers.
 
 </para>
 
+@meta: 
+@format: 
+@visual: 
+@height: 
 
 <!-- ##### STRUCT MetaDGA ##### -->
 <para>
@@ -31,10 +35,18 @@ Information about video buffers.
 
 </para>
 
+@width: 
+@height: 
+@did_overlay: 
+@fully_obscured: 
 
 <!-- ##### STRUCT OverlayClip ##### -->
 <para>
 
 </para>
 
+@x1: 
+@x2: 
+@y1: 
+@y2: