GNU bug report logs - #31652
Use of ‘keymap’ vs. ‘layout’ in manual

Please note: This is a static page, with minimal formatting, updated once a day.
Click here to see this page with the latest information and nicer formatting.

Package: guix; Reported by: Tobias Geerinckx-Rice <me@HIDDEN>; dated Wed, 30 May 2018 04:17:01 UTC; Maintainer for guix is bug-guix@HIDDEN.

Message received at 31652 <at> debbugs.gnu.org:


Received: (at 31652) by debbugs.gnu.org; 31 May 2018 15:14:53 +0000
From debbugs-submit-bounces <at> debbugs.gnu.org Thu May 31 11:14:53 2018
Received: from localhost ([127.0.0.1]:56149 helo=debbugs.gnu.org)
	by debbugs.gnu.org with esmtp (Exim 4.84_2)
	(envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>)
	id 1fOPHx-0007Ee-Kp
	for submit <at> debbugs.gnu.org; Thu, 31 May 2018 11:14:53 -0400
Received: from sender-of-o51.zoho.com ([135.84.80.216]:21145)
 by debbugs.gnu.org with esmtp (Exim 4.84_2)
 (envelope-from <rekado@HIDDEN>) id 1fOPHu-0007ER-TT
 for 31652 <at> debbugs.gnu.org; Thu, 31 May 2018 11:14:51 -0400
DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; t=1527679652; 
 s=zoho; d=elephly.net; i=rekado@HIDDEN;
 h=References:From:To:Cc:Subject:In-reply-to:Date:MIME-Version:Content-Type:Content-Transfer-Encoding:Message-ID;
 l=1485; bh=c5wGteo/9dU6Mu6pNBhAEPfhOpLhjEeG7Gjms1PAW2g=;
 b=CNkBvCZGIHe1oOF7SbTFzpkLZin8I+epCdXqAMz5cil7rRVJkcc/VpDI5e5u89I3
 ePPImdrfwpuS5YY71VHiZwYmV6jXggESwlfvLOSPVioiLbuJC3psK6TYNsCoxb+zLQp
 T4K048qOSFZI8FbymhcJ70FWcbnirc6FKLwj8bWU=
Received: from localhost (141.80.247.213 [141.80.247.213]) by mx.zohomail.com
 with SMTPS id 152767965263771.85504168078535;
 Wed, 30 May 2018 04:27:32 -0700 (PDT)
References: <87sh69ls5i.fsf@HIDDEN> <87vab5tsx5.fsf@HIDDEN>
User-agent: mu4e 1.0; emacs 25.3.1
From: Ricardo Wurmus <rekado@HIDDEN>
To: Alex Kost <alezost@HIDDEN>
Subject: Re: bug#31652: Use of =?utf-8?B?4oCYa2V5bWFw4oCZ?= vs.
 =?utf-8?B?4oCYbGF5b3V04oCZ?= in manual
In-reply-to: <87vab5tsx5.fsf@HIDDEN>
X-URL: https://elephly.net
X-PGP-Key: https://elephly.net/rekado.pubkey
X-PGP-Fingerprint: BCA6 89B6 3655 3801 C3C6  2150 197A 5888 235F ACAC
Date: Wed, 30 May 2018 13:27:27 +0200
MIME-Version: 1.0
Content-Type: text/plain; charset=utf-8
Content-Transfer-Encoding: quoted-printable
Message-ID: <87y3g1pen4.fsf@HIDDEN>
X-ZohoMailClient: External
X-Spam-Score: 0.0 (/)
X-Debbugs-Envelope-To: 31652
Cc: 31652 <at> debbugs.gnu.org, Tobias Geerinckx-Rice <me@HIDDEN>
X-BeenThere: debbugs-submit <at> debbugs.gnu.org
X-Mailman-Version: 2.1.18
Precedence: list
List-Id: <debbugs-submit.debbugs.gnu.org>
List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe>
List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/>
List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org>
List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help>
List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe>
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
X-Spam-Score: -1.0 (-)


Alex Kost <alezost@HIDDEN> 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






Information forwarded to bug-guix@HIDDEN:
bug#31652; Package guix. Full text available.

