From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED.blaine.gmane.org!not-for-mail From: Eli Zaretskii Newsgroups: gmane.emacs.bugs Subject: bug#36365: Add info how to deselect secondary selection (Emacs manual) Date: Fri, 02 Aug 2019 15:05:09 +0300 Message-ID: <83k1bvg4cq.fsf@gnu.org> References: <83zhlr8sxv.fsf@gnu.org> <62734ba6-a335-710a-2d09-3b54f0d58bde@gmail.com> <834l3z81ni.fsf@gnu.org> <831rz38107.fsf@gnu.org> <2d744cb6-8aae-2af4-d4c1-1c263cbc5866@gmail.com> <599a8119-24c4-d1cc-c022-fdde7826b677@gmail.com> <831ry4gcwv.fsf@gnu.org> Injection-Info: blaine.gmane.org; posting-host="blaine.gmane.org:195.159.176.226"; logging-data="255531"; mail-complaints-to="usenet@blaine.gmane.org" Cc: 36365@debbugs.gnu.org To: Sebastian Urban Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Fri Aug 02 14:06:09 2019 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([209.51.188.17]) by blaine.gmane.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.89) (envelope-from ) id 1htWK0-0014M5-Ms for geb-bug-gnu-emacs@m.gmane.org; Fri, 02 Aug 2019 14:06:08 +0200 Original-Received: from localhost ([::1]:34260 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.86_2) (envelope-from ) id 1htWJz-0005mZ-O4 for geb-bug-gnu-emacs@m.gmane.org; Fri, 02 Aug 2019 08:06:07 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:33517) by lists.gnu.org with esmtp (Exim 4.86_2) (envelope-from ) id 1htWJu-0005mA-Vg for bug-gnu-emacs@gnu.org; Fri, 02 Aug 2019 08:06:03 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1htWJu-0007mJ-1X for bug-gnu-emacs@gnu.org; Fri, 02 Aug 2019 08:06:02 -0400 Original-Received: from debbugs.gnu.org ([209.51.188.43]:47122) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1htWJt-0007mE-UZ for bug-gnu-emacs@gnu.org; Fri, 02 Aug 2019 08:06:01 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1htWJt-0001w8-Mw for bug-gnu-emacs@gnu.org; Fri, 02 Aug 2019 08:06: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: Fri, 02 Aug 2019 12:06:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 36365 X-GNU-PR-Package: emacs Original-Received: via spool by 36365-submit@debbugs.gnu.org id=B36365.15647475257397 (code B ref 36365); Fri, 02 Aug 2019 12:06:01 +0000 Original-Received: (at 36365) by debbugs.gnu.org; 2 Aug 2019 12:05:25 +0000 Original-Received: from localhost ([127.0.0.1]:55943 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1htWJJ-0001vF-3v for submit@debbugs.gnu.org; Fri, 02 Aug 2019 08:05:25 -0400 Original-Received: from eggs.gnu.org ([209.51.188.92]:49245) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1htWJG-0001v0-9V for 36365@debbugs.gnu.org; Fri, 02 Aug 2019 08:05:22 -0400 Original-Received: from fencepost.gnu.org ([2001:470:142:3::e]:37267) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1htWJB-00075U-7i; Fri, 02 Aug 2019 08:05:17 -0400 Original-Received: from [176.228.60.248] (port=2292 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_256_CBC_SHA1:256) (Exim 4.82) (envelope-from ) id 1htWJ8-0006qm-DK; Fri, 02 Aug 2019 08:05:16 -0400 In-reply-to: (message from Sebastian Urban on Fri, 2 Aug 2019 12:52:23 +0200) X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 209.51.188.43 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.org@gnu.org Original-Sender: "bug-gnu-emacs" Xref: news.gmane.org gmane.emacs.bugs:164331 Archived-At: > From: Sebastian Urban > Cc: 36365@debbugs.gnu.org > Date: Fri, 2 Aug 2019 12:52:23 +0200 > > > I don't think there's anything wrong with the documentation you > > cite, and I thought I already explained why I thought so in this > > discussion. > > Well, now I'm confused. I reread the thread and I found nothing but > "I see nothing wrong with the doc string as it is" as an explanation > for not changing the doc string of 'mouse-start-secondary'. And I'm > still going to write that it's missing information about deselecting, > which could be useful. We've established that it isn't possible to deselect without making a new selection. So I don't think deselection is something we can describe, as it doesn't really exist. > As for description of 'M-mouse-1' in Emacs Manual, I will also write > that the "use @kbd{M-mouse-3} to set the other end and complete the > selection" part of the sentence below is unnecessary. > > From KILLING.TEXI (L604-610): > @findex mouse-start-secondary > @kindex M-mouse-1 > @item M-mouse-1 > Set one endpoint for the @dfn{secondary selection} > (@code{mouse-start-secondary}); use @kbd{M-mouse-3} to set the other > end and complete the selection. This command cancels any existing > secondary selection, when it starts a new one. > > But in this case, if you have a reason for this, that I cannot see, > I'll leave this one alone. Yes, the manual should generally present a coherent text, so the addition looked like an improvement to me.