From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Alan Mackenzie Newsgroups: gmane.emacs.devel Subject: Re: isearch-allow-prefix [Was: [PATCH] Make `C-x {' and `C-x }' repeatable] Date: Tue, 4 Jun 2013 21:24:00 +0000 Message-ID: <20130604212400.GB2492@acm.acm> References: <87txlts7so.fsf@mail.jurta.org> <20130524093858.GA2754@acm.acm> <87hahstd47.fsf@mail.jurta.org> <20130525200103.GA3451@acm.acm> <878v32aj3c.fsf@mail.jurta.org> <20130602210512.GC2765@acm.acm> <87sj0xn484.fsf@mail.jurta.org> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Trace: ger.gmane.org 1370381072 16791 80.91.229.3 (4 Jun 2013 21:24:32 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Tue, 4 Jun 2013 21:24:32 +0000 (UTC) Cc: Stefan Monnier , Drew Adams , emacs-devel@gnu.org To: Juri Linkov Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Tue Jun 04 23:24:32 2013 Return-path: Envelope-to: ged-emacs-devel@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by plane.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1UjyiQ-0004Dk-FH for ged-emacs-devel@m.gmane.org; Tue, 04 Jun 2013 23:24:26 +0200 Original-Received: from localhost ([::1]:58562 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1UjyiQ-0003vF-01 for ged-emacs-devel@m.gmane.org; Tue, 04 Jun 2013 17:24:26 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:37790) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1UjyiM-0003ub-OC for emacs-devel@gnu.org; Tue, 04 Jun 2013 17:24:24 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1UjyiK-0000Zu-Le for emacs-devel@gnu.org; Tue, 04 Jun 2013 17:24:22 -0400 Original-Received: from colin.muc.de ([193.149.48.1]:40349 helo=mail.muc.de) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1UjyiK-0000Zb-BX for emacs-devel@gnu.org; Tue, 04 Jun 2013 17:24:20 -0400 Original-Received: (qmail 63348 invoked by uid 3782); 4 Jun 2013 21:24:17 -0000 Original-Received: from acm.muc.de (pD9518768.dip0.t-ipconnect.de [217.81.135.104]) by colin.muc.de (tmda-ofmipd) with ESMTP; Tue, 04 Jun 2013 23:24:11 +0200 Original-Received: (qmail 4228 invoked by uid 1000); 4 Jun 2013 21:24:00 -0000 Content-Disposition: inline In-Reply-To: <87sj0xn484.fsf@mail.jurta.org> User-Agent: Mutt/1.5.21 (2010-09-15) X-Delivery-Agent: TMDA/1.1.12 (Macallan) X-Primary-Address: acm@muc.de X-detected-operating-system: by eggs.gnu.org: FreeBSD 8.x X-Received-From: 193.149.48.1 X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Original-Sender: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.devel:160084 Archived-At: Hi, Juri. On Tue, Jun 04, 2013 at 09:03:07PM +0300, Juri Linkov wrote: > > I'm not terribly impressed by the documentation patch, but it was the > > best I could manage. > Could you try adding new text to the existing node (info "(emacs) > Isearch Scroll") and renaming it to something more general that would > fit both variables? I know that it's not trivial to find such a name, > but it would be better to have related variables in the same node. > What about the node name "Exiting Isearch" to document in one node all > options that affect commands exiting Isearch? I've used something similar: "Not Exiting Isearch". :-) I've also made the two somewhat dissimilar parts of this @subsection into a @table. I think it jars a bit less, and is a bit less confusing, than simply having the bit about prefixes running into the bit about scrolling. Could I ask you to take one more look, please? Thanks! === modified file 'doc/emacs/emacs.texi' *** doc/emacs/emacs.texi 2013-03-30 16:47:07 +0000 --- doc/emacs/emacs.texi 2013-06-04 20:45:12 +0000 *************** *** 396,409 **** Incremental Search ! * Basic Isearch:: Basic incremental search commands. ! * Repeat Isearch:: Searching for the same string again. ! * Error in Isearch:: When your string is not found. ! * Special Isearch:: Special input in incremental search. ! * Isearch Yank:: Commands that grab text into the search string ! or else edit the search string. ! * Isearch Scroll:: Scrolling during an incremental search. ! * Isearch Minibuffer:: Incremental search of the minibuffer history. Replacement Commands --- 396,409 ---- Incremental Search ! * Basic Isearch:: Basic incremental search commands. ! * Repeat Isearch:: Searching for the same string again. ! * Error in Isearch:: When your string is not found. ! * Special Isearch:: Special input in incremental search. ! * Isearch Yank:: Commands that grab text into the search string ! or else edit the search string. ! * Not Exiting Isearch:: Prefix argument and scrolling commands. ! * Isearch Minibuffer:: Incremental search of the minibuffer history. Replacement Commands === modified file 'doc/emacs/search.texi' *** doc/emacs/search.texi 2013-05-15 23:14:18 +0000 --- doc/emacs/search.texi 2013-06-04 20:48:10 +0000 *************** *** 52,65 **** @end table @menu ! * Basic Isearch:: Basic incremental search commands. ! * Repeat Isearch:: Searching for the same string again. ! * Error in Isearch:: When your string is not found. ! * Special Isearch:: Special input in incremental search. ! * Isearch Yank:: Commands that grab text into the search string ! or else edit the search string. ! * Isearch Scroll:: Scrolling during an incremental search. ! * Isearch Minibuffer:: Incremental search of the minibuffer history. @end menu @node Basic Isearch --- 52,65 ---- @end table @menu ! * Basic Isearch:: Basic incremental search commands. ! * Repeat Isearch:: Searching for the same string again. ! * Error in Isearch:: When your string is not found. ! * Special Isearch:: Special input in incremental search. ! * Isearch Yank:: Commands that grab text into the search string ! or else edit the search string. ! * Not Exiting Isearch:: Prefix argument and scrolling commands. ! * Isearch Minibuffer:: Incremental search of the minibuffer history. @end menu @node Basic Isearch *************** *** 332,340 **** minibuffer with @kbd{M-e} (@pxref{Repeat Isearch}) and type @kbd{C-f} at the end of the search string in the minibuffer. ! @node Isearch Scroll ! @subsection Scrolling During Incremental Search @vindex isearch-allow-scroll Normally, scrolling commands exit incremental search. If you change the variable @code{isearch-allow-scroll} to a non-@code{nil} value, --- 332,359 ---- minibuffer with @kbd{M-e} (@pxref{Repeat Isearch}) and type @kbd{C-f} at the end of the search string in the minibuffer. ! @node Not Exiting Isearch ! @subsection Not Exiting Incremental Search + This subsection describes two categories of commands which you can + type without exiting the current incremental search, even though they + are not themselves part of incremental search. + + @table @asis + @item Prefix Arguments + @vindex isearch-allow-prefix + In incremental search, when you enter a prefix argument + (@pxref{Arguments}), by default it will apply either to the next + action in the search or to the command that exits the search. + + In previous versions of Emacs, entering a prefix argument always + terminated the search. You can revert to this behavior by setting the + variable @code{isearch-allow-prefix} to @code{nil}. + + When @code{isearch-allow-scroll} is non-@code{nil} (see below), + prefix arguments always have the default behavior described above. + + @item Scrolling Commands @vindex isearch-allow-scroll Normally, scrolling commands exit incremental search. If you change the variable @code{isearch-allow-scroll} to a non-@code{nil} value, *************** *** 366,371 **** --- 385,391 ---- change point, the buffer contents, the match data, the current buffer, or the selected window and frame. The command must not itself attempt an incremental search. + @end table @node Isearch Minibuffer @subsection Searching the Minibuffer -- Alan Mackenzie (Nuremberg, Germany).