diff options
author | Daniel Baumann <daniel.baumann@progress-linux.org> | 2024-04-27 14:51:55 +0000 |
---|---|---|
committer | Daniel Baumann <daniel.baumann@progress-linux.org> | 2024-04-27 14:51:55 +0000 |
commit | 86b7f1a83d7db9c912f32b29c32e1124c0a6454d (patch) | |
tree | 42a7ff7c6885e99e0669d07b104df11b2bf387b6 /plugins/xsettings/README.xsettings | |
parent | Initial commit. (diff) | |
download | gnome-settings-daemon-86b7f1a83d7db9c912f32b29c32e1124c0a6454d.tar.xz gnome-settings-daemon-86b7f1a83d7db9c912f32b29c32e1124c0a6454d.zip |
Adding upstream version 3.38.2.upstream/3.38.2upstream
Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>
Diffstat (limited to 'plugins/xsettings/README.xsettings')
-rw-r--r-- | plugins/xsettings/README.xsettings | 35 |
1 files changed, 35 insertions, 0 deletions
diff --git a/plugins/xsettings/README.xsettings b/plugins/xsettings/README.xsettings new file mode 100644 index 0000000..624ccab --- /dev/null +++ b/plugins/xsettings/README.xsettings @@ -0,0 +1,35 @@ +This is very simple documentation for the 'override' GSettings key for +gnome-setting-daemon's xsettings plugin. + +The override is given as a dictionary of overrides to be applied on top +of the usual values that are exported to the X server as XSETTINGS. The +intent of this is to allow users to override values of programmatically +determined settings (such as 'Gtk/ShellShowsAppMenu') and to allow +developers to introduce new XSETTINGS for testing (without having to kill the +gnome-settings-daemon running in the session and run their own patched +version). + +The type of the overrides is 'a{sv}'. + +The key gives the full XSETTINGS setting name to override (for example, +'Gtk/ShellShowsAppMenu'). The value is one of the following: + + - a string ('s') for the case of a string XSETTING + + - an int32 ('i') for the case of an integer XSETTING + + - a 4-tuple of uint16s ('(qqqq)') for the case of a color XSETTING + +Dictionary items with a value that is not one of the above types will be +ignored. Specifically note that XSETTINGS does not have a concept of +booleans -- you must use an integer that is either 0 or 1. + +An example setting for this key (as expressed in GVariant text format) +might be: + + { 'Gtk/ShellShowsAppMenu': < 0 >, 'Xft/DPI': < 98304 > } + +Noting that variants must be specified in the usual way (wrapped in <>). + +Note also that DPI in the above example is expressed in 1024ths of an +inch. |