[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
01/02: doc: Document xorg keymap configuration.
From: |
julien lepiller |
Subject: |
01/02: doc: Document xorg keymap configuration. |
Date: |
Fri, 8 Jun 2018 14:39:02 -0400 (EDT) |
roptat pushed a commit to branch master
in repository guix.
commit 136a1e8b577a5f44e7ff35e24d81d13be922f2af
Author: Julien Lepiller <address@hidden>
Date: Wed Jun 6 19:01:42 2018 +0200
doc: Document xorg keymap configuration.
* doc/guix.texi (Xorg display): Add an example xorg keymap configuration.
---
doc/guix.texi | 38 ++++++++++++++++++++++++++++++++++++++
1 file changed, 38 insertions(+)
diff --git a/doc/guix.texi b/doc/guix.texi
index 965ac42..6ed4799 100644
--- a/doc/guix.texi
+++ b/doc/guix.texi
@@ -11857,6 +11857,44 @@ resolutions---e.g., @code{((1024 768) (640 480))}.
Last, @var{extra-config} is a list of strings or objects appended to the
configuration file. It is used to pass extra text to be
added verbatim to the configuration file.
+
address@hidden keymap
address@hidden keyboard layout
+This procedure is especially useful to configure a different keyboard layout
+than the default US keymap. For instance, to use the ``bépo'' keymap by
+default on the display manager:
+
address@hidden
+(define bepo-evdev
+ "Section \"InputClass\"
+ Identifier \"evdev keyboard catchall\"
+ Driver \"evdev\"
+ MatchIsKeyboard \"on\"
+ Option \"xkb_layout\" \"fr\"
+ Option \"xkb_variant\" \"bepo\"
+EndSection")
+
+(operating-system
+ ...
+ (services
+ (modify-services %desktop-services
+ (slim-service-type config =>
+ (slim-configuration
+ (inherit config)
+ (startx (xorg-start-command
+ #:configuration-file
+ (xorg-configuration-file
+ #:extra-config
+ (list bepo-evdev)))))))))
address@hidden example
+
+The @code{MatchIsKeyboard} line specifies that we only apply the configuration
+to keyboards. Without this line, other devices such as touchpad may not work
+correctly because they will be attached to the wrong driver. In this example,
+the user typically used @code{setxkbmap fr bepo} to set their favorite keymap
+once logged in. The first argument corresponds to the layout, while the second
+argument corresponds to the variant. The @code{xkb_variant} line can be
omitted
+to select the default variant.
@end deffn
@deffn {Scheme Procedure} screen-locker-service @var{package} address@hidden