renamed to actual element names, so much nicer to look at

Original commit message from CVS:

* common/gtk-doc-plugins.mak:
* docs/plugins/Makefile.am:
* docs/plugins/gst-plugins-base-plugins-docs.sgml:
* docs/plugins/gst-plugins-base-plugins-sections.txt:
renamed to actual element names, so much nicer to look at
* docs/plugins/tmpl/gstmultifdsink.sgml:
remove
* docs/plugins/tmpl/multifdsink.sgml:
* docs/plugins/tmpl/tcpserversink.sgml:
add
* ext/alsa/gstalsa.c:
* ext/cdparanoia/gstcdparanoia.c: (cdparanoia_get_property):
* ext/ogg/gstoggmux.c:
* gst/audioconvert/gstaudioconvert.c: (gst_audio_convert_chain):
* gst/playback/gstdecodebin.c:
* gst/tcp/gstmultifdsink.c: (gst_multifdsink_class_init):
* gst/tcp/gsttcpserversink.c:
various fixes and documentation additions

diff --git a/ChangeLog b/ChangeLog
index 6144e2fc58ab2bc15997c981602e0ae752fee617..35d3cbafd1621d950db1798d894a73a6b4f26bcb 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,24 @@
+2005-08-05  Thomas Vander Stichele  <thomas at apestaart dot org>
+
+       * common/gtk-doc-plugins.mak:
+       * docs/plugins/Makefile.am:
+       * docs/plugins/gst-plugins-base-plugins-docs.sgml:
+       * docs/plugins/gst-plugins-base-plugins-sections.txt:
+         renamed to actual element names, so much nicer to look at
+       * docs/plugins/tmpl/gstmultifdsink.sgml:
+         remove
+       * docs/plugins/tmpl/multifdsink.sgml:
+       * docs/plugins/tmpl/tcpserversink.sgml:
+         add
+       * ext/alsa/gstalsa.c:
+       * ext/cdparanoia/gstcdparanoia.c: (cdparanoia_get_property):
+       * ext/ogg/gstoggmux.c:
+       * gst/audioconvert/gstaudioconvert.c: (gst_audio_convert_chain):
+       * gst/playback/gstdecodebin.c:
+       * gst/tcp/gstmultifdsink.c: (gst_multifdsink_class_init):
+       * gst/tcp/gsttcpserversink.c:
+         various fixes and documentation additions
+
 2005-08-05  Thomas Vander Stichele  <thomas at apestaart dot org>
 
        * common/Makefile.am:

diff --git a/common b/common
index c99f9050f296219783c6717efe319dc741d2e2d3..856fbbfa88621ab67df141ead8d4d3df32c5c176 160000 (submodule)
--- a/common
+++ b/common
@@ -1 +1 @@
-Subproject commit c99f9050f296219783c6717efe319dc741d2e2d3
+Subproject commit 856fbbfa88621ab67df141ead8d4d3df32c5c176

diff --git a/docs/plugins/Makefile.am b/docs/plugins/Makefile.am
index 967133fbb032fbde8e541849591e8c0f00e606ba..9967cac6ef40fdf45b130fbfc952a2dfbe9e7001 100644 (file)
--- a/docs/plugins/Makefile.am
+++ b/docs/plugins/Makefile.am
@@ -49,7 +49,7 @@ SCAN_OPTIONS=
 #EXTRA_DIST = gstreamer.types.in gstreamer.hierarchy $(DOC_MODULE)-sections.txt gstreamer-sections.txt $(DOC_MAIN_SGML_FILE)
 
 # Extra options to supply to gtkdoc-mkdb.
-MKDB_OPTIONS=--sgml-mode --ignore-files=trio
+MKDB_OPTIONS=--sgml-mode
 
 # Extra options to supply to gtkdoc-fixref.
 # FIXME get the location of the installed gstreamer docs
@@ -66,9 +66,12 @@ CFILE_GLOB=$(DOC_SOURCE_DIR)/*/*/*.c
 SCANOBJ_DEPS =
 
 # Header files to ignore when scanning.
-IGNORE_HFILES = avcodec.h gstffmpegcodecmap.h
+IGNORE_HFILES = avcodec.h gstffmpegcodecmap.h dsputil.h
+IGNORE_CFILES = utils.c mem.c imgconvert.c
 
