nixos/doc: inform users of startx about -xkbdir argument needed

This commit is contained in:
rnhmjoj 2019-09-08 14:57:52 +02:00
parent e57c0f3bf9
commit 7468809e72
No known key found for this signature in database
GPG key ID: BFBAF4C975F76450

View file

@ -279,6 +279,12 @@ xkb_symbols "media"
<programlisting>
<xref linkend="opt-services.xserver.displayManager.sessionCommands"/> = "setxkbmap -keycodes media";
</programlisting>
<para>
If you are manually starting the X server, you should set the argument
<literal>-xkbdir /etc/X11/xkb</literal>, otherwise X won't find your layout files.
For example with <command>xinit</command> run
<screen><prompt>$ </prompt>xinit -- -xkbdir /etc/X11/xkb</screen>
</para>
<para>
To learn how to write layouts take a look at the XKB
<link xlink:href="https://www.x.org/releases/current/doc/xorg-docs/input/XKB-Enhancing.html#Defining_New_Layouts">