various style fixes
authorThomas Vander Stichele <thomas@apestaart.org>
Sat, 15 Oct 2005 16:01:57 +0000 (16:01 +0000)
committerThomas Vander Stichele <thomas@apestaart.org>
Sat, 15 Oct 2005 16:01:57 +0000 (16:01 +0000)
Original commit message from CVS:
various style fixes

44 files changed:
gst/gst.c
gst/gstbin.c
gst/gstbuffer.c
gst/gstbus.c
gst/gstcaps.c
gst/gstchildproxy.c
gst/gstclock.c
gst/gstconfig.h.in
gst/gstelement.c
gst/gstelementfactory.c
gst/gsterror.c
gst/gstevent.c
gst/gstfilter.c
gst/gstformat.c
gst/gstghostpad.c
gst/gstindex.c
gst/gstindexfactory.c
gst/gstinfo.c
gst/gstinterface.c
gst/gstiterator.c
gst/gstmemchunk.c
gst/gstmessage.c
gst/gstobject.c
gst/gstpad.c
gst/gstpadtemplate.c
gst/gstparse.c
gst/gstpipeline.c
gst/gstplugin.c
gst/gstpluginfeature.c
gst/gstquery.c
gst/gstqueue.c
gst/gstregistry.c
gst/gststructure.c
gst/gstsystemclock.c
gst/gsttaglist.c
gst/gsttagsetter.c
gst/gsttrace.c
gst/gsttypefind.c
gst/gsttypefindfactory.c
gst/gsturi.c
gst/gsturitype.c
gst/gstutils.c
gst/gstxml.c
plugins/elements/gstqueue.c

index 37ab6a8..ea9ee39 100644 (file)
--- a/gst/gst.c
+++ b/gst/gst.c
  * 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
index 04f4b11..8873cad 100644 (file)
@@ -22,6 +22,7 @@
  *
  * MT safe.
  */
+
 /**
  * SECTION:gstbin
  * @short_description: Base class for elements that contain other elements
index 249135f..6be177e 100644 (file)
@@ -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.
  * 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).
index a3092c4..a402c67 100644 (file)
@@ -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>
index ae85313..ef31954 100644 (file)
@@ -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
index 4f88c44..c61aa4d 100644 (file)
@@ -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().
index 3a2de83..00f2e1a 100644 (file)
@@ -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"
index 13483cd..46363c8 100644 (file)
@@ -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>
index d048380..1d90bd6 100644 (file)
@@ -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
  * 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"
index c0a0cd0..dc99d23 100644 (file)
  * 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
+ * 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.
  *
index 1b4f1cc..30640d2 100644 (file)
@@ -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
index eb469e9..785b68d 100644 (file)
@@ -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
index 56fb08a..a63c451 100644 (file)
@@ -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.
index 099771a..7695de0 100644 (file)
  * 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>
index 1ff4cfc..97652c1 100644 (file)
@@ -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
index b88a5cc..046ce66 100644 (file)
@@ -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
index 6b06d6b..ed8bfb6 100644 (file)
@@ -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
index dfb4357..48ce5b2 100644 (file)
@@ -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
  * 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()
index 271a8a4..3f8c347 100644 (file)
@@ -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
index e6877fa..62359b6 100644 (file)
@@ -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
index ae4a28c..51c3822 100644 (file)
@@ -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 */
index 023ac53..ad25db0 100644 (file)
  * 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
index 8969066..5c46c67 100644 (file)
@@ -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
  * 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
 #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;
index 80a2642..480c464 100644 (file)
@@ -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
  * 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.
  *
index 5c815a2..930bab7 100644 (file)
@@ -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.
  * 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
index 24ed0ca..05f56a2 100644 (file)
@@ -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
index dc50aca..9f45fca 100644 (file)
  * 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
index 1a294e3..b72d238 100644 (file)
  * 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
index 080df63..1a0ea92 100644 (file)
@@ -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
index f3cf969..4be5700 100644 (file)
@@ -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
index 959e081..db3c60a 100644 (file)
@@ -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"
index cffe9a4..374e3d1 100644 (file)
@@ -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
index 6edb740..46a4643 100644 (file)
@@ -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
index 65e9499..d814dbb 100644 (file)
@@ -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
index 71e465f..86571e3 100644 (file)
@@ -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
index 3aa9c7c..38d6269 100644 (file)
  * 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
  *
  */
 
index a4e0037..20d200f 100644 (file)
  * 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
index bb0f725..3e3e862 100644 (file)
@@ -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
index 6e988b9..993f393 100644 (file)
@@ -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"
index f02a427..0161add 100644 (file)
  * 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
index 8bb6971..065d065 100644 (file)
@@ -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
index 9d477f2..d2b67b8 100644 (file)
@@ -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
index a4a9af6..d73b332 100644 (file)
@@ -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
index 959e081..db3c60a 100644 (file)
@@ -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"