Bug 86135 - setxkbmap -config file format is undocumented
Summary: setxkbmap -config file format is undocumented
Alias: None
Product: xorg
Classification: Unclassified
Component: App/setxkbmap (show other bugs)
Version: unspecified
Hardware: All All
: medium normal
Assignee: Xorg Project Team
QA Contact: Xorg Project Team
Depends on:
Reported: 2014-11-11 02:58 UTC by Alan Coopersmith
Modified: 2018-08-10 20:28 UTC (History)
2 users (show)

See Also:
i915 platform:
i915 features:


Description Alan Coopersmith 2014-11-11 02:58:05 UTC
As noted in http://unix.stackexchange.com/q/167131/146 , the setxkbmap man page
does not document the file format of the file passed for -config, and I can't
find anywhere else in our docs, including all of the links on 
http://www.x.org/wiki/XKB/ that documents it either.

We really should give users some clue what to provide, once we figure out the
details ourselves.
Comment 1 Peter Hutterer 2014-11-11 04:48:26 UTC
What I can tell from a quick skim is that the format permitted is quite simple:

field = value; # comment // also comment

where field is one of "rules", "model", etc for RMLVO and KcCGST, or "keymap".

libxkbfile's XkbCFParse allows more, but those are the only ones we check in setxkbmap. Not sure what the exact format is for keymap, but it's likewise some string that's then passed into XkbGetKeyboardByName()
Comment 2 GitLab Migration User 2018-08-10 20:28:20 UTC
-- GitLab Migration Automatic Message --

This bug has been migrated to freedesktop.org's GitLab instance and has been closed from further activity.

You can subscribe and participate further through the new bug through this link to our GitLab instance: https://gitlab.freedesktop.org/xorg/app/setxkbmap/issues/2.

Use of freedesktop.org services, including Bugzilla, is subject to our Code of Conduct. How we collect and use information is described in our Privacy Policy.