diff --git a/gst/gst.c b/gst/gst.c
index 37ab6a8065..ea9ee3966a 100644
--- a/gst/gst.c
+++ b/gst/gst.c
@@ -19,11 +19,13 @@
* Free Software Foundation, Inc., 59 Temple Place - Suite 330,
* Boston, MA 02111-1307, USA.
*/
+
/**
* SECTION:gst
- * @short_description: Media library supporting arbitrary formats and filter graphs.
+ * @short_description: Media library supporting arbitrary formats and filter
+ * graphs.
* @see_also: Check out both OGI's
- * pipeline and Microsoft's DirectShow for some background.
+ * pipeline and Microsoft's DirectShow for some background.
*
* GStreamer is a framework for constructing graphs of various filters
* (termed elements here) that will handle streaming media. Any discreet
@@ -57,8 +59,8 @@
*
*
*
- * It's allowed to pass two NULL pointers to gst_init() in case you don't want to
- * pass the command line args to GStreamer.
+ * It's allowed to pass two NULL pointers to gst_init() in case you don't want
+ * to pass the command line args to GStreamer.
*
* You can also use a popt table to initialize your own parameters as shown in
* the next code fragment:
@@ -85,8 +87,8 @@
*
*
*
- * Use gst_version() to query the library version at runtime or use the GST_VERSION_* macros
- * to find the version at compile time.
+ * Use gst_version() to query the library version at runtime or use the
+ * GST_VERSION_* macros to find the version at compile time.
*
* The functions gst_main() and gst_main_quit() enter and exit the main loop.
* GStreamer doesn't currently require you to use a mainloop but can intergrate
diff --git a/gst/gstbin.c b/gst/gstbin.c
index 04f4b1113e..8873cade67 100644
--- a/gst/gstbin.c
+++ b/gst/gstbin.c
@@ -22,6 +22,7 @@
*
* MT safe.
*/
+
/**
* SECTION:gstbin
* @short_description: Base class for elements that contain other elements
diff --git a/gst/gstbuffer.c b/gst/gstbuffer.c
index 249135fe28..6be177eb1f 100644
--- a/gst/gstbuffer.c
+++ b/gst/gstbuffer.c
@@ -19,6 +19,7 @@
* Free Software Foundation, Inc., 59 Temple Place - Suite 330,
* Boston, MA 02111-1307, USA.
*/
+
/**
* SECTION:gstbuffer
* @short_description: Data-passing buffer type, supporting sub-buffers.
@@ -75,12 +76,13 @@
* a buffer that is safe to modify by using gst_buffer_make_writable(). This
* function is optimized so that a copy will only be made when it is necessary.
*
- * Several flags of the buffer can be set and unset with the GST_BUFFER_FLAG_SET()
- * and GST_BUFFER_FLAG_UNSET() macros. Use GST_BUFFER_FLAG_IS_SET() to test it
- * a certain #GstBufferFlag is set.
+ * Several flags of the buffer can be set and unset with the
+ * GST_BUFFER_FLAG_SET() and GST_BUFFER_FLAG_UNSET() macros. Use
+ * GST_BUFFER_FLAG_IS_SET() to test it a certain #GstBufferFlag is set.
*
- * Buffers can be efficiently merged into a larger buffer with gst_buffer_merge()
- * and gst_buffer_span() if the gst_buffer_is_span_fast() function returns TRUE.
+ * Buffers can be efficiently merged into a larger buffer with
+ * gst_buffer_merge() and gst_buffer_span() if the gst_buffer_is_span_fast()
+ * function returns TRUE.
*
* An element should either unref the buffer or push it out on a src pad
* using gst_pad_push() (see #GstPad).
diff --git a/gst/gstbus.c b/gst/gstbus.c
index a3092c4482..a402c67cd8 100644
--- a/gst/gstbus.c
+++ b/gst/gstbus.c
@@ -18,6 +18,7 @@
* Free Software Foundation, Inc., 59 Temple Place - Suite 330,
* Boston, MA 02111-1307, USA.
*/
+
/**
* SECTION:gstbus
* @short_description: Asynchronous message bus subsystem
@@ -45,9 +46,9 @@
* up to the specified timeout value until one of the specified messages types
* is posted on the bus. The application can then _pop() the messages from the
* bus to handle them.
- * Alternatively the application can register an asynchronous bus function using
- * gst_bus_add_watch_full() or gst_bus_add_watch(). This function will receive
- * messages a short while after they have been posted.
+ * Alternatively the application can register an asynchronous bus function
+ * using gst_bus_add_watch_full() or gst_bus_add_watch(). This function will
+ * receive messages a short while after they have been posted.
*
* It is also possible to get messages from the bus without any thread
* marshalling with the gst_bus_set_sync_handler() method. This makes it
@@ -57,8 +58,8 @@
*
* Every #GstPipeline has one bus.
*
- * Note that a #GstPipeline will set its bus into flushing state when changing from
- * READY to NULL state.
+ * Note that a #GstPipeline will set its bus into flushing state when changing
+ * from READY to NULL state.
*/
#include
diff --git a/gst/gstcaps.c b/gst/gstcaps.c
index ae85313458..ef31954f7b 100644
--- a/gst/gstcaps.c
+++ b/gst/gstcaps.c
@@ -16,6 +16,7 @@
* Free Software Foundation, Inc., 59 Temple Place - Suite 330,
* Boston, MA 02111-1307, USA.
*/
+
/**
* SECTION:gstcaps
* @short_description: Structure describing sets of media formats
diff --git a/gst/gstchildproxy.c b/gst/gstchildproxy.c
index 4f88c445eb..c61aa4deac 100644
--- a/gst/gstchildproxy.c
+++ b/gst/gstchildproxy.c
@@ -18,6 +18,7 @@
* Free Software Foundation, Inc., 59 Temple Place - Suite 330,
* Boston, MA 02111-1307, USA.
*/
+
/**
* SECTION:gstchildproxy
* @short_description: Interface for multi child elements.
@@ -25,8 +26,8 @@
*
* This interface abstracts handling of property sets for child elements.
* Imagine elements such as mixers or polyphonic generators. They all have
- * multiple #GstPads or some kind of voice objects. The element acts as a parent
- * for those child objects. Each child has the same properties.
+ * multiple #GstPads or some kind of voice objects. The element acts as a
+ * parent for those child objects. Each child has the same properties.
*
* By implementing this interface the child properties can be accessed from the
* parent element by using gst_child_proxy_get() and gst_child_proxy_set().
diff --git a/gst/gstclock.c b/gst/gstclock.c
index 3a2de83c9e..00f2e1a16e 100644
--- a/gst/gstclock.c
+++ b/gst/gstclock.c
@@ -20,6 +20,7 @@
* Free Software Foundation, Inc., 59 Temple Place - Suite 330,
* Boston, MA 02111-1307, USA.
*/
+
/**
* SECTION:gstclock
* @short_description: Abstract class for global clocks
@@ -36,6 +37,7 @@
*
* The time of the clock in itself is not very useful for an application.
*/
+
#include
#include "gst_private.h"
diff --git a/gst/gstconfig.h.in b/gst/gstconfig.h.in
index 13483cdd11..46363c88aa 100644
--- a/gst/gstconfig.h.in
+++ b/gst/gstconfig.h.in
@@ -24,7 +24,7 @@
* SECTION:gstconfig
* @short_description: Build configuration options
*
- * This describes the configuration options for GStreamer. When building
+ * This describes the configuration options for GStreamer. When building
* GStreamer there are a lot of parts (known internally as "subsystems" ) that
* can be disabled for various reasons. The most common reasons are speed and
* size, which is important because GStreamer is designed to run on embedded
@@ -34,8 +34,8 @@
* compatible way, so you don't need to adapt your code in most cases. It is
* never done in an ABI compatible way though. So if you want to disable a
* suybsystem, you have to rebuild all programs depending on GStreamer, too.
- *
- * If a subsystem is disabled in GStreamer, a value is defined in
+ *
+ * If a subsystem is disabled in GStreamer, a value is defined in
* <gst/gst.h>. You can check this if you do subsystem-specific stuff.
*
* Doing subsystem specific things
diff --git a/gst/gstelement.c b/gst/gstelement.c
index d048380353..1d90bd609a 100644
--- a/gst/gstelement.c
+++ b/gst/gstelement.c
@@ -19,6 +19,7 @@
* Free Software Foundation, Inc., 59 Temple Place - Suite 330,
* Boston, MA 02111-1307, USA.
*/
+
/**
* SECTION:gstelement
* @short_description: Abstract base class for all pipeline elements
@@ -64,11 +65,12 @@
* gst_element_provides_clock() returns TRUE. With the gst_element_provide_clock()
* method one can retrieve the clock provided by such an element.
* Not all elements require a clock to operate correctly. If
- * gst_element_requires_clock() returns TRUE, a clock should be set on the element
- * with gst_element_set_clock().
+ * gst_element_requires_clock() returns TRUE, a clock should be set on the
+ * element with gst_element_set_clock().
*
- * Note that clock slection and distribution is normally handled by the toplevel
- * #GstPipeline so the clock functions are only to be used in very specific situations.
+ * Note that clock slection and distribution is normally handled by the
+ * toplevel #GstPipeline so the clock functions are only to be used in very
+ * specific situations.
*/
#include "gst_private.h"
diff --git a/gst/gstelementfactory.c b/gst/gstelementfactory.c
index c0a0cd01b1..dc99d23600 100644
--- a/gst/gstelementfactory.c
+++ b/gst/gstelementfactory.c
@@ -20,24 +20,26 @@
* Free Software Foundation, Inc., 59 Temple Place - Suite 330,
* Boston, MA 02111-1307, USA.
*/
+
/**
* SECTION:gstelementfactory
* @short_description: Create GstElements from a factory
* @see_also: #GstElement, #GstPlugin, #GstPluginFeature, #GstPadTemplate.
*
- * GstElementFactory is used to create instances of elements. A GstElementfactory
- * can be added to a #GstPlugin as it is also a #GstPluginFeature.
+ * GstElementFactory is used to create instances of elements. A
+ * GstElementfactory can be added to a #GstPlugin as it is also a
+ * #GstPluginFeature.
*
- * Use gst_element_factory_new() to create a new factory which can be added to a
- * plugin with gst_plugin_add_feature().
+ * Use gst_element_factory_new() to create a new factory which can be added to
+ * a plugin with gst_plugin_add_feature().
*
- * gst_element_factory_add_pad_template() is used to add a padtemplate to the factory.
- * This function will enable the application to query for elementfactories that handle
- * a specific media type.
+ * gst_element_factory_add_pad_template() is used to add a padtemplate to the
+ * factory. This function will enable the application to query for
+ * elementfactories that handle a specific media type.
*
- * Use the gst_element_factory_find() and gst_element_factory_create() functions
- * to create element instances or use gst_element_factory_make() as a convenient
- * shortcut.
+ * Use the gst_element_factory_find() and gst_element_factory_create()
+ * functions to create element instances or use gst_element_factory_make() as a
+ * convenient shortcut.
*
* The following code example shows you how to create a GstFileSrc element.
*
diff --git a/gst/gsterror.c b/gst/gsterror.c
index 1b4f1cc416..30640d2719 100644
--- a/gst/gsterror.c
+++ b/gst/gsterror.c
@@ -16,6 +16,7 @@
* Free Software Foundation, Inc., 59 Temple Place - Suite 330,
* Boston, MA 02111-1307, USA.
*/
+
/**
* SECTION:gsterror
* @short_description: Categorized error messages
diff --git a/gst/gstevent.c b/gst/gstevent.c
index eb469e9138..785b68d7ba 100644
--- a/gst/gstevent.c
+++ b/gst/gstevent.c
@@ -19,6 +19,7 @@
* Free Software Foundation, Inc., 59 Temple Place - Suite 330,
* Boston, MA 02111-1307, USA.
*/
+
/**
* SECTION:gstevent
* @short_description: Structure describing events that are passed up and down
diff --git a/gst/gstfilter.c b/gst/gstfilter.c
index 56fb08a2c4..a63c451818 100644
--- a/gst/gstfilter.c
+++ b/gst/gstfilter.c
@@ -16,6 +16,7 @@
* Free Software Foundation, Inc., 59 Temple Place - Suite 330,
* Boston, MA 02111-1307, USA.
*/
+
/**
* SECTION:gstfilter
* @short_description: A utility function to filter GLists.
diff --git a/gst/gstformat.c b/gst/gstformat.c
index 099771a0b4..7695de01b0 100644
--- a/gst/gstformat.c
+++ b/gst/gstformat.c
@@ -20,13 +20,15 @@
* Free Software Foundation, Inc., 59 Temple Place - Suite 330,
* Boston, MA 02111-1307, USA.
*/
+
/**
* SECTION:gstformat
* @short_description: Dynamically register new data formats
* @see_also: #GstPad, #GstElement
*
- * GstFormats functions are used to register a new format to the gstreamer core.
- * Formats can be used to perform seeking or conversions/query operations.
+ * GstFormats functions are used to register a new format to the gstreamer
+ * core. Formats can be used to perform seeking or conversions/query
+ * operations.
*/
#include
diff --git a/gst/gstghostpad.c b/gst/gstghostpad.c
index 1ff4cfc5cd..97652c150d 100644
--- a/gst/gstghostpad.c
+++ b/gst/gstghostpad.c
@@ -20,6 +20,7 @@
* Free Software Foundation, Inc., 59 Temple Place - Suite 330,
* Boston, MA 02111-1307, USA.
*/
+
/**
* SECTION:gstghostpad
* @short_description: Pseudo link pads
diff --git a/gst/gstindex.c b/gst/gstindex.c
index b88a5cc479..046ce669d1 100644
--- a/gst/gstindex.c
+++ b/gst/gstindex.c
@@ -19,6 +19,7 @@
* Free Software Foundation, Inc., 59 Temple Place - Suite 330,
* Boston, MA 02111-1307, USA.
*/
+
/**
* SECTION:gstindex
* @short_description: Generate indexes on objects
diff --git a/gst/gstindexfactory.c b/gst/gstindexfactory.c
index 6b06d6bbdd..ed8bfb6e18 100644
--- a/gst/gstindexfactory.c
+++ b/gst/gstindexfactory.c
@@ -19,6 +19,7 @@
* Free Software Foundation, Inc., 59 Temple Place - Suite 330,
* Boston, MA 02111-1307, USA.
*/
+
/**
* SECTION:gstindexfactory
* @short_description: Create GstIndexes from a factory
diff --git a/gst/gstinfo.c b/gst/gstinfo.c
index dfb4357979..48ce5b2a57 100644
--- a/gst/gstinfo.c
+++ b/gst/gstinfo.c
@@ -20,6 +20,7 @@
* Free Software Foundation, Inc., 59 Temple Place - Suite 330,
* Boston, MA 02111-1307, USA.
*/
+
/**
* SECTION:gstinfo
* @short_description: Debugging and logging facillities
@@ -27,21 +28,19 @@
* and environment variables that affect the debugging output.
*
* GStreamer's debugging subsystem is an easy way to get information about what
- * the application is doing.
- * It is not meant for programming errors. Use GLib methods (g_warning and
- * friends) for that.
+ * the application is doing. It is not meant for programming errors. Use GLib
+ * methods (g_warning and friends) for that.
*
* The debugging subsystem works only after GStreamer has been initialized
* - for example by calling gst_init().
*
* The debugging subsystem is used to log informational messages while the
- * application runs.
- * Each messages has some properties attached to it. Among these properties
- * are the debugging category, the severity (called "level" here) and an
- * optional
- * #GObject it belongs to. Each of these messages is sent to all registered
- * debugging handlers, which then handle the messages. GStreamer attaches a
- * default handler on startup, which outputs requested messages to stderr.
+ * application runs. Each messages has some properties attached to it. Among
+ * these properties are the debugging category, the severity (called "level"
+ * here) and an optional #GObject it belongs to. Each of these messages is sent
+ * to all registered debugging handlers, which then handle the messages.
+ * GStreamer attaches a default handler on startup, which outputs requested
+ * messages to stderr.
*
* Messages are output by using shortcut macros like #GST_DEBUG,
* #GST_CAT_ERROR_OBJECT or similar. These all expand to calling gst_debug_log()
diff --git a/gst/gstinterface.c b/gst/gstinterface.c
index 271a8a4eb5..3f8c347ad9 100644
--- a/gst/gstinterface.c
+++ b/gst/gstinterface.c
@@ -20,6 +20,7 @@
* Free Software Foundation, Inc., 59 Temple Place - Suite 330,
* Boston, MA 02111-1307, USA.
*/
+
/**
* SECTION:gstimplementsinterface
* @short_description: Core interface implemented by #GstElement instances that
diff --git a/gst/gstiterator.c b/gst/gstiterator.c
index e6877fa739..62359b6c44 100644
--- a/gst/gstiterator.c
+++ b/gst/gstiterator.c
@@ -18,6 +18,7 @@
* Free Software Foundation, Inc., 59 Temple Place - Suite 330,
* Boston, MA 02111-1307, USA.
*/
+
/**
* SECTION:gstiterator
* @short_description: Object to retrieve multiple elements in a threadsafe
diff --git a/gst/gstmemchunk.c b/gst/gstmemchunk.c
index ae4a28ca78..51c3822e55 100644
--- a/gst/gstmemchunk.c
+++ b/gst/gstmemchunk.c
@@ -20,6 +20,7 @@
* Free Software Foundation, Inc., 59 Temple Place - Suite 330,
* Boston, MA 02111-1307, USA.
*/
+
/**
* SECTION:gstmemchunk
* @short_description: Atomic chunk allocator
@@ -32,6 +33,7 @@
* The GstMemChunk is used to allocate critical resources for #GstBuffer and
* #GstEvent.
*/
+
#include "gst_private.h"
#include /* memset */
diff --git a/gst/gstmessage.c b/gst/gstmessage.c
index 023ac530d3..ad25db05eb 100644
--- a/gst/gstmessage.c
+++ b/gst/gstmessage.c
@@ -18,9 +18,11 @@
* Free Software Foundation, Inc., 59 Temple Place - Suite 330,
* Boston, MA 02111-1307, USA.
*/
+
/**
* SECTION:gstmessage
- * @short_description: Lightweight objects to signal the application of pipeline events
+ * @short_description: Lightweight objects to signal the application of
+ * pipeline events
* @see_also: #GstBus,#GstMiniObject
*
* Messages are implemented as a subclass of #GstMiniObject with a generic
diff --git a/gst/gstobject.c b/gst/gstobject.c
index 8969066f82..5c46c67b6a 100644
--- a/gst/gstobject.c
+++ b/gst/gstobject.c
@@ -20,6 +20,7 @@
* Free Software Foundation, Inc., 59 Temple Place - Suite 330,
* Boston, MA 02111-1307, USA.
*/
+
/**
* SECTION:gstobject
* @short_description: Base class for the GStreamer object hierarchy
@@ -33,30 +34,31 @@
* found under the same name in the base class of GstObject which is GObject
* (e.g. g_object_ref() becomes gst_object_ref()).
*
- * The most interesting difference between GstObject and GObject is the "floating"
- * reference count. A GObject is created with a reference count of 1, owned by the
- * creator of the GObject. (The owner of a reference is the code section that has
- * the right to call gst_object_unref() in order to remove that reference.)
- * A GstObject is created with a reference count of 1 also, but it isn't owned by
- * anyone; calling gst_object_unref() on the newly-created GtkObject is incorrect.
- * Instead, the initial reference count of a GstObject is "floating". The floating
- * reference can be removed by anyone at any time, by calling gst_object_sink().
- * gst_object_sink() does nothing if an object is already sunk (has no floating
- * reference).
+ * The most interesting difference between GstObject and GObject is the
+ * "floating" reference count. A GObject is created with a reference count of
+ * 1, owned by the creator of the GObject. (The owner of a reference is the
+ * code section that has the right to call gst_object_unref() in order to
+ * remove that reference.) A GstObject is created with a reference count of 1
+ * also, but it isn't owned by anyone; calling gst_object_unref() on the
+ * newly-created GtkObject is incorrect. Instead, the initial reference count
+ * of a GstObject is "floating". The floating reference can be removed by
+ * anyone at any time, by calling gst_object_sink(). gst_object_sink() does
+ * nothing if an object is already sunk (has no floating reference).
*
- * When you add a GstElement to its parent container, the parent container will do
- * this:
+ * When you add a GstElement to its parent container, the parent container will
+ * do this:
*
*
* gst_object_ref (GST_OBJECT (child_element));
* gst_object_sink (GST_OBJECT (child_element));
*
*
- * This means that the container now owns a reference to the child element (since
- * it called gst_object_ref()), and the child element has no floating reference.
+ * This means that the container now owns a reference to the child element
+ * (since it called gst_object_ref()), and the child element has no floating
+ * reference.
*
- * The purpose of the floating reference is to keep the child element alive until
- * you add it to a parent container:
+ * The purpose of the floating reference is to keep the child element alive
+ * until you add it to a parent container:
*
*
* element = gst_element_factory_make (factoryname, name);
@@ -66,9 +68,9 @@
*
*
*
- * Another effect of this is, that calling gst_object_unref() on a bin object, will
- * also destoy all the GstElement objects in it. The same is true for calling
- * gst_bin_remove().
+ * Another effect of this is, that calling gst_object_unref() on a bin object,
+ * will also destoy all the GstElement objects in it. The same is true for
+ * calling gst_bin_remove().
*
* In contrast to GObject instances GstObject add a name property. The functions
* gst_object_set_name() and gst_object_get_name() are used to set/get the name
@@ -91,18 +93,17 @@
#define REFCOUNT_HACK
#endif
-/* Refcount hack: since glib is not threadsafe, the glib refcounter can be
+/* Refcount hack: since glib < 2.8 is not threadsafe, the glib refcounter can be
* screwed up and the object can be freed unexpectedly. We use an evil hack
* to work around this problem. We set the glib refcount to a high value so
* that glib will never unref the object under realistic circumstances. Then
* we use our own atomic refcounting to do proper MT safe refcounting.
*
* The hack has several side-effect. At first you should use
- * gst_object_ref/unref() whenever you can. Next when using g_value_set/get_object();
- * you need to manually fix the refcount.
+ * gst_object_ref/unref() whenever you can. Next when using
+ * g_value_set/get_object(); you need to manually fix the refcount.
*
- * A proper fix is of course to make the glib refcounting threadsafe which is
- * planned. Update: atomic refcounting is now in glib >= 2.7.3
+ * A proper fix is of course to upgrade to glib 2.8
*/
#ifdef REFCOUNT_HACK
#define PATCH_REFCOUNT(obj) ((GObject*)(obj))->ref_count = 100000;
diff --git a/gst/gstpad.c b/gst/gstpad.c
index 80a2642bfd..480c464c3f 100644
--- a/gst/gstpad.c
+++ b/gst/gstpad.c
@@ -21,7 +21,8 @@
*/
/**
* SECTION:gstpad
- * @short_description: Object contained by elements that allows links to other elements
+ * @short_description: Object contained by elements that allows links to
+ * other elements
* @see_also: #GstPadTemplate, #GstElement, #GstEvent
*
* A #GstElement is linked to other elements via "pads", which are extremely
@@ -34,10 +35,9 @@
* Pads are typically created from a #GstPadTemplate with
* gst_pad_new_from_template().
*
- * Pads have #GstCaps attached to it to describe the media type they are capable
- * of dealing with.
- * gst_pad_get_caps() and gst_pad_try_set_caps() are used to manipulate the caps
- * of the pads.
+ * Pads have #GstCaps attached to it to describe the media type they are
+ * capable of dealing with. gst_pad_get_caps() and gst_pad_try_set_caps() are
+ * used to manipulate the caps of the pads.
* Pads created from a pad template cannot set capabilities that are
* incompatible with the pad template capabilities.
*
diff --git a/gst/gstpadtemplate.c b/gst/gstpadtemplate.c
index 5c815a2f64..930bab76d0 100644
--- a/gst/gstpadtemplate.c
+++ b/gst/gstpadtemplate.c
@@ -19,6 +19,7 @@
* Free Software Foundation, Inc., 59 Temple Place - Suite 330,
* Boston, MA 02111-1307, USA.
*/
+
/**
* SECTION:gstpadtemplate
* @short_description: Describe the media type of a pad.
@@ -27,14 +28,14 @@
* Padtemplates describe the possible media types a pad or an elementfactory can
* handle.
*
- * Pad and PadTemplates have #GstCaps attached to it to describe the media type they
- * are capable of dealing with. gst_pad_template_get_caps() is used to get the
- * caps of a padtemplate. It's not possible to modify the caps of a padtemplate after
- * creation.
+ * Pad and PadTemplates have #GstCaps attached to it to describe the media type
+ * they are capable of dealing with. gst_pad_template_get_caps() is used to get
+ * the caps of a padtemplate. It's not possible to modify the caps of a
+ * padtemplate after creation.
*
- * Padtemplates can be created with gst_pad_template_new() or with the convenient
- * GST_PAD_TEMPLATE_FACTORY() macro. A padtemplate can be used to create a pad or
- * to add to an elementfactory.
+ * Padtemplates can be created with gst_pad_template_new() or with the
+ * convenient GST_PAD_TEMPLATE_FACTORY() macro. A padtemplate can be used to
+ * create a pad or to add to an elementfactory.
*
* The following code example shows the code to create a pad from a padtemplate.
*
@@ -44,7 +45,7 @@
* GST_STATIC_PAD_TEMPLATE (
* "sink", // the name of the pad
* GST_PAD_SINK, // the direction of the pad
- * GST_PAD_ALWAYS, // when this pad will be present
+ * GST_PAD_ALWAYS, // when this pad will be present
* GST_STATIC_CAPS ( // the capabilities of the padtemplate
* "audio/x-raw-int, "
* "channels = (int) [ 1, 6 ]"
@@ -62,7 +63,8 @@
*
*
*
- * The following example shows you how to add the padtemplate to an elementfactory:
+ * The following example shows you how to add the padtemplate to an
+ * elementfactory:
*
*
* gboolean
diff --git a/gst/gstparse.c b/gst/gstparse.c
index 24ed0caa21..05f56a299f 100644
--- a/gst/gstparse.c
+++ b/gst/gstparse.c
@@ -20,6 +20,7 @@
* Free Software Foundation, Inc., 59 Temple Place - Suite 330,
* Boston, MA 02111-1307, USA.
*/
+
/**
* SECTION:gstparse
* @short_description: Get a pipeline from a text pipeline description
diff --git a/gst/gstpipeline.c b/gst/gstpipeline.c
index dc50aca658..9f45fca3d8 100644
--- a/gst/gstpipeline.c
+++ b/gst/gstpipeline.c
@@ -19,21 +19,24 @@
* Free Software Foundation, Inc., 59 Temple Place - Suite 330,
* Boston, MA 02111-1307, USA.
*/
+
/**
* SECTION:gstpipeline
- * @short_description: Top-level bin with clocking and bus management functionality.
+ * @short_description: Top-level bin with clocking and bus management
+ functionality.
* @see_also: #GstBin
*
* In almost all cases, you'll want to use a GstPipeline when creating a filter
- * graph. The GstPipeline will manage the selection and distribution of a global
+ * graph. The GstPipeline will manage the selection and distribution of a
+ * global
* clock as well as provide a GstBus to the application.
*
- * The pipeline will also use the selected clock to calculate the stream time of
- * the pipeline.
+ * The pipeline will also use the selected clock to calculate the stream time
+ * of the pipeline.
*
* When sending a seek event to a GstPipeline, it will make sure that the
- * pipeline is properly PAUSED and resumed as well as update the new stream time
- * after the seek.
+ * pipeline is properly PAUSED and resumed as well as update the new stream
+ * time after the seek.
*
* gst_pipeline_new() is used to create a pipeline. when you are done with
* the pipeline, use gst_object_unref() to free its resources including all
diff --git a/gst/gstplugin.c b/gst/gstplugin.c
index 1a294e3e38..b72d2387ad 100644
--- a/gst/gstplugin.c
+++ b/gst/gstplugin.c
@@ -19,29 +19,32 @@
* Free Software Foundation, Inc., 59 Temple Place - Suite 330,
* Boston, MA 02111-1307, USA.
*/
+
/**
* SECTION:gstplugin
* @short_description: Container for features loaded from a shared object module
* @see_also: #GstPluginFeature, #GstElementFactory
*
* GStreamer is extensible, so #GstElement instances can be loaded at runtime.
- * A plugin system can provide one or more of the basic GStreamer
- * #GstPluginFeature subclasses.
+ * A plugin system can provide one or more of the basic
+ * GStreamer #GstPluginFeature subclasses.
*
* A plugin should export a symbol plugin_desc that is a struct of type #GstPluginDesc.
- * the plugin loader will check the version of the core library the plugin was linked against
- * and will create a new #GstPlugin. It will then call the #GstPluginInitFunc function
- * that was provided in the plugin_desc.
+ * the plugin loader will check the version of the core library the plugin was
+ * linked against and will create a new #GstPlugin. It will then call the
+ * #GstPluginInitFunc function that was provided in the plugin_desc.
*
- * Once you have a handle to a #GstPlugin (e.g. from the #GstRegistryPool), you can
- * add any object that subclasses #GstPluginFeature.
+ * Once you have a handle to a #GstPlugin (e.g. from the #GstRegistryPool), you
+ * can add any object that subclasses #GstPluginFeature.
*
- * Use gst_plugin_find_feature() and gst_plugin_get_feature_list() to find features in a plugin.
+ * Use gst_plugin_find_feature() and gst_plugin_get_feature_list() to find
+ * features in a plugin.
*
- * Usually plugins are always automaticlly loaded so you don't need to call gst_plugin_load() explicitly
- * to bring it into memory. There are options to statically link plugins to an app or even
- * use GStreamer without a plugin repository in which case gst_plugin_load() can be needed
- * to bring the plugin into memory.
+ * Usually plugins are always automaticlly loaded so you don't need to call
+ * gst_plugin_load() explicitly to bring it into memory. There are options to
+ * statically link plugins to an app or even use GStreamer without a plugin
+ * repository in which case gst_plugin_load() can be needed to bring the plugin
+ * into memory.
*/
#ifdef HAVE_CONFIG_H
diff --git a/gst/gstpluginfeature.c b/gst/gstpluginfeature.c
index 080df63aa6..1a0ea92ca2 100644
--- a/gst/gstpluginfeature.c
+++ b/gst/gstpluginfeature.c
@@ -19,6 +19,7 @@
* Free Software Foundation, Inc., 59 Temple Place - Suite 330,
* Boston, MA 02111-1307, USA.
*/
+
/**
* SECTION:gstpluginfeature
* @short_description: Base class for contents of a GstPlugin
diff --git a/gst/gstquery.c b/gst/gstquery.c
index f3cf969e8a..4be57004c0 100644
--- a/gst/gstquery.c
+++ b/gst/gstquery.c
@@ -20,6 +20,7 @@
* Free Software Foundation, Inc., 59 Temple Place - Suite 330,
* Boston, MA 02111-1307, USA.
*/
+
/**
* SECTION:gstquery
* @short_description: Dynamically register new query types and parse results
diff --git a/gst/gstqueue.c b/gst/gstqueue.c
index 959e081705..db3c60ac8f 100644
--- a/gst/gstqueue.c
+++ b/gst/gstqueue.c
@@ -21,6 +21,7 @@
* Free Software Foundation, Inc., 59 Temple Place - Suite 330,
* Boston, MA 02111-1307, USA.
*/
+
/**
* SECTION:gstqueue
* @short_description: Simple asynchronous data queue.
@@ -36,7 +37,6 @@
* The queue blocks by default.
*/
-
#include "gst_private.h"
#include "gstqueue.h"
diff --git a/gst/gstregistry.c b/gst/gstregistry.c
index cffe9a4b8b..374e3d1ac2 100644
--- a/gst/gstregistry.c
+++ b/gst/gstregistry.c
@@ -20,6 +20,7 @@
* Free Software Foundation, Inc., 59 Temple Place - Suite 330,
* Boston, MA 02111-1307, USA.
*/
+
/**
* SECTION:gstregistry
* @short_description: Abstract base class for management of #GstPlugin objects
diff --git a/gst/gststructure.c b/gst/gststructure.c
index 6edb740ad0..46a4643eea 100644
--- a/gst/gststructure.c
+++ b/gst/gststructure.c
@@ -18,6 +18,7 @@
* Free Software Foundation, Inc., 59 Temple Place - Suite 330,
* Boston, MA 02111-1307, USA.
*/
+
/**
* SECTION:gststructure
* @short_description: Generic structure containing fields of names and values
diff --git a/gst/gstsystemclock.c b/gst/gstsystemclock.c
index 65e9499e62..d814dbb3d0 100644
--- a/gst/gstsystemclock.c
+++ b/gst/gstsystemclock.c
@@ -19,6 +19,7 @@
* Free Software Foundation, Inc., 59 Temple Place - Suite 330,
* Boston, MA 02111-1307, USA.
*/
+
/**
* SECTION:gstsystemclock
* @short_description: Default clock that uses the current system time
diff --git a/gst/gsttaglist.c b/gst/gsttaglist.c
index 71e465fcb5..86571e3758 100644
--- a/gst/gsttaglist.c
+++ b/gst/gsttaglist.c
@@ -18,6 +18,7 @@
* Free Software Foundation, Inc., 59 Temple Place - Suite 330,
* Boston, MA 02111-1307, USA.
*/
+
/**
* SECTION:gsttaglist
* @short_description: List of tags and values used to describe media metadata
diff --git a/gst/gsttagsetter.c b/gst/gsttagsetter.c
index 3aa9c7c003..38d6269d91 100644
--- a/gst/gsttagsetter.c
+++ b/gst/gsttagsetter.c
@@ -18,9 +18,11 @@
* Free Software Foundation, Inc., 59 Temple Place - Suite 330,
* Boston, MA 02111-1307, USA.
*/
+
/**
* SECTION:gsttagsetter
- * @short_description: Element interface that allows setting and retrieval of media metadata
+ * @short_description: Element interface that allows setting and retrieval
+ * of media metadata
*
*/
diff --git a/gst/gsttrace.c b/gst/gsttrace.c
index a4e00379a1..20d200ff0a 100644
--- a/gst/gsttrace.c
+++ b/gst/gsttrace.c
@@ -19,13 +19,13 @@
* Free Software Foundation, Inc., 59 Temple Place - Suite 330,
* Boston, MA 02111-1307, USA.
*/
+
/**
* SECTION:gsttrace
* @short_description: Tracing functionality
*
*/
-
#ifdef HAVE_CONFIG_H
#include "config.h"
#endif
diff --git a/gst/gsttypefind.c b/gst/gsttypefind.c
index bb0f72581a..3e3e8626b1 100644
--- a/gst/gsttypefind.c
+++ b/gst/gsttypefind.c
@@ -18,6 +18,7 @@
* Free Software Foundation, Inc., 59 Temple Place - Suite 330,
* Boston, MA 02111-1307, USA.
*/
+
/**
* SECTION:gsttypefind
* @short_description: Stream type detection
diff --git a/gst/gsttypefindfactory.c b/gst/gsttypefindfactory.c
index 6e988b9b2c..993f393850 100644
--- a/gst/gsttypefindfactory.c
+++ b/gst/gsttypefindfactory.c
@@ -18,6 +18,7 @@
* Free Software Foundation, Inc., 59 Temple Place - Suite 330,
* Boston, MA 02111-1307, USA.
*/
+
/**
* SECTION:gsttypefindfactory
* @short_description: Information about registered typefind functions
@@ -73,8 +74,9 @@
*
*
*
- * The above example shows how to write a very simple typefinder that identifies
- * the given data. You can get quite a bit more complicated than that though.
+ * The above example shows how to write a very simple typefinder that
+ * identifies the given data. You can get quite a bit more complicated than
+ * that though.
*/
#include "gst_private.h"
diff --git a/gst/gsturi.c b/gst/gsturi.c
index f02a42767b..0161add756 100644
--- a/gst/gsturi.c
+++ b/gst/gsturi.c
@@ -19,13 +19,14 @@
* Free Software Foundation, Inc., 59 Temple Place - Suite 330,
* Boston, MA 02111-1307, USA.
*/
+
/**
* SECTION:gsturihandler
* @short_description: Plugin feature that handles URI types
* @see_also: #GstPluginFeature, #GstUri
*
- * The URIHandler is a pluginfeature that can be used to locate elements and the
- * element property that can handle a given URI.
+ * The URIHandler is a pluginfeature that can be used to locate elements and
+ * the element property that can handle a given URI.
*/
#ifdef HAVE_CONFIG_H
diff --git a/gst/gsturitype.c b/gst/gsturitype.c
index 8bb6971245..065d065ce4 100644
--- a/gst/gsturitype.c
+++ b/gst/gsturitype.c
@@ -19,6 +19,7 @@
* Free Software Foundation, Inc., 59 Temple Place - Suite 330,
* Boston, MA 02111-1307, USA.
*/
+
/**
* SECTION:gsturitype
* @short_description: Describes URI types
diff --git a/gst/gstutils.c b/gst/gstutils.c
index 9d477f27a7..d2b67b860b 100644
--- a/gst/gstutils.c
+++ b/gst/gstutils.c
@@ -19,6 +19,7 @@
* Free Software Foundation, Inc., 59 Temple Place - Suite 330,
* Boston, MA 02111-1307, USA.
*/
+
/**
* SECTION:gstutils
* @short_description: Various utility functions
diff --git a/gst/gstxml.c b/gst/gstxml.c
index a4a9af6050..d73b332971 100644
--- a/gst/gstxml.c
+++ b/gst/gstxml.c
@@ -19,6 +19,7 @@
* Free Software Foundation, Inc., 59 Temple Place - Suite 330,
* Boston, MA 02111-1307, USA.
*/
+
/**
* SECTION:gstxml
* @short_description: XML save/restore operations of pipelines
diff --git a/plugins/elements/gstqueue.c b/plugins/elements/gstqueue.c
index 959e081705..db3c60ac8f 100644
--- a/plugins/elements/gstqueue.c
+++ b/plugins/elements/gstqueue.c
@@ -21,6 +21,7 @@
* Free Software Foundation, Inc., 59 Temple Place - Suite 330,
* Boston, MA 02111-1307, USA.
*/
+
/**
* SECTION:gstqueue
* @short_description: Simple asynchronous data queue.
@@ -36,7 +37,6 @@
* The queue blocks by default.
*/
-
#include "gst_private.h"
#include "gstqueue.h"