From 1dbdbecd39356a6ca4d0bb06a222d3229e055b3b Mon Sep 17 00:00:00 2001 From: Philip Withnall Date: Fri, 4 Nov 2016 20:16:06 +0000 Subject: gtkstylecontext: Clarify memory allocation behaviour of getters MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit It wasn’t clear that gtk_style_context_get[_valist]() behave like g_object_get() — i.e. pointer-based types are returned newly-allocated. Clarify that. https://bugzilla.gnome.org/show_bug.cgi?id=773954 --- gtk/gtkstylecontext.c | 12 ++++++++++++ 1 file changed, 12 insertions(+) (limited to 'gtk/gtkstylecontext.c') diff --git a/gtk/gtkstylecontext.c b/gtk/gtkstylecontext.c index 881bc45511..150d404da3 100644 --- a/gtk/gtkstylecontext.c +++ b/gtk/gtkstylecontext.c @@ -774,6 +774,12 @@ gtk_style_context_get_property (GtkStyleContext *context, * * See gtk_style_context_get_property() for details. * + * As with g_object_get(), a copy is made of the property contents for + * pointer-valued properties, and the caller is responsible for freeing the + * memory in the appropriate manner for the type. For example, by calling + * g_free() or g_object_unref(). Non-pointer-valued properties, such as + * integers, are returned by value and do not need to be freed. + * * Since: 3.0 */ void @@ -819,6 +825,12 @@ gtk_style_context_get_valist (GtkStyleContext *context, * * See gtk_style_context_get_property() for details. * + * As with g_object_get(), a copy is made of the property contents for + * pointer-valued properties, and the caller is responsible for freeing the + * memory in the appropriate manner for the type. For example, by calling + * g_free() or g_object_unref(). Non-pointer-valued properties, such as + * integers, are returned by value and do not need to be freed. + * * Since: 3.0 */ void -- cgit v1.2.1