-EXTRA_HFILES = $(top_srcdir)/gst/tcp/gstmultifdsink.h
+EXTRA_HFILES = \
+       $(top_srcdir)/gst/tcp/gstmultifdsink.h \
+       $(top_srcdir)/gst/tcp/gsttcpserversink.h
 
 # Images to copy into HTML directory.
 HTML_IMAGES =

diff --git a/docs/plugins/gst-plugins-base-plugins-docs.sgml b/docs/plugins/gst-plugins-base-plugins-docs.sgml
index 5e8f8d45e35e3afe0fb767143f26084177b59659..99c0e476868f1854816bd0248292c919039e979d 100644 (file)
--- a/docs/plugins/gst-plugins-base-plugins-docs.sgml
+++ b/docs/plugins/gst-plugins-base-plugins-docs.sgml
@@ -1,13 +1,18 @@
 <?xml version="1.0"?>
 <!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" 
-               "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd">
+               "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" [
+<!ENTITY % version-entities SYSTEM "version.entities">
+%version-entities;
+]>
+
 <book id="index" xmlns:xi="http://www.w3.org/2003/XInclude">
   <bookinfo>
-    <title>gst-plugins-base Plugins Reference Manual</title>
+    <title>GStreamer Base Plugins &GST_MAJORMINOR; Plugins Reference Manual</title>
   </bookinfo>
 
   <chapter>
     <title>gst-plugins-base Plugins</title>
-    <xi:include href="xml/gstmultifdsink.xml"/>
+    <xi:include href="xml/multifdsink.xml"/>
+    <xi:include href="xml/tcpserversink.xml"/>
   </chapter>
 </book>

diff --git a/docs/plugins/gst-plugins-base-plugins-sections.txt b/docs/plugins/gst-plugins-base-plugins-sections.txt
index 647f76e2a50e0ce262b61c4699da8ce2171975df..d01ad8ac316428d259a0964f2eb66edf2b94c9ac 100644 (file)
--- a/docs/plugins/gst-plugins-base-plugins-sections.txt
+++ b/docs/plugins/gst-plugins-base-plugins-sections.txt
@@ -1,13 +1,41 @@
 <SECTION>
-<FILE>gstmultifdsink</FILE>
+<FILE>multifdsink</FILE>
 GstMultiFdSink
 GstMultiFdSinkFlags
 GstRecoverPolicy
 GstSyncMethod
 GstUnitType
 GstClientStatus
-<TITLE>GstMultiFdSink</TITLE>
+<TITLE>multifdsink</TITLE>
 <SUBSECTION Standard>
 GstMultiFdSinkClass
 </SECTION>
 
+<SECTION>
+<FILE>tcpserversink</FILE>
+GstTCPServerSink
+<TITLE>tcpserversink</TITLE>
+<SUBSECTION Standard>
+GstTCPServerSinkClass
+</SECTION>
+
+
+<SECTION>
+<FILE>private</FILE>
+CLIENTS_UNLOCK
+CLIENTS_LOCK_INIT
+GST_MULTIFDSINK_GET_CLASS
+CLIENTS_LOCK_FREE
+GST_IS_MULTIFDSINK_CLASS
+gst_multifdsink_get_type
+gst_multifdsink_remove
+GST_IS_MULTIFDSINK
+CLIENTS_LOCK
+GST_TYPE_MULTIFDSINK
+gst_multifdsink_clear
+GstTCPClient
+GST_MULTIFDSINK_CLASS
+gst_multifdsink_get_stats
+GST_MULTIFDSINK
+gst_multifdsink_add
+</SECTION>

