summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorPhilip Withnall <philip@tecnocode.co.uk>2020-08-24 09:02:43 +0000
committerPhilip Withnall <philip@tecnocode.co.uk>2020-08-24 09:02:43 +0000
commit9674d14175374f02877dc27b1475ec5746413842 (patch)
treec72d9f85d281a79712858b01bddc929591969af9
parente47a7e297c2e309e18a0ca13cb8f1bb2cc038b51 (diff)
parentdc1a1b841cb6a7902d019284a054cce75f04dc14 (diff)
downloadglib-9674d14175374f02877dc27b1475ec5746413842.tar.gz
Merge branch 'g_settings_new' into 'master'
gio: Document g_settings_new() missing schema behaviour See merge request GNOME/glib!1626
-rw-r--r--gio/gsettings.c6
1 files changed, 6 insertions, 0 deletions
diff --git a/gio/gsettings.c b/gio/gsettings.c
index eeb9e3bbe..4332ebe44 100644
--- a/gio/gsettings.c
+++ b/gio/gsettings.c
@@ -961,6 +961,12 @@ g_settings_class_init (GSettingsClass *class)
* Creates a new #GSettings object with the schema specified by
* @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
* via the thread-default #GMainContext in effect at the time of the
* call to g_settings_new(). The new #GSettings will hold a reference