From 976bc30c13ffaeed54466a6770273a969f673c4a Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Corentin=20No=C3=ABl?= Date: Sat, 5 May 2018 23:36:23 +0100 Subject: [PATCH] introspection: fix some annotations --- src/polkit/polkitsystembusname.c | 3 ++- src/polkit/polkitunixgroup.c | 7 ++++--- src/polkit/polkitunixnetgroup.c | 3 ++- src/polkit/polkitunixprocess.c | 9 ++++++--- src/polkit/polkitunixsession.c | 13 +++++++------ src/polkit/polkitunixuser.c | 6 ++++-- 6 files changed, 25 insertions(+), 16 deletions(-) diff --git a/src/polkit/polkitsystembusname.c b/src/polkit/polkitsystembusname.c index aa92d63..23c7c48 100644 --- a/src/polkit/polkitsystembusname.c +++ b/src/polkit/polkitsystembusname.c @@ -191,7 +191,8 @@ polkit_system_bus_name_set_name (PolkitSystemBusName *system_bus_name, * * Creates a new #PolkitSystemBusName for @name. * - * Returns: (transfer full): A #PolkitSystemBusName. Free with g_object_unref(). + * Returns: (transfer full) (type PolkitSystemBusName): A #PolkitSystemBusName. + * Free with g_object_unref(). */ PolkitSubject * polkit_system_bus_name_new (const gchar *name) diff --git a/src/polkit/polkitunixgroup.c b/src/polkit/polkitunixgroup.c index c57a1aa..3e213cf 100644 --- a/src/polkit/polkitunixgroup.c +++ b/src/polkit/polkitunixgroup.c @@ -178,7 +178,8 @@ polkit_unix_group_set_gid (PolkitUnixGroup *group, * * Creates a new #PolkitUnixGroup object for @gid. * - * Returns: (transfer full): A #PolkitUnixGroup object. Free with g_object_unref(). + * Returns: (transfer full) (type PolkitUnixGroup): A #PolkitUnixGroup object. + * Free with g_object_unref(). */ PolkitIdentity * polkit_unix_group_new (gint gid) @@ -196,8 +197,8 @@ polkit_unix_group_new (gint gid) * Creates a new #PolkitUnixGroup object for a group with the group name * @name. * - * Returns: (transfer full): (allow-none): A #PolkitUnixGroup object or %NULL if @error - * is set. + * Returns: (transfer full) (nullable) (type PolkitUnixGroup): A #PolkitUnixGroup + * object or %NULL if @error is set. */ PolkitIdentity * polkit_unix_group_new_for_name (const gchar *name, diff --git a/src/polkit/polkitunixnetgroup.c b/src/polkit/polkitunixnetgroup.c index 8a2b369..bc49453 100644 --- a/src/polkit/polkitunixnetgroup.c +++ b/src/polkit/polkitunixnetgroup.c @@ -189,7 +189,8 @@ polkit_unix_netgroup_set_name (PolkitUnixNetgroup *group, * * Creates a new #PolkitUnixNetgroup object for @name. * - * Returns: (transfer full): A #PolkitUnixNetgroup object. Free with g_object_unref(). + * Returns: (transfer full) (type PolkitUnixNetgroup): A #PolkitUnixNetgroup + * object. Free with g_object_unref(). */ PolkitIdentity * polkit_unix_netgroup_new (const gchar *name) diff --git a/src/polkit/polkitunixprocess.c b/src/polkit/polkitunixprocess.c index f292c9b..e74283c 100644 --- a/src/polkit/polkitunixprocess.c +++ b/src/polkit/polkitunixprocess.c @@ -366,7 +366,8 @@ polkit_unix_process_set_pid (PolkitUnixProcess *process, * e.g. the /proc filesystem depending on the * platform in use. * - * Returns: (transfer full): A #PolkitSubject. Free with g_object_unref(). + * Returns: (transfer full) (type PolkitUnixProcess): A #PolkitUnixProcess. + * Free with g_object_unref(). */ PolkitSubject * polkit_unix_process_new (gint pid) @@ -387,7 +388,8 @@ polkit_unix_process_new (gint pid) * /proc filesystem depending on the platform in * use. * - * Returns: (transfer full): A #PolkitSubject. Free with g_object_unref(). + * Returns: (transfer full) (type PolkitUnixProcess): A #PolkitUnixProcess. + * Free with g_object_unref(). */ PolkitSubject * polkit_unix_process_new_full (gint pid, @@ -407,7 +409,8 @@ polkit_unix_process_new_full (gint pid, * * Creates a new #PolkitUnixProcess object for @pid, @start_time and @uid. * - * Returns: (transfer full): A #PolkitSubject. Free with g_object_unref(). + * Returns: (transfer full) (type PolkitUnixProcess): A #PolkitUnixProcess. + * Free with g_object_unref(). */ PolkitSubject * polkit_unix_process_new_for_owner (gint pid, diff --git a/src/polkit/polkitunixsession.c b/src/polkit/polkitunixsession.c index c6f85bc..425aa94 100644 --- a/src/polkit/polkitunixsession.c +++ b/src/polkit/polkitunixsession.c @@ -222,7 +222,8 @@ polkit_unix_session_set_session_id (PolkitUnixSession *session, * * Creates a new #PolkitUnixSession for @session_id. * - * Returns: (transfer full): A #PolkitUnixSession. Free with g_object_unref(). + * Returns: (transfer full) (type PolkitUnixSession): A #PolkitUnixSession. + * Free with g_object_unref(). **/ PolkitSubject * polkit_unix_session_new (const gchar *session_id) @@ -274,9 +275,9 @@ polkit_unix_session_new_for_process (gint pid, * * Finishes constructing a #PolkitSubject for a process id. * - * Returns: (transfer full) (allow-none): A #PolkitUnixSession for the @pid passed to - * polkit_unix_session_new_for_process() or %NULL if @error is - * set. Free with g_object_unref(). + * Returns: (transfer full) (nullable) (type PolkitUnixSession): A #PolkitUnixSession + * for the @pid passed to polkit_unix_session_new_for_process() + * or %NULL if @error is set. Free with g_object_unref(). **/ PolkitSubject * polkit_unix_session_new_for_process_finish (GAsyncResult *res, @@ -312,8 +313,8 @@ polkit_unix_session_new_for_process_finish (GAsyncResult *res, * reply is received. For the asynchronous version, see * polkit_unix_session_new_for_process(). * - * Returns: (allow-none) (transfer full): A #PolkitUnixSession for - * @pid or %NULL if @error is set. Free with g_object_unref(). + * Returns: (allow-none) (transfer full) (type PolkitUnixSession): A #PolkitUnixSession + * for @pid or %NULL if @error is set. Free with g_object_unref(). **/ PolkitSubject * polkit_unix_session_new_for_process_sync (gint pid, diff --git a/src/polkit/polkitunixuser.c b/src/polkit/polkitunixuser.c index 8bfd3a1..c25df4f 100644 --- a/src/polkit/polkitunixuser.c +++ b/src/polkit/polkitunixuser.c @@ -191,7 +191,8 @@ polkit_unix_user_set_uid (PolkitUnixUser *user, * * Creates a new #PolkitUnixUser object for @uid. * - * Returns: (transfer full): A #PolkitUnixUser object. Free with g_object_unref(). + * Returns: (transfer full) (type PolkitUnixUser): A #PolkitUnixUser object. + * Free with g_object_unref(). */ PolkitIdentity * polkit_unix_user_new (gint uid) @@ -209,7 +210,8 @@ polkit_unix_user_new (gint uid) * Creates a new #PolkitUnixUser object for a user with the user name * @name. * - * Returns: (allow-none) (transfer full): A #PolkitUnixUser object or %NULL if @error is set. + * Returns: (nullable) (transfer full) (type PolkitUnixUser): A #PolkitUnixUser + * object or %NULL if @error is set. */ PolkitIdentity * polkit_unix_user_new_for_name (const gchar *name, -- 2.17.0