diff --git a/docs/plugins/tmpl/gstmultifdsink.sgml b/docs/plugins/tmpl/gstmultifdsink.sgml
deleted file mode 100644 (file)
index 2389fef..0000000
--- a/docs/plugins/tmpl/gstmultifdsink.sgml
+++ /dev/null
@@ -1,174 +0,0 @@
-<!-- ##### SECTION Title ##### -->
-GstMultiFdSink
-
-<!-- ##### SECTION Short_Description ##### -->
-
-
-<!-- ##### SECTION Long_Description ##### -->
-<para>
-
-</para>
-
-<!-- ##### SECTION See_Also ##### -->
-<para>
-
-</para>
-
-<!-- ##### STRUCT GstMultiFdSink ##### -->
-<para>
-
-</para>
-
-
-<!-- ##### SIGNAL GstMultiFdSink::add ##### -->
-<para>
-
-</para>
-
-@gstmultifdsink: the object which received the signal.
-@arg1: 
-
-<!-- ##### SIGNAL GstMultiFdSink::clear ##### -->
-<para>
-
-</para>
-
-@gstmultifdsink: the object which received the signal.
-
-<!-- ##### SIGNAL GstMultiFdSink::client-added ##### -->
-<para>
-
-</para>
-
-@gstmultifdsink: the object which received the signal.
-@arg1: 
-
-<!-- ##### SIGNAL GstMultiFdSink::client-removed ##### -->
-<para>
-
-</para>
-
-@gstmultifdsink: the object which received the signal.
-@arg1: 
-@arg2: 
-
-<!-- ##### SIGNAL GstMultiFdSink::get-stats ##### -->
-<para>
-
-</para>
-
-@gstmultifdsink: the object which received the signal.
-@arg1: 
-@Returns: 
-
-<!-- ##### SIGNAL GstMultiFdSink::remove ##### -->
-<para>
-
-</para>
-
-@gstmultifdsink: the object which received the signal.
-@arg1: 
-
-<!-- ##### ARG GstMultiFdSink:buffers-max ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GstMultiFdSink:buffers-queued ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GstMultiFdSink:buffers-soft-max ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GstMultiFdSink:bytes-served ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GstMultiFdSink:bytes-to-serve ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GstMultiFdSink:mode ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GstMultiFdSink:protocol ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GstMultiFdSink:recover-policy ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GstMultiFdSink:sync-clients ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GstMultiFdSink:sync-method ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GstMultiFdSink:timeout ##### -->
-<para>
-
-</para>
-
-<!-- ##### ENUM GstMultiFdSinkFlags ##### -->
-<para>
-
-</para>
-
-@GST_MULTIFDSINK_OPEN: 
-@GST_MULTIFDSINK_FLAG_LAST: 
-
-<!-- ##### ENUM GstRecoverPolicy ##### -->
-<para>
-
-</para>
-
-@GST_RECOVER_POLICY_NONE: 
-@GST_RECOVER_POLICY_RESYNC_START: 
-@GST_RECOVER_POLICY_RESYNC_SOFT: 
-@GST_RECOVER_POLICY_RESYNC_KEYFRAME: 
-
-<!-- ##### ENUM GstSyncMethod ##### -->
-<para>
-
-</para>
-
-@GST_SYNC_METHOD_NONE: 
-@GST_SYNC_METHOD_WAIT: 
-@GST_SYNC_METHOD_BURST: 
-
-<!-- ##### ENUM GstUnitType ##### -->
-<para>
-
-</para>
-
-@GST_UNIT_TYPE_BUFFERS: 
-@GST_UNIT_TYPE_TIME: 
-@GST_UNIT_TYPE_BYTES: 
-
-<!-- ##### ENUM GstClientStatus ##### -->
-<para>
-
-</para>
-
-@GST_CLIENT_STATUS_OK: 
-@GST_CLIENT_STATUS_CLOSED: 
-@GST_CLIENT_STATUS_REMOVED: 
-@GST_CLIENT_STATUS_SLOW: 
-@GST_CLIENT_STATUS_ERROR: 
-@GST_CLIENT_STATUS_DUPLICATE: 
-

