Merge branch 'g_settings_new' into 'master'

gio: Document g_settings_new() missing schema behaviour

See merge request GNOME/glib!1626
This commit is contained in:
Philip Withnall 2020-08-24 09:02:43 +00:00
commit 9674d14175

View File

@ -961,6 +961,12 @@ g_settings_class_init (GSettingsClass *class)
* Creates a new #GSettings object with the schema specified by * Creates a new #GSettings object with the schema specified by
* @schema_id. * @schema_id.
* *
* It is an error for the schema to not exist: schemas are an
* essential part of a program, as they provide type information.
* If schemas need to be dynamically loaded (for example, from an
* optional runtime dependency), g_settings_schema_source_lookup()
* can be used to test for their existence before loading them.
*
* Signals on the newly created #GSettings object will be dispatched * Signals on the newly created #GSettings object will be dispatched
* via the thread-default #GMainContext in effect at the time of the * via the thread-default #GMainContext in effect at the time of the
* call to g_settings_new(). The new #GSettings will hold a reference * call to g_settings_new(). The new #GSettings will hold a reference