From mboxrd@z Thu Jan  1 00:00:00 1970
From: Ricardo Wurmus <rekado@elephly.net>
Subject: bug#31652: Use of =?UTF-8?Q?=E2=80=98keymap=E2=80=99?= vs.
	=?UTF-8?Q?=E2=80=98layout=E2=80=99?= in manual
Date: Wed, 30 May 2018 13:27:27 +0200
Message-ID: <87y3g1pen4.fsf@elephly.net>
References: <87sh69ls5i.fsf@lapdog.tobias.gr> <87vab5tsx5.fsf@gmail.com>
Mime-Version: 1.0
Content-Type: text/plain; charset=utf-8
Content-Transfer-Encoding: quoted-printable
Return-path: <bug-guix-bounces+gcggb-bug-guix=m.gmane.org@gnu.org>
Received: from eggs.gnu.org ([2001:4830:134:3::10]:56719)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <Debian-debbugs@debbugs.gnu.org>) id 1fOPIC-0003uE-Tk
	for bug-guix@gnu.org; Thu, 31 May 2018 11:15:09 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <Debian-debbugs@debbugs.gnu.org>) id 1fOPI7-0001uC-VK
	for bug-guix@gnu.org; Thu, 31 May 2018 11:15:08 -0400
Received: from debbugs.gnu.org ([208.118.235.43]:48252)
	by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16)
	(Exim 4.71) (envelope-from <Debian-debbugs@debbugs.gnu.org>)
	id 1fOPI7-0001te-OG
	for bug-guix@gnu.org; Thu, 31 May 2018 11:15:03 -0400
Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2)
	(envelope-from <Debian-debbugs@debbugs.gnu.org>) id 1fOPI7-0007FN-D2
	for bug-guix@gnu.org; Thu, 31 May 2018 11:15:03 -0400
Sender: "Debbugs-submit" <debbugs-submit-bounces@debbugs.gnu.org>
Resent-Message-ID: <handler.31652.B31652.152777969327820@debbugs.gnu.org>
In-reply-to: <87vab5tsx5.fsf@gmail.com>
List-Id: Bug reports for GNU Guix <bug-guix.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/bug-guix>,
	<mailto:bug-guix-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/bug-guix/>
List-Post: <mailto:bug-guix@gnu.org>
List-Help: <mailto:bug-guix-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/bug-guix>,
	<mailto:bug-guix-request@gnu.org?subject=subscribe>
Errors-To: bug-guix-bounces+gcggb-bug-guix=m.gmane.org@gnu.org
Sender: "bug-Guix" <bug-guix-bounces+gcggb-bug-guix=m.gmane.org@gnu.org>
To: Alex Kost <alezost@gmail.com>
Cc: 31652@debbugs.gnu.org


Alex Kost <alezost@gmail.com> writes:

> Tobias Geerinckx-Rice (2018-05-30 05:49 +0200) wrote:
>
>> Guix,
>>
>> Grepping the manual for =E2=80=98keyboard layout=E2=80=99 will get you t=
o 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
>> =E2=80=98keymap=E2=80=99 with the common term.
>
> Do you mean =E2=80=98layout=E2=80=99 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:
>
> 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
> =20
>  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}).
> =20
>  @subsubsection Networking

This is fine.  We should also consider adding more @cindex entries to
cover all terms that people might search for.  The index should guide
people to the relevant places in the manual.

--=20
Ricardo