From 2011ecd6ac9dff37aaab9a0d831b78c369375b4b Mon Sep 17 00:00:00 2001
From: Matthias Clasen <mclasen@redhat.com>
Date: Mon, 21 Nov 2011 11:01:16 -0500
Subject: [PATCH] GPermission: Drop @returns syntax from doc comments

---
 gio/gpermission.c | 21 ++++++++++++++-------
 1 file changed, 14 insertions(+), 7 deletions(-)

diff --git a/gio/gpermission.c b/gio/gpermission.c
index 97a4fd9..aefccaa 100644
--- a/gio/gpermission.c
+++ b/gio/gpermission.c
@@ -76,7 +76,6 @@ enum  {
  * @permission: a #GPermission instance
  * @cancellable: a #GCancellable, or %NULL
  * @error: a pointer to a %NULL #GError, or %NULL
- * @returns: %TRUE if the permission was successfully acquired
  *
  * Attempts to acquire the permission represented by @permission.
  *
@@ -94,6 +93,8 @@ enum  {
  * user interaction is required).  See g_permission_acquire_async() for
  * the non-blocking version.
  *
+ * Returns: %TRUE if the permission was successfully acquired
+ *
  * Since: 2.26
  */
 gboolean
@@ -134,7 +135,6 @@ g_permission_acquire_async (GPermission         *permission,
  * @permission: a #GPermission instance
  * @result: the #GAsyncResult given to the #GAsyncReadyCallback
  * @error: a pointer to a %NULL #GError, or %NULL
- * @returns: %TRUE if the permission was successfully acquired
  *
  * Collects the result of attempting to acquire the permission
  * represented by @permission.
@@ -142,6 +142,8 @@ g_permission_acquire_async (GPermission         *permission,
  * This is the second half of the asynchronous version of
  * g_permission_acquire().
  *
+ * Returns: %TRUE if the permission was successfully acquired
+ *
  * Since: 2.26
  **/
 gboolean
@@ -158,7 +160,6 @@ g_permission_acquire_finish (GPermission   *permission,
  * @permission: a #GPermission instance
  * @cancellable: a #GCancellable, or %NULL
  * @error: a pointer to a %NULL #GError, or %NULL
- * @returns: %TRUE if the permission was successfully released
  *
  * Attempts to release the permission represented by @permission.
  *
@@ -176,6 +177,8 @@ g_permission_acquire_finish (GPermission   *permission,
  * user interaction is required).  See g_permission_release_async() for
  * the non-blocking version.
  *
+ * Returns: %TRUE if the permission was successfully released
+ *
  * Since: 2.26
  **/
 gboolean
@@ -216,7 +219,6 @@ g_permission_release_async (GPermission         *permission,
  * @permission: a #GPermission instance
  * @result: the #GAsyncResult given to the #GAsyncReadyCallback
  * @error: a pointer to a %NULL #GError, or %NULL
- * @returns: %TRUE if the permission was successfully released
  *
  * Collects the result of attempting to release the permission
  * represented by @permission.
@@ -224,6 +226,8 @@ g_permission_release_async (GPermission         *permission,
  * This is the second half of the asynchronous version of
  * g_permission_release().
  *
+ * Returns: %TRUE if the permission was successfully released
+ *
  * Since: 2.26
  **/
 gboolean
@@ -238,12 +242,13 @@ g_permission_release_finish (GPermission   *permission,
 /**
  * g_permission_get_allowed:
  * @permission: a #GPermission instance
- * @returns: the value of the 'allowed' property
  *
  * Gets the value of the 'allowed' property.  This property is %TRUE if
  * the caller currently has permission to perform the action that
  * @permission represents the permission to perform.
  *
+ * Returns: the value of the 'allowed' property
+ *
  * Since: 2.26
  **/
 gboolean
@@ -255,12 +260,13 @@ g_permission_get_allowed (GPermission *permission)
 /**
  * g_permission_get_can_acquire:
  * @permission: a #GPermission instance
- * @returns: the value of the 'can-acquire' property
  *
  * Gets the value of the 'can-acquire' property.  This property is %TRUE
  * if it is generally possible to acquire the permission by calling
  * g_permission_acquire().
  *
+ * Returns: the value of the 'can-acquire' property
+ *
  * Since: 2.26
  **/
 gboolean
@@ -272,12 +278,13 @@ g_permission_get_can_acquire (GPermission *permission)
 /**
  * g_permission_get_can_release:
  * @permission: a #GPermission instance
- * @returns: the value of the 'can-release' property
  *
  * Gets the value of the 'can-release' property.  This property is %TRUE
  * if it is generally possible to release the permission by calling
  * g_permission_release().
  *
+ * Returns: the value of the 'can-release' property
+ *
  * Since: 2.26
  **/
 gboolean
-- 
2.7.4