various style fixes

Original commit message from CVS: various style fixes
2025-02-16 19:25:18 +00:00 · 2005-10-15 16:01:57 +00:00 · 2005-10-15 16:01:57 +00:00 · bef56ce78d
commit bef56ce78d
parent 5cb910050a
44 changed files with 164 additions and 112 deletions
--- 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 <ulink url="http://www.cse.ogi.edu/sysl/">OGI's
- *   pipeline</ulink> and Microsoft's DirectShow for some background.
+ *            pipeline</ulink> 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 @@
 * </programlisting>
 * </example>
 *
- * 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 @@
 * </programlisting>
 * </example>
 *
- * 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
--- 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
--- 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).
--- 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 <errno.h>
--- 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
--- 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().
--- 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 <time.h>

 #include "gst_private.h"
--- 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
 * &lt;gst/gst.h&gt;. You can check this if you do subsystem-specific stuff.
 * <example>
 * <title>Doing subsystem specific things</title>
--- 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"
--- 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.
 *
--- 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
--- 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
--- 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.
--- 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 <string.h>
--- 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
--- 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
--- 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
--- 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()
--- 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
--- 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
--- 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 <string.h>             /* memset */
--- 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
--- 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:
 * <informalexample>
 * <programlisting>
 *   gst_object_ref (GST_OBJECT (child_element));
 *   gst_object_sink (GST_OBJECT (child_element));
 * </programlisting>
 * </informalexample>
- * 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:
 * <informalexample>
 * <programlisting>
 *    element = gst_element_factory_make (factoryname, name);
@ -66,9 +68,9 @@
 * </programlisting>
 * </informalexample>
 *
- * 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;
--- 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.
 *
--- 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.
 * <example>
@ -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 @@
 *   </programlisting>
 * </example>
 *
- * 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:
 * <informalexample>
 *   <programlisting>
 *   gboolean
--- 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
--- 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
--- 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 <application>GStreamer</application>
- * #GstPluginFeature subclasses.
+ * A plugin system can provide one or more of the basic
+ * <application>GStreamer</application> #GstPluginFeature subclasses.
 *
 * A plugin should export a symbol <symbol>plugin_desc</symbol> 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
--- 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
--- 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
--- 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"
--- 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
--- 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
--- 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
--- 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
--- 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
 *
 */

--- 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
--- 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
--- 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 @@
 *   </programlisting>
 * </example>
 *
- * 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"
--- 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
--- 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
--- 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
--- 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
--- 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"