diff --git a/docs/plugins/tmpl/multifdsink.sgml b/docs/plugins/tmpl/multifdsink.sgml
new file mode 100644 (file)
index 0000000..aac559c
--- /dev/null
+++ b/docs/plugins/tmpl/multifdsink.sgml
@@ -0,0 +1,177 @@
+<!-- ##### SECTION Title ##### -->
+multifdsink
+
+<!-- ##### SECTION Short_Description ##### -->
+
+
+<!-- ##### SECTION Long_Description ##### -->
+<para>
+
+</para>
+
+<!-- ##### SECTION See_Also ##### -->
+<para>
+
+</para>
+
+<!-- ##### SECTION Stability_Level ##### -->
+
+
+<!-- ##### STRUCT GstMultiFdSink ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### SIGNAL GstMultiFdSink::add ##### -->
+<para>
+
+</para>
+
+@gstmultifdsink: the object which received the signal.
+@arg1: 
+
+<!-- ##### SIGNAL GstMultiFdSink::clear ##### -->
+<para>
+
+</para>
+
+@gstmultifdsink: the object which received the signal.
+
+<!-- ##### SIGNAL GstMultiFdSink::client-added ##### -->
+<para>
+
+</para>
+
+@gstmultifdsink: the object which received the signal.
+@arg1: 
+
+<!-- ##### SIGNAL GstMultiFdSink::client-removed ##### -->
+<para>
+
+</para>
+
+@gstmultifdsink: the object which received the signal.
+@arg1: 
+@arg2: 
+
+<!-- ##### SIGNAL GstMultiFdSink::get-stats ##### -->
+<para>
+
+</para>
+
+@gstmultifdsink: the object which received the signal.
+@arg1: 
+@Returns: 
+
+<!-- ##### SIGNAL GstMultiFdSink::remove ##### -->
+<para>
+
+</para>
+
+@gstmultifdsink: the object which received the signal.
+@arg1: 
+
+<!-- ##### ARG GstMultiFdSink:buffers-max ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GstMultiFdSink:buffers-queued ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GstMultiFdSink:buffers-soft-max ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GstMultiFdSink:bytes-served ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GstMultiFdSink:bytes-to-serve ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GstMultiFdSink:mode ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GstMultiFdSink:protocol ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GstMultiFdSink:recover-policy ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GstMultiFdSink:sync-clients ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GstMultiFdSink:sync-method ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GstMultiFdSink:timeout ##### -->
+<para>
+
+</para>
+
+<!-- ##### ENUM GstMultiFdSinkFlags ##### -->
+<para>
+
+</para>
+
+@GST_MULTIFDSINK_OPEN: 
+@GST_MULTIFDSINK_FLAG_LAST: 
+
+<!-- ##### ENUM GstRecoverPolicy ##### -->
+<para>
+
+</para>
+
+@GST_RECOVER_POLICY_NONE: 
+@GST_RECOVER_POLICY_RESYNC_START: 
+@GST_RECOVER_POLICY_RESYNC_SOFT: 
+@GST_RECOVER_POLICY_RESYNC_KEYFRAME: 
+
+<!-- ##### ENUM GstSyncMethod ##### -->
+<para>
+
+</para>
+
+@GST_SYNC_METHOD_NONE: 
+@GST_SYNC_METHOD_WAIT: 
+@GST_SYNC_METHOD_BURST: 
+
+<!-- ##### ENUM GstUnitType ##### -->
+<para>
+
+</para>
+
+@GST_UNIT_TYPE_BUFFERS: 
+@GST_UNIT_TYPE_TIME: 
+@GST_UNIT_TYPE_BYTES: 
+
+<!-- ##### ENUM GstClientStatus ##### -->
+<para>
+
+</para>
+
+@GST_CLIENT_STATUS_OK: 
+@GST_CLIENT_STATUS_CLOSED: 
+@GST_CLIENT_STATUS_REMOVED: 
+@GST_CLIENT_STATUS_SLOW: 
+@GST_CLIENT_STATUS_ERROR: 
+@GST_CLIENT_STATUS_DUPLICATE: 
+

diff --git a/docs/plugins/tmpl/tcpserversink.sgml b/docs/plugins/tmpl/tcpserversink.sgml
new file mode 100644 (file)
index 0000000..fd31f24
--- /dev/null
+++ b/docs/plugins/tmpl/tcpserversink.sgml
@@ -0,0 +1,35 @@
+<!-- ##### SECTION Title ##### -->
+tcpserversink
+
+<!-- ##### SECTION Short_Description ##### -->
+
+
+<!-- ##### SECTION Long_Description ##### -->
+<para>
+
+</para>
+
+<!-- ##### SECTION See_Also ##### -->
+<para>
+
+</para>
+
+<!-- ##### SECTION Stability_Level ##### -->
+
+
+<!-- ##### STRUCT GstTCPServerSink ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### ARG GstTCPServerSink:host ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GstTCPServerSink:port ##### -->
+<para>
+
+</para>
+

diff --git a/ext/alsa/gstalsa.c b/ext/alsa/gstalsa.c
index d6e08515690e9a221a68db7be9db3add2dc11216..5d80de540bbb7e4331d0b0c6af7af8f62b5714d8 100644 (file)
--- a/ext/alsa/gstalsa.c
+++ b/ext/alsa/gstalsa.c
@@ -96,7 +96,7 @@ static gboolean gst_alsa_query (GstElement * element,
 static gboolean gst_alsa_pad_query (GstPad * pad,
     GstQueryType type, GstFormat * format, gint64 * value);
 
-/*** TYPE FUNCTIONS ***********************************************************/
+/* TYPE FUNCTIONS ***********************************************************/
 
 GType
 gst_alsa_get_type (void)
@@ -131,7 +131,7 @@ gst_alsa_get_type (void)
   return alsa_type;
 }
 
