From 7a7f989f83612ea312006702c6483f928fdb04ae Mon Sep 17 00:00:00 2001 From: Emmanuele Bassi Date: Tue, 17 Aug 2021 18:35:14 +0100 Subject: Update the GLib annotations --- gir/glib-2.0.c | 20 +++++++++++--------- 1 file changed, 11 insertions(+), 9 deletions(-) diff --git a/gir/glib-2.0.c b/gir/glib-2.0.c index 5ea15d63..2880a21a 100644 --- a/gir/glib-2.0.c +++ b/gir/glib-2.0.c @@ -4661,6 +4661,9 @@ * In order to use this function, you must include string.h yourself, * because this macro may use memmove() and GLib does not include * string.h for you. + * + * Each invocation of `G_VA_COPY (ap1, ap2)` must be matched with a + * corresponding `va_end (ap1)` call in the same function. */ @@ -32526,18 +32529,18 @@ /** - * g_string_new: + * g_string_new: (constructor) * @init: (nullable): the initial text to copy into the string, or %NULL to - * start with an empty string + * start with an empty string * * Creates a new #GString, initialized with the given string. * - * Returns: the new #GString + * Returns: (transfer full): the new #GString */ /** - * g_string_new_len: + * g_string_new_len: (constructor) * @init: initial contents of the string * @len: length of @init to use * @@ -32549,7 +32552,7 @@ * responsibility to ensure that @init has at least @len addressable * bytes. * - * Returns: a new #GString + * Returns: (transfer full): a new #GString */ @@ -32690,16 +32693,15 @@ /** - * g_string_sized_new: - * @dfl_size: the default size of the space allocated to - * hold the string + * g_string_sized_new: (constructor) + * @dfl_size: the default size of the space allocated to hold the string * * Creates a new #GString, with enough space for @dfl_size * bytes. This is useful if you are going to add a lot of * text to the string and don't want it to be reallocated * too often. * - * Returns: the new #GString + * Returns: (transfer full): the new #GString */ -- cgit v1.2.1