docs: Clarify scope of gtk_widget_clear_template()

The clear_template() method only clears the template children.
This commit is contained in:
Emmanuele Bassi 2022-07-06 13:04:22 +01:00
parent e8c5c2f648
commit 620d48ca0c

View File

@ -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()`.