From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Stefan Kangas Newsgroups: gmane.emacs.bugs Subject: bug#50950: "(emacs) Mark" should contrast to "selecting" text in other editors Date: Sat, 2 Oct 2021 01:01:21 +0200 Message-ID: References: <83pmsocyze.fsf@gnu.org> Mime-Version: 1.0 Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: quoted-printable Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="9732"; mail-complaints-to="usenet@ciao.gmane.io" Cc: 50950@debbugs.gnu.org To: Eli Zaretskii Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Sat Oct 02 01:02:11 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 1mWRXf-0002MH-1C for geb-bug-gnu-emacs@m.gmane-mx.org; Sat, 02 Oct 2021 01:02:11 +0200 Original-Received: from localhost ([::1]:58478 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1mWRXe-00043k-47 for geb-bug-gnu-emacs@m.gmane-mx.org; Fri, 01 Oct 2021 19:02:10 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:39232) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1mWRXW-00043b-NF for bug-gnu-emacs@gnu.org; Fri, 01 Oct 2021 19:02:02 -0400 Original-Received: from debbugs.gnu.org ([209.51.188.43]:46001) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1mWRXW-0008QM-FQ for bug-gnu-emacs@gnu.org; Fri, 01 Oct 2021 19:02:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1mWRXW-0004gz-BH for bug-gnu-emacs@gnu.org; Fri, 01 Oct 2021 19:02:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Stefan Kangas Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Fri, 01 Oct 2021 23:02:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 50950 X-GNU-PR-Package: emacs Original-Received: via spool by 50950-submit@debbugs.gnu.org id=B50950.163312930218010 (code B ref 50950); Fri, 01 Oct 2021 23:02:02 +0000 Original-Received: (at 50950) by debbugs.gnu.org; 1 Oct 2021 23:01:42 +0000 Original-Received: from localhost ([127.0.0.1]:57547 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1mWRXC-0004gP-CR for submit@debbugs.gnu.org; Fri, 01 Oct 2021 19:01:42 -0400 Original-Received: from mail-pg1-f177.google.com ([209.85.215.177]:44966) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1mWRX8-0004gA-IT for 50950@debbugs.gnu.org; Fri, 01 Oct 2021 19:01:41 -0400 Original-Received: by mail-pg1-f177.google.com with SMTP id s11so10704785pgr.11 for <50950@debbugs.gnu.org>; Fri, 01 Oct 2021 16:01:38 -0700 (PDT) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=x-gm-message-state:mime-version:references:in-reply-to:from:date :message-id:subject:to:cc:content-transfer-encoding; bh=t9z1N4Gg85pMUCFhsxSeaKWgmUv8cCf2CdCeLBUgi4s=; b=D42YSMrALGFO2wQJnGIIUpjjRvXCKIb66De6qLaZ32XON//CPr2oaHIpIC6sUpTpTJ UUPgX1o22KtSfwWA+r9LEosq0fsPbcjT0gVGD/EyZMxGhJ4N1c3hDOXbhwS8Vj4B9dU5 7ONOJi/AeGFgYm7F/O4f9a3WzrHKUf6LLC6FpYEo1Pqc6v77XFyQhRI9vfwHJFz5uqDE IFIIe/7Frixrt0S/HAfkjdCEibf2rAlHuheoiLypi9IJ6ux41M5jV8PyZ8a0xNm4oOc7 ozTbF3tdhBzoN2SXgykNs6vA1rna6ECNia4koCU+ui26JFpxMxFMcXEV25PgePwGBFZj OP/A== X-Gm-Message-State: AOAM530Gg2p/V8NnGAhOWMCVRMUhfN6dlpOM6RSfB/EFVGn+aZ5tCcqR pdejw1B8ChrVUQnRRhf9jWHl6cqVasEDaYhsouYkWtErsxM= X-Google-Smtp-Source: ABdhPJyjuR7lOThO3Z0xMlr8Qc4eSprBqZdJle+JBoTdFvHu3fGPiWsfY702syIP9GE4lt8+JKwItTGNDXFsrdD3IVs= X-Received: by 2002:a05:6a00:1586:b0:447:b30c:4a65 with SMTP id u6-20020a056a00158600b00447b30c4a65mr12489499pfk.0.1633129292421; Fri, 01 Oct 2021 16:01:32 -0700 (PDT) In-Reply-To: <83pmsocyze.fsf@gnu.org> 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:216089 Archived-At: Den fre 1 okt. 2021 kl 21:44 skrev Eli Zaretskii : > > > From: Stefan Kangas > > Date: Fri, 1 Oct 2021 21:31:22 +0200 > > > > Severity: wishlist > > > > The section '(emacs) Mark' starts with saying: > > > > "Many Emacs commands operate on an arbitrary contiguous part of the > > current buffer." > > > > This makes it sound like this is an unusual, super advanced feature, > > when in the rest of the world this is just known as "selecting text". > > We should avoid the words "arbitrary" and "contiguous" which, while > > accurate, comes off as extremely highbrow for such an extremely basic > > feature. > > I disagree that the region is a basic feature. It may look > deceptively similar to text selections, but it isn't. We have the > region, the active region, and the shift- and mouse-selected text, > which all look similar, and sometimes behave similarly, but they are > not identical. IMO, it is not an advanced feature, and on the most basic level it really is just selecting text. You want to copy it, make it bold, indent it, or what have you. It is of course precisely what makes it different that needs to be explained. But this can and IMO should be done by starting out from what is already known. For example, where we now have: Many Emacs commands operate on an arbitrary contiguous part of the current buffer. To specify the text for such a command to operate on, you set =E2=80=9Cthe mark=E2=80=9D at one end of it, and move point to th= e other end. it would be better to put something along these lines: In other text editors, you can select text to perform various operations on, such as copying or deleting it. In Emacs, we say that such commands operate on the "region". The region starts at point, and ends at what in Emacs is known as "the mark" ... [Note: this a very quick write-up, and not a proposal.] We don't need to talk about "arbitrary contiguous parts" or anything like that. There is no need to pretend as if the user don't already have a very strong concept of what exactly is a text selection and how it works: our job is to help the user see exactly where that intuition fails. > > We should re-work this section to contrast the unusual parts of point, > > mark and region to the types of text selection that exists in other > > editors. We can safely assume that the latter is well known. > > The region and selected text are not identical. The differences are > subtle and not easy to explain, but saying that they are the same is > worse than that, because it will trip users. See above, this is not about saying that these things are the same. In any case, AFAICT, the manual doesn't make much of an attempt to explain this difference as it is, so I'm not sure it is very important. I could be wrong, but in that case I think the manual should try to do a better job at explaining it. (The only match I can find for variations of "select" in the index is "mouse, selecting text using" and that section is talking about the region.)