bug#31652: Use of ‘keymap’ vs. ‘layout’ in manual

[Alex Kost <alezost@gmail.com>]

[-- Attachment #1: Type: text/plain, Size: 636 bytes --]

Tobias Geerinckx-Rice (2018-05-30 05:49 +0200) wrote:

> Guix,
>
> Grepping the manual for ‘keyboard layout’ will get you to section
> 6.1.4.1 (setting the layout temporarily during installation using
> loadkeys), but not 6.2.7.1 where you might learn about using
> console-keymap-service to make the change permanent.
>
> This bug is a reminder to myself to replace at least one occurrence of
> ‘keymap’ with the common term.

Do you mean ‘layout’ is the common term?  "man loadkeys" mentions
"layout" only once, and "keymap" a lot.

I think we can just put a reference to that section.  Maybe like this:


[-- Warning: decoded text below may be mangled, UTF-8 assumed --]
[-- Attachment #2: doc-keymap.diff --]
[-- Type: text/x-patch, Size: 500 bytes --]

diff --git a/doc/guix.texi b/doc/guix.texi
index 09749b15e..02425e791 100644
--- a/doc/guix.texi
+++ b/doc/guix.texi
@@ -8418,7 +8418,9 @@ loadkeys dvorak
 
 See the files under @file{/run/current-system/profile/share/keymaps} for
 a list of available keyboard layouts.  Run @command{man loadkeys} for
-more information.
+more information.  After installing GuixSD, you can set your default
+keyboard layout with @code{console-keymap-service} (@pxref{Base
+Services}).
 
 @subsubsection Networking
 

[-- Attachment #3: Type: text/plain, Size: 10 bytes --]


-- 
Alex