luc14n0/glib
1
0
Fork 0
mirror of https://gitlab.gnome.org/GNOME/glib.git synced 2025-01-12 15:36:17 +01:00
Code Issues Packages Projects Releases Wiki Activity

gdbusproxy: Add some missing (transfer) and (nullable) annotations

Browse Source 
Signed-off-by: Philip Withnall <withnall@endlessm.com>

https://bugzilla.gnome.org/show_bug.cgi?id=773663
This commit is contained in:
Philip Withnall 2018-02-09 11:12:14 +00:00
parent f82b8f31e3
commit f8ee429db7
1 changed files with 19 additions and 12 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

31
gio/gdbusproxy.c
View File

@ -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