Incorrect documentation about GSettings child add/remove notifications
Submitted by Tanu Kaskinen
g_settings_get_children() has this sentence in its documentation:
For GSettings objects that are lists, this value can change at any time and you should connect to the "children-changed" signal to watch for those changes.
First of all, I don't understand what it means for a GSettings object to be a list. Does that have to be declared in some special way in the schema, or is the object a list just because the application uses it as a list (i.e. containing a variable number of childern of the same type)? I didn't find an answer to this in the documentation.
The main problem with the sentence, however, is that the "children-changed" signal doesn't exist. I grepped the glib source code and this is the only place where the string "children-changed" appears.
How are applications supposed to get notifications about new and removed children? Can the "change-event" signal be used for that? Or is it actually impossible to create children dynamically, i.e. all children should be declared in the schema?