From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED!not-for-mail From: charles@aurox.ch (Charles A. Roelli) Newsgroups: gmane.emacs.bugs Subject: bug#32990: 26.1.50; isearch-forward + t-m-m/mark-active doc Date: Sun, 14 Oct 2018 21:53:31 +0200 Message-ID: References: <83muroyzfk.fsf@gnu.org> <83woqrx9pt.fsf@gnu.org> Reply-To: charles@aurox.ch NNTP-Posting-Host: blaine.gmane.org X-Trace: blaine.gmane.org 1539546488 8545 195.159.176.226 (14 Oct 2018 19:48:08 GMT) X-Complaints-To: usenet@blaine.gmane.org NNTP-Posting-Date: Sun, 14 Oct 2018 19:48:08 +0000 (UTC) Cc: 32990@debbugs.gnu.org To: Eli Zaretskii Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Sun Oct 14 21:48:04 2018 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by blaine.gmane.org with esmtp (Exim 4.84_2) (envelope-from ) id 1gBmMs-00024t-PC for geb-bug-gnu-emacs@m.gmane.org; Sun, 14 Oct 2018 21:48:03 +0200 Original-Received: from localhost ([::1]:49358 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1gBmOz-0001Em-7V for geb-bug-gnu-emacs@m.gmane.org; Sun, 14 Oct 2018 15:50:13 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:51868) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1gBmOs-0001DB-5u for bug-gnu-emacs@gnu.org; Sun, 14 Oct 2018 15:50:07 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1gBmOo-0000iL-VO for bug-gnu-emacs@gnu.org; Sun, 14 Oct 2018 15:50:06 -0400 Original-Received: from debbugs.gnu.org ([208.118.235.43]:45331) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1gBmOo-0000iA-Rv for bug-gnu-emacs@gnu.org; Sun, 14 Oct 2018 15:50:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1gBmOo-0000cr-Kl for bug-gnu-emacs@gnu.org; Sun, 14 Oct 2018 15:50:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: charles@aurox.ch (Charles A. Roelli) Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sun, 14 Oct 2018 19:50:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 32990 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: Original-Received: via spool by 32990-submit@debbugs.gnu.org id=B32990.15395465602347 (code B ref 32990); Sun, 14 Oct 2018 19:50:02 +0000 Original-Received: (at 32990) by debbugs.gnu.org; 14 Oct 2018 19:49:20 +0000 Original-Received: from localhost ([127.0.0.1]:49589 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1gBmO7-0000bn-M8 for submit@debbugs.gnu.org; Sun, 14 Oct 2018 15:49:19 -0400 Original-Received: from sinyavsky.aurox.ch ([37.35.109.145]:36357) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1gBmO5-0000bY-6d for 32990@debbugs.gnu.org; Sun, 14 Oct 2018 15:49:17 -0400 Original-Received: from sinyavsky.aurox.ch (sinyavsky.aurox.ch [127.0.0.1]) by sinyavsky.aurox.ch (Postfix) with ESMTP id 3DF4D2289B for <32990@debbugs.gnu.org>; Sun, 14 Oct 2018 19:53:21 +0000 (UTC) Authentication-Results: sinyavsky.aurox.ch (amavisd-new); dkim=pass reason="pass (just generated, assumed good)" header.d=aurox.ch DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=aurox.ch; h= references:reply-to:subject:subject:in-reply-to:to:from:from :message-id:date:date; s=dkim; t=1539546799; x=1540410800; bh=j7 bDouZjLLYJyA0iiWF5zX6dUmkXMM+pAoPNX5CYjyI=; b=gykLAy738VntLGvMWD avMEr0Bs+YAmC58HImlaNN5ky90YLH5VrqcFtYwFzoHIJAi84T16YsbxuVoOAvFH jLhCVGZNeeRh8qBzjPqVpPKoFd1nvX0wi4DLErFANy9vcRHwdUf8HdtveyKmN/TU VBHkWem287dXr6yXd8sXTQqdQ= X-Virus-Scanned: Debian amavisd-new at test.virtualizor.com Original-Received: from sinyavsky.aurox.ch ([127.0.0.1]) by sinyavsky.aurox.ch (sinyavsky.aurox.ch [127.0.0.1]) (amavisd-new, port 10026) with ESMTP id x3QoqZd30JBl for <32990@debbugs.gnu.org>; Sun, 14 Oct 2018 19:53:19 +0000 (UTC) Original-Received: from gray (unknown [IPv6:2a02:1205:c693:2d60:c62c:3ff:fe30:b864]) by sinyavsky.aurox.ch (Postfix) with ESMTPSA id 9466922887; Sun, 14 Oct 2018 19:53:19 +0000 (UTC) In-reply-to: <83woqrx9pt.fsf@gnu.org> (message from Eli Zaretskii on Tue, 09 Oct 2018 21:21:02 +0300) 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: 208.118.235.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:151249 Archived-At: > Date: Tue, 09 Oct 2018 21:21:02 +0300 > From: Eli Zaretskii > > > Ok, that would be better than duplicating all the details in both the > > function documentation and the manual. I will prepare a patch. > > Thanks! This line of isearch-forward's current docstring points to several issues which make me uncomfortable changing or deleting it yet: Type DEL to cancel last input item from end of search string. (DEL is the binding for "isearch-delete-char"). "Last input" is defined by the documentation of "isearch-delete-char" as "the last character or the last isearch command that added or deleted characters from the search string, moved point, toggled regexp mode or case-sensitivity, etc.". This definition of "last input" is not in the manual, and DEL is never advertised to be capable of canceling regexp mode or case-sensitivity toggling. DEL is only advertised as being capable of "canceling the last character of the search string" (in node "Basic Isearch") and "canceling some C-s characters" (in node "Repeat Isearch"). For example, from emacs -Q, M-< C-s buffer M-r DEL deletes the "r" off the search string, instead of "canceling the last input item", which I understand should be the "M-r" regexp mode toggling. To make matters more complicated, DEL /sometimes/ does cancel the "last input" of a search: for example, if you have some text on your kill ring, C-s C-y DEL undoes the yanking of the string into the search. (This is surprisingly sophisticated to me, and, I think, something to document better.) All of this makes it sound as if "isearch-delete-char" is badly named: it is a wrapper around "isearch-pop-state", and seems to be a sort of general (but incomplete) "undo" command for ISEARCH. Maybe we should name it differently and even provide a more intuitive binding for it (on the master branch). Its name also clashes with "isearch-del-char". Thus, some first steps for the emacs-26 branch could be to: . correct the definition of "last input item" as mentioned in the documentation of "isearch-delete-char" . name, index and fully explain "isearch-delete-char" in the Emacs manual . mention in more places how and when to use "isearch-delete-char" If anybody can explain more about "isearch-delete-char", please do!