Use "Returns:" instead of the invalid "@returns" for annotating return values.

[platform/upstream/glib.git] / glib / deprecated / gthread-deprecated.c

diff --git a/glib/deprecated/gthread-deprecated.c b/glib/deprecated/gthread-deprecated.c
index 5e25ce8..a98fc95 100644 (file)
--- a/glib/deprecated/gthread-deprecated.c
+++ b/glib/deprecated/gthread-deprecated.c
@@ -351,10 +351,11 @@ g_thread_create (GThreadFunc   func,
  * @bound: ignored
  * @priority: ignored
  * @error: return location for error.
- * @Returns: the new #GThread on success.
  *
  * This function creates a new thread.
  *
+ * Returns: the new #GThread on success.
+ *
  * Deprecated:2.32: The @bound and @priority arguments are now ignored.
  * Use g_thread_new().
  */
@@ -501,12 +502,13 @@ g_static_mutex_init (GStaticMutex *mutex)
 /**
  * g_static_mutex_get_mutex:
  * @mutex: a #GStaticMutex.
- * @Returns: the #GMutex corresponding to @mutex.
  *
  * For some operations (like g_cond_wait()) you must have a #GMutex
  * instead of a #GStaticMutex. This function will return the
  * corresponding #GMutex for @mutex.
  *
+ * Returns: the #GMutex corresponding to @mutex.
+ *
  * Deprecated: 2.32: Just use a #GMutex
  */
 GMutex *
@@ -556,10 +558,11 @@ g_static_mutex_get_mutex_impl (GStaticMutex* mutex)
 /**
  * g_static_mutex_trylock:
  * @mutex: a #GStaticMutex.
- * @Returns: %TRUE, if the #GStaticMutex could be locked.
  *
  * Works like g_mutex_trylock(), but for a #GStaticMutex.
  *
+ * Returns: %TRUE, if the #GStaticMutex could be locked.
+ *
  * Deprecated: 2.32: Use g_mutex_trylock()
  */
 
@@ -716,7 +719,6 @@ g_static_rec_mutex_lock (GStaticRecMutex* mutex)
 /**
  * g_static_rec_mutex_trylock:
  * @mutex: a #GStaticRecMutex to lock.
- * @Returns: %TRUE, if @mutex could be locked.
  *
  * Tries to lock @mutex. If @mutex is already locked by another thread,
  * it immediately returns %FALSE. Otherwise it locks @mutex and returns
@@ -724,6 +726,8 @@ g_static_rec_mutex_lock (GStaticRecMutex* mutex)
  * functions increases the depth of @mutex and immediately returns
  * %TRUE.
  *
+ * Returns: %TRUE, if @mutex could be locked.
+ *
  * Deprecated: 2.32: Use g_rec_mutex_trylock()
  */
 gboolean
@@ -789,8 +793,6 @@ g_static_rec_mutex_lock_full (GStaticRecMutex *mutex,
 /**
  * g_static_rec_mutex_unlock_full:
  * @mutex: a #GStaticRecMutex to completely unlock.
- * @Returns: number of times @mutex has been locked by the current
- *           thread.
  *
  * Completely unlocks @mutex. If another thread is blocked in a
  * g_static_rec_mutex_lock() call for @mutex, it will be woken and can
@@ -800,6 +802,9 @@ g_static_rec_mutex_lock_full (GStaticRecMutex *mutex,
  * g_static_rec_mutex_lock_full() with the depth returned by this
  * function.
  *
+ * Returns: number of times @mutex has been locked by the current
+ *          thread.
+ *
  * Deprecated: 2.32: Use g_rec_mutex_unlock()
  */
 guint
@@ -1024,7 +1029,6 @@ g_static_rw_lock_reader_lock (GStaticRWLock* lock)
 /**
  * g_static_rw_lock_reader_trylock:
  * @lock: a #GStaticRWLock to lock for reading.
- * @Returns: %TRUE, if @lock could be locked for reading.
  *
  * Tries to lock @lock for reading. If @lock is already locked for
  * writing by another thread or if another thread is already waiting to
@@ -1032,6 +1036,8 @@ g_static_rw_lock_reader_lock (GStaticRWLock* lock)
  * @lock for reading and returns %TRUE. This lock has to be unlocked by
  * g_static_rw_lock_reader_unlock().
  *
+ * Returns: %TRUE, if @lock could be locked for reading.
+ *
  * Deprectated: 2.32: Use g_rw_lock_reader_trylock() instead
  */
 gboolean
@@ -1113,13 +1119,14 @@ g_static_rw_lock_writer_lock (GStaticRWLock* lock)
 /**
  * g_static_rw_lock_writer_trylock:
  * @lock: a #GStaticRWLock to lock for writing.
- * @Returns: %TRUE, if @lock could be locked for writing.
  *
  * Tries to lock @lock for writing. If @lock is already locked (for
  * either reading or writing) by another thread, it immediately returns
  * %FALSE. Otherwise it locks @lock for writing and returns %TRUE. This
  * lock has to be unlocked by g_static_rw_lock_writer_unlock().
  *
+ * Returns: %TRUE, if @lock could be locked for writing.
+ *
  * Deprectated: 2.32: Use g_rw_lock_writer_trylock() instead
  */
 gboolean