README.xsettings
1This is very simple documentation for the 'override' GSettings key for
2gnome-setting-daemon's xsettings plugin.
3
4The override is given as a dictionary of overrides to be applied on top
5of the usual values that are exported to the X server as XSETTINGS. The
6intent of this is to allow users to override values of programmatically
7determined settings (such as 'Gtk/ShellShowsAppMenu') and to allow
8developers to introduce new XSETTINGS for testing (without having to kill the
9gnome-settings-daemon running in the session and run their own patched
10version).
11
12The type of the overrides is 'a{sv}'.
13
14The key gives the full XSETTINGS setting name to override (for example,
15'Gtk/ShellShowsAppMenu'). The value is one of the following:
16
17 - a string ('s') for the case of a string XSETTING
18
19 - an int32 ('i') for the case of an integer XSETTING
20
21 - a 4-tuple of uint16s ('(qqqq)') for the case of a color XSETTING
22
23Dictionary items with a value that is not one of the above types will be
24ignored. Specifically note that XSETTINGS does not have a concept of
25booleans -- you must use an integer that is either 0 or 1.
26
27An example setting for this key (as expressed in GVariant text format)
28might be:
29
30 { 'Gtk/ShellShowsAppMenu': < 0 >, 'Xft/DPI': < 98304 > }
31
32Noting that variants must be specified in the usual way (wrapped in <>).
33
34Note also that DPI in the above example is expressed in 1024ths of an
35inch.
36