From 620d48ca0cd4726fd628e82d940e1510bfc080a7 Mon Sep 17 00:00:00 2001 From: Emmanuele Bassi Date: Wed, 6 Jul 2022 13:04:22 +0100 Subject: [PATCH] docs: Clarify scope of gtk_widget_clear_template() The clear_template() method only clears the template children. --- gtk/gtkwidget.c | 7 +++++-- 1 file changed, 5 insertions(+), 2 deletions(-) diff --git a/gtk/gtkwidget.c b/gtk/gtkwidget.c index 432e10301b..8c943d15af 100644 --- a/gtk/gtkwidget.c +++ b/gtk/gtkwidget.c @@ -10974,10 +10974,13 @@ out: * @widget: the widget with a template * @widget_type: the type of the widget to finalize the template for * - * Clears the template data for the given widget. + * Clears the template children for the given widget. * * This function is the opposite of [method@Gtk.Widget.init_template], and - * it is used to clear all the template data from a widget instance. + * it is used to clear all the template children from a widget instance. + * If you bound a template child to a field in the instance structure, or + * in the instance private data structure, the field will be set to `NULL` + * after this function returns. * * You should call this function inside the `GObjectClass.dispose()` * implementation of any widget that called `gtk_widget_init_template()`.