docs/gst/Makefile.am: Disable a bunch of headers from being scanned

Original commit message from CVS:
* docs/gst/Makefile.am:  Disable a bunch of headers from being scanned
* docs/gst/gstreamer-docs.sgml:  More hacking
* docs/gst/gstreamer-sections.txt:
* docs/gst/tmpl/cothreads_compat.sgml:
* docs/gst/tmpl/gstcaps.sgml:
* docs/gst/tmpl/gstclock.sgml:
* docs/gst/tmpl/gstelement.sgml:
* docs/gst/tmpl/gstevent.sgml:
* docs/gst/tmpl/gstpad.sgml:
* docs/gst/tmpl/gstutils.sgml:
* docs/gst/tmpl/gstxml.sgml:
* docs/gst/tmpl/gthread-cothreads.sgml:
* docs/random/ds/0.9-suggested-changes:
* gst/elements/gstfakesink.h: doc fixes
* gst/elements/gstfakesrc.h: doc fixes
* gst/gstcaps.c: doc fixes
* gst/gstcaps.h: doc fixes
* gst/gstelement.c: doc fixes
* gst/gstelement.h: doc fixes
* gst/gstindex.c: doc fixes
* gst/gstinfo.c: doc fixes
* gst/gstpad.c: doc fixes
* gst/gstpad.h: doc fixes
* gst/gstplugin.c: doc fixes
* gst/gsttypefind.h: doc fixes
* gst/gsturi.c: doc fixes
* gst/gstvalue.c: doc fixes

ChangeLog

@@ -1,3 +1,33 @@
+2004-03-29  David Schleef  <ds@schleef.org>
+
+	* docs/gst/Makefile.am:  Disable a bunch of headers from being scanned
+	* docs/gst/gstreamer-docs.sgml:  More hacking
+	* docs/gst/gstreamer-sections.txt:
+	* docs/gst/tmpl/cothreads_compat.sgml:
+	* docs/gst/tmpl/gstcaps.sgml:
+	* docs/gst/tmpl/gstclock.sgml:
+	* docs/gst/tmpl/gstelement.sgml:
+	* docs/gst/tmpl/gstevent.sgml:
+	* docs/gst/tmpl/gstpad.sgml:
+	* docs/gst/tmpl/gstutils.sgml:
+	* docs/gst/tmpl/gstxml.sgml:
+	* docs/gst/tmpl/gthread-cothreads.sgml:
+	* docs/random/ds/0.9-suggested-changes:
+	* gst/elements/gstfakesink.h: doc fixes
+	* gst/elements/gstfakesrc.h: doc fixes
+	* gst/gstcaps.c: doc fixes
+	* gst/gstcaps.h: doc fixes
+	* gst/gstelement.c: doc fixes
+	* gst/gstelement.h: doc fixes
+	* gst/gstindex.c: doc fixes
+	* gst/gstinfo.c: doc fixes
+	* gst/gstpad.c: doc fixes
+	* gst/gstpad.h: doc fixes
+	* gst/gstplugin.c: doc fixes
+	* gst/gsttypefind.h: doc fixes
+	* gst/gsturi.c: doc fixes
+	* gst/gstvalue.c: doc fixes
+
 2004-03-29  Colin Walters  <walters@redhat.com>
 
 	* gst/registries/gstxmlregistry.c (get_time)

docs/gst/Makefile.am

