From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp1 ([2001:41d0:2:4a6f::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms0.migadu.com with LMTPS id 4E4pG2oiTWG/dQAAgWs5BA (envelope-from ) for ; Fri, 24 Sep 2021 02:57:14 +0200 Received: from aspmx1.migadu.com ([2001:41d0:2:4a6f::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp1 with LMTPS id gMSzFmoiTWEpPQAAbx9fmQ (envelope-from ) for ; Fri, 24 Sep 2021 00:57:14 +0000 Received: from lists.gnu.org (lists.gnu.org [209.51.188.17]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by aspmx1.migadu.com (Postfix) with ESMTPS id 16DCAE8CC for ; Fri, 24 Sep 2021 02:57:14 +0200 (CEST) Received: from localhost ([::1]:36268 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1mTZWb-0002mO-94 for larch@yhetil.org; Thu, 23 Sep 2021 20:57:13 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]:46048) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1mTZWQ-0002m5-OD for bug-guix@gnu.org; Thu, 23 Sep 2021 20:57:02 -0400 Received: from debbugs.gnu.org ([209.51.188.43]:44749) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1mTZWQ-0007lQ-Dk for bug-guix@gnu.org; Thu, 23 Sep 2021 20:57:02 -0400 Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1mTZWQ-0008T0-B8 for bug-guix@gnu.org; Thu, 23 Sep 2021 20:57:02 -0400 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 Resent-From: Sarah Morgensen Original-Sender: "Debbugs-submit" Resent-To: bug-guix@gnu.org Resent-Date: Fri, 24 Sep 2021 00:57:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: cc-closed 31652 X-GNU-PR-Package: guix X-GNU-PR-Keywords: To: Ricardo Wurmus Mail-Followup-To: 31652@debbugs.gnu.org, iskarian@mgsn.dev, me@tobias.gr Received: via spool by 31652-done@debbugs.gnu.org id=D31652.163244498132482 (code D ref 31652); Fri, 24 Sep 2021 00:57:02 +0000 Received: (at 31652-done) by debbugs.gnu.org; 24 Sep 2021 00:56:21 +0000 Received: from localhost ([127.0.0.1]:56295 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1mTZVl-0008Rp-A8 for submit@debbugs.gnu.org; Thu, 23 Sep 2021 20:56:21 -0400 Received: from out2.migadu.com ([188.165.223.204]:37406) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1mTZVe-0008Ra-MB for 31652-done@debbugs.gnu.org; Thu, 23 Sep 2021 20:56:20 -0400 X-Report-Abuse: Please report any abuse attempt to abuse@migadu.com and include these headers. DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=mgsn.dev; s=key1; t=1632444973; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references; bh=3vKVsk/j1VEiheM9Hpq5L786sK7wsWwOZF46bd8TaEs=; b=R8eP1p4+0dbBOcQJp9mRlY1f9ti8aT0EjeUHnhKHAOUQY251um1IhV0/1blLA4AfCdU9c4 ujGtlcb+yOoIU9Y45eO8DBfWN9Y3BhgOxaR4TsU7GrwKFhsjSl3z7C8IJ0N8DzYwpj4P7X nYLAOw8sEKG/RVEPCmrlSACIvM3jF+M= From: Sarah Morgensen References: <87sh69ls5i.fsf@lapdog.tobias.gr> <87vab5tsx5.fsf@gmail.com> <87y3g1pen4.fsf@elephly.net> Date: Thu, 23 Sep 2021 17:56:12 -0700 In-Reply-To: <87y3g1pen4.fsf@elephly.net> (Ricardo Wurmus's message of "Wed, 30 May 2018 13:27:27 +0200 (3 years, 16 weeks, 4 days ago)") Message-ID: <86tuiaiyfn.fsf@mgsn.dev> MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-BeenThere: bug-guix@gnu.org List-Id: Bug reports for GNU Guix List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Cc: 31652-done@debbugs.gnu.org, Alex Kost Errors-To: bug-guix-bounces+larch=yhetil.org@gnu.org Sender: "bug-Guix" X-Migadu-Flow: FLOW_IN ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=yhetil.org; s=key1; t=1632445034; h=from:from:sender:sender:reply-to:subject:subject:date:date: message-id:message-id:to:to:cc:cc:mime-version:mime-version: content-type:content-type: content-transfer-encoding:content-transfer-encoding:resent-to: resent-from:resent-sender:resent-message-id:in-reply-to:in-reply-to: references:references:list-id:list-help:list-unsubscribe: list-subscribe:list-post:dkim-signature; bh=3vKVsk/j1VEiheM9Hpq5L786sK7wsWwOZF46bd8TaEs=; b=KS5QG2f57opyfEJ0oN7JmSF6if5Lnews6vl0sR9/sTfNN9lG83yo8JOB6VlXT7I7Wtlcec C/jWbWon4Nbf7cCvIuQrdKwkZ2ucTS/HHOGv7a4I4El0lNREGvKJ2cD6okSfhHi3tbsY0C IK+63F/YVF5Q8GMU6q5US9wPf8ZCKTVQlgvLCp4LZnFuiNKEJy+P1RFdJosFKk3wsVZvRt G6Tr8+kSBKa0WpqmRBBRqH5UeVm9UGpQvdDDz1EOdEHuW+ImpGZS2T5/G54Z2YwZ7QLJKL a9B9919efTVGr139552aPW2BDMTdTZXx6gI1uJWi4b5kLc8C8Q5ufvgRmMeYBQ== ARC-Seal: i=1; s=key1; d=yhetil.org; t=1632445034; a=rsa-sha256; cv=none; b=eJ0IfoXxa12F4drYDgSrRj7b+zxtJ4DGdTiOzcyb9ZBmlqhnFBgQaijFl/qIlEkaGfVGDw JgkweG9vUoYatbzLNFSlbNf+aFlK2VGAffmLrVwpldd0X0lpcmuV0BUNvuxvX7P4K2VEx1 NYHdt8c98ap1+Gw2Vh9jSgpMFC7KzDEp/XMUvBZoFOPPu0gb/Tt0JysYdjQ9tcdmcWjYPF PicvhKrgjhsguVwZs8L4SBZFP8lhV/gHsi2DqdaJyvF8/Fc+rNK5FTh6OEK7NBclHDdO6l a/b/+s7u0ilrN/d0CAlaGU+SEVKVO68yqtlWPDnOBaH5Qk+wrA5dRNhaz4Gn5w== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=fail ("headers rsa verify failed") header.d=mgsn.dev header.s=key1 header.b=R8eP1p4+; spf=pass (aspmx1.migadu.com: domain of bug-guix-bounces@gnu.org designates 209.51.188.17 as permitted sender) smtp.mailfrom=bug-guix-bounces@gnu.org X-Migadu-Spam-Score: -1.69 Authentication-Results: aspmx1.migadu.com; dkim=fail ("headers rsa verify failed") header.d=mgsn.dev header.s=key1 header.b=R8eP1p4+; dmarc=fail reason="SPF not aligned (relaxed)" header.from=mgsn.dev (policy=none); spf=pass (aspmx1.migadu.com: domain of bug-guix-bounces@gnu.org designates 209.51.188.17 as permitted sender) smtp.mailfrom=bug-guix-bounces@gnu.org X-Migadu-Queue-Id: 16DCAE8CC X-Spam-Score: -1.69 X-Migadu-Scanner: scn1.migadu.com X-TUID: 1ONO7wb8BfkJ Hello all, I found this old bug... Ricardo Wurmus writes: > Alex Kost 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 = 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"= 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=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=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. However, it seems the manual now primarily uses "keyboard layout" with an entry in the index for "keymap". This seems to resolve the original issue, so I'm closing this bug. Please reopen if this was in error. Note also that when there is alternate terminology, you can use @cindex keymap @seeentry{keyboard layout} to put a single entry in the index which says keymap: see keyboard layout See (texinfo)Advanced Indexing for more info :) -- Sarah