From d877ef13f5f99da56e16166286bc8daf9b8c4d58 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Tim-Philipp=20M=C3=BCller?= <tim.muller@collabora.co.uk>
Date: Fri, 30 Dec 2011 19:24:09 +0000
Subject: [PATCH] docs: make gtk-doc happier

---
 docs/libs/gst-plugins-base-libs-docs.sgml    | 17 ++++++++---------
 docs/libs/gst-plugins-base-libs-sections.txt |  1 -
 gst-libs/gst/audio/gstaudiodecoder.c         |  2 +-
 gst-libs/gst/audio/gstaudioringbuffer.h      |  1 -
 gst-libs/gst/pbutils/encoding-profile.c      |  3 ++-
 gst-libs/gst/video/gstvideofilter.h          |  3 +++
 6 files changed, 14 insertions(+), 13 deletions(-)

diff --git a/docs/libs/gst-plugins-base-libs-docs.sgml b/docs/libs/gst-plugins-base-libs-docs.sgml
index 049b6291a0..328dba7c06 100644
--- a/docs/libs/gst-plugins-base-libs-docs.sgml
+++ b/docs/libs/gst-plugins-base-libs-docs.sgml
@@ -56,6 +56,10 @@
       <xi:include href="xml/gstmultichannel.xml" />
       <xi:include href="xml/gstaudioringbuffer.xml" />
       <xi:include href="xml/gstaudioiec61937.xml" />
+      <xi:include href="xml/gststreamvolume.xml" />
+      <xi:include href="xml/gstmixer.xml" />
+      <xi:include href="xml/gstmixeroptions.xml" />
+      <xi:include href="xml/gstmixertrack.xml" />
     </chapter>
 
     <chapter id="gstreamer-ffft">
@@ -84,19 +88,10 @@
         <filename>gstreamer-plugins-base-&GST_MAJORMINOR;.pc</filename> and adding
         <filename>-lgstinterfaces-&GST_MAJORMINOR;</filename> to the library flags.
       </para>
-      <xi:include href="xml/gstcolorbalance.xml" />
-      <xi:include href="xml/gstcolorbalancechannel.xml" />
-      <xi:include href="xml/gstmixer.xml" />
-      <xi:include href="xml/gstmixeroptions.xml" />
-      <xi:include href="xml/gstmixertrack.xml" />
       <xi:include href="xml/gstnavigation.xml" />
-      <xi:include href="xml/gstpropertyprobe.xml" />
-      <xi:include href="xml/gststreamvolume.xml" />
       <xi:include href="xml/gsttuner.xml" />
       <xi:include href="xml/gsttunerchannel.xml" />
       <xi:include href="xml/gsttunernorm.xml" />
-      <xi:include href="xml/gstvideoorientation.xml" />
-      <xi:include href="xml/gstvideooverlay.xml" />
     </chapter>
 
     <chapter id="gstreamer-riff">
@@ -198,6 +193,10 @@
       <xi:include href="xml/gstvideooverlaycomposition.xml" />
       <xi:include href="xml/gstvideofilter.xml" />
       <xi:include href="xml/gstvideosink.xml" />
+      <xi:include href="xml/gstcolorbalance.xml" />
+      <xi:include href="xml/gstcolorbalancechannel.xml" />
+      <xi:include href="xml/gstvideoorientation.xml" />
+      <xi:include href="xml/gstvideooverlay.xml" />
     </chapter>
   </part>
 
diff --git a/docs/libs/gst-plugins-base-libs-sections.txt b/docs/libs/gst-plugins-base-libs-sections.txt
index c0ed9370c3..00eeab7699 100644
--- a/docs/libs/gst-plugins-base-libs-sections.txt
+++ b/docs/libs/gst-plugins-base-libs-sections.txt
@@ -382,7 +382,6 @@ GstAudioRingBuffer
 GstAudioRingBufferClass
 GstAudioRingBufferSpec
 GstAudioRingBufferCallback
-GstAudioRingBufferSegState
 GstAudioRingBufferState
 GstAudioRingBufferFormatType
 
diff --git a/gst-libs/gst/audio/gstaudiodecoder.c b/gst-libs/gst/audio/gstaudiodecoder.c
index 7098347132..d69a1a9ced 100644
--- a/gst-libs/gst/audio/gstaudiodecoder.c
+++ b/gst-libs/gst/audio/gstaudiodecoder.c
@@ -499,7 +499,7 @@ gst_audio_decoder_finalize (GObject * object)
  * sanity checking of @caps and extracts output data format
  *
  * Returns: %TRUE on success.
- * */
+ **/
 gboolean
 gst_audio_decoder_set_outcaps (GstAudioDecoder * dec, GstCaps * caps)
 {
diff --git a/gst-libs/gst/audio/gstaudioringbuffer.h b/gst-libs/gst/audio/gstaudioringbuffer.h
index 5f581b4f8f..5c1c52ef54 100644
--- a/gst-libs/gst/audio/gstaudioringbuffer.h
+++ b/gst-libs/gst/audio/gstaudioringbuffer.h
@@ -157,7 +157,6 @@ struct _GstAudioRingBufferSpec
  * @memory: data in the ringbuffer
  * @size: size of data in the ringbuffer
  * @spec: format and layout of the ringbuffer data
- * @segstate: status of each segment in the ringbuffer (unused)
  * @samples_per_seg: number of samples in one segment
  * @empty_seg: pointer to memory holding one segment of silence samples
  * @state: state of the buffer
diff --git a/gst-libs/gst/pbutils/encoding-profile.c b/gst-libs/gst/pbutils/encoding-profile.c
index e6ac8278a5..a74e72dfba 100644
--- a/gst-libs/gst/pbutils/encoding-profile.c
+++ b/gst-libs/gst/pbutils/encoding-profile.c
@@ -454,7 +454,8 @@ gst_encoding_container_profile_class_init (GObjectClass * klass)
  * @profile: a #GstEncodingContainerProfile
  *
  * Returns: (element-type GstPbutils.EncodingProfile) (transfer none):
- * the list of contained #GstEncodingProfile. */
+ * the list of contained #GstEncodingProfile.
+ */
 const GList *
 gst_encoding_container_profile_get_profiles (GstEncodingContainerProfile *
     profile)
diff --git a/gst-libs/gst/video/gstvideofilter.h b/gst-libs/gst/video/gstvideofilter.h
index 4259657cd6..e5477adb9d 100644
--- a/gst-libs/gst/video/gstvideofilter.h
+++ b/gst-libs/gst/video/gstvideofilter.h
@@ -54,6 +54,9 @@ struct _GstVideoFilter {
 /**
  * GstVideoFilterClass:
  * @parent_class: the parent class structure
+ * @set_info: function to be called with the negotiated caps and video infos
+ * @transform_frame: transform a video frame
+ * @transform_frame_ip: transform a video frame in place
  *
  * The video filter class structure.
  */