From: Torsten Schoenfeld <kaffeetisch@gmx.de>
To: linux-hotplug@vger.kernel.org
Subject: gudev: a few missing annotations
Date: Sat, 18 Sep 2010 18:34:06 +0000 [thread overview]
Message-ID: <4C95061E.1080602@gmx.de> (raw)
[-- Attachment #1: Type: text/plain, Size: 132 bytes --]
Here are a few missing gudev annotations that newer
gobject-introspection versions demand.
[I'm not subscribed, so please CC me.]
[-- Attachment #2: gudev-annotations.patch --]
[-- Type: text/x-patch, Size: 3379 bytes --]
diff --git a/extras/gudev/gudevclient.c b/extras/gudev/gudevclient.c
index e829ca3..9ebd8f8 100644
--- a/extras/gudev/gudevclient.c
+++ b/extras/gudev/gudevclient.c
@@ -316,7 +316,7 @@ g_udev_client_init (GUdevClient *client)
/**
* g_udev_client_new:
- * @subsystems: (allow-none): A %NULL terminated string array of subsystems to listen for uevents on, %NULL to not listen on uevents at all, or an empty array to listen to uevents on all subsystems. See the documentation for the #GUdevClient:subsystems property for details on this parameter.
+ * @subsystems: (array zero-terminated=1) (element-type utf8) (transfer none) (allow-none): A %NULL terminated string array of subsystems to listen for uevents on, %NULL to not listen on uevents at all, or an empty array to listen to uevents on all subsystems. See the documentation for the #GUdevClient:subsystems property for details on this parameter.
*
* Constructs a #GUdevClient object that can be used to query
* information about devices. Connect to the #GUdevClient::uevent
@@ -339,7 +339,7 @@ g_udev_client_new (const gchar * const *subsystems)
*
* Gets all devices belonging to @subsystem.
*
- * Returns: (element-type GUdevDevice): A list of #GUdevDevice objects. The caller should free the result by using g_object_unref() on each element in the list and then g_list_free() on the list.
+ * Returns: (element-type GUdevDevice) (transfer full): A list of #GUdevDevice objects. The caller should free the result by using g_object_unref() on each element in the list and then g_list_free() on the list.
*/
GList *
g_udev_client_query_by_subsystem (GUdevClient *client,
@@ -392,7 +392,7 @@ g_udev_client_query_by_subsystem (GUdevClient *client,
*
* Looks up a device for a type and device number.
*
- * Returns: A #GUdevDevice object or %NULL if the device was not found. Free with g_object_unref().
+ * Returns: (transfer full): A #GUdevDevice object or %NULL if the device was not found. Free with g_object_unref().
*/
GUdevDevice *
g_udev_client_query_by_device_number (GUdevClient *client,
@@ -424,7 +424,7 @@ g_udev_client_query_by_device_number (GUdevClient *client,
*
* Looks up a device for a device file.
*
- * Returns: A #GUdevDevice object or %NULL if the device was not found. Free with g_object_unref().
+ * Returns: (transfer full): A #GUdevDevice object or %NULL if the device was not found. Free with g_object_unref().
*/
GUdevDevice *
g_udev_client_query_by_device_file (GUdevClient *client,
@@ -460,7 +460,7 @@ g_udev_client_query_by_device_file (GUdevClient *client,
*
* Looks up a device for a sysfs path.
*
- * Returns: A #GUdevDevice object or %NULL if the device was not found. Free with g_object_unref().
+ * Returns: (transfer full): A #GUdevDevice object or %NULL if the device was not found. Free with g_object_unref().
*/
GUdevDevice *
g_udev_client_query_by_sysfs_path (GUdevClient *client,
@@ -492,7 +492,7 @@ g_udev_client_query_by_sysfs_path (GUdevClient *client,
*
* Looks up a device for a subsystem and name.
*
- * Returns: A #GUdevDevice object or %NULL if the device was not found. Free with g_object_unref().
+ * Returns: (transfer full): A #GUdevDevice object or %NULL if the device was not found. Free with g_object_unref().
*/
GUdevDevice *
g_udev_client_query_by_subsystem_and_name (GUdevClient *client,
next reply other threads:[~2010-09-18 18:34 UTC|newest]
Thread overview: 2+ messages / expand[flat|nested] mbox.gz Atom feed top
2010-09-18 18:34 Torsten Schoenfeld [this message]
2010-09-20 8:26 ` gudev: a few missing annotations Kay Sievers
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=4C95061E.1080602@gmx.de \
--to=kaffeetisch@gmx.de \
--cc=linux-hotplug@vger.kernel.org \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.