From mboxrd@z Thu Jan  1 00:00:00 1970
Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail
From: Lars Ingebrigtsen <larsi@gnus.org>
Newsgroups: gmane.emacs.bugs
Subject: bug#35885: 25.2; Few mistakes in Emacs Manual (+ proposals)
Date: Wed, 12 May 2021 16:47:49 +0200
Message-ID: <87r1ichuui.fsf@gnus.org>
References: <c27a8c46-68d3-f9f4-2e92-05e0b6496b53@gmail.com>
 <87v9hkvygw.fsf@gnus.org>
 <47224e43-28c1-04d0-4418-b8f069a48b0c@gmail.com>
 <87d03qx2mm.fsf@gnus.org>
 <9d2594a9-8632-eb3b-18aa-359584c96753@gmail.com>
 <87k0xwj97f.fsf@gnus.org>
 <dcedcf66-a2ce-f88c-6952-ee34d92081c1@gmail.com>
 <87r1s37xb2.fsf@gnus.org>
 <5047e985-673d-1c3c-4f97-0353e83285a9@gmail.com>
 <87o8n5xz9t.fsf@gnus.org>
 <b74cb116-4f49-5c4b-fcf5-ac622c3ee4d8@gmail.com>
 <83sgcf9mey.fsf@gnu.org>
 <7695eb68-1b42-efb7-0560-4ffbcc8bc8ac@gmail.com>
Mime-Version: 1.0
Content-Type: text/plain
Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214";
	logging-data="23277"; mail-complaints-to="usenet@ciao.gmane.io"
User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/28.0.50 (gnu/linux)
Cc: 35885@debbugs.gnu.org
To: Sebastian Urban <mrsebastianurban@gmail.com>
Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Wed May 12 16:49:10 2021
Return-path: <bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org>
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 <bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org>)
	id 1lgqAg-0005uu-KZ
	for geb-bug-gnu-emacs@m.gmane-mx.org; Wed, 12 May 2021 16:49:10 +0200
Original-Received: from localhost ([::1]:52918 helo=lists1p.gnu.org)
	by lists.gnu.org with esmtp (Exim 4.90_1)
	(envelope-from <bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org>)
	id 1lgqAf-0002Kj-NX
	for geb-bug-gnu-emacs@m.gmane-mx.org; Wed, 12 May 2021 10:49:09 -0400
Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:38540)
 by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256)
 (Exim 4.90_1) (envelope-from <Debian-debbugs@debbugs.gnu.org>)
 id 1lgqAY-0002JL-Ql
 for bug-gnu-emacs@gnu.org; Wed, 12 May 2021 10:49:02 -0400
Original-Received: from debbugs.gnu.org ([209.51.188.43]:56713)
 by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128)
 (Exim 4.90_1) (envelope-from <Debian-debbugs@debbugs.gnu.org>)
 id 1lgqAY-0007OJ-Hx
 for bug-gnu-emacs@gnu.org; Wed, 12 May 2021 10:49:02 -0400
Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2)
 (envelope-from <Debian-debbugs@debbugs.gnu.org>) id 1lgqAY-0002B2-Eo
 for bug-gnu-emacs@gnu.org; Wed, 12 May 2021 10:49:02 -0400
X-Loop: help-debbugs@gnu.org
Resent-From: Lars Ingebrigtsen <larsi@gnus.org>
Original-Sender: "Debbugs-submit" <debbugs-submit-bounces@debbugs.gnu.org>
Resent-CC: bug-gnu-emacs@gnu.org
Resent-Date: Wed, 12 May 2021 14:49:02 +0000
Resent-Message-ID: <handler.35885.B35885.16208308828288@debbugs.gnu.org>
Resent-Sender: help-debbugs@gnu.org
X-GNU-PR-Message: followup 35885
X-GNU-PR-Package: emacs
X-GNU-PR-Keywords: patch
Original-Received: via spool by 35885-submit@debbugs.gnu.org id=B35885.16208308828288
 (code B ref 35885); Wed, 12 May 2021 14:49:02 +0000
