derat/xsettingsd

locate, test and add more avilable xsettings as documentation

quantenzitrone opened this issue · 7 comments

I have read the Xsettings Freedesktop Specification and am not really able to find documentation about available settings online.

The specification states:

Names beginning with 'Net/' and case variants of that string are reserved and must not be used without prior agreement.

But there is no documentation on how or where to find or do these agreements.

I also get that everything else is depending on the specific Application(-framework) and i can likely find documentation there.
For example the GTK settings from the documentation can probably be translated directly, by changing the first - to a / and converting the rest to UpperCamelCase/PascalCase.
But I am also a bit lost there: What about Xft? Xft stands for X font library and the only documentation i can find is the Freedesktop Specification. The GTK documentation only provides the options, that are already in the Wiki. Unless I or someone else finds anything else, I'll just guess that's it.

I'm sorry if this not the right place for asking this.

derat commented

It's a good question! Unfortunately, I don't remember there being much in the way of documentation when I was looking at this. :-(

I documented the settings that I could find at https://github.com/derat/xsettingsd/wiki/Settings (I don't think Markdown was popular at the time, hence the weird GitHub Wiki). I think I mostly figured them out through a combination of grepping through GTK+ source code and trial and error. It looks like there's a list (from 2013?) at https://www.freedesktop.org/wiki/Specifications/XSettingsRegistry/ that lists some Net/- and Xft/-prefixed settings, too.

Thanks a lot!
I could also find this example xsettingsd config in someones blog, maybe we can expand the wiki.

Wait, (how) can i expand the wiki? I can clone it locally, but i probably won't be able to push. I can't clone it on GitHub, apparently. I have never done anything with GitHub wikis.

derat commented

I'm in the process of moving those wiki pages into the README.md file so it's easier to make changes.

Ok, so i could confirm these settings on my machine so far:

Net/ThemeName
Net/IconThemeName
Net/DoubleClickTime
Net/DoubleClickDistance
Net/DoubleClickTime
Net/DndDragThreshold
Net/CursorBlink
Net/CursorBlinkTime

Gtk/DecorationLayout
Gtk/FontName

Xft/Antialias
Xft/RGBA
Xft/Hinting
Xft/HintStyle

These don't work for me so far:

Gtk/CursorThemeName
Gtk/CursorThemeSize

Unable/don't know how to test:

Net/EnableEventSounds
derat commented

Okay, the table is in README.md now.

derat commented

Thanks!