Add annotations for element types of returned lists
authorMiloslav Trmač <mitr@redhat.com>
Mon, 15 Apr 2013 21:08:21 +0000 (23:08 +0200)
committerMiloslav Trmač <mitr@redhat.com>
Mon, 15 Apr 2013 21:22:50 +0000 (23:22 +0200)
... to silence warnings when g-ir-scanner warnings are enabled.

https://bugs.freedesktop.org/show_bug.cgi?id=63573

src/polkit/polkitauthority.c
src/polkitagent/polkitagentlistener.c

index 9947cf3273b29abbfa6d33390fff3957bc246ace..75619ab70f67f9636bedc81f58e98e4c3e6d589d 100644 (file)
@@ -680,10 +680,10 @@ polkit_authority_enumerate_actions (PolkitAuthority     *authority,
  *
  * Finishes retrieving all registered actions.
  *
- * Returns: (transfer full): A list of #PolkitActionDescription
- * objects or %NULL if @error is set. The returned list should be
- * freed with g_list_free() after each element have been freed with
- * g_object_unref().
+ * Returns: (element-type Polkit.ActionDescription) (transfer full): A list of
+ * #PolkitActionDescription objects or %NULL if @error is set. The returned
+ * list should be freed with g_list_free() after each element have been freed
+ * with g_object_unref().
  **/
 GList *
 polkit_authority_enumerate_actions_finish (PolkitAuthority *authority,
@@ -736,9 +736,9 @@ polkit_authority_enumerate_actions_finish (PolkitAuthority *authority,
  * is blocked until a reply is received. See
  * polkit_authority_enumerate_actions() for the asynchronous version.
  *
- * Returns: (transfer full): A list of #PolkitActionDescription or
- * %NULL if @error is set. The returned list should be freed with
- * g_list_free() after each element have been freed with
+ * Returns: (element-type Polkit.ActionDescription) (transfer full): A list of
+ * #PolkitActionDescription or %NULL if @error is set. The returned list should
+ * be freed with g_list_free() after each element have been freed with
  * g_object_unref().
  **/
 GList *
@@ -1656,10 +1656,10 @@ polkit_authority_enumerate_temporary_authorizations (PolkitAuthority     *author
  *
  * Finishes retrieving all registered actions.
  *
- * Returns: (transfer full): A list of #PolkitTemporaryAuthorization
- * objects or %NULL if @error is set. The returned list should be
- * freed with g_list_free() after each element have been freed with
- * g_object_unref().
+ * Returns: (element-type Polkit.TemporaryAuthorization) (transfer full): A
+ * list of #PolkitTemporaryAuthorization objects or %NULL if @error is set. The
+ * returned list should be freed with g_list_free() after each element have
+ * been freed with g_object_unref().
  **/
 GList *
 polkit_authority_enumerate_temporary_authorizations_finish (PolkitAuthority *authority,
@@ -1723,10 +1723,10 @@ polkit_authority_enumerate_temporary_authorizations_finish (PolkitAuthority *aut
  * polkit_authority_enumerate_temporary_authorizations() for the
  * asynchronous version.
  *
- * Returns: (transfer full): A list of #PolkitTemporaryAuthorization
- * objects or %NULL if @error is set. The returned list should be
- * freed with g_list_free() after each element have been freed with
- * g_object_unref().
+ * Returns: (element-type Polkit.TemporaryAuthorization) (transfer full): A
+ * list of #PolkitTemporaryAuthorization objects or %NULL if @error is set. The
+ * returned list should be freed with g_list_free() after each element have
+ * been freed with g_object_unref().
  **/
 GList *
 polkit_authority_enumerate_temporary_authorizations_sync (PolkitAuthority     *authority,
index 29a0fdfd0c0bbb9488a65f6d262b43c76b337086..8c333afaab3a5b34ad09d39cc7bfc64ff2720404 100644 (file)
@@ -749,7 +749,7 @@ polkit_agent_listener_class_init (PolkitAgentListenerClass *klass)
  * @icon_name: A themed icon name representing the action or %NULL.
  * @details: Details describing the action.
  * @cookie: The cookie for the authentication request.
- * @identities: A list of #PolkitIdentity objects that the user can choose to authenticate as.
+ * @identities: (element-type Polkit.Identity): A list of #PolkitIdentity objects that the user can choose to authenticate as.
  * @cancellable: A #GCancellable.
  * @callback: Function to call when the user is done authenticating.
  * @user_data: Data to pass to @callback.