From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from eggs.gnu.org ([209.51.188.92]:41023) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1hBfCR-0001tO-Mg for guix-patches@gnu.org; Wed, 03 Apr 2019 08:41:04 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1hBfCQ-0003wP-Mi for guix-patches@gnu.org; Wed, 03 Apr 2019 08:41:03 -0400 Received: from debbugs.gnu.org ([209.51.188.43]:56867) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1hBfCQ-0003wG-IV for guix-patches@gnu.org; Wed, 03 Apr 2019 08:41:02 -0400 Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1hBfCQ-00058I-ET for guix-patches@gnu.org; Wed, 03 Apr 2019 08:41:02 -0400 Subject: [bug#35120] [PATCH 2/3] doc: Explain how to change the keyboard layout at run time. Resent-Message-ID: From: Ludovic =?UTF-8?Q?Court=C3=A8s?= Date: Wed, 3 Apr 2019 14:39:52 +0200 Message-Id: <20190403123953.29853-2-ludo@gnu.org> In-Reply-To: <20190403123953.29853-1-ludo@gnu.org> References: <20190403123953.29853-1-ludo@gnu.org> MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: guix-patches-bounces+kyle=kyleam.com@gnu.org Sender: "Guix-patches" To: 35120@debbugs.gnu.org * 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 96755a6cce..1b0bd1de58 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 +@cindex keyboard layout +@cindex 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: + +@itemize +@item +If you're using GNOME, its settings panel has a ``Region & Language'' entry +where you can select one or more keyboard layouts. + +@item +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: + +@example +setxkbmap us dvorak +@end example + +@item +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: + +@example +loadkeys fr-bepo +@end example +@end itemize + @node Locales @section Locales -- 2.21.0