[glib] gdbusproxy: Add some missing (transfer) and (nullable) annotations
- From: Philip Withnall <pwithnall src gnome org>
- To: commits-list gnome org
- Cc:
- Subject: [glib] gdbusproxy: Add some missing (transfer) and (nullable) annotations
- Date: Mon, 12 Feb 2018 11:33:51 +0000 (UTC)
commit f8ee429db7f0f89464df0c622ba3950a8f21bf15
Author: Philip Withnall <withnall endlessm com>
Date: Fri Feb 9 11:12:14 2018 +0000
gdbusproxy: Add some missing (transfer) and (nullable) annotations
Signed-off-by: Philip Withnall <withnall endlessm com>
https://bugzilla.gnome.org/show_bug.cgi?id=773663
gio/gdbusproxy.c | 31 +++++++++++++++++++------------
1 file changed, 19 insertions(+), 12 deletions(-)
---
diff --git a/gio/gdbusproxy.c b/gio/gdbusproxy.c
index ef77e40a8..38ccd285a 100644
--- a/gio/gdbusproxy.c
+++ b/gio/gdbusproxy.c
@@ -656,7 +656,8 @@ property_name_sort_func (const gchar **a,
*
* Gets the names of all cached properties on @proxy.
*
- * Returns: (transfer full): A %NULL-terminated array of strings or %NULL if
+ * Returns: (transfer full) (nullable) (array zero-terminated=1): A
+ * %NULL-terminated array of strings or %NULL if
* @proxy has no cached properties. Free the returned array with
* g_strfreev().
*
@@ -723,9 +724,9 @@ lookup_property_info (GDBusProxy *proxy,
* #GDBusProxy:g-interface-info) and @property_name is referenced by
* it, then @value is checked against the type of the property.
*
- * Returns: A reference to the #GVariant instance that holds the value
- * for @property_name or %NULL if the value is not in the cache. The
- * returned reference must be freed with g_variant_unref().
+ * Returns: (transfer full) (nullable): A reference to the #GVariant instance
+ * that holds the value for @property_name or %NULL if the value is not in
+ * the cache. The returned reference must be freed with g_variant_unref().
*
* Since: 2.26
*/
@@ -2049,7 +2050,8 @@ g_dbus_proxy_new (GDBusConnection *connection,
*
* Finishes creating a #GDBusProxy.
*
- * Returns: A #GDBusProxy or %NULL if @error is set. Free with g_object_unref().
+ * Returns: (transfer full): A #GDBusProxy or %NULL if @error is set.
+ * Free with g_object_unref().
*
* Since: 2.26
*/
@@ -2104,7 +2106,8 @@ g_dbus_proxy_new_finish (GAsyncResult *res,
*
* #GDBusProxy is used in this [example][gdbus-wellknown-proxy].
*
- * Returns: A #GDBusProxy or %NULL if error is set. Free with g_object_unref().
+ * Returns: (transfer full): A #GDBusProxy or %NULL if error is set.
+ * Free with g_object_unref().
*
* Since: 2.26
*/
@@ -2200,7 +2203,8 @@ g_dbus_proxy_new_for_bus (GBusType bus_type,
*
* Finishes creating a #GDBusProxy.
*
- * Returns: A #GDBusProxy or %NULL if @error is set. Free with g_object_unref().
+ * Returns: (transfer full): A #GDBusProxy or %NULL if @error is set.
+ * Free with g_object_unref().
*
* Since: 2.26
*/
@@ -2227,7 +2231,8 @@ g_dbus_proxy_new_for_bus_finish (GAsyncResult *res,
*
* #GDBusProxy is used in this [example][gdbus-wellknown-proxy].
*
- * Returns: A #GDBusProxy or %NULL if error is set. Free with g_object_unref().
+ * Returns: (transfer full): A #GDBusProxy or %NULL if error is set.
+ * Free with g_object_unref().
*
* Since: 2.26
*/
@@ -2327,7 +2332,8 @@ g_dbus_proxy_get_name (GDBusProxy *proxy)
* #GObject::notify signal to track changes to the
* #GDBusProxy:g-name-owner property.
*
- * Returns: The name owner or %NULL if no name owner exists. Free with g_free().
+ * Returns: (transfer full) (nullable): The name owner or %NULL if no name
+ * owner exists. Free with g_free().
*
* Since: 2.26
*/
@@ -2448,8 +2454,8 @@ g_dbus_proxy_set_default_timeout (GDBusProxy *proxy,
* that @proxy conforms to. See the #GDBusProxy:g-interface-info
* property for more details.
*
- * Returns: A #GDBusInterfaceInfo or %NULL. Do not unref the returned
- * object, it is owned by @proxy.
+ * Returns: (transfer none) (nullable): A #GDBusInterfaceInfo or %NULL.
+ * Do not unref the returned object, it is owned by @proxy.
*
* Since: 2.26
*/
@@ -2472,7 +2478,8 @@ g_dbus_proxy_get_interface_info (GDBusProxy *proxy)
/**
* g_dbus_proxy_set_interface_info:
* @proxy: A #GDBusProxy
- * @info: (nullable): Minimum interface this proxy conforms to or %NULL to unset.
+ * @info: (transfer none) (nullable): Minimum interface this proxy conforms to
+ * or %NULL to unset.
*
* Ensure that interactions with @proxy conform to the given
* interface. See the #GDBusProxy:g-interface-info property for more
[
Date Prev][
Date Next] [
Thread Prev][
Thread Next]
[
Thread Index]
[
Date Index]
[
Author Index]