From 251e4d160a57323c4deea143ada5d7ff4e08c2ef Mon Sep 17 00:00:00 2001
From: Stefan Kost <ensonic@users.sf.net>
Date: Thu, 26 Feb 2009 09:35:43 +0200
Subject: [PATCH] docs: don't put random stuff in tags.

Tags like Since: or Returns: can only be followed by more tags. gtk-doc has no
tag to append text again to the documentation body.
---
 gst-libs/gst/app/gstappsink.c       |  4 ++--
 gst-libs/gst/app/gstappsrc.c        |  4 ++--
 gst-libs/gst/audio/gstaudiofilter.c |  4 ++--
 gst-libs/gst/audio/gstringbuffer.c  | 16 ++++++++--------
 gst-libs/gst/rtp/gstrtcpbuffer.c    |  4 ++--
 5 files changed, 16 insertions(+), 16 deletions(-)

diff --git a/gst-libs/gst/app/gstappsink.c b/gst-libs/gst/app/gstappsink.c
index 183c7f0e97..8e18336a5e 100644
--- a/gst-libs/gst/app/gstappsink.c
+++ b/gst-libs/gst/app/gstappsink.c
@@ -72,9 +72,9 @@
  * The eos signal can also be used to be informed when the EOS state is reached
  * to avoid polling.
  *
- * Since: 0.10.22
- *
  * Last reviewed on 2008-12-17 (0.10.22)
+ *
+ * Since: 0.10.22
  */
 
 #ifdef HAVE_CONFIG_H
diff --git a/gst-libs/gst/app/gstappsrc.c b/gst-libs/gst/app/gstappsrc.c
index 69b37e64be..aa7bb255b1 100644
--- a/gst-libs/gst/app/gstappsrc.c
+++ b/gst-libs/gst/app/gstappsrc.c
@@ -96,10 +96,10 @@
  * gst_app_src_end_of_stream() or emit the end-of-stream action signal. After
  * this call, no more buffers can be pushed into appsrc until a flushing seek
  * happened or the state of the appsrc has gone through READY.
- * 
- * Since: 0.10.22
  *
  * Last reviewed on 2008-12-17 (0.10.10)
+ *
+ * Since: 0.10.22
  */
 
 #ifdef HAVE_CONFIG_H
diff --git a/gst-libs/gst/audio/gstaudiofilter.c b/gst-libs/gst/audio/gstaudiofilter.c
index 6a2323ec3c..9c329bfb0f 100644
--- a/gst-libs/gst/audio/gstaudiofilter.c
+++ b/gst-libs/gst/audio/gstaudiofilter.c
@@ -37,9 +37,9 @@
  * #GstBaseTransformClass.transform()
  * virtual functions in their class_init function.
  *
- * Since: 0.10.12
- *
  * Last reviewed on 2007-02-03 (0.10.11.1)
+ *
+ * Since: 0.10.12
  */
 
 #ifdef HAVE_CONFIG_H
diff --git a/gst-libs/gst/audio/gstringbuffer.c b/gst-libs/gst/audio/gstringbuffer.c
index e9023c8f13..24bbda4d31 100644
--- a/gst-libs/gst/audio/gstringbuffer.c
+++ b/gst-libs/gst/audio/gstringbuffer.c
@@ -901,12 +901,12 @@ gst_ring_buffer_is_acquired (GstRingBuffer * buf)
  *
  * Activate @buf to start or stop pulling data.
  *
+ * MT safe.
+ *
  * Returns: TRUE if the device could be activated in the requested mode,
  * FALSE on error.
  *
  * Since: 0.10.22.
- *
- * MT safe.
  */
 gboolean
 gst_ring_buffer_activate (GstRingBuffer * buf, gboolean active)
@@ -970,11 +970,11 @@ activate_failed:
  *
  * Check if @buf is activated.
  *
+ * MT safe.
+ *
  * Returns: TRUE if the device is active.
  *
  * Since: 0.10.22.
- *
- * MT safe.
  */
 gboolean
 gst_ring_buffer_is_active (GstRingBuffer * buf)
@@ -1552,13 +1552,13 @@ G_STMT_START {					\
  * interrupted, one can resume the processing by passing the previously returned
  * @accum value back to this function.
  *
+ * MT safe.
+ *
  * Returns: The number of samples written to the ringbuffer or -1 on error. The
  * number of samples written can be less than @out_samples when @buf was interrupted
  * with a flush or stop.
  *
  * Since: 0.10.11.
- *
- * MT safe.
  */
 guint
 gst_ring_buffer_commit_full (GstRingBuffer * buf, guint64 * sample,
@@ -1956,9 +1956,9 @@ gst_ring_buffer_clear (GstRingBuffer * buf, gint segment)
  * Tell the ringbuffer that it is allowed to start playback when
  * the ringbuffer is filled with samples. 
  *
- * Since: 0.10.6
- *
  * MT safe.
+ *
+ * Since: 0.10.6
  */
 void
 gst_ring_buffer_may_start (GstRingBuffer * buf, gboolean allowed)
diff --git a/gst-libs/gst/rtp/gstrtcpbuffer.c b/gst-libs/gst/rtp/gstrtcpbuffer.c
index b7172c6ee2..ab77c8a47d 100644
--- a/gst-libs/gst/rtp/gstrtcpbuffer.c
+++ b/gst-libs/gst/rtp/gstrtcpbuffer.c
@@ -41,9 +41,9 @@
  * </para>
  * </refsect2>
  *
- * Since: 0.10.13
- *
  * Last reviewed on 2007-03-26 (0.10.13)
+ *
+ * Since: 0.10.13
  */
 
 #include <string.h>