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#51236: 27.2/28 small typos/faq correction? Date: Sun, 17 Oct 2021 09:10:22 +0300 Message-ID: <838rysgp0x.fsf@gnu.org> References: <001E06F1-5371-4644-9575-C5DC220D12FC@shaw.ca> <834k9hif88.fsf@gnu.org> Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="39391"; mail-complaints-to="usenet@ciao.gmane.io" Cc: 51236@debbugs.gnu.org To: Ian Nehera Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Sun Oct 17 08:11:09 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 1mbzO1-000A1q-8M for geb-bug-gnu-emacs@m.gmane-mx.org; Sun, 17 Oct 2021 08:11:09 +0200 Original-Received: from localhost ([::1]:57950 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1mbzNz-0002pl-Mh for geb-bug-gnu-emacs@m.gmane-mx.org; Sun, 17 Oct 2021 02:11:07 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:53038) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1mbzNu-0002pX-B8 for bug-gnu-emacs@gnu.org; Sun, 17 Oct 2021 02:11:02 -0400 Original-Received: from debbugs.gnu.org ([209.51.188.43]:60157) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1mbzNt-0004dX-V7 for bug-gnu-emacs@gnu.org; Sun, 17 Oct 2021 02:11:01 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1mbzNt-0000mg-OW for bug-gnu-emacs@gnu.org; Sun, 17 Oct 2021 02:11: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: Sun, 17 Oct 2021 06:11:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 51236 X-GNU-PR-Package: emacs Original-Received: via spool by 51236-submit@debbugs.gnu.org id=B51236.16344510472993 (code B ref 51236); Sun, 17 Oct 2021 06:11:01 +0000 Original-Received: (at 51236) by debbugs.gnu.org; 17 Oct 2021 06:10:47 +0000 Original-Received: from localhost ([127.0.0.1]:43470 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1mbzNf-0000mD-Jv for submit@debbugs.gnu.org; Sun, 17 Oct 2021 02:10:47 -0400 Original-Received: from eggs.gnu.org ([209.51.188.92]:51106) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1mbzNe-0000lz-N7 for 51236@debbugs.gnu.org; Sun, 17 Oct 2021 02:10:46 -0400 Original-Received: from fencepost.gnu.org ([2001:470:142:3::e]:45690) by eggs.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1mbzNX-0004KA-BT; Sun, 17 Oct 2021 02:10:40 -0400 Original-Received: from [87.69.77.57] (port=1293 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 1mbzNC-0002p0-1N; Sun, 17 Oct 2021 02:10:33 -0400 In-Reply-To: (message from Ian Nehera on Sat, 16 Oct 2021 15:01:22 -0700) 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:217406 Archived-At: > From: Ian Nehera > Date: Sat, 16 Oct 2021 15:01:22 -0700 > Cc: 51236@debbugs.gnu.org > > > On Oct 16, 2021, at 12:46 AM, Eli Zaretskii wrote: > > "Data" is plural, so I think using plural form here is non incorrect. > > It’s not incorrect, it just jumped out to me when I read it. Similar to: > - There is no data on the disk. > as opposed to: > - There are no data on the disk. > "Data is” and “data are" are both technically correct so I guess this > one's more of a style choice than a typo. Yes. > > What would you suggest to update and how? Both C-y and M-y are > > mentioned in the manual, and the manual is always more detailed than > > any other documentation. Could you state the problem you see with the > > current text? > > The cross-referenced manual page (Isearch Yanking) doesn’t mention that > `isearch-yank-pop’ (27.2) can yank text when the previous command wasn’t > a yank. The only place it gets mentioned is in a comment in the source: > > ;; Fall back on `isearch-yank-kill' for the benefits of people > ;; who are used to the old behavior of `M-y' in isearch mode. In > ;; future, this fallback may be changed if we ever change > ;; `yank-pop' to do something like the kill-ring-browser. > > A separate function was made for the `kill-ring-browser’ functionality in 28.1 > (isearch-yank-pop) but the old behaviour is still the default (isearch-yank-pop-only). > If that’s going to be the case long term, there should be a note of it in the manual. > Maybe something like: > > …usual ‘M-y’ (‘yank-pop’) command (see Yanking). [However unlike the usual > ‘M-y’, ‘isearch-yank-pop’ will act like ‘C-y’ when the previous command wasn’t > a yank. That is, it will yank the most recent kill.] Clicking ‘mouse-2’ in the… I see no reason to have those details in the manual. Many Emacs commands have some DWIM-ish aspects, and we don't always document all of them in such detail. Does anyone else think it's important to have those details in the manual?