Fix gtk-doc warnings. Also don't misuse api-doc comments for normal comments.

Original commit message from CVS:
* docs/plugins/gst-plugins-bad-plugins-sections.txt:
* examples/app/appsrc-ra.c:
* examples/app/appsrc-seekable.c:
* examples/app/appsrc-stream.c:
* examples/app/appsrc-stream2.c:
* ext/directfb/dfbvideosink.h:
* ext/metadata/gstbasemetadata.c:
* ext/metadata/gstbasemetadata.h:
* ext/metadata/metadata.c:
* ext/metadata/metadataexif.c:
* ext/theora/theoradec.h:
* gst/deinterlace2/gstdeinterlace2.h:
* gst/deinterlace2/tvtime/speedy.c:
* gst/deinterlace2/tvtime/speedy.h:
* gst/deinterlace2/tvtime/vfir.c:
Fix gtk-doc warnings. Also don't misuse api-doc comments for normal
comments.

6 files changed, 7 insertions, 20 deletions

diff --git a/ext/directfb/dfbvideosink.h b/ext/directfb/dfbvideosink.h
index b83df381..bbab762d 100644
--- a/ext/directfb/dfbvideosink.h
+++ b/ext/directfb/dfbvideosink.h
@@ -71,9 +71,9 @@ struct _GstDfbVMode {
  * The opaque #GstDfbVideoSink structure.
  */
 struct _GstDfbVideoSink {
-  /* Our element stuff */
   GstVideoSink videosink;
   
+  /* < private > */
   GMutex *pool_lock;
   GSList *buffer_pool;
   
diff --git a/ext/metadata/gstbasemetadata.c b/ext/metadata/gstbasemetadata.c
index 58b610e1..e86c9ce1 100644
--- a/ext/metadata/gstbasemetadata.c
+++ b/ext/metadata/gstbasemetadata.c
@@ -1914,11 +1914,7 @@ done:
  * EXIF, IPTC, XMP or not.
  * @see_also: #gst_base_metadata_unset_option_flag
  * #gst_base_metadata_get_option_flag 
- *
- * Returns: nothing
- *
  */
-
 void
 gst_base_metadata_set_option_flag (GstBaseMetadata * base, MetaOptions options)
 {
@@ -1934,11 +1930,7 @@ gst_base_metadata_set_option_flag (GstBaseMetadata * base, MetaOptions options)
  * EXIF, IPTC, XMP or not.
  * @see_also: #gst_base_metadata_set_option_flag
  * #gst_base_metadata_get_option_flag 
- *
- * Returns: nothing
- *
  */
-
 void
 gst_base_metadata_unset_option_flag (GstBaseMetadata * base,
     MetaOptions options)
@@ -1956,9 +1948,7 @@ gst_base_metadata_unset_option_flag (GstBaseMetadata * base,
  * #gst_base_metadata_unset_option_flag
  *
  * Returns: The current mode of operation
- *
  */
-
 MetaOptions
 gst_base_metadata_get_option_flag (const GstBaseMetadata * base)
 {
@@ -1979,11 +1969,7 @@ gst_base_metadata_get_option_flag (const GstBaseMetadata * base)
  * the @data ownership will be taken and @data and @size willl be set to 0;
  * Hanlding EXIF, IPTC, XMP or not.
  * @see_also: #gst_base_metadata_calculate_offsets
- *
- * Returns: Nothing
- *
  */
-
 void gst_base_metadata_update_inject_segment_with_new_data
     (GstBaseMetadata * base,
     guint8 ** data, guint32 * size, MetadataChunkType type)
diff --git a/ext/metadata/gstbasemetadata.h b/ext/metadata/gstbasemetadata.h
index 427496c0..946ac1a4 100644
--- a/ext/metadata/gstbasemetadata.h
+++ b/ext/metadata/gstbasemetadata.h
@@ -67,10 +67,10 @@ G_BEGIN_DECLS
 typedef struct _GstBaseMetadata GstBaseMetadata;
 typedef struct _GstBaseMetadataClass GstBaseMetadataClass;
 
-typedef enum _tag_BaseMetadataType {
+enum {
   BASE_METADATA_DEMUXING,
   BASE_METADATA_MUXING
-} BaseMetadataType;
+};
 
 
 /*
@@ -126,7 +126,7 @@ typedef enum _tag_BaseMetadataType {
     (GST_BASE_METADATA_CAST (obj)->img_type)
 
 
-typedef enum _tag_MetadataState
+typedef enum _MetadataState
 {
   MT_STATE_NULL,                /* still need to check media type */
   MT_STATE_PARSED
diff --git a/ext/metadata/metadata.c b/ext/metadata/metadata.c
index c680b73d..cc4b1dff 100644
--- a/ext/metadata/metadata.c
+++ b/ext/metadata/metadata.c
@@ -41,7 +41,7 @@
  * Boston, MA 02111-1307, USA.
  */
 
-/*
+/**
  * SECTION: metadata
  * @short_description: This module provides high-level functions to parse files
  *
diff --git a/ext/metadata/metadataexif.c b/ext/metadata/metadataexif.c
index c5b8f80d..9e993cce 100644
--- a/ext/metadata/metadataexif.c
+++ b/ext/metadata/metadataexif.c
@@ -41,7 +41,7 @@
  * Boston, MA 02111-1307, USA.
  */
 
-/*
+/**
  * SECTION: metadataexif
  * @short_description: This module provides functions to extract tags from
  * EXIF metadata chunks and create EXIF chunks from metadata tags.
diff --git a/ext/theora/theoradec.h b/ext/theora/theoradec.h
index ccda321e..582b305b 100644
--- a/ext/theora/theoradec.h
+++ b/ext/theora/theoradec.h
@@ -54,6 +54,7 @@ struct _GstTheoraExpDec
 {
   GstElement element;
 
+  /* <private> */
   /* Pads */
   GstPad *sinkpad;
   GstPad *srcpad;