From b00192d7c0c92cbfdbaf11c812dc0c00a19e4cdc Mon Sep 17 00:00:00 2001
From: Edward Hervey <edward@collabora.com>
Date: Sat, 22 Jun 2013 08:57:12 +0200
Subject: [PATCH] codecparsers: Fix gtk-doc

Detected by initial pre-run of gi-scanner.
---
 gst-libs/gst/codecparsers/gsth264parser.h      | 1 +
 gst-libs/gst/codecparsers/gstmpeg4parser.h     | 4 +++-
 gst-libs/gst/codecparsers/gstmpegvideoparser.h | 3 +--
 gst-libs/gst/codecparsers/gstvc1parser.c       | 8 +++-----
 gst-libs/gst/codecparsers/gstvc1parser.h       | 3 ++-
 5 files changed, 10 insertions(+), 9 deletions(-)

diff --git a/gst-libs/gst/codecparsers/gsth264parser.h b/gst-libs/gst/codecparsers/gsth264parser.h
index 46b28c5..e79c1ce 100644
--- a/gst-libs/gst/codecparsers/gsth264parser.h
+++ b/gst-libs/gst/codecparsers/gsth264parser.h
@@ -49,6 +49,7 @@ G_BEGIN_DECLS
 #define GST_H264_IS_SI_SLICE(slice) (((slice)->type % 5) == GST_H264_SI_SLICE)
 
 /**
+ * GstH264Profile:
  * @GST_H264_PROFILE_BASELINE: Baseline profile (A.2.1)
  * @GST_H264_PROFILE_MAIN: Main profile (A.2.2)
  * @GST_H264_PROFILE_EXTENDED: Extended profile (A.2.3)
diff --git a/gst-libs/gst/codecparsers/gstmpeg4parser.h b/gst-libs/gst/codecparsers/gstmpeg4parser.h
index 6864b06..4a726e2 100644
--- a/gst-libs/gst/codecparsers/gstmpeg4parser.h
+++ b/gst-libs/gst/codecparsers/gstmpeg4parser.h
@@ -144,7 +144,7 @@ typedef enum {
 } GstMpeg4VideoObjectCodingType;
 
 /**
- * GstMpeg4ChromaFormat
+ * GstMpeg4ChromaFormat:
  *
  * The chroma format in use as
  * defined in: Table 6-13 -- Meaning of chroma_format
@@ -248,6 +248,8 @@ struct _GstMpeg4VisualObjectSequence {
 };
 
 /**
+ * GstMpeg4VisualObject:
+ *
  * The visual object structure as defined in:
  * 6.2.2 Visual Object Sequence and Visual Object
  */
diff --git a/gst-libs/gst/codecparsers/gstmpegvideoparser.h b/gst-libs/gst/codecparsers/gstmpegvideoparser.h
index daeec60..8d30dd9 100644
--- a/gst-libs/gst/codecparsers/gstmpegvideoparser.h
+++ b/gst-libs/gst/codecparsers/gstmpegvideoparser.h
@@ -384,7 +384,6 @@ struct _GstMpegVideoGop
 
 /**
  * GstMpegVideoTypeOffsetSize:
- *
  * @type: the type of the packet that start at @offset
  * @data: the data containing the packet starting at @offset
  * @offset: the offset of the packet start in bytes, it is the exact, start of the packet, no sync code included
@@ -403,7 +402,7 @@ struct _GstMpegVideoPacket
 gboolean gst_mpeg_video_parse                         (GstMpegVideoPacket * packet,
                                                        const guint8 * data, gsize size, guint offset);
 
-gboolean gst_mpeg_video_parse_sequence_header         (GstMpegVideoSequenceHdr * params,
+gboolean gst_mpeg_video_parse_sequence_header         (GstMpegVideoSequenceHdr * seqhdr,
                                                        const guint8 * data, gsize size, guint offset);
 
 /* seqext and displayext may be NULL if not received */
diff --git a/gst-libs/gst/codecparsers/gstvc1parser.c b/gst-libs/gst/codecparsers/gstvc1parser.c
index a890d78..84817bb 100644
--- a/gst-libs/gst/codecparsers/gstvc1parser.c
+++ b/gst-libs/gst/codecparsers/gstvc1parser.c
@@ -1674,8 +1674,7 @@ gst_vc1_identify_next_bdu (const guint8 * data, gsize size, GstVC1BDU * bdu)
   g_return_val_if_fail (bdu != NULL, GST_VC1_PARSER_ERROR);
 
   if (size < 4) {
-    GST_DEBUG ("Can't parse, buffer has too small size %" G_GSIZE_FORMAT,
-        size);
+    GST_DEBUG ("Can't parse, buffer has too small size %" G_GSIZE_FORMAT, size);
     return GST_VC1_PARSER_ERROR;
   }
 
@@ -1718,7 +1717,7 @@ gst_vc1_identify_next_bdu (const guint8 * data, gsize size, GstVC1BDU * bdu)
  * gst_vc1_parse_sequence_layer:
  * @data: The data to parse
  * @size: the size of @data
- * @structa: The #GstVC1SeqLayer to set.
+ * @seqlayer: The #GstVC1SeqLayer to set.
  *
  * Parses @data, and fills @seqlayer fields.
  *
@@ -1792,7 +1791,7 @@ gst_vc1_parse_sequence_header_struct_a (const guint8 * data,
  * gst_vc1_parse_sequence_header_struct_b:
  * @data: The data to parse
  * @size: the size of @data
- * @structa: The #GstVC1SeqStructB to set.
+ * @structb: The #GstVC1SeqStructB to set.
  *
  * Parses @data, and fills @structb fields.
  *
@@ -2098,7 +2097,6 @@ failed:
 
 /**
  * gst_vc1_bitplanes_new:
- * @seqhdr: The #GstVC1SeqHdr from which to set @bitplanes
  *
  * Creates a new #GstVC1BitPlanes. It should be freed with
  * gst_vc1_bitplanes_free() after use.
diff --git a/gst-libs/gst/codecparsers/gstvc1parser.h b/gst-libs/gst/codecparsers/gstvc1parser.h
index e025db9..e2720d7 100644
--- a/gst-libs/gst/codecparsers/gstvc1parser.h
+++ b/gst-libs/gst/codecparsers/gstvc1parser.h
@@ -34,7 +34,8 @@ G_BEGIN_DECLS
 #define MAX_HRD_NUM_LEAKY_BUCKETS 31
 
 /**
- * @GST_VC1_BFRACTION_BASIS: The @bfraction variable should be divided
+ * GST_VC1_BFRACTION_BASIS:
+ * The @bfraction variable should be divided
  * by this constant to have the actual value.
  */
 #define GST_VC1_BFRACTION_BASIS 840
-- 
2.7.4