From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Eli Zaretskii Newsgroups: gmane.emacs.bugs Subject: bug#7702: 24.0.50; doc of select-active-regions, cut/paste/kill/yank Date: Sat, 25 Dec 2010 20:10:54 +0200 Message-ID: <83ei95d8pd.fsf@gnu.org> References: <6728B5371A6446B9B4C1CEB95BFF7FF2@us.oracle.com> <83oc8acc1c.fsf@gnu.org> <666BE4469D9F466C87AE36367C3947A0@us.oracle.com> Reply-To: Eli Zaretskii NNTP-Posting-Host: lo.gmane.org X-Trace: dough.gmane.org 1293301402 29604 80.91.229.12 (25 Dec 2010 18:23:22 GMT) X-Complaints-To: usenet@dough.gmane.org NNTP-Posting-Date: Sat, 25 Dec 2010 18:23:22 +0000 (UTC) Cc: 7702@debbugs.gnu.org To: Drew Adams Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Sat Dec 25 19:23:18 2010 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([199.232.76.165]) by lo.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1PWYlw-0005zJ-S4 for geb-bug-gnu-emacs@m.gmane.org; Sat, 25 Dec 2010 19:23:17 +0100 Original-Received: from localhost ([127.0.0.1]:52669 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1PWYlw-0004lR-5C for geb-bug-gnu-emacs@m.gmane.org; Sat, 25 Dec 2010 13:23:16 -0500 Original-Received: from [140.186.70.92] (port=35092 helo=eggs.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1PWYls-0004lM-8u for bug-gnu-emacs@gnu.org; Sat, 25 Dec 2010 13:23:13 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1PWYlq-0001YT-S8 for bug-gnu-emacs@gnu.org; Sat, 25 Dec 2010 13:23:12 -0500 Original-Received: from debbugs.gnu.org ([140.186.70.43]:45583) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1PWYlq-0001YP-QX for bug-gnu-emacs@gnu.org; Sat, 25 Dec 2010 13:23:10 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.69) (envelope-from ) id 1PWYWE-0002HQ-8Z; Sat, 25 Dec 2010 13:07:02 -0500 X-Loop: help-debbugs@gnu.org Resent-From: Eli Zaretskii Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-To: owner@debbugs.gnu.org Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sat, 25 Dec 2010 18:07:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 7702 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: Original-Received: via spool by 7702-submit@debbugs.gnu.org id=B7702.12933003768710 (code B ref 7702); Sat, 25 Dec 2010 18:07:02 +0000 Original-Received: (at 7702) by debbugs.gnu.org; 25 Dec 2010 18:06:16 +0000 Original-Received: from localhost ([127.0.0.1] helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1PWYVT-0002GQ-Iu for submit@debbugs.gnu.org; Sat, 25 Dec 2010 13:06:15 -0500 Original-Received: from mtaout20.012.net.il ([80.179.55.166]) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1PWYVP-0002GD-N2 for 7702@debbugs.gnu.org; Sat, 25 Dec 2010 13:06:13 -0500 Original-Received: from conversion-daemon.a-mtaout20.012.net.il by a-mtaout20.012.net.il (HyperSendmail v2007.08) id <0LDZ00700X7O2I00@a-mtaout20.012.net.il> for 7702@debbugs.gnu.org; Sat, 25 Dec 2010 20:12:52 +0200 (IST) Original-Received: from HOME-C4E4A596F7 ([77.124.219.104]) by a-mtaout20.012.net.il (HyperSendmail v2007.08) with ESMTPA id <0LDZ0061CX9D3HB0@a-mtaout20.012.net.il>; Sat, 25 Dec 2010 20:12:52 +0200 (IST) In-reply-to: <666BE4469D9F466C87AE36367C3947A0@us.oracle.com> X-012-Sender: halo1@inter.net.il X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 Precedence: list Resent-Date: Sat, 25 Dec 2010 13:07:02 -0500 X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 3) 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: , Original-Sender: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.bugs:42852 Archived-At: > From: "Drew Adams" > Cc: <7702-done@debbugs.gnu.org> > Date: Sat, 25 Dec 2010 09:38:48 -0800 > > > "If non-nil, an active region automatically sets the > > primary selection." > > That doesn't help for a system such as Windows that has no concept of primary > selection. The manual now explains what that means on Windows (that's the change I described below). There's also an index entry wrt primary selection on MS-Windows. I don't think we can or should explain all that in a doc string of an option. > It leaves the user wondering: does this variable do nothing on > Windows? Is the behavior on Windows always as if the variable is nil? non-nil? This variable has the same meaning and effect on Windows as on X, and its default value is the same. So I see nothing that should be said about that. The only difference -- that on Windows the primary selection exists only within a single Emacs session -- is now in the manual. > > @cindex MS-Windows, and primary selection > > MS-Windows provides no primary selection, but Emacs emulates it > > within a single Emacs session: all the features and commands related > > to the primary selection work as described for cutting and pasting > > within the same session, but not across Emacs sessions or with other > > applications. > > OK, but what does "work as described" mean for something whose behavior is > described wrt the primary? "As described" in this subsection, and elsewhere in the manual. If that's not clear, we could say that explicitly. > E.g. what does it mean for a var like `select-active-regions'? Just what the documentation of that variable says: an active region is placed into the primary selection, and can be pasted from there by any command that retrieves text from the primary selection. > I think we should be more specific and say what Emacs on Windows does with the > emulated primary. Does it use the kill-ring? the clipboard? Neither. It's an entirely separate store. Why is this important? The manual doesn't explain how the primary selection works on X, and most users will probably never know. So why should we go into these implementation details for Windows? If the emulation were using one of the existing facilities, like the kill-ring, then we would need to tell that, because the effect would be visible to the user. But since it doesn't, and the place where the selection is stored is entirely concealed from the user, I see no reason for any further details. > > > For example, the description of `select-active-regions' makes it > > > sound like it has no effect on a system, such as MS Windows, that > > > has no concept of a primary selection. If that is so, then say so. > > > > It has the same effect on MS-Windows, with the caveat that the primary > > selection "works" only within the current session. > > Then let's say that, including the last part. You've added the last part in the > manual (above), so that's OK. But the doc string should at least give some > indication that this var is not irrelevant on Windows. Given that I modified it to not refer to X, why would a user think that it is irrelevant? It's unreasonable to ask that we repeat in each doc string related to selections that these features also work on Windows. > Also, as I mentioned, the notion of "other app" needs to be > clarified. Does it include Emacs (another session)? I said (below) that it does, and the exception wrt primary selection was already mentioned in the text before the paragraph about "other app". > You clarified the Windows behavior wrt other sessions, but what > about non-Windows? The exception wrt to other session is clearly Windows-specific. The text says this explicitly. > And, as I mentioned, there is the problem of just what the relation is between > pasting and yanking - see what I wrote in the initial bug report. Even just the > notion of "pasting" is not very clear. When you use `mouse-2' are you pasting? > Or is "pasting" reserved for something that is pasted from the clipboard. Etc. > - we need to be clearer about these terms. That's a different job, and a much larger one. I would suggest a separate bug report, or maybe wait until Emacs 24 is near its pretest. That's because Emacs 23, in whose manual I made the change, makes no distinction between these two, and in fact mixes them freely (e.g., mouse-2 does the equivalent of C-y), so explaining the difference is hopelessly complicated, perhaps even impossible in Emacs 23. > As I mentioned, there is even a mismatch between the node name and the node > title: one refers to cut/paste and the other to kill/yank. Not anymore. > > AFAIK, there's nothing special about Emacs wrt cutting/pasting between > > different applications (with the exception of primary selections on > > MS-Windows, which is now covered). If you know about anything else, > > please tell. > > No, I don't know more than you about it, obviously. But this bug was filed the > same day as #7699 (it was actually sent before, but the bug number is slightly > higher), and that report was about the fact that copying text in another app did > not paste it into Emacs. The manual describes the correct behavior. Bugs which violate that correctness should be fixed, they don't need to affect the manual. What I say above is how Emacs _should_ work on Windows. Any deviation from that behavior is potentially a bug that should be fixed. > [I] look forward to the new version. If I then notice anything that > I think is unclear I'll let you know. Thanks. > If you're comfortable with having responded to my concerns, then > please go ahead and close this bug. But please first think about > what I said above, then decide. Will do.