GNOME Bugzilla – Bug 744053
Add documentation for GtkBuilder templates
Last modified: 2018-04-15 00:00:09 UTC
GtkBuilder templates are completely undocumented except for a single sentence: “Additionally, since 3.10 a special <template> tag has been added to the format allowing one to define a widget class’s components.” Tristan has written a couple of good blog/ML posts on the topic, so (given suitable licencing) they could be used as the basis for some proper documentation for the feature. https://mail.gnome.org/archives/gtk-devel-list/2013-April/msg00001.html http://blogs.gnome.org/tvb/2013/04/09/announcing-composite-widget-templates/
I added a bunch of documentation on how to use templates in the GtkWidget API reference: https://git.gnome.org/browse/gtk+/commit/?id=5b571ff4b6eff43d187f288974b4c8de67f33aa1 We need the other side of the story in GtkBuilder, on how to use the <template> tag.
We're moving to gitlab! As part of this move, we are moving bugs to NEEDINFO if they haven't seen activity in more than a year. If this issue is still important to you and still relevant with GTK+ 3.22 or master, please reopen it and we will migrate it to gitlab.
As announced a while ago, we are migrating to gitlab, and bugs that haven't seen activity in the last year or so will be not be migrated, but closed out in bugzilla. If this bug is still relevant to you, you can open a new issue describing the symptoms and how to reproduce it with gtk 3.22.x or master in gitlab: https://gitlab.gnome.org/GNOME/gtk/issues/new