luc14n0/glib
1
0
Fork 0
mirror of https://gitlab.gnome.org/GNOME/glib.git synced 2025-08-20 07:38:54 +02:00
Code Issues Packages Projects Releases Wiki Activity

gdbusaddress: Add missing (transfer) and (nullable) return annotations

Browse Source 
This commit only looks at the `Returns:` lines in the documentation, and
has examined all of them in the file. Function arguments have not been
checked.

Signed-off-by: Philip Withnall <pwithnall@endlessos.org>

Helps: #2227
This commit is contained in:
Philip Withnall
2020-12-15 09:11:50 +00:00
parent f4766f2034
commit b19782e26b
1 changed files with 8 additions and 2 deletions
Download Patch File Download Diff File Expand all files Collapse all files

10
gio/gdbusaddress.c
View File

@@ -903,11 +903,14 @@ g_dbus_address_get_stream (const gchar *address,
/** /**
* g_dbus_address_get_stream_finish: * g_dbus_address_get_stream_finish:
* @res: A #GAsyncResult obtained from the GAsyncReadyCallback passed to g_dbus_address_get_stream(). * @res: A #GAsyncResult obtained from the GAsyncReadyCallback passed to g_dbus_address_get_stream().
* @out_guid: (optional) (out): %NULL or return location to store the GUID extracted from @address, if any. * @out_guid: (optional) (out) (nullable): %NULL or return location to store the GUID extracted from @address, if any.
* @error: Return location for error or %NULL. * @error: Return location for error or %NULL.
* *
* Finishes an operation started with g_dbus_address_get_stream(). * Finishes an operation started with g_dbus_address_get_stream().
* *
* A server is not required to set a GUID, so @out_guid may be set to %NULL
* even on success.
*
* Returns: (transfer full): A #GIOStream or %NULL if @error is set. * Returns: (transfer full): A #GIOStream or %NULL if @error is set.
* *
* Since: 2.26 * Since: 2.26
@@ -940,7 +943,7 @@ g_dbus_address_get_stream_finish (GAsyncResult *res,
/** /**
* g_dbus_address_get_stream_sync: * g_dbus_address_get_stream_sync:
* @address: A valid D-Bus address. * @address: A valid D-Bus address.
* @out_guid: (optional) (out): %NULL or return location to store the GUID extracted from @address, if any. * @out_guid: (optional) (out) (nullable): %NULL or return location to store the GUID extracted from @address, if any.
* @cancellable: (nullable): A #GCancellable or %NULL. * @cancellable: (nullable): A #GCancellable or %NULL.
* @error: Return location for error or %NULL. * @error: Return location for error or %NULL.
* *
@@ -949,6 +952,9 @@ g_dbus_address_get_stream_finish (GAsyncResult *res,
* of the D-Bus authentication conversation. @address must be in the * of the D-Bus authentication conversation. @address must be in the
* [D-Bus address format](https://dbus.freedesktop.org/doc/dbus-specification.html#addresses). * [D-Bus address format](https://dbus.freedesktop.org/doc/dbus-specification.html#addresses).
* *
* A server is not required to set a GUID, so @out_guid may be set to %NULL
* even on success.
*
* This is a synchronous failable function. See * This is a synchronous failable function. See
* g_dbus_address_get_stream() for the asynchronous version. * g_dbus_address_get_stream() for the asynchronous version.
* *