Message received at 31652 <at> debbugs.gnu.org:


Received: (at 31652) by debbugs.gnu.org; 30 May 2018 09:05:34 +0000
From debbugs-submit-bounces <at> debbugs.gnu.org Wed May 30 05:05:34 2018
Received: from localhost ([127.0.0.1]:54653 helo=debbugs.gnu.org)
	by debbugs.gnu.org with esmtp (Exim 4.84_2)
	(envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>)
	id 1fNx30-0007Wh-9J
	for submit <at> debbugs.gnu.org; Wed, 30 May 2018 05:05:34 -0400
Received: from mail-lf0-f44.google.com ([209.85.215.44]:35669)
 by debbugs.gnu.org with esmtp (Exim 4.84_2)
 (envelope-from <alezost@HIDDEN>) id 1fNx2z-0007WV-1D
 for 31652 <at> debbugs.gnu.org; Wed, 30 May 2018 05:05:33 -0400
Received: by mail-lf0-f44.google.com with SMTP id y72-v6so3098058lfd.2
 for <31652 <at> debbugs.gnu.org>; Wed, 30 May 2018 02:05:33 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025;
 h=from:to:cc:subject:references:date:in-reply-to:message-id
 :user-agent:mime-version;
 bh=0IRX/OhLY67ASIo5Ge88Ys6L9Se4gOYNAjAbTZ3PUKQ=;
 b=ahpdZE9x1bUOHLyl+IcPpQLOFxQjY1QXO/D/0YOejlkQOhk68cTitSNnItLZOKfEMS
 zl6nFI2EQNNHx8xnXZk/NhhkEwxX/oUbiiw1WZb2S1fxhhFEzSUFMUb4Tvnr1o7hBDGf
 3p5uZ3dROaT8ZifE5GFR6MiRr6eHtmFR2pCMdHEu4u+pFXHECSJ7iJ3MrPjwyiid87wx
 v/XXyF5jEfWQP90TM545M55GOl/4QPc2dykoPbMzE9QcEZCrdHWYh0mQnn279L/T9dGs
 Vv5mZ16bbV1vsr7Uct0Dv8KUYUTrta7gPKWbwAV7YkLRwQ2ECrCRBVt7MAYfJ975F9dd
 cGSw==
X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;
 d=1e100.net; s=20161025;
 h=x-gm-message-state:from:to:cc:subject:references:date:in-reply-to
 :message-id:user-agent:mime-version;
 bh=0IRX/OhLY67ASIo5Ge88Ys6L9Se4gOYNAjAbTZ3PUKQ=;
 b=RWETXOXkVJSho7JPE/5wK6vvx7w+oGFwWIBhYgYO4bx+zfLVHoPtUZzL1rlc7RvEHt
 0+sKwbYiNwVh3NkBm7oMFc/GEDe7IJEu2kTOb7NSmvYXuBKkF5K3Pg++5qzEA/1pb5HG
 nxLaUuuEDA+WKmaoQG0gq8bE4IXXA5QAoRbQvjKPW3KIAzRrlfjn1jhYmgGjezoCFQ6X
 O9yE2yv/jtb5CIHDupq7Dy/Kew4PHHwJiJyaTIx5qW/hceF9hd9uDY/I9VhcyTH5jcoh
 Ws839WQsr0HYGPvvHIsuQvUQlXwQBSgUxUfqsyvUJEQBXwf/D6e94J7g980FoQ8S940y
 NGoQ==
X-Gm-Message-State: ALKqPwfcyYc13pLTjv1w1lAo/V97xjl+786uuoNo4kShAV7bz9Kyy4in
 JsTK/dTA1dTfmhe0th5s5AD2lw==
X-Google-Smtp-Source: ADUXVKKrLc6IH7qRZx1//8u6ZMPsuxHE9BCsfFqRSlkF27YV0ceBWUypLyzy+DYWjbOBihY7ig59Fw==
X-Received: by 2002:a19:1b11:: with SMTP id
 b17-v6mr1138501lfb.50.1527671127097; 
 Wed, 30 May 2018 02:05:27 -0700 (PDT)
