[glib/glib-2-72: 7/39] garray: Add missing (transfer full) introspection annotations

[Matthias Clasen <matthiasc src gnome org>]

commit b34b4ebe8cf2a134c93efc58a1800061d71aad2c
Author: Philip Withnall <pwithnall endlessos org>
Date:   Fri May 27 14:27:12 2022 +0100

    garray: Add missing (transfer full) introspection annotations
    
    Signed-off-by: Philip Withnall <pwithnall endlessos org>
    
    (cherry-picked from commit a9321c365222c4fe0fe7a33e0d3c0a0cb635b318)

 glib/garray.c | 9 +++++----
 1 file changed, 5 insertions(+), 4 deletions(-)
---
diff --git a/glib/garray.c b/glib/garray.c
index 1ab3beeda3..739141e3da 100644
--- a/glib/garray.c
+++ b/glib/garray.c
@@ -1169,8 +1169,9 @@ g_ptr_array_new (void)
  * g_assert (chunk_buffer->len == 0);
  * ]|
  *
- * Returns: (transfer full): the element data, which should be
- *     freed using g_free().
+ * Returns: (transfer full) (nullable): the element data, which should be
+ *     freed using g_free(). This may be %NULL if the array doesn’t have any
+ *     elements (i.e. if `*len` is zero).
  *
  * Since: 2.64
  */
@@ -1307,7 +1308,7 @@ g_array_copy (GArray *array)
  * either via g_ptr_array_unref(), when g_ptr_array_free() is called with
  * @free_segment set to %TRUE or when removing elements.
  *
- * Returns: A new #GPtrArray
+ * Returns: (transfer full): A new #GPtrArray
  *
  * Since: 2.22
  */
@@ -1331,7 +1332,7 @@ g_ptr_array_new_with_free_func (GDestroyNotify element_free_func)
  * g_ptr_array_unref(), when g_ptr_array_free() is called with
  * @free_segment set to %TRUE or when removing elements.
  *
- * Returns: A new #GPtrArray
+ * Returns: (transfer full): A new #GPtrArray
  *
  * Since: 2.30
  */