docs: make gtk-doc happier

diff --git a/docs/libs/gst-plugins-base-libs-docs.sgml b/docs/libs/gst-plugins-base-libs-docs.sgml
index 049b629..328dba7 100644 (file)
--- 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 c0ed937..00eeab7 100644 (file)
--- 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 7098347..d69a1a9 100644 (file)
--- 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 5f581b4..5c1c52e 100644 (file)
--- 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 e6ac827..a74e72d 100644 (file)
--- 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 4259657..e5477ad 100644 (file)
--- 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.
  */