Received: from leviafan ([217.107.194.6])
 by smtp.gmail.com with ESMTPSA id t22-v6sm6968005lji.75.2018.05.30.02.05.25
 (version=TLS1_2 cipher=ECDHE-RSA-CHACHA20-POLY1305 bits=256/256);
 Wed, 30 May 2018 02:05:25 -0700 (PDT)
From: Alex Kost <alezost@HIDDEN>
To: Tobias Geerinckx-Rice <me@HIDDEN>
Subject: Re: bug#31652: Use of =?utf-8?B?4oCYa2V5bWFw4oCZ?= vs.
 =?utf-8?B?4oCYbGF5b3V04oCZ?= in manual
References: <87sh69ls5i.fsf@HIDDEN>
Date: Wed, 30 May 2018 12:05:26 +0300
In-Reply-To: <87sh69ls5i.fsf@HIDDEN> (Tobias Geerinckx-Rice's
 message of "Wed, 30 May 2018 05:49:13 +0200")
Message-ID: <87vab5tsx5.fsf@HIDDEN>
User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/25.3 (gnu/linux)
MIME-Version: 1.0
Content-Type: multipart/mixed; boundary="=-=-="
X-Spam-Score: 0.0 (/)
X-Debbugs-Envelope-To: 31652
Cc: 31652 <at> debbugs.gnu.org
X-BeenThere: debbugs-submit <at> debbugs.gnu.org
X-Mailman-Version: 2.1.18
Precedence: list
List-Id: <debbugs-submit.debbugs.gnu.org>
List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe>
List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/>
List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org>
List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help>
List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe>
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
X-Spam-Score: -1.0 (-)

--=-=-=
Content-Type: text/plain; charset=utf-8
Content-Transfer-Encoding: quoted-printable

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 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
> =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" me=
ntions
"layout" only once, and "keymap" a lot.

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


--=-=-=
Content-Type: text/x-patch
Content-Disposition: inline; filename=doc-keymap.diff

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
 

--=-=-=
Content-Type: text/plain


-- 
Alex

--=-=-=--




Information forwarded to bug-guix@HIDDEN:
bug#31652; Package guix. Full text available.

Message received at submit <at> debbugs.gnu.org:


Received: (at submit) by debbugs.gnu.org; 30 May 2018 04:16:03 +0000
From debbugs-submit-bounces <at> debbugs.gnu.org Wed May 30 00:16:03 2018
Received: from localhost ([127.0.0.1]:54547 helo=debbugs.gnu.org)
	by debbugs.gnu.org with esmtp (Exim 4.84_2)
	(envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>)
	id 1fNsWp-0000W5-Aa
	for submit <at> debbugs.gnu.org; Wed, 30 May 2018 00:16:03 -0400
Received: from eggs.gnu.org ([208.118.235.92]:51105)
 by debbugs.gnu.org with esmtp (Exim 4.84_2)
 (envelope-from <me@HIDDEN>) id 1fNsWo-0000VN-6B
 for submit <at> debbugs.gnu.org; Wed, 30 May 2018 00:16:02 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
 (envelope-from <me@HIDDEN>) id 1fNsWi-0007Hu-Cf
 for submit <at> debbugs.gnu.org; Wed, 30 May 2018 00:15:57 -0400
X-Spam-Checker-Version: SpamAssassin 3.3.2 (2011-06-06) on eggs.gnu.org
X-Spam-Level: 
X-Spam-Status: No, score=-1.9 required=5.0 tests=BAYES_00,T_DKIM_INVALID
 autolearn=disabled version=3.3.2
Received: from lists.gnu.org ([2001:4830:134:3::11]:52531)
 by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_256_CBC_SHA1:32)
 (Exim 4.71) (envelope-from <me@HIDDEN>) id 1fNsWi-0007Hq-9y
 for submit <at> debbugs.gnu.org; Wed, 30 May 2018 00:15:56 -0400
