GtkBuilder/GtkBuildable name vs. id confusion
Submitted by rk@..@..er.org
Assigned to GtkBuilder maintainers
Link to original bug (#727846)
Description
In GtkBuilder-XML-files (which are e.g. created by Glade), every widget has an id, and every widget can have a name:
- id:
- name:
<property name="name">
...</property>
The "id" is used by GtkBuilder, the "name" is used e.g. for styles/themes.
Unfortunately, the documentation is quite confusing here: The GtkBuilder- and GtkBuildable-documentation always use the word "name" for the "id" of the widget.
So, I propose to modify the documentation, and replace the word "name" by the words "id" or "widget-id", when talking about the id of a widget.
In a second step, gtk_buildable_set_id() and gtk_buildable_get_id() could be added, and gtk_buildable_set_name() and gtk_buildable_get_name() could be deprecated.
Version: 3.22.x