-/*** GOBJECT FUNCTIONS ********************************************************/
+/* GOBJECT FUNCTIONS ********************************************************/
 
 enum
 {
@@ -519,7 +519,7 @@ gst_alsa_probe_interface_init (GstPropertyProbeInterface * iface)
   iface->get_values = gst_alsa_probe_get_values;
 }
 
-/*** GSTREAMER PAD / QUERY / CONVERSION / STATE FUNCTIONS *********************/
+/* GSTREAMER PAD / QUERY / CONVERSION / STATE FUNCTIONS *********************/
 
 static GstPad *
 gst_alsa_request_new_pad (GstElement * element, GstPadTemplate * templ,
@@ -767,7 +767,7 @@ add_channels (GstStructure * structure, gint min_channels, gint max_channels)
   }
 }
 
-/**
+/*
  * Get all available caps.
  * @format: SND_PCM_FORMAT_UNKNOWN for all formats, desired format else
  * @rate: allowed rates if < 0, else desired rate
@@ -1425,7 +1425,7 @@ gst_alsa_set_clock (GstElement * element, GstClock * clock)
   GST_ALSA (element)->ext_clock = clock;
 }
 
-/*** AUDIO PROCESSING *********************************************************/
+/* AUDIO PROCESSING *********************************************************/
 
 inline snd_pcm_sframes_t
 gst_alsa_update_avail (GstAlsa * this)
@@ -1474,8 +1474,8 @@ gst_alsa_pcm_wait (GstAlsa * this)
   return TRUE;
 }
 
-/**
- * error out or make sure we're in SND_PCM_STATE_RUNNING afterwards 
+/*
+ * error out or make sure we're in SND_PCM_STATE_RUNNING afterwards
  * return FALSE if we're not
  */
 inline gboolean
@@ -1552,7 +1552,7 @@ gst_alsa_xrun_recovery (GstAlsa * this)
   return TRUE;
 }
 
-/*** AUDIO SETUP / START / STOP ***********************************************/
+/* AUDIO SETUP / START / STOP ***********************************************/
 
 void
 gst_alsa_set_eos (GstAlsa * this)
@@ -1700,7 +1700,7 @@ gst_alsa_probe_hw_params (GstAlsa * this, GstAlsaFormat * format)
   return TRUE;
 }
 
-/**
+/*
  * You must set all hw parameters at once and can't use already set params and
  * change them.
  * Thx ALSA for not documenting this
@@ -1932,7 +1932,7 @@ gst_alsa_close_audio (GstAlsa * this)
   return TRUE;
 }
 
-/*** QUERYING/FORMAT/CONVERSION FUNCTIONS *************************************/
+/* QUERYING/FORMAT/CONVERSION FUNCTIONS *************************************/
 
 static const GstFormat *
 gst_alsa_get_formats (GstPad * pad)

diff --git a/ext/cdparanoia/gstcdparanoia.c b/ext/cdparanoia/gstcdparanoia.c
index 879d201ffa3b2affe362740ef57010b9221169f2..eda93cee20db5aecfc639a9a63390f040821a949 100644 (file)
--- a/ext/cdparanoia/gstcdparanoia.c
+++ b/ext/cdparanoia/gstcdparanoia.c
@@ -65,7 +65,7 @@ GST_STATIC_PAD_TEMPLATE ("src",
     );
 
 
-/********** Define useful types for non-programmatic interfaces **********/
+/* Define useful types for non-programmatic interfaces **********/
 #define GST_TYPE_PARANOIA_MODE (gst_paranoia_mode_get_type())
 static GType
 gst_paranoia_mode_get_type (void)
@@ -103,7 +103,7 @@ gst_paranoia_endian_get_type (void)
   return paranoia_endian_type;
 }
 
