doc: Workaround gtkdoc issue

With gtkdoc 1.22, the XML generator fails when a itemizedlist is
followed by a refsect2. Workaround the issue by wrapping the
refsect2 into para.

diff --git a/gst/audiomixer/gstaudiomixer.c b/gst/audiomixer/gstaudiomixer.c
index f0e8f66..57be45f 100644 (file)
--- a/gst/audiomixer/gstaudiomixer.c
+++ b/gst/audiomixer/gstaudiomixer.c
@@ -42,13 +42,14 @@
  * </listitem>
  * </itemizedlist>
  *
+ * <para>
  * <refsect2>
  * <title>Example launch line</title>
  * |[
  * gst-launch audiotestsrc freq=100 ! audiomixer name=mix ! audioconvert ! alsasink audiotestsrc freq=500 ! mix.
  * ]| This pipeline produces two sine waves mixed together.
  * </refsect2>
- *
+ * </para>
  */
 
 #ifdef HAVE_CONFIG_H

diff --git a/gst/compositor/compositor.c b/gst/compositor/compositor.c
index 942c480..7ab6c85 100644 (file)
--- a/gst/compositor/compositor.c
+++ b/gst/compositor/compositor.c
@@ -61,6 +61,7 @@
  * </listitem>
  * </itemizedlist>
  *
+ * <para>
  * <refsect2>
  * <title>Sample pipelines</title>
  * |[
@@ -104,6 +105,7 @@
  *   timeoverlay ! queue2 ! comp.
  * ]| A pipeline to demonstrate synchronized compositing (the second stream starts after 3 seconds)
  * </refsect2>
+ * </para>
  */
 
 #ifdef HAVE_CONFIG_H