Received: from eggs.gnu.org ([2001:4830:134:3::10]:42075)
 by lists.gnu.org with esmtp (Exim 4.71)
 (envelope-from <me@HIDDEN>) id 1fNsWh-0004Fc-9o
 for bug-guix@HIDDEN; Wed, 30 May 2018 00:15:56 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
 (envelope-from <me@HIDDEN>) id 1fNsWg-0007HH-96
 for bug-guix@HIDDEN; Wed, 30 May 2018 00:15:55 -0400
Received: from tobias.gr ([2001:470:cc92::1]:36938)
 by eggs.gnu.org with esmtps (TLS1.0:DHE_RSA_AES_256_CBC_SHA1:32)
 (Exim 4.71) (envelope-from <me@HIDDEN>) id 1fNsWf-0007GB-U2
 for bug-guix@HIDDEN; Wed, 30 May 2018 00:15:54 -0400
Received: by tobias.gr (OpenSMTPD) with ESMTP id 1f5bf2e8
 for <bug-guix@HIDDEN>; Wed, 30 May 2018 03:49:12 +0000 (UTC)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed; d=tobias.gr; h=from:to
 :subject:date:message-id:mime-version:content-type
 :content-transfer-encoding; s=2018; i=me@HIDDEN; bh=arK8m5PDN
 BrcLy4oKPpaVBFiZ67D6dz0zp9XQjUftTU=; b=aAY2dJcXEN2sYQIxLk/Mt1plL
 4YGEdYA9d9qdBFUlX7jAqPbGuxTTQ5tz29TV94xYMG1W4DmJ/RCe/gYL0pjqjvVE
 NdBAi3PotNLp9m20j/Q/UoXuT/X3J+5MXjbYSQ0Cv8DVWe5YKJ67Jmc1pggISgMV
 1UpPDNApiNa9l5K1mPpDrwl2tDYrq0avU/8orfldHN3yYwPKcRHjOu4XAx21Au/3
 R8cxnfOoI5sMKF96gFCJ9Jduyv/kRh2My12jWtjoboPr9731cw8Ds+N0unVGx8Ex
 HvVAXEU7FFY6JQWshzoPlCbT1mfgVl6fPtFm+3LKAPynTeGTW4wP0UvhTwf6Q==
Received: by submission.tobias.gr (OpenSMTPD) with ESMTPSA id 25bfd55d
 (TLSv1.2:ECDHE-RSA-AES256-GCM-SHA384:256:NO) for <bug-guix@HIDDEN>;
 Wed, 30 May 2018 03:49:10 +0000 (UTC)
User-agent: mu4e 1.0; emacs 25.3.1
From: Tobias Geerinckx-Rice <me@HIDDEN>
To: bug-guix@HIDDEN
Subject: Use of =?utf-8?B?4oCYa2V5bWFw4oCZ?= vs. =?utf-8?B?4oCYbGF5b3V0?=
 =?utf-8?B?4oCZ?= in manual
Date: Wed, 30 May 2018 05:49:13 +0200
Message-ID: <87sh69ls5i.fsf@HIDDEN>
MIME-Version: 1.0
Content-Type: text/plain; charset=utf-8; format=flowed
Content-Transfer-Encoding: 8bit
X-detected-operating-system: by eggs.gnu.org: Genre and OS details not
 recognized.
X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6.x
X-Received-From: 2001:4830:134:3::11
X-Spam-Score: -4.1 (----)
X-Debbugs-Envelope-To: submit
X-BeenThere: debbugs-submit <at> debbugs.gnu.org
X-Mailman-Version: 2.1.18
Precedence: list
List-Id: <debbugs-submit.debbugs.gnu.org>
List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe>
List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/>
List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org>
List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help>
List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe>
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
X-Spam-Score: -5.1 (-----)

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.

Kind regards,

T G-R




Acknowledgement sent to Tobias Geerinckx-Rice <me@HIDDEN>:
New bug report received and forwarded. Copy sent to bug-guix@HIDDEN. Full text available.
Report forwarded to bug-guix@HIDDEN:
bug#31652; Package guix. Full text available.
Please note: This is a static page, with minimal formatting, updated once a day.
Click here to see this page with the latest information and nicer formatting.
Last modified: Mon, 25 Nov 2019 12:00:02 UTC

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997 nCipher Corporation Ltd, 1994-97 Ian Jackson.