g_settings_new_full(): more docs

diff --git a/gio/gsettings.c b/gio/gsettings.c
index ee6f1c9..3d25107 100644 (file)
--- a/gio/gsettings.c
+++ b/gio/gsettings.c
@@ -964,6 +964,13 @@ g_settings_new_with_backend_and_path (const gchar      *schema_id,
  * @schema, @backend and @path, and the main context is taken from the
  * thread-default (as per g_settings_new()).
  *
+ * If @backend is %NULL then the default backend is used.
+ *
+ * If @path is %NULL then the path from the schema is used.  It is an
+ * error f @path is %NULL and the schema has no path of its own or if
+ * @path is non-%NULL and not equal to the path that the schema does
+ * have.
+ *
  * Since: 2.32
  */
 GSettings *