From 41c1f3dd2b698fc9b1540e5681b3f306869ef39a Mon Sep 17 00:00:00 2001 From: Matthias Clasen Date: Fri, 16 Apr 2010 23:56:40 -0400 Subject: [PATCH] Add some advice for dealing with unset/default values. --- docs/reference/gio/migrating.xml | 11 +++++++++++ 1 file changed, 11 insertions(+) diff --git a/docs/reference/gio/migrating.xml b/docs/reference/gio/migrating.xml index 046705c8f..166da1b79 100644 --- a/docs/reference/gio/migrating.xml +++ b/docs/reference/gio/migrating.xml @@ -247,6 +247,17 @@ start_monitoring_trash (void) + + There is a pattern that is sometimes used for GConf, where a setting can have + explicit 'value A', explicit 'value B' or 'use the system default'. With GConf, + 'use the system default' is sometimes implemented by unsetting the user value. + + + This is not possible in GSettings, since it does not have API to determine if a value + is the default and does not let you unset values. The recommended way (and much + clearer) way in which this can be implemented in GSettings is to have a separate + 'use-system-default' boolean setting. +