[glib: 6/7] gdbuserror: Add missing (transfer) and (nullable) return annotations




commit b66ae5a87ef3029531b697097a59311b99e7795b
Author: Philip Withnall <pwithnall endlessos org>
Date:   Tue Dec 15 09:14:39 2020 +0000

    gdbuserror: Add missing (transfer) and (nullable) return annotations
    
    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

 gio/gdbuserror.c | 9 +++++----
 1 file changed, 5 insertions(+), 4 deletions(-)
---
diff --git a/gio/gdbuserror.c b/gio/gdbuserror.c
index 4ad97bb6e..b3ea28f5a 100644
--- a/gio/gdbuserror.c
+++ b/gio/gdbuserror.c
@@ -512,8 +512,8 @@ g_dbus_error_is_remote_error (const GError *error)
  * (e.g. g_dbus_connection_call_finish()) unless
  * g_dbus_error_strip_remote_error() has been used on @error.
  *
- * Returns: an allocated string or %NULL if the D-Bus error name
- *     could not be found. Free with g_free().
+ * Returns: (nullable) (transfer full): an allocated string or %NULL if the
+ *     D-Bus error name could not be found. Free with g_free().
  *
  * Since: 2.26
  */
@@ -600,7 +600,7 @@ g_dbus_error_get_remote_error (const GError *error)
  * #GError instances for applications. Regular applications should not use
  * it.
  *
- * Returns: An allocated #GError. Free with g_error_free().
+ * Returns: (transfer full): An allocated #GError. Free with g_error_free().
  *
  * Since: 2.26
  */
@@ -810,7 +810,8 @@ g_dbus_error_strip_remote_error (GError *error)
  * This function is typically only used in object mappings to put a
  * #GError on the wire. Regular applications should not use it.
  *
- * Returns: A D-Bus error name (never %NULL). Free with g_free().
+ * Returns: (transfer full) (not nullable): A D-Bus error name (never %NULL).
+ *     Free with g_free().
  *
  * Since: 2.26
  */


[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]