GSettings: More docs for deprecated _list_schemas()

Most _list_schemas() uses were to check for the availability
of a particular schema. g_settings_schema_source_lookup() is
a better way to do this.

https://bugzilla.gnome.org/show_bug.cgi?id=712315

diff --git a/gio/gsettingsschema.c b/gio/gsettingsschema.c
index 10a8c2be39c8455d0b411722d0fb8d98a8641eb8..78d68ab65f2396d136ee20daf1d2df103e92cc8d 100644 (file)
--- a/gio/gsettingsschema.c
+++ b/gio/gsettingsschema.c
@@ -842,7 +842,10 @@ ensure_schema_lists (void)
  *
  * Since: 2.26
  *
- * Deprecated:2.40: Use g_settings_schema_source_list_schemas() instead
+ * Deprecated:2.40: Use g_settings_schema_source_list_schemas() instead.
+ * If you used g_settings_list_schemas() to check for the presence of
+ * a particular schema, use g_settings_schema_source_lookup() instead
+ * of your whole loop.
  **/
 const gchar * const *
 g_settings_list_schemas (void)