Document new API 2.28.0
authorMatthias Clasen <mclasen@redhat.com>
Tue, 8 Feb 2011 15:05:00 +0000 (10:05 -0500)
committerMatthias Clasen <mclasen@redhat.com>
Tue, 8 Feb 2011 15:05:00 +0000 (10:05 -0500)
gio/gmemorysettingsbackend.c
gio/gnullsettingsbackend.c

index 5d747b5..14e3fcd 100644 (file)
@@ -174,6 +174,19 @@ g_memory_settings_backend_class_init (GMemorySettingsBackendClass *class)
   object_class->finalize = g_memory_settings_backend_finalize;
 }
 
+/**
+ * g_memory_settings_backend_new:
+ *
+ * Creates a memory-backed #GSettingsBackend.
+ *
+ * This backend allows changes to settings, but does not write them
+ * to any backing storage, so the next time you run your application,
+ * the memory backend will start out with the default values again.
+ *
+ * Returns: (transfer full): a newly created #GSettingsBackend
+ *
+ * Since: 2.28
+ */
 GSettingsBackend *
 g_memory_settings_backend_new (void)
 {
index d994f08..523f074 100644 (file)
@@ -119,6 +119,19 @@ g_null_settings_backend_class_init (GNullSettingsBackendClass *class)
   backend_class->get_permission = g_null_settings_backend_get_permission;
 }
 
+/**
+ * g_null_settings_backend_new:
+ *
+ *
+ * Creates a readonly #GSettingsBackend.
+ *
+ * This backend does not allow changes to settings, so all settings
+ * will always have their default values.
+ *
+ * Returns: (transfer full): a newly created #GSettingsBackend
+ *
+ * Since: 2.28
+ */
 GSettingsBackend *
 g_null_settings_backend_new (void)
 {