locate, test and add more avilable xsettings as documentation #28

Quantenzitrone commented 2023年03月09日 23:14:54 +01:00 (Migrated from github.com)

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.

I have read the [Xsettings Freedesktop Specification](https://specifications.freedesktop.org/xsettings-spec/xsettings-latest.html#manager-behavior) 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](https://docs.gtk.org/gtk4/class.Settings.html) 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](https://www.freedesktop.org/wiki/Software/Xft/). 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 2023年03月09日 23:25:31 +01:00 (Migrated from github.com)

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.

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.

Quantenzitrone commented 2023年03月09日 23:30:54 +01:00 (Migrated from github.com)

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

Thanks a lot! I could also find [this example xsettingsd config in someones blog](https://m4he.gitlab.io/linux-theming-compendium/appendix/#full-xsettingsd-configuration-example), maybe we can expand the wiki.

Quantenzitrone commented 2023年03月09日 23:35:01 +01:00 (Migrated from github.com)

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.

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 2023年03月10日 00:17:28 +01:00 (Migrated from github.com)

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

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

Quantenzitrone commented 2023年03月10日 00:19:54 +01:00 (Migrated from github.com)

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

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 2023年03月10日 00:34:57 +01:00 (Migrated from github.com)

Okay, the table is in README.md now.

Okay, the table is in README.md now.

derat commented 2023年04月13日 23:19:46 +02:00 (Migrated from github.com)

Thanks!

Thanks!