From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Ian Nehera Newsgroups: gmane.emacs.bugs Subject: bug#51236: 27.2/28 small typos/faq correction? Date: Sat, 16 Oct 2021 15:01:22 -0700 Message-ID: References: <001E06F1-5371-4644-9575-C5DC220D12FC@shaw.ca> <834k9hif88.fsf@gnu.org> Mime-Version: 1.0 (Mac OS X Mail 12.4 \(3445.104.21\)) 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="453"; mail-complaints-to="usenet@ciao.gmane.io" Cc: 51236@debbugs.gnu.org To: Eli Zaretskii Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Sun Oct 17 06:48:27 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 1mby5y-000AWa-Ko for geb-bug-gnu-emacs@m.gmane-mx.org; Sun, 17 Oct 2021 06:48:27 +0200 Original-Received: from localhost ([::1]:46840 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1mby5x-00084b-4K for geb-bug-gnu-emacs@m.gmane-mx.org; Sun, 17 Oct 2021 00:48:25 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:46614) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1mby5a-00080n-45 for bug-gnu-emacs@gnu.org; Sun, 17 Oct 2021 00:48:02 -0400 Original-Received: from debbugs.gnu.org ([209.51.188.43]:60057) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1mby5Z-00031T-R6 for bug-gnu-emacs@gnu.org; Sun, 17 Oct 2021 00:48:01 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1mby5Z-0006ql-Lm for bug-gnu-emacs@gnu.org; Sun, 17 Oct 2021 00:48:01 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Ian Nehera Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sun, 17 Oct 2021 04:48: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.163444603326127 (code B ref 51236); Sun, 17 Oct 2021 04:48:01 +0000 Original-Received: (at 51236) by debbugs.gnu.org; 17 Oct 2021 04:47:13 +0000 Original-Received: from localhost ([127.0.0.1]:43368 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1mby4m-0006nJ-Bb for submit@debbugs.gnu.org; Sun, 17 Oct 2021 00:47:13 -0400 Original-Received: from omta001.cacentral1.a.cloudfilter.net ([3.97.99.32]:39654) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1mbrk9-0002Z4-B4 for 51236@debbugs.gnu.org; Sat, 16 Oct 2021 18:01:29 -0400 Original-Received: from shw-obgw-4002a.ext.cloudfilter.net ([10.228.9.250]) by cmsmtp with ESMTP id bgDSm79mTczbLbrk4miSds; Sat, 16 Oct 2021 22:01:24 +0000 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=shaw.ca; s=s20180605; t=1634421684; bh=Fztx2uJlG8ResKBBkWy4CaXIihTe2rd+VTgHuGGbK9Y=; h=Subject:From:In-Reply-To:Date:Cc:References:To; b=bYkQMCmAQczIhcAQ1UuY7QSrSaHU5+Fakv6vwTUJrfHMRMr/DklNq7zVtCG8RUYr2 BMTDwpfs06hTmTzOMEDWZ9t3Y0XMs5Buv5d2yCZk+GHvzEDK8gYp1NqY21lbGTkQAf bl4MvHLhw8RW6rWKeKv+hpX3fhfyN3gQWuEFZVMPCVu61/kKuU2HVnH5d7UAfFIt7Z Tvp7+ftKHkOae4bLg1T3idpIjFE0xN2Bg+pQy6xI/++AOtl9gQQlQ18YcOfgGQxopU pu1h7c8CGd2rSwdCfjOb7L5T+5VPvHzHd5b6Dy8h+AwXxfWPwSjhhlRIwhuMweZxmg x37HC7Op9btqw== Original-Received: from ians-mbp.hitronhub.home ([24.80.41.162]) by cmsmtp with ESMTPA id brk2mnulCgxGibrk3mrE6J; Sat, 16 Oct 2021 22:01:24 +0000 Authentication-Results: ; auth=pass (PLAIN) smtp.auth=delta29@shaw.ca X-Authority-Analysis: v=2.4 cv=SqLzVNC0 c=1 sm=1 tr=0 ts=616b4bb4 a=68GUtf/ThuVGfj9FO3ScHA==:117 a=68GUtf/ThuVGfj9FO3ScHA==:17 a=IkcTkHD0fZMA:10 a=mDV3o1hIAAAA:8 a=_Dj-zB-qAAAA:8 a=qSDR_CHpbW8i7WBp6VwA:9 a=QEXdDO2ut3YA:10 a=_FVE-zBwftR9WsbkzFJk:22 a=c-cOe7UV8MviEfHuAVEQ:22 In-Reply-To: <834k9hif88.fsf@gnu.org> X-Mailer: Apple Mail (2.3445.104.21) X-CMAE-Envelope: MS4xfOpaoJJGrnCoyJmE+G4qbNwdfaqlqIZkcDR5N4tuS74gxHgMnSSi8o4ZPzdfbUVlmRGXFUXOV8e2HSbgEuhTawMe8ZrRIhQ9S3sUI64dH5iJiePNU9P2 B2js+O1TR04ZOLBH9U/aukBriMh7GFsgl6H57ytdU2tC4AeWLX27l1K451mvNW5Gw0OPiVQYtsT780oIdpZmdS2tTFhlDBZMafqtxNTZpluneiXjdI1fyIaY X-Mailman-Approved-At: Sun, 17 Oct 2021 00:47:11 -0400 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:217404 Archived-At: > 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=E2=80=99s 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=E2=80=9D and =E2=80=9Cdata are" are both technically correct so = I guess this one's more of a style choice than a typo. > 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=E2=80=99t = mention that `isearch-yank-pop=E2=80=99 (27.2) can yank text when the previous = command wasn=E2=80=99t 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=E2=80=99 = functionality in 28.1 (isearch-yank-pop) but the old behaviour is still the default = (isearch-yank-pop-only). If that=E2=80=99s going to be the case long term, there should be a note = of it in the manual. Maybe something like: =E2=80=A6usual =E2=80=98M-y=E2=80=99 (=E2=80=98yank-pop=E2=80=99) = command (see Yanking). [However unlike the usual =E2=80=98M-y=E2=80=99, =E2=80=98isearch-yank-pop=E2=80=99 will = act like =E2=80=98C-y=E2=80=99 when the previous command wasn=E2=80=99t a yank. That is, it will yank the most recent kill.] Clicking = =E2=80=98mouse-2=E2=80=99 in the=E2=80=A6 If the old `M-y=E2=80=99 behaviour WON=E2=80=99T be the default long = term, then the FAQ should be change to something along the lines of: [=E2=80=98C-y=E2=80=99 and =E2=80=98M-y=E2=80=99 work the same = in searches as they do in normal editing.] See=E2=80=A6 Thanks, Ian > On Oct 16, 2021, at 12:46 AM, Eli Zaretskii wrote: >=20 >> From: Ian Nehera >> Date: Fri, 15 Oct 2021 22:03:08 -0700 >>=20 >> Hi, I found a couple small typos in 27.2 that are still present in = the source for 28.1. >=20 > Thank you for your reports. >=20 >> doc/lispref/searching.texi line 2174: missing =E2=80=99s=E2=80=99 on = "describe" >> - Because the match data normally describe[s] =E2=80=A6 >>=20 >> url-retrieve-synchronously doc-string >> lisp/url/url.el line 229: >> - Original: ...or nil if there are no data associated with it = (the =E2=80=A6 >> - Change V1: there [is] no data ... >> - Change V2: or nil if [the buffer contains] no data = [=E2=80=A6] (the =E2=80=A6 >=20 > "Data" is plural, so I think using plural form here is non incorrect. >=20 >> The other thing I found is that the Emacs FAQ. >>=20 >> doc/misc/efaq.texi line 1905: >> Yanking text in isearch recommends =E2=80=98M-y=E2=80=99 for yanking = text out of the kill >> ring. This works, but the cross referenced manual page only mentions >> the usual =E2=80=98C-y=E2=80=99 method with =E2=80=98M-y=E2=80=99 = yanking previous kills. Is the manual=20 >> out of date or should the FAQ be updated? >=20 > 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? >=20 > Thanks again for your interest in Emacs documentation.