06/07: doc: Explain how to change the keyboard layout at run time.

[guix-commits]

civodul pushed a commit to branch master
in repository guix.

commit a31af2beeeb5dceb9d535a598eb51e5792d44e14
Author: Ludovic Courtès <address@hidden>
Date:   Wed Apr 3 14:26:21 2019 +0200

    doc: Explain how to change the keyboard layout at run time.
    
    * doc/guix.texi (Keyboard Layout): Mention GNOME's "Region & Language",
    setxkbmap, and loadkeys.
---
 doc/guix.texi | 30 ++++++++++++++++++++++++++++++
 1 file changed, 30 insertions(+)

diff --git a/doc/guix.texi b/doc/guix.texi
index 96755a6..1b0bd1d 100644
--- a/doc/guix.texi
+++ b/doc/guix.texi
@@ -11002,6 +11002,8 @@ special-case and is automatically added whether or not 
it is specified.
 @node Keyboard Layout
 @section Keyboard Layout
 
address@hidden keyboard layout
address@hidden keymap
 To specify what each key of your keyboard does, you need to tell the operating
 system what @dfn{keyboard layout} you want to use.  The default, when nothing
 is specified, is the US English QWERTY layout for 105-key PC keyboards.
@@ -11101,6 +11103,34 @@ a different layout.  The @code{set-xorg-configuration} 
procedure communicates
 the desired Xorg configuration to the graphical log-in manager, by default
 GDM.
 
+We've discussed how to specify the @emph{default} keyboard layout of your
+system when it starts, but you can also adjust it at run time:
+
address@hidden
address@hidden
+If you're using GNOME, its settings panel has a ``Region & Language'' entry
+where you can select one or more keyboard layouts.
+
address@hidden
+Under Xorg, the @command{setxkbmap} command (from the same-named package)
+allows you to change the current layout.  For example, this is how you would
+change the layout to US Dvorak:
+
address@hidden
+setxkbmap us dvorak
address@hidden example
+
address@hidden
+The @code{loadkeys} command changes the keyboard layout in effect in the Linux
+console.  However, note that @code{loadkeys} does @emph{not} use the XKB
+keyboard layout categorization described above.  The command below loads the
+French bépo layout:
+
address@hidden
+loadkeys fr-bepo
address@hidden example
address@hidden itemize
+
 @node Locales
 @section Locales