Original-Received: (at 35885) by debbugs.gnu.org; 12 May 2021 14:48:02 +0000
Original-Received: from localhost ([127.0.0.1]:40026 helo=debbugs.gnu.org)
 by debbugs.gnu.org with esmtp (Exim 4.84_2)
 (envelope-from <debbugs-submit-bounces@debbugs.gnu.org>)
 id 1lgq9Z-00029V-Jw
 for submit@debbugs.gnu.org; Wed, 12 May 2021 10:48:01 -0400
Original-Received: from quimby.gnus.org ([95.216.78.240]:59406)
 by debbugs.gnu.org with esmtp (Exim 4.84_2)
 (envelope-from <larsi@gnus.org>) id 1lgq9W-00029G-Pi
 for 35885@debbugs.gnu.org; Wed, 12 May 2021 10:48:00 -0400
DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnus.org;
 s=20200322; h=Content-Type:MIME-Version:Message-ID:In-Reply-To:Date:
 References:Subject:Cc:To:From:Sender:Reply-To:Content-Transfer-Encoding:
 Content-ID:Content-Description:Resent-Date:Resent-From:Resent-Sender:
 Resent-To:Resent-Cc:Resent-Message-ID:List-Id:List-Help:List-Unsubscribe:
 List-Subscribe:List-Post:List-Owner:List-Archive;
 bh=6IOIOl1M3zTwti+vkonRBDEk2/nRrzZa38I2k6niSek=; b=su0hOFBsKLPm2fEon8KWeVY6eQ
 B11jnYrSSp+nGFlvDXsu3xlKEy2QCbJjqcWMJmo2AMAKT7Nx+F1u3YD8hBg2ihGlku+B4RFvUFB9B
 ZcxUvHv4I3YFW4vOW9WEBLF1HpLaFU14awxWoxzy6mANSRmFNbKnWK0QS9ks00+eG+UY=;
Original-Received: from cm-84.212.220.105.getinternet.no ([84.212.220.105] helo=xo)
 by quimby.gnus.org with esmtpsa (TLS1.3:ECDHE_RSA_AES_256_GCM_SHA384:256)
 (Exim 4.92) (envelope-from <larsi@gnus.org>)
 id 1lgq9O-0005kl-Bg; Wed, 12 May 2021 16:47:52 +0200
X-Now-Playing: Fire!'s _Defeat_: "Alien (to my feet)"
In-Reply-To: <7695eb68-1b42-efb7-0560-4ffbcc8bc8ac@gmail.com> (Sebastian
 Urban's message of "Sat, 22 Aug 2020 12:19:17 +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" <bug-gnu-emacs.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/bug-gnu-emacs>,
 <mailto:bug-gnu-emacs-request@gnu.org?subject=unsubscribe>
List-Archive: <https://lists.gnu.org/archive/html/bug-gnu-emacs>
List-Post: <mailto:bug-gnu-emacs@gnu.org>
List-Help: <mailto:bug-gnu-emacs-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/bug-gnu-emacs>,
 <mailto:bug-gnu-emacs-request@gnu.org?subject=subscribe>
Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org
Original-Sender: "bug-gnu-emacs"
 <bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org>
Xref: news.gmane.io gmane.emacs.bugs:206332
Archived-At: <http://permalink.gmane.org/gmane.emacs.bugs/206332>

Sebastian Urban <mrsebastianurban@gmail.com> writes:

>> I understand item 1, but not item 2.  Why would we want to change
>> @samp to @kbd?  Likewise in other parts, where you suggest to change
>> @t to @kbd.  @kbd is for something the user types; using it for quotes
>> in context other than typing input is wrong.
>
> Before I answer, I have to ask: do we want extra (curved) quotes
> around examples showing quotes, both ASCII and curved?  Because I have
> doubts which way is correct...

I think we should use what's logical, even if it looks awkward on some
platforms.  So if it's something the user types, then it should be @kbd,
and if not, it shouldn't be.

Can you respin the patch without those changes?

-- 
(domestic pets only, the antidote for overdose, milk.)
   bloggy blog: http://lars.ingebrigtsen.no