From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Sebastian Urban Newsgroups: gmane.emacs.bugs Subject: bug#48504: Improve style of C-h t description (Preface) Date: Thu, 20 May 2021 08:21:01 +0200 Message-ID: <2dbee0a0-4c4a-cad0-ae8a-91e8ba88cbde@gmail.com> References: <83im3frgsr.fsf@gnu.org> <3195631d-1f4c-2b55-b7ed-9bb919458c76@gmail.com> <83h7izqx4l.fsf@gnu.org> <837djvq6n2.fsf@gnu.org> <83tumyq0mk.fsf@gnu.org> Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8; format=flowed Content-Transfer-Encoding: 7bit Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="8342"; mail-complaints-to="usenet@ciao.gmane.io" User-Agent: Mozilla/5.0 (Windows NT 6.1; Win64; x64; rv:78.0) Gecko/20100101 Thunderbird/78.10.2 Cc: 48504@debbugs.gnu.org To: Eli Zaretskii Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Thu May 20 08:22:52 2021 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane-mx.org Original-Received: from lists.gnu.org ([209.51.188.17]) by ciao.gmane.io with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1ljc55-00022Z-KP for geb-bug-gnu-emacs@m.gmane-mx.org; Thu, 20 May 2021 08:22:51 +0200 Original-Received: from localhost ([::1]:45660 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1ljc54-0006n4-1O for geb-bug-gnu-emacs@m.gmane-mx.org; Thu, 20 May 2021 02:22:50 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:44698) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1ljc4I-0006mm-8S for bug-gnu-emacs@gnu.org; Thu, 20 May 2021 02:22:02 -0400 Original-Received: from debbugs.gnu.org ([209.51.188.43]:49619) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1ljc4I-0004vU-0j for bug-gnu-emacs@gnu.org; Thu, 20 May 2021 02:22:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1ljc4H-0000Vq-TF for bug-gnu-emacs@gnu.org; Thu, 20 May 2021 02:22:01 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Sebastian Urban Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Thu, 20 May 2021 06:22:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 48504 X-GNU-PR-Package: emacs Original-Received: via spool by 48504-submit@debbugs.gnu.org id=B48504.16214916661904 (code B ref 48504); Thu, 20 May 2021 06:22:01 +0000 Original-Received: (at 48504) by debbugs.gnu.org; 20 May 2021 06:21:06 +0000 Original-Received: from localhost ([127.0.0.1]:32932 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1ljc3N-0000Ud-RR for submit@debbugs.gnu.org; Thu, 20 May 2021 02:21:06 -0400 Original-Received: from mail-wr1-f52.google.com ([209.85.221.52]:38900) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1ljc3M-0000Tr-0n for 48504@debbugs.gnu.org; Thu, 20 May 2021 02:21:04 -0400 Original-Received: by mail-wr1-f52.google.com with SMTP id j14so14576202wrq.5 for <48504@debbugs.gnu.org>; Wed, 19 May 2021 23:21:03 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=from:subject:to:cc:references:message-id:date:user-agent :mime-version:in-reply-to:content-language:content-transfer-encoding; bh=F9+I0AA8KrF9HXcvKGQ4vOty7Bok/+wBD1h6ztFs+fI=; b=UgHg7VrkbzFwKDzOKyIR1X8kDLqZzViKVhaF3eiE2jHNfunrXx2l4m9SGM8R/GhGXS LZGyheTm4yvW0QF6fEUen8917v3qy0BkJs/VLKPswLCYfsauHT/bmaB0bxXaZ91ywBV2 s6+iXWDDKBD82V6MvJ8VOY1gl3niWly3wrbh8/ZXqFBOP6iMPY4ZdWEMdm8IkBx8MFwE 7hANcJbILR1v7sjqBtXHsnsHGdqsMR67NQ+XEYNsz9okei1DALcIr6daDjzAu1gW/uML C3UTSyxkcz6Dw32jh0uzPT5qBp5ilH3QTjUniwUIW9NefRYzDORsHeGcDx1WbmX5UCfe BOgg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:subject:to:cc:references:message-id:date :user-agent:mime-version:in-reply-to:content-language :content-transfer-encoding; bh=F9+I0AA8KrF9HXcvKGQ4vOty7Bok/+wBD1h6ztFs+fI=; b=etrIIqpYHFB3V9mBx6Dkc1VNWjsvYy6uQWJ4qlTqBFgR4JC2cv5PJtgZ9RdN8frGat lHQV4IB9/0lxeR6cX3h++AOih2bTAG2zUJjKRvp6yJCdhgmG//v4Sr3LLJSlD5RWfnKu QAPrzg1g3zBGEYG20M5Hb1MSn2eUHvVGeGg9EZCDigIq1SELQQCOQKXwetRdr168q+4l OOKBdee0/l7TjVfQBVIgLWXYG0pucZZlDupB7LySLwX5sdKE9odtZfgM9yIlvcErtqRv 8vB2PgKj0rEKrq9O0tbOkb9e9SfGnJG/H5lScKRV+kj5O8+v8Fd2uLWMyfFPdDbOVmIm CH6Q== X-Gm-Message-State: AOAM533iIVOEYi/BQZ9hFK5HU7qOj1Dz6+rtv7G+rlMkHEXgWWKPEgGV 02KTd7qjE6tMC3kvB13ONya/7wn9PUM= X-Google-Smtp-Source: ABdhPJwaEjP+WyejO0n8PDSoUl75cC3eQwjnTevfXPXHMDKR7hm6aaBB09v//eXzdXwgFeGlCDrq/Q== X-Received: by 2002:adf:e3c8:: with SMTP id k8mr2439982wrm.212.1621491658105; Wed, 19 May 2021 23:20:58 -0700 (PDT) Original-Received: from ?IPv6:2a00:f41:c06:40df:44c1:eb67:5fc6:f50c? ([2a00:f41:c06:40df:44c1:eb67:5fc6:f50c]) by smtp.gmail.com with ESMTPSA id y2sm1825666wrl.92.2021.05.19.23.20.56 (version=TLS1_3 cipher=TLS_AES_128_GCM_SHA256 bits=128/128); Wed, 19 May 2021 23:20:57 -0700 (PDT) In-Reply-To: <83tumyq0mk.fsf@gnu.org> Content-Language: en-GB X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-BeenThere: bug-gnu-emacs@gnu.org List-Id: "Bug reports for GNU Emacs, the Swiss army knife of text editors" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Original-Sender: "bug-gnu-emacs" Xref: news.gmane.io gmane.emacs.bugs:206922 Archived-At: >>> How about >>> >>> To run the tutorial, start Emacs and type @kbd{C-h t} (that is, >>> press and hold Control, then type h, then release Control and type >>> t). >> >> Why @kbd/@key (commands for indication) can't be used here for >> "Control"/"h"/"t"? > > Because we didn't yet explain this notation, that comes later in the > manual. This is becoming a surprisingly confusing issue... So, we can't present keys or other KBD input with @key/@kbd style, because of the notation, that e.g. makes keys like Control use @key style, which is introduced later? Until that section - "(emacs) User Input" perhaps - we can only write "Control"/"h"/"t" just like an ordinary text? BTW, isn't @kbd{C-h t}, in the same sentence, and @kbd{h}, in the same file (EMACS.TEXI - L128), against this rule as well? What is to explain at all? The fact that - e.g. in PDF - @kbd/@key change font from Roman to Typewriter. It helps to distinguish the input keys/chars from the rest of the paragraph. In your example "h" and "t" may look like leftovers from a partially removed words... which is something I want to avoid.