docs: add gtk-doc blobs

gst/gsttracer.c

@@ -19,6 +19,22 @@
  * Boston, MA 02110-1301, USA.
  */
 
+/**
+ * SECTION:gsttracer
+ * @short_description: Tracing subsystem
+ *
+ * The tracing subsystem provides hooks in the core library and API for modules
+ * to attach to them.
+ *
+ * Tracing modules will subclass #GstTracer and register through
+ * gst_tracer_register(). Modules can attach to various hook-types - see
+ * #GstTracerHook. When invoked they receive hook specific contextual data, 
+ * which they must not modify.
+ *
+ * The user can activate tracers by setting the environment variable GST_TRACE
+ * to a ';' separated list of tracers.
+ */
+
 #include "gst_private.h"
 #include "gstenumtypes.h"
 #include "gstregistry.h"

gst/gsttracerfactory.c

@@ -23,7 +23,8 @@
  * SECTION:gsttracerfactory
  * @short_description: Information about registered tracer functions
  *
- * Last reviewed on 2012-10-24 (1.2.X)
+ * Use gst_tracer_factory_get_list() to get a list of tracer factories known to
+ * GStreamer.
  */
 
 #include "gst_private.h"

plugins/tracers/gstlatency.c

@@ -18,6 +18,13 @@
  * Free Software Foundation, Inc., 51 Franklin St, Fifth Floor,
  * Boston, MA 02110-1301, USA.
  */
+/**
+ * SECTION:gstlatency
+ * @short_description: log processing latency stats
+ *
+ * A tracing module that determines src-to-sink latencies by injecting custom
+ * events at sources and process them at sinks. 
+ */
 /* TODO(ensonic): if there are two sources feeding into a mixer/muxer and later
  * we fan-out with tee and have two sinks, each sink would get all two events,
  * the later event would overwrite the former. Unfortunately when the buffer

plugins/tracers/gstlog.c

@@ -18,6 +18,12 @@
  * Free Software Foundation, Inc., 51 Franklin St, Fifth Floor,
  * Boston, MA 02110-1301, USA.
  */
+/**
+ * SECTION:gstlog
+ * @short_description: log hook event
+ *
+ * A tracing module that logs all data from all hooks. 
+ */
 
 #ifdef HAVE_CONFIG_H
 #  include "config.h"

plugins/tracers/gstrusage.c

@@ -18,6 +18,12 @@
  * Free Software Foundation, Inc., 51 Franklin St, Fifth Floor,
  * Boston, MA 02110-1301, USA.
  */
+/**
+ * SECTION:gstrusage
+ * @short_description: log resource usage stats
+ *
+ * A tracing module that take rusage() snapshots and logs them. 
+ */
 
 #ifdef HAVE_CONFIG_H
 #  include "config.h"

plugins/tracers/gststats.c

@@ -18,6 +18,12 @@
  * Free Software Foundation, Inc., 51 Franklin St, Fifth Floor,
  * Boston, MA 02110-1301, USA.
  */
+/**
+ * SECTION:gstrusage
+ * @short_description: log event stats
+ *
+ * A tracing module that builds usage statistic for elements and pads. 
+ */
 
 #ifdef HAVE_CONFIG_H
 #  include "config.h"