@@ -64,7 +64,34 @@ CFILE_GLOB=$(DOC_SOURCE_DIR)/*.c
 #	$(top_builddir)/gst/schedulers/libgstbasicomegascheduler.la
 
 # Header files to ignore when scanning.
-IGNORE_HFILES=
+IGNORE_HFILES= \
+	gettext.h \
+	gst-i18n-lib.h \
+	gst-i18n-app.h \
+	gst_private.h \
+	gstatomic_impl.h \
+	gstdata_private.h \
+	gstarch.h \
+	cothreads.h \
+	schedulers/cothreads_compat.h \
+	schedulers/gthread-cothreads.h \
+	parse/types.h \
+	elements/gstaggregator.h \
+	elements/gstbufferstore.h \
+	elements/gstfakesink.h \
+	elements/gstfakesrc.h \
+	elements/gstfdsink.h \
+	elements/gstfdsrc.h \
+	elements/gstfilesink.h \
+	elements/gstfilesrc.h \
+	elements/gstidentity.h \
+	elements/gstmd5sink.h \
+	elements/gstmultifilesrc.h \
+	elements/gstpipefilter.h \
+	elements/gstshaper.h \
+	elements/gststatistics.h \
+	elements/gsttee.h \
+	elements/gsttypefind.h
 
 # Images to copy into HTML directory.
 HTML_IMAGES =

docs/gst/gstreamer-docs.sgml

@@ -47,7 +47,6 @@
 <!-- these are elements without API docs
 <!ENTITY GstQueue SYSTEM "xml/gstqueue.xml">
 -->
-<!ENTITY cothreads SYSTEM "xml/cothreads.xml">
 
 <!ENTITY GstAggregator SYSTEM "xml/gstaggregator.xml">
 <!ENTITY GstFakeSrc SYSTEM "xml/gstfakesrc.xml">
@@ -125,7 +124,6 @@ with some more specialized elements.</para>
     <para>
     </para>
 
-    &cothreads;
     &GstAtomic;
     &GstMemChunk;
 

docs/gst/gstreamer-sections.txt

@@ -174,6 +174,7 @@ gst_clock_reset
 gst_clock_handle_discont
 gst_clock_get_time
 gst_clock_get_event_time
+gst_clock_get_event_time_delay
 gst_clock_get_next_id
 gst_clock_new_single_shot_id
 gst_clock_new_periodic_id
@@ -307,6 +308,7 @@ gst_element_clock_wait
 gst_element_get_time
 gst_element_wait
 gst_element_set_time
+gst_element_set_time_delay
 gst_element_adjust_time
 gst_element_is_indexable
 gst_element_set_index
@@ -394,6 +396,7 @@ GST_ELEMENT_GET_CLASS
 <SECTION>
 <FILE>gstevent</FILE>
 GstEventType
+GST_EVENT_ANY
 GST_EVENT_TRACE_NAME
 GST_EVENT_TYPE
 GST_EVENT_TIMESTAMP
@@ -1465,32 +1468,6 @@ GST_XML_REGISTRY_CLASS
 GST_IS_XML_REGISTRY_CLASS
 </SECTION>
 
-<SECTION>
-<FILE>cothreads</FILE>
-cothread_state
-cothread_context
-cothread_func
-COTHREAD_STARTED
-COTHREAD_DESTROYED
-cothread_context_init
-cothread_context_free
-cothread_context_set_data
-cothread_context_get_data
-cothread_create
-cothread_free
-cothread_setfunc
-cothread_stop
-cothread_switch
-cothread_set_private
-cothread_get_private
-cothread_lock
-cothread_trylock
-cothread_unlock
-cothread_main
-cothread_current_main
-cothread_current
-</SECTION>
-
 <SECTION>
 <FILE>gst</FILE>
 gst_init
@@ -1504,46 +1481,6 @@ gst_main
 gst_main_quit
 </SECTION>
 
-<SECTION>
-<FILE>gst_private</FILE>
-GST_CAT_GST_INIT
-GST_CAT_COTHREADS
-GST_CAT_COTHREAD_SWITCH
-GST_CAT_AUTOPLUG
-GST_CAT_AUTOPLUG_ATTEMPT
-GST_CAT_PARENTAGE
-GST_CAT_STATES
-GST_CAT_PLANNING
-GST_CAT_SCHEDULING
-GST_CAT_DATAFLOW
-GST_CAT_BUFFER
-GST_CAT_CAPS
-GST_CAT_CLOCK
-GST_CAT_ELEMENT_PADS
-GST_CAT_PADS
-GST_CAT_PIPELINE
-GST_CAT_PLUGIN_LOADING
-GST_CAT_PLUGIN_INFO
-GST_CAT_PROPERTIES
-GST_CAT_THREAD
-GST_CAT_XML
-GST_CAT_NEGOTIATION
-GST_CAT_REFCOUNTING
-GST_CAT_ERROR_SYSTEM
-GST_CAT_EVENT
-GST_CAT_PARAMS
-GST_CAT_CALL_TRACE
-</SECTION>
-
-<SECTION>
-<FILE>gstarch</FILE>
-GST_ARCH_SET_SP
-GST_ARCH_CALL
-GST_ARCH_SETUP_STACK
-GST_ARCH_PRESETJMP
-USE_MAKECONTEXT
-</SECTION>
-
 <SECTION>
 <FILE>gstatomic</FILE>
 gst_vgint
@@ -1557,14 +1494,6 @@ gst_atomic_int_inc
 gst_atomic_int_dec_and_test
 </SECTION>
 
-<SECTION>
-<FILE>gstatomic_impl</FILE>
-SMP_LOCK
-SMP_SYNC
-SMP_ISYNC
-PPC405_ERR77
-</SECTION>
-
 <SECTION>
 <FILE>gstenumtypes</FILE>
 gst_object_flags_get_type
@@ -1696,10 +1625,6 @@ GstCPUFlags
 gst_cpu_get_flags
 </SECTION>
 
-<SECTION>
-<FILE>gstdata_private</FILE>
-</SECTION>
-
 <SECTION>
 <FILE>gstfilter</FILE>
 GstFilterFunc
@@ -2080,20 +2005,6 @@ GST_VERSION_MICRO
 gst_version
 </SECTION>
 
-<SECTION>
-<FILE>gettext</FILE>
-gettext
-dgettext
-dcgettext
-ngettext
-dngettext
-dcngettext
-textdomain
-bindtextdomain
-bind_textdomain_codeset
-gettext_noop
-</SECTION>
-
 <SECTION>
 <FILE>gsterror</FILE>
 GstCoreError
@@ -2114,18 +2025,6 @@ gst_resource_error_quark
 gst_library_error_quark
 </SECTION>
 
-<SECTION>
-<FILE>gst-i18n-app</FILE>
-_
-N_
-</SECTION>
-
-<SECTION>
-<FILE>gst-i18n-lib</FILE>
-_
-N_
-</SECTION>
-
 <SECTION>
 <FILE>gstsearchfuncs</FILE>
 GST_AUTOPLUG_MAX_COST
@@ -2161,6 +2060,7 @@ gst_parse_chain_free
 
 <SECTION>
 <FILE>cothreads_compat</FILE>
+COTHREADS_TYPE
 COTHREADS_NAME
 COTHREADS_NAME_CAPITAL
 cothread
@@ -2180,6 +2080,7 @@ do_cothread_get_main
 
 <SECTION>
 <FILE>gthread-cothreads</FILE>
+COTHREADS_TYPE
 COTHREADS_NAME
 COTHREADS_NAME_CAPITAL
 cothread_func
@@ -2190,5 +2091,6 @@ do_cothread_lock
 do_cothread_unlock
 do_cothread_get_current
 do_cothread_get_main
+do_cothread_setfunc
 </SECTION>
 

docs/gst/tmpl/cothreads_compat.sgml

@@ -14,6 +14,13 @@ cothreads_compat
 
 </para>
 
+<!-- ##### MACRO COTHREADS_TYPE ##### -->
+<para>
+
+</para>
+
+
+
 <!-- ##### MACRO COTHREADS_NAME ##### -->
 <para>
 

docs/gst/tmpl/gstcaps.sgml

@@ -170,8 +170,10 @@ Structure describing sets of media formats
 
 </para>
 
-@caps: 
+@static_caps: 
 @Returns: 
+<!-- # Unused Parameters # -->
+@caps: 
 
 
 <!-- ##### FUNCTION gst_caps_append ##### -->
@@ -188,8 +190,10 @@ Structure describing sets of media formats
 
 </para>
 
-@caps1: 
+@caps: 
 @structure: 
+<!-- # Unused Parameters # -->
+@caps1: 
 
 
 <!-- ##### FUNCTION gst_caps_split_one ##### -->

docs/gst/tmpl/gstclock.sgml

@@ -329,6 +329,16 @@ Get the clock flags
 @Returns: 
 
 
+<!-- ##### FUNCTION gst_clock_get_event_time_delay ##### -->
+<para>
+
+</para>
+
+@clock: 
+@delay: 
+@Returns: 
+
+
 <!-- ##### FUNCTION gst_clock_get_next_id ##### -->
 <para>
 

docs/gst/tmpl/gstelement.sgml

@@ -591,6 +591,16 @@ Sets the parent of an element.
 @time: 
 
 
+<!-- ##### FUNCTION gst_element_set_time_delay ##### -->
+<para>
+
+</para>
+
+@element: 
+@time: 
+@delay: 
+
+
 <!-- ##### FUNCTION gst_element_adjust_time ##### -->
 <para>
 
@@ -1175,10 +1185,12 @@ Sets the parent of an element.
 </para>
 
 @plugin: 
-@elementname: 
+@name: 
 @rank: 
 @type: 
 @Returns: 
+<!-- # Unused Parameters # -->
+@elementname: 
 
 
 <!-- ##### FUNCTION gst_element_factory_find ##### -->

docs/gst/tmpl/gstevent.sgml

@@ -50,6 +50,13 @@ The different major types of events.
 @GST_EVENT_NAVIGATION: 
 @GST_EVENT_TAG: 
 
+<!-- ##### MACRO GST_EVENT_ANY ##### -->
+<para>
+
+</para>
+
+
+
 <!-- ##### MACRO GST_EVENT_TRACE_NAME ##### -->
 <para>
 The name used for memory allocation tracing

docs/gst/tmpl/gstpad.sgml

@@ -1048,6 +1048,8 @@ Check if the properties of the padtemplate are fixed
 </para>
 
 @pad: 
+@bufalloc: 
+<!-- # Unused Parameters # -->
 @bufferalloc: 
 
 
@@ -1718,8 +1720,10 @@ Remove the probe from the pad
 
 </para>
 
-@templ: 
+@pad_template: 
 @Returns: 
+<!-- # Unused Parameters # -->
+@templ: 
 
 
 <!-- ##### FUNCTION gst_pad_template_get_caps ##### -->

docs/gst/tmpl/gstutils.sgml

@@ -70,6 +70,56 @@ Some convenience functions
 @type: 
 @type_as_function: 
 @parent_type: 
+@\
+    parent_type_macro:
+@\
+    parent_type_macro:
+@\
+    parent_type_macro:
+@\
+    parent_type_macro:
+@\
+    parent_type_macro:
+@\
+    parent_type_macro:
+@\
+    parent_type_macro:
+@\
+    parent_type_macro:
+@\
+    parent_type_macro:
+@\
+    parent_type_macro:
+@\
+    parent_type_macro:
+@\
+    parent_type_macro:
+@\
+    parent_type_macro:
+@\
+    parent_type_macro:
+@\
+    parent_type_macro:
+@\
+    parent_type_macro:
+@\
+    parent_type_macro:
+@\
+    parent_type_macro:
+@\
+    parent_type_macro:
+@\
+    parent_type_macro:
+@\
+    parent_type_macro:
+@\
+    parent_type_macro:
+@\
+    parent_type_macro:
+@\
+    parent_type_macro:
+@\
+    parent_type_macro:
 @\
     parent_type_macro:
 @\

docs/gst/tmpl/gstxml.sgml

@@ -115,6 +115,10 @@ GstXML
 
 </para>
 
+@: 
+@: 
+@:
+
 @gstxml: the object which received the signal.
 @arg1: 
 @arg2: 
@@ -124,7 +128,7 @@ GstXML
 
 </para>
 
-@: 
+@gstxml: the object which received the signal.
-@: 
+@arg1: 
-@: 
+@arg2: 
 

docs/gst/tmpl/gthread-cothreads.sgml

@@ -14,6 +14,13 @@ gthread-cothreads
 
 </para>
 
+<!-- ##### MACRO COTHREADS_TYPE ##### -->
+<para>
+
+</para>
+
+
+
 <!-- ##### MACRO COTHREADS_NAME ##### -->
 <para>
 
@@ -33,9 +40,12 @@ gthread-cothreads
 
 </para>
 
+@Varargs: 
+@Param2: 
+@Returns: 
+<!-- # Unused Parameters # -->
 @argc: 
 @argv: 
-@Returns: 
 
 
 <!-- ##### TYPEDEF cothread ##### -->
@@ -99,3 +109,15 @@ gthread-cothreads
 @context: 
 
 
+<!-- ##### MACRO do_cothread_setfunc ##### -->
+<para>
+
+</para>
+
+@cothread: 
+@context: 
+@func: 
+@argc: 
+@argv: 
+
+

docs/random/ds/0.9-suggested-changes

@@ -34,6 +34,8 @@ API:
 
  - caps should have a flag on fields to indicate that the field is optional
 
+ - remove gst_pad_select() and add gst_pad_pull_many(), which pulls one
+   buffer from one of many pads
 
 caps:
 

gst/elements/gstfakesink.h

@@ -47,7 +47,7 @@ typedef enum {
   FAKESINK_STATE_ERROR_PAUSED_PLAYING,
   FAKESINK_STATE_ERROR_PLAYING_PAUSED,
   FAKESINK_STATE_ERROR_PAUSED_READY,
-  FAKESINK_STATE_ERROR_READY_NULL,
+  FAKESINK_STATE_ERROR_READY_NULL
 } GstFakeSinkStateError;
 
 typedef struct _GstFakeSink GstFakeSink;

gst/elements/gstfakesrc.h

@@ -42,7 +42,7 @@ typedef enum {
 
 typedef enum {
   FAKESRC_DATA_ALLOCATE = 1,
-  FAKESRC_DATA_SUBBUFFER,
+  FAKESRC_DATA_SUBBUFFER
 } GstFakeSrcDataType;
 
 typedef enum {

gst/gstcaps.c

@@ -107,6 +107,7 @@ gst_caps_new_any (void)
 /**
  * gst_caps_new_simple:
  * @media_type: the media type of the structure
+ * @fieldname: first field to set
  * @...: additional arguments
  *
  * Creates a new #GstCaps that contains one #GstStructure.  The
@@ -161,7 +162,7 @@ gst_caps_new_full (GstStructure * struct1, ...)
 
 /**
  * gst_caps_new_full_valist:
- * @struct1: the first structure to add
+ * @structure: the first structure to add
  * @var_args: additional structures to add
  *
  * Creates a new #GstCaps and adds all the structures listed as
@@ -310,7 +311,7 @@ gst_caps_append (GstCaps * caps1, GstCaps * caps2)
  * @caps: the #GstCaps that will be appended to
  * @structure: the #GstStructure to append
  *
- * Appends @structure to @caps1.  The structure is not copied; @caps1
+ * Appends @structure to @caps.  The structure is not copied; @caps
  * becomes the owner of @structure.
  */
 void
@@ -1164,7 +1165,7 @@ gst_caps_from_string_inplace (GstCaps * caps, const gchar * string)
 
 /**
  * gst_caps_from_string:
- * @caps: a string to convert to #GstCaps
+ * @string: a string to convert to #GstCaps
  *
  * Converts @caps from a string representation.
  *

gst/gstcaps.h

@@ -81,12 +81,12 @@ GstCaps *                gst_caps_new_full_valist                       (GstStru
 									 va_list        var_args);
 GstCaps *                gst_caps_copy                                  (const GstCaps *caps);
 void                     gst_caps_free                                  (GstCaps       *caps);
-G_CONST_RETURN GstCaps * gst_static_caps_get                            (GstStaticCaps *caps);
+G_CONST_RETURN GstCaps * gst_static_caps_get                            (GstStaticCaps *static_caps);
 
 /* manipulation */
 void                     gst_caps_append                                (GstCaps       *caps1,
 									 GstCaps       *caps2);
-void                     gst_caps_append_structure                      (GstCaps       *caps1,
+void                     gst_caps_append_structure                      (GstCaps       *caps,
 									 GstStructure  *structure);
 GstCaps *                gst_caps_split_one                             (GstCaps       *caps);
 int                      gst_caps_get_size                              (const GstCaps *caps);

gst/gstelement.c

@@ -931,7 +931,7 @@ gst_element_set_time_delay (GstElement * element, GstClockTime time,
 /**
  * gst_element_adjust_time:
  * @element: element to adjust time on
- * @difference: difference to adjust
+ * @diff: difference to adjust
  *
  * Adjusts the current time of the element by the specified difference. This 
  * function can be used when handling discont events. You can only call this 
@@ -2446,8 +2446,11 @@ _gst_element_error_printf (const gchar * format, ...)
  * @code: the error code belonging to the domain
  * @message: an allocated message to be used as a replacement for the default
  *           message connected to code, or NULL
- * debug: an allocated debug message to be used as a replacement for the
+ * @debug: an allocated debug message to be used as a replacement for the
  *        default debugging information, or NULL
+ * @file: source filename
+ * @function: source function
+ * @line: source line
  *
  * Signals an error condition on an element.
  * This function is used internally by elements.

gst/gstelement.h

@@ -433,7 +433,7 @@ struct _GstElementFactoryClass {
 GType 			gst_element_factory_get_type 		(void);
 
 gboolean		gst_element_register			(GstPlugin *plugin,
-								 const gchar *elementname,
+								 const gchar *name,
 								 guint rank,
 								 GType type);
 

gst/gstindex.c

@@ -412,6 +412,8 @@ gst_index_set_resolver (GstIndex * index,
  * @entry: the entry to copy
  *
  * Copies an entry and returns the result.
+ *
+ * Returns:
  */
 GstIndexEntry *
 gst_index_entry_copy (GstIndexEntry * entry)

gst/gstinfo.c

@@ -319,6 +319,8 @@ gst_debug_log_valist (GstDebugCategory * category, GstDebugLevel level,
  *
  * Gets the string representation of a GstDebugMessage. This function is used
  * in debug handlers to extract the message.
+ *
+ * Returns: the string representation
  */
 const gchar *
 gst_debug_message_get (GstDebugMessage * message)

gst/gstpad.c

@@ -2262,6 +2262,7 @@ gst_pad_proxy_getcaps (GstPad * pad)
 /**
  * gst_pad_proxy_pad_link:
  * @pad: a #GstPad to proxy.
+ * @caps: the #GstCaps to link with
  *
  * Calls gst_pad_try_set_caps() for every other pad belonging to the
  * same element as @pad.  If gst_pad_try_set_caps() fails on any pad,
@@ -2303,6 +2304,7 @@ gst_pad_proxy_pad_link (GstPad * pad, const GstCaps * caps)
 /**
  * gst_pad_proxy_fixate:
  * @pad: a #GstPad to proxy.
+ * @caps: the #GstCaps to fixate
  *
  * Implements a default fixate function based on the caps set on the other
  * pads in the element.  This function should only be used if every pad
@@ -2756,13 +2758,14 @@ gst_pad_recover_caps_error (GstPad * pad, const GstCaps * allowed)
   return FALSE;
 }
 
-/* FIXME 0.9: Is it so difficult to write SOURCE? */
 /**
  * gst_pad_alloc_buffer:
  * @pad: a source #GstPad.
+ * @offset: the offset of the new buffer in the stream
+ * @size: the size of the new buffer
  *
  * Allocates a new, empty buffer optimized to push to pad @pad.  This
- * function only works if @pad is a src pad.
+ * function only works if @pad is a source pad.
  *
  * Returns: a new, empty #GstBuffer, or NULL if there is an error
  */

gst/gstpad.h

@@ -381,7 +381,7 @@ GList*			gst_pad_get_ghost_pad_list		(GstPad *pad);
 
 GstPadTemplate*		gst_pad_get_pad_template		(GstPad *pad);
 
-void			gst_pad_set_bufferalloc_function		(GstPad *pad, GstPadBufferAllocFunction bufferalloc);
+void			gst_pad_set_bufferalloc_function		(GstPad *pad, GstPadBufferAllocFunction bufalloc);
 GstBuffer*		gst_pad_alloc_buffer			(GstPad *pad, guint64 offset, gint size);
 
 /* data passing setup functions */
@@ -504,7 +504,7 @@ GstPadTemplate*		gst_pad_template_new			(const gchar *name_template,
 		                                        	 GstPadDirection direction, GstPadPresence presence,
 								 GstCaps *caps);
 
-GstPadTemplate *	gst_static_pad_template_get             (GstStaticPadTemplate *templ);
+GstPadTemplate *	gst_static_pad_template_get             (GstStaticPadTemplate *pad_template);
 const GstCaps*		gst_pad_template_get_caps		(GstPadTemplate *templ);
 const GstCaps*		gst_pad_template_get_caps_by_name	(GstPadTemplate *templ, const gchar *name);
 

gst/gstplugin.c

@@ -277,7 +277,7 @@ static void _gst_plugin_fault_handler_setup ();
 
 /**
  * gst_plugin_load_file:
- * @plugin: The plugin to load
+ * @filename: The file to load
  * @error: Pointer to a NULL-valued GError.
  *
  * Load the given plugin.

gst/gsttypefind.h

@@ -49,7 +49,7 @@ typedef enum {
   GST_TYPE_FIND_POSSIBLE = 50,
   GST_TYPE_FIND_LIKELY = 80,
   GST_TYPE_FIND_NEARLY_CERTAIN = 99,
-  GST_TYPE_FIND_MAXIMUM = 100,
+  GST_TYPE_FIND_MAXIMUM = 100
 } GstTypeFindProbability;
 
 struct _GstTypeFind {

gst/gsturi.c

@@ -116,7 +116,7 @@ gst_uri_protocol_is_valid (const gchar * protocol)
 
 /**
  * gst_uri_is_valid:
- * @protocol: string to check
+ * @uri: string to check
  *
  * Tests if the given string is a valid URI identifier. URIs start with a valid
  * protocol followed by "://" and a string identifying the location.

gst/gstvalue.c

@@ -157,7 +157,7 @@ gst_value_list_prepend_value (GValue * value, const GValue * prepend_value)
 /**
  * gst_value_list_append_value:
  * @value: a GstValueList to append a value to
- * @apppend_value: the value to append
+ * @append_value: the value to append
  *
  * Appends @append_value to the GstValueList in @value.
  */
@@ -188,7 +188,7 @@ gst_value_list_get_size (const GValue * value)
 /**
  * gst_value_list_get_value:
  * @value: a GstValueList
- * @index
+ * @index: the index
  *
  * Gets the value that is a member of the list contained in @value and
  * has the index @index.
@@ -1285,7 +1285,10 @@ gst_value_register_union_func (GType type1, GType type2, GstValueUnionFunc func)
 
 /**
  * gst_value_can_intersect:
+ * @value1:
+ * @value2:
  *
+ * Returns:
  */
 gboolean
 gst_value_can_intersect (const GValue * value1, const GValue * value2)
@@ -1357,6 +1360,9 @@ gst_value_intersect (GValue * dest, const GValue * value1,
 
 /**
  * gst_value_register_intersection_func:
+ * @type1:
+ * @type2:
+ * @func:
  *
  */
 void
@@ -1374,6 +1380,7 @@ gst_value_register_intersect_func (GType type1, GType type2,
 
 /**
  * gst_value_register:
+ * @table:
  *
  */
 void
@@ -1384,6 +1391,8 @@ gst_value_register (const GstValueTable * table)
 
 /**
  * gst_value_init_and_copy:
+ * @dest:
+ * @src:
  *
  */
 void
@@ -1395,7 +1404,9 @@ gst_value_init_and_copy (GValue * dest, const GValue * src)
 
 /**
  * gst_value_serialize:
+ * @value:
  *
+ * Returns:
  */
 gchar *
 gst_value_serialize (const GValue * value)
@@ -1423,7 +1434,10 @@ gst_value_serialize (const GValue * value)
 
 /**
  * gst_value_deserialize:
+ * @dest:
+ * @src:
  *
+ * Returns:
  */
 gboolean
 gst_value_deserialize (GValue * dest, const gchar * src)

plugins/elements/gstfakesink.h

@@ -47,7 +47,7 @@ typedef enum {
   FAKESINK_STATE_ERROR_PAUSED_PLAYING,
   FAKESINK_STATE_ERROR_PLAYING_PAUSED,
   FAKESINK_STATE_ERROR_PAUSED_READY,
-  FAKESINK_STATE_ERROR_READY_NULL,
+  FAKESINK_STATE_ERROR_READY_NULL
 } GstFakeSinkStateError;
 
 typedef struct _GstFakeSink GstFakeSink;

plugins/elements/gstfakesrc.h

@@ -42,7 +42,7 @@ typedef enum {
 
 typedef enum {
   FAKESRC_DATA_ALLOCATE = 1,
-  FAKESRC_DATA_SUBBUFFER,
+  FAKESRC_DATA_SUBBUFFER
 } GstFakeSrcDataType;
 
 typedef enum {