-/********** Standard stuff for signals and arguments **********/
+/* Standard stuff for signals and arguments **********/
 /* CDParanoia signals and args */
 enum
 {
@@ -446,7 +446,7 @@ cdparanoia_get_property (GObject * object, guint prop_id, GValue * value,
       g_value_set_enum (value, src->paranoia_mode);
       break;
     case ARG_DISCID:
-      /**
+      /*
        * Due to possible autocorrections of start sectors of audio tracks on 
        * multisession cds, we can maybe not compute the correct discid.
        * So issue a warning.
@@ -1163,7 +1163,7 @@ plugin_init (GstPlugin * plugin)
   return TRUE;
 }
 
-/*** GSTURIHANDLER INTERFACE *************************************************/
+/* GSTURIHANDLER INTERFACE *************************************************/
 
 static guint
 cdparanoia_uri_get_type (void)

diff --git a/ext/ogg/gstoggmux.c b/ext/ogg/gstoggmux.c
index a5e5a1b1d223c3d071d34dfa8e11a9900ce0d27a..807eb5f0551ff32d4e815510aff322aa2c6622f9 100644 (file)
--- a/ext/ogg/gstoggmux.c
+++ b/ext/ogg/gstoggmux.c
@@ -694,7 +694,7 @@ gst_ogg_mux_set_header_on_caps (GstCaps * caps, GList * buffers)
   return caps;
 }
 
-/**
+/*
  * For each pad we need to write out one (small) header in one
  * page that allows decoders to identify the type of the stream.
  * After that we need to write out all extra info for the decoders.

diff --git a/gst/audioconvert/gstaudioconvert.c b/gst/audioconvert/gstaudioconvert.c
index 098e38ba6c6781111236ee4c67e9850be36a53b3..775dfe317ab06e3b4d8cdc40a81423ffa81fef36 100644 (file)
--- a/gst/audioconvert/gstaudioconvert.c
+++ b/gst/audioconvert/gstaudioconvert.c
@@ -237,7 +237,7 @@ gst_audio_convert_chain (GstPad * pad, GstBuffer * buf)
 
   this = GST_AUDIO_CONVERT (GST_OBJECT_PARENT (pad));
 
-  /**
+  /*
    * Theory of operation:
    * - convert the format (endianness, signedness, width, depth) to
    *   (G_BYTE_ORDER, TRUE, 32, 32)

diff --git a/gst/playback/gstdecodebin.c b/gst/playback/gstdecodebin.c
index f22e76878df741c9adb3028879366d9ee26a7176..3e2359343dcb1cf9dea613e446540d2efc93a42d 100644 (file)
--- a/gst/playback/gstdecodebin.c
+++ b/gst/playback/gstdecodebin.c
@@ -541,11 +541,11 @@ many_types:
   }
 }
 
-/** 
+/*
  * given a list of element factories, try to link one of the factories
  * to the given pad.
  *
- * The function returns the element that was successfully linked to the 
+ * The function returns the element that was successfully linked to the
  * pad.
  */
 static GstElement *

diff --git a/gst/tcp/gstmultifdsink.c b/gst/tcp/gstmultifdsink.c
index 21baf18f1a9b2b1406234d94b43bf80720224ee9..c55ed26354c7537f882777f33cb709a019908fbd 100644 (file)
--- a/gst/tcp/gstmultifdsink.c
+++ b/gst/tcp/gstmultifdsink.c
@@ -18,6 +18,14 @@
  * Boston, MA 02111-1307, USA.
  */
 
+/**
+ * SECTION:multifdsink
+ * @short_description: a sink that writes to multiple file descriptors
+ * @see_also: tcpserversink
+ *
+ * Incredibly, still a sink that writes to multiple file descriptors
+ */
+
 #ifdef HAVE_CONFIG_H
 #include "config.h"
 #endif

diff --git a/gst/tcp/gsttcpserversink.c b/gst/tcp/gsttcpserversink.c
index 7b2c196eab67c1f5fbdede8ab42518c00416916f..5be2e1da3132284e86dbf27f5e5aab9bf49fdb8e 100644 (file)
--- a/gst/tcp/gsttcpserversink.c
+++ b/gst/tcp/gsttcpserversink.c
@@ -18,6 +18,13 @@
  * Boston, MA 02111-1307, USA.
  */
 
+/**
+ * SECTION:tcpserversink
+ * @short_description: a sink that acts as a TCP server and sends data to
+ *  multiple clients
+ * @see_also: #multifdsink
+ */
+
 #ifdef HAVE_CONFIG_H
 #include "config.h"
 #endif