From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Eli Zaretskii Newsgroups: gmane.emacs.bugs Subject: bug#48504: Improve style of C-h t description (Preface) Date: Thu, 20 May 2021 10:06:24 +0300 Message-ID: <83a6opq3yn.fsf@gnu.org> References: <83im3frgsr.fsf@gnu.org> <3195631d-1f4c-2b55-b7ed-9bb919458c76@gmail.com> <83h7izqx4l.fsf@gnu.org> <837djvq6n2.fsf@gnu.org> <83tumyq0mk.fsf@gnu.org> <2dbee0a0-4c4a-cad0-ae8a-91e8ba88cbde@gmail.com> Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="24008"; mail-complaints-to="usenet@ciao.gmane.io" Cc: 48504@debbugs.gnu.org To: Sebastian Urban Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Thu May 20 09:07:26 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 1ljcmD-00063A-Pi for geb-bug-gnu-emacs@m.gmane-mx.org; Thu, 20 May 2021 09:07:25 +0200 Original-Received: from localhost ([::1]:36872 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1ljcmC-0005Sh-Ry for geb-bug-gnu-emacs@m.gmane-mx.org; Thu, 20 May 2021 03:07:24 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:58040) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1ljcls-0005SV-8h for bug-gnu-emacs@gnu.org; Thu, 20 May 2021 03:07:04 -0400 Original-Received: from debbugs.gnu.org ([209.51.188.43]:49692) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1ljclp-0005GF-PB for bug-gnu-emacs@gnu.org; Thu, 20 May 2021 03:07:03 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1ljclp-0001cb-KF for bug-gnu-emacs@gnu.org; Thu, 20 May 2021 03:07:01 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Eli Zaretskii Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Thu, 20 May 2021 07:07: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.16214943826179 (code B ref 48504); Thu, 20 May 2021 07:07:01 +0000 Original-Received: (at 48504) by debbugs.gnu.org; 20 May 2021 07:06:22 +0000 Original-Received: from localhost ([127.0.0.1]:33005 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1ljclB-0001bb-RA for submit@debbugs.gnu.org; Thu, 20 May 2021 03:06:22 -0400 Original-Received: from eggs.gnu.org ([209.51.188.92]:36110) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1ljcl9-0001bN-7m for 48504@debbugs.gnu.org; Thu, 20 May 2021 03:06:20 -0400 Original-Received: from fencepost.gnu.org ([2001:470:142:3::e]:50128) by eggs.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1ljcl3-0004Yq-1D; Thu, 20 May 2021 03:06:14 -0400 Original-Received: from 84.94.185.95.cable.012.net.il ([84.94.185.95]:2966 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1ljcl2-00076Q-E4; Thu, 20 May 2021 03:06:12 -0400 In-Reply-To: <2dbee0a0-4c4a-cad0-ae8a-91e8ba88cbde@gmail.com> (message from Sebastian Urban on Thu, 20 May 2021 08:21:01 +0200) 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:206925 Archived-At: > From: Sebastian Urban > Cc: 48504@debbugs.gnu.org > Date: Thu, 20 May 2021 08:21:01 +0200 > > 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? Using some notation before explaining it is confusing, especially when you are telling the reader how to start the tutorial, which is probably the first document about Emacs for that reader. > 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. Look, you don't have to agree with my reasoning. As long as I explained it, and the explanation is clear (as I think it is, based on your response), we don't have to continue to argue. Just accept that this is my reasoning for doing things this way, and it